Item (OpenComputers MC1.7.10-1.3.6.169-dev API)

All Known Subinterfaces:

Inventory, Memory, Processor, UpgradeContainer

All Known Implementing Classes:

DriverItem
```
public interface Item
```
Interface for item component drivers.
This driver type is used for components that are items, i.e. that can be inserted into computers and robots. An example for this are internal drives, memory and graphic cards.
When trying to add an item to a computer the list of registered drivers is queried using the drivers' worksWith functions. The first driver that replies positively and whose check against the slot type is successful, i.e. for which the slot matches the slot it should be inserted into, will be used as the component's driver and the component will be added. If no driver is found the item will be rejected and cannot be installed.
Note that it is possible to write one driver that supports as many different items as you wish. I'd recommend writing one per device (type), though, to keep things modular.

Method Summary

Methods
Modifier and Type	Method and Description
`ManagedEnvironment`	`createEnvironment(net.minecraft.item.ItemStack stack, Container container)` Create a new managed environment interfacing the specified item.
`net.minecraft.nbt.NBTTagCompound`	`dataTag(net.minecraft.item.ItemStack stack)` Get the tag compound based on the item stack to use for persisting the environment associated with the specified item stack.
`Slot`	`slot(net.minecraft.item.ItemStack stack)` Deprecated. This will be replaced in 1.4, where slot types will then be referred to by name (using Strings) instead, to make this system more flexible (not requiring an API change for each new slot type, e.g.).
`int`	`tier(net.minecraft.item.ItemStack stack)` The tier of the specified item this driver supports.
`boolean`	`worksWith(net.minecraft.item.ItemStack stack)` Used to determine the item types this driver handles.

- Method Detail
  - worksWith
```
boolean worksWith(net.minecraft.item.ItemStack stack)
```
    Used to determine the item types this driver handles.
    This is used to determine which driver to use for an item when it should be installed in a computer. Note that the return value should not change over time; if it does, though, an already installed component will not be ejected, since this value is only checked when adding components.
    
    Parameters:
    stack - the item to check.
    
    Returns:
    true if the item is supported; false otherwise.
  - createEnvironment
```
ManagedEnvironment createEnvironment(net.minecraft.item.ItemStack stack,
                                   Container container)
```
    Create a new managed environment interfacing the specified item.
    This is used to connect the component to the component network when it is added to a computer, for example. The only kind of component that does not need to be connected to the component network is probably memory, and there's a built-in driver for that. You may still opt to not implement this - i.e. it is safe to return null here.
    Keep in mind that the container's location may change if the owner is a robot. This is important if you cache the location somewhere. For example, the wireless network card checks in a robot movement event handler for position changes to update the index structure used for receiver look-up.
    This is expected to return a new instance each time it is called. The created instance's life cycle is managed by the container that caused its creation.
    
    Parameters:
    stack - the item stack for which to get the environment.
    container - the container the environment will be managed by.
    
    Returns:
    the environment for that item.
  - slot
```
@Deprecated
Slot slot(net.minecraft.item.ItemStack stack)
```
    Deprecated. This will be replaced in 1.4, where slot types will then be referred to by name (using Strings) instead, to make this system more flexible (not requiring an API change for each new slot type, e.g.).
    
    The slot type of the specified item this driver supports.
    This is used to determine into which slot of a computer the components this driver supports may go. This will only be called if a previous call to worksWith(net.minecraft.item.ItemStack) with the same stack returned true.
    
    Parameters:
    stack - the item stack to get the slot type for.
    
    Returns:
    the slot type of the specified item.
  - tier
```
int tier(net.minecraft.item.ItemStack stack)
```
    The tier of the specified item this driver supports.
    This is used to determine into which slot of a computer the components this driver supports may go. This will only be called if a previous call to worksWith(net.minecraft.item.ItemStack) with the same stack returned true.
    Important: tiers are zero-indexed.
    
    Parameters:
    stack - the item stack to get the tier for.
    
    Returns:
    the tier of the specified item.
  - dataTag
```
net.minecraft.nbt.NBTTagCompound dataTag(net.minecraft.item.ItemStack stack)
```
    Get the tag compound based on the item stack to use for persisting the environment associated with the specified item stack.
    This is only used if the item has an environment. This must always be a child tag of the item stack's own tag compound, it will not be saved otherwise. Use this in the unlikely case that the default name collides with something. The built-in components use a child tag-compound with the name oc:data, which will also be used if this returns null.
    This tag will be passed to the environment's save and load methods when appropriate (world save / load and when removed from their hosting inventory).
    
    Parameters:
    stack - the item to get the child tag from.
    
    Returns:
    the tag to use for saving and loading, or null to use the default tag oc:data.

Interface Item

Method Summary

Method Detail

worksWith

createEnvironment

slot

tier

dataTag