net.minecraftforge.oredict

Class OreDictionary

java.lang.Object

net.minecraftforge.oredict.OreDictionary

public class OreDictionary
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OreDictionary.OreRegisterEvent

Field Summary

Fields

Modifier and Type	Field and Description
private static boolean	DEBUG
static NonNullList<ItemStack>	EMPTY_LIST
private static boolean	hasInit
private static java.util.List<java.lang.String>	idToName
private static java.util.List<NonNullList<ItemStack>>	idToStack
private static java.util.List<NonNullList<ItemStack>>	idToStackUn
private static java.util.Map<java.lang.String,java.lang.Integer>	nameToId
private static java.util.Map<java.lang.Integer,java.util.List<java.lang.Integer>>	stackToId
static int	WILDCARD_VALUE Minecraft changed from -1 to Short.MAX_VALUE in 1.5 release for the "block wildcard".

Constructor Summary

Constructors

Constructor and Description
OreDictionary()

Method Summary

Modifier and Type	Method and Description
private static boolean	containsMatch(boolean strict, ItemStack[] inputs, ItemStack... targets)
static boolean	containsMatch(boolean strict, NonNullList<ItemStack> inputs, ItemStack... targets)
static boolean	doesOreNameExist(java.lang.String name) Returns whether or not an oreName exists in the dictionary.
static int	getOreID(java.lang.String name) Gets the integer ID for the specified ore name.
static int[]	getOreIDs(ItemStack stack) Gets all the integer ID for the ores that the specified item stack is registered to.
static java.lang.String	getOreName(int id) Reverse of getOreID, will not create new entries.
static java.lang.String[]	getOreNames() Retrieves a list of all unique ore names that are already registered.
private static NonNullList<ItemStack>	getOres(int id) Retrieves the List of items that are registered to this ore type.
static NonNullList<ItemStack>	getOres(java.lang.String name) Retrieves the ArrayList of items that are registered to this ore type.
static NonNullList<ItemStack>	getOres(java.lang.String name, boolean alwaysCreateEntry) Retrieves the List of items that are registered to this ore type at this instant.
private static void	initVanillaEntries()
static boolean	itemMatches(ItemStack target, ItemStack input, boolean strict)
static void	rebakeMap()
static void	registerOre(java.lang.String name, Block ore)
static void	registerOre(java.lang.String name, Item ore)
static void	registerOre(java.lang.String name, ItemStack ore)
private static void	registerOreImpl(java.lang.String name, ItemStack ore) Registers a ore item into the dictionary.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEBUG

private static final boolean DEBUG

See Also:

Constant Field Values

hasInit

private static boolean hasInit

idToName

private static java.util.List<java.lang.String> idToName

nameToId

private static java.util.Map<java.lang.String,java.lang.Integer> nameToId

idToStack

private static java.util.List<NonNullList<ItemStack>> idToStack

idToStackUn

private static java.util.List<NonNullList<ItemStack>> idToStackUn

stackToId

private static java.util.Map<java.lang.Integer,java.util.List<java.lang.Integer>> stackToId

EMPTY_LIST

public static final NonNullList<ItemStack> EMPTY_LIST

WILDCARD_VALUE

public static final int WILDCARD_VALUE

Minecraft changed from -1 to Short.MAX_VALUE in 1.5 release for the "block wildcard". Use this in case it changes again.

See Also:

Constant Field Values

Constructor Detail

OreDictionary

public OreDictionary()

Method Detail

initVanillaEntries

private static void initVanillaEntries()

getOreID

public static int getOreID(java.lang.String name)

Gets the integer ID for the specified ore name. If the name does not have a ID it assigns it a new one.

Parameters:

name - The unique name for this ore 'oreIron', 'ingotIron', etc..

Returns:

A number representing the ID for this ore type

getOreName

public static java.lang.String getOreName(int id)

Reverse of getOreID, will not create new entries.

Parameters:

id - The ID to translate to a string

Returns:

The String name, or "Unknown" if not found.

getOreIDs

public static int[] getOreIDs(@Nonnull
                              ItemStack stack)

Gets all the integer ID for the ores that the specified item stack is registered to. If the item stack is not linked to any ore, this will return an empty array and no new entry will be created.

Parameters:

stack - The item stack of the ore.

Returns:

An array of ids that this ore is registered as.

getOres

public static NonNullList<ItemStack> getOres(java.lang.String name)

Retrieves the ArrayList of items that are registered to this ore type. Creates the list as empty if it did not exist. The returned List is unmodifiable, but will be updated if a new ore is registered using registerOre

Parameters:

name - The ore name, directly calls getOreID

Returns:

An arrayList containing ItemStacks registered for this ore

getOres

public static NonNullList<ItemStack> getOres(java.lang.String name,
                                             boolean alwaysCreateEntry)

Retrieves the List of items that are registered to this ore type at this instant. If the flag is TRUE, then it will create the list as empty if it did not exist. This option should be used by modders who are doing blanket scans in postInit. It greatly reduces clutter in the OreDictionary is the responsible and proper way to use the dictionary in a large number of cases. The other function above is utilized in OreRecipe and is required for the operation of that code.

Parameters:

name - The ore name, directly calls getOreID if the flag is TRUE

alwaysCreateEntry - Flag - should a new entry be created if empty

Returns:

An arraylist containing ItemStacks registered for this ore

doesOreNameExist

public static boolean doesOreNameExist(java.lang.String name)

Returns whether or not an oreName exists in the dictionary. This function can be used to safely query the Ore Dictionary without adding needless clutter to the underlying map structure. Please use this when possible and appropriate.

Parameters:

name - The ore name

Returns:

Whether or not that name is in the Ore Dictionary.

getOreNames

public static java.lang.String[] getOreNames()

Retrieves a list of all unique ore names that are already registered.

Returns:

All unique ore names that are currently registered.

getOres

private static NonNullList<ItemStack> getOres(int id)

Retrieves the List of items that are registered to this ore type. Creates the list as empty if it did not exist.

Parameters:

id - The ore ID, see getOreID

Returns:

An List containing ItemStacks registered for this ore

containsMatch

private static boolean containsMatch(boolean strict,
                                     ItemStack[] inputs,
                                     @Nonnull
                                     ItemStack... targets)

containsMatch

public static boolean containsMatch(boolean strict,
                                    NonNullList<ItemStack> inputs,
                                    @Nonnull
                                    ItemStack... targets)

itemMatches

public static boolean itemMatches(@Nonnull
                                  ItemStack target,
                                  @Nonnull
                                  ItemStack input,
                                  boolean strict)

registerOre

public static void registerOre(java.lang.String name,
                               Item ore)

registerOre

public static void registerOre(java.lang.String name,
                               Block ore)

registerOre

public static void registerOre(java.lang.String name,
                               @Nonnull
                               ItemStack ore)

registerOreImpl

private static void registerOreImpl(java.lang.String name,
                                    @Nonnull
                                    ItemStack ore)

Registers a ore item into the dictionary. Raises the registerOre function in all registered handlers.

Parameters:

name - The name of the ore

ore - The ore's ItemStack

rebakeMap

public static void rebakeMap()