li.cil.oc.api

Class Items

java.lang.Object

li.cil.oc.api.Items

public final class Items
extends java.lang.Object

Access to item definitions for all blocks and items provided by OpenComputers.

Method Summary

Modifier and Type	Method and Description
static ItemInfo	get(net.minecraft.item.ItemStack stack) Get a descriptor object for the block or item represented by the specified item stack.
static ItemInfo	get(java.lang.String name) Get a descriptor object for the block or item with the specified name.
static net.minecraft.item.ItemStack	registerEEPROM(java.lang.String name, byte[] code, byte[] data, boolean readonly) Register a single custom EEPROM.
static net.minecraft.item.ItemStack	registerFloppy(java.lang.String name, int color, java.util.concurrent.Callable<FileSystem> factory) Register a single loot floppy disk.

Methods inherited from class java.lang.Object

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

Method Detail

get

public static ItemInfo get(java.lang.String name)

Get a descriptor object for the block or item with the specified name.

The names are the same as the ones used in the recipe files. An info object can be used to retrieve both the block and item instance of the item, if available. It can also be used to create a new item stack of the item.

Note that these methods should not be called in the pre-init phase, since the API.items may not have been initialized at that time. Only start calling these methods in the init phase or later.

Parameters:

name - the name of the item to get the descriptor for.

Returns:

the descriptor for the item with the specified name, or null if there is no such item.

get

public static ItemInfo get(net.minecraft.item.ItemStack stack)

Get a descriptor object for the block or item represented by the specified item stack.

Parameters:

stack - the stack to get the descriptor for.

Returns:

the descriptor for the specified item stack, or null if the stack is not a valid OpenComputers item or block.

registerFloppy

public static net.minecraft.item.ItemStack registerFloppy(java.lang.String name,
                                                          int color,
                                                          java.util.concurrent.Callable<FileSystem> factory)

Register a single loot floppy disk.

The disk will be listed in the creative tab of OpenComputers.

The specified factory callable will be used to generate a new file system when the loot disk is used as a component. The specified name will be used as the label for the loot disk, as well as the identifier to select the corresponding factory method, so choose wisely.

To use some directory in your mod JAR as the directory provided by the loot disk, use FileSystem.fromClass(java.lang.Class<?>, java.lang.String, java.lang.String) in your callable.

Parameters:

name - the label and identifier to use for the loot disk.

color - the color of the disk, as a Minecraft color (so 0-15, with 0 being black, 1 red and so on).

factory - the callable to call for creating file system instances.

Returns:

an item stack representing the registered loot disk, to allow adding a recipe for your loot disk, for example.

registerEEPROM

public static net.minecraft.item.ItemStack registerEEPROM(java.lang.String name,
                                                          byte[] code,
                                                          byte[] data,
                                                          boolean readonly)

Register a single custom EEPROM.

The EEPROM will be listed in the creative tab of OpenComputers.

The EEPROM will be initialized with the specified code and data byte arrays. For script code (e.g. a Lua script) use String.getBytes("UTF-8"). You can omit any of the arguments by passing null.

Parameters:

name - the label of the EEPROM.

code - the code section of the EEPROM.

data - the data section of the EEPROM.

readonly - whether the code section is read-only.

Returns:

an item stack representing the registered EEPROM, to allow adding a recipe for your custom BIOS, for example.