Package net.minecraftforge.common.capabilities

Class Capability<T>

java.lang.Object

net.minecraftforge.common.capabilities.Capability<T>

public class Capability<T>
extends Object

This is the core holder object Capabilities. Each capability will have ONE instance of this class, and it will the the one passed into the ICapabilityProvider functions. The CapabilityManager is in charge of creating this class.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Capability.IStorage<T>

Field Summary

Fields

Modifier and Type	Field	Description
private final Callable<? extends T>	factory
private final String	name
private final Capability.IStorage<T>	storage

Constructor Summary

Constructors

Constructor	Description
Capability(String name, Capability.IStorage<T> storage, Callable<? extends T> factory)

Method Summary

Modifier and Type	Method	Description
T	getDefaultInstance()	A NEW instance of the default implementation.
String	getName()
Capability.IStorage<T>	getStorage()
<R> LazyOptional<R>	orEmpty(Capability<R> toCheck, LazyOptional<T> inst)
void	readNBT(T instance, Direction side, INBT nbt)	Quick access to the IStorage's readNBT.
INBT	writeNBT(T instance, Direction side)	Quick access to the IStorage's writeNBT.

Methods inherited from class java.lang.Object

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

Field Details

name

private final String name

storage

private final Capability.IStorage<T> storage

factory

private final Callable<? extends T> factory

Constructor Details

Capability

Capability(String name,
 Capability.IStorage<T> storage,
 Callable<? extends T> factory)

Method Details

getName

public String getName()

Returns:

The unique name of this capability, typically this is the fully qualified class name for the target interface.

getStorage

public Capability.IStorage<T> getStorage()

Returns:

An instance of the default storage handler. You can safely use this store your default implementation in NBT.

readNBT

public void readNBT(T instance,
 Direction side,
 INBT nbt)

Quick access to the IStorage's readNBT. See Capability.IStorage.readNBT(Capability, Object, EnumFacing, NBTBase) for documentation.

writeNBT

@Nullable
public INBT writeNBT(T instance,
 Direction side)

Quick access to the IStorage's writeNBT. See Capability.IStorage.writeNBT(Capability, Object, EnumFacing) for documentation.

getDefaultInstance

@Nullable
public T getDefaultInstance()

A NEW instance of the default implementation. If it important to note that if you want to use the default storage you may be required to use this exact implementation. Refer to the owning API of the Capability in question.

Returns:

A NEW instance of the default implementation.

orEmpty

@Nonnull
public <R> LazyOptional<R> orEmpty(Capability<R> toCheck,
 LazyOptional<T> inst)