buildcraft.api.blueprints

Class Schematic

java.lang.Object

buildcraft.api.blueprints.Schematic

Direct Known Subclasses:

SchematicBlock, SchematicMask

public class Schematic
extends java.lang.Object

This class allow to specify specific behavior for blocks stored in blueprints: - what items needs to be used to create that block - how the block has to be built on the world - how to rotate the block - what extra data to store / load in the blueprint Default implementations of this can be seen in the package buildcraft.api.schematics. The class SchematicUtils provide some additional utilities. Blueprints perform "id translation" in case the block ids between a blueprint and the world installation are different. Mapping is done through the builder context. At blueprint load time, BuildCraft will check that each block id of the blueprint corresponds to the block id in the installation. If not, it will perform a search through the block list, and upon matching signature, it will translate all blocks ids of the blueprint to the installation ones. If no such block id is found, BuildCraft will assume that the block is not installed and will not load the blueprint.

Constructor Summary

Constructors

Constructor and Description
Schematic()

Method Summary

Methods

Modifier and Type	Method and Description
void	addRequirements(IBuilderContext context, java.util.LinkedList<net.minecraft.item.ItemStack> requirements) Returns the requirements needed to build this block.
java.util.LinkedList<net.minecraft.item.ItemStack>	getRequirements(IBuilderContext context)
boolean	ignoreBuilding() Return true if the block should not be placed to the world.
boolean	isValid(IBuilderContext context, int x, int y, int z) Return true if the block on the world correspond to the block stored in the blueprint at the location given by the slot.
void	postProcessing(IBuilderContext context, int x, int y, int z) Called on a block when the blueprint has finished to place all the blocks.
void	readFromNBT(net.minecraft.nbt.NBTTagCompound nbt, MappingRegistry registry)
void	readFromWorld(IBuilderContext context, int x, int y, int z) Initializes a slot from the blueprint according to an objet placed on {x, y, z} on the world.
void	rotateLeft(IBuilderContext context) Perform a 90 degree rotation to the slot.
net.minecraft.item.ItemStack	useItem(IBuilderContext context, net.minecraft.item.ItemStack req, net.minecraft.item.ItemStack stack) This is called each time an item matches a reqquirement, that is: (req id == stack id) for damageable items (req id == stack id && req dmg == stack dmg) for other items by default, it will increase damage of damageable items by the amount of damage of the requirement, and remove the intended amount of non damageable item.
void	writeToNBT(net.minecraft.nbt.NBTTagCompound nbt, MappingRegistry registry)
void	writeToWorld(IBuilderContext context, int x, int y, int z) Places the block in the world, at the location specified in the slot.

Methods inherited from class java.lang.Object

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

Constructor Detail

Schematic

public Schematic()

Method Detail

getRequirements

public final java.util.LinkedList<net.minecraft.item.ItemStack> getRequirements(IBuilderContext context)

addRequirements

public void addRequirements(IBuilderContext context,
                   java.util.LinkedList<net.minecraft.item.ItemStack> requirements)

Returns the requirements needed to build this block. When the requirements are met, they will be removed all at once from the builder, before calling buildBlock.

useItem

public net.minecraft.item.ItemStack useItem(IBuilderContext context,
                                   net.minecraft.item.ItemStack req,
                                   net.minecraft.item.ItemStack stack)

This is called each time an item matches a reqquirement, that is: (req id == stack id) for damageable items (req id == stack id && req dmg == stack dmg) for other items by default, it will increase damage of damageable items by the amount of damage of the requirement, and remove the intended amount of non damageable item. Client may override this behavior for default items. Note that this subprogram may be called twice with the same parameters, once with a copy of requirements and stack to check if the entire requirements can be fullfilled, and once with the real inventory. Implementer is responsible for updating req (with the remaining requirements if any) and stack (after usage) returns: what was used (similer to req, but created from stack, so that any NBT based differences are drawn from the correct source)

isValid

public boolean isValid(IBuilderContext context,
              int x,
              int y,
              int z)

Return true if the block on the world correspond to the block stored in the blueprint at the location given by the slot. By default, this subprogram is permissive and doesn't take into account metadata.

rotateLeft

public void rotateLeft(IBuilderContext context)

Perform a 90 degree rotation to the slot.

writeToWorld

public void writeToWorld(IBuilderContext context,
                int x,
                int y,
                int z)

Places the block in the world, at the location specified in the slot.

ignoreBuilding

public boolean ignoreBuilding()

Return true if the block should not be placed to the world. Requirements will not be asked on such a block, and building will not be called.

readFromWorld

public void readFromWorld(IBuilderContext context,
                 int x,
                 int y,
                 int z)

Initializes a slot from the blueprint according to an objet placed on {x, y, z} on the world. This typically means adding entries in slot.cpt. Note that "id" and "meta" will be set automatically, corresponding to the block id and meta. By default, if the block is a BlockContainer, tile information will be to save / load the block.

postProcessing

public void postProcessing(IBuilderContext context,
                  int x,
                  int y,
                  int z)

Called on a block when the blueprint has finished to place all the blocks. This may be useful to adjust variable depending on surrounding blocks that may not be there already at initial building.

writeToNBT

public void writeToNBT(net.minecraft.nbt.NBTTagCompound nbt,
              MappingRegistry registry)

readFromNBT

public void readFromNBT(net.minecraft.nbt.NBTTagCompound nbt,
               MappingRegistry registry)