public interface IStructureElementChain<T> extends IStructureElement<T>
IStructureElement.BlocksToPlace, IStructureElement.PlaceResult| Modifier and Type | Method and Description |
|---|---|
default boolean |
check(T t,
World world,
int x,
int y,
int z) |
IStructureElement<T>[] |
fallbacks() |
default IStructureElement.BlocksToPlace |
getBlocksToPlace(T t,
World world,
int x,
int y,
int z,
ItemStack trigger,
AutoPlaceEnvironment env)
A simplified version of survivalPlaceBlock.
|
default boolean |
placeBlock(T t,
World world,
int x,
int y,
int z,
ItemStack trigger) |
default boolean |
spawnHint(T t,
World world,
int x,
int y,
int z,
ItemStack trigger) |
default IStructureElement.PlaceResult |
survivalPlaceBlock(T t,
World world,
int x,
int y,
int z,
ItemStack trigger,
AutoPlaceEnvironment env)
Try place the block by taking resource from given
IItemSource. |
default IStructureElement.PlaceResult |
survivalPlaceBlock(T t,
World world,
int x,
int y,
int z,
ItemStack trigger,
IItemSource s,
EntityPlayerMP actor,
Consumer<IChatComponent> chatter)
Try place the block by taking resource from given IItemSource.
|
getStepA, getStepB, getStepC, isNavigating, noPlacement, resetA, resetB, resetCIStructureElement<T>[] fallbacks()
default boolean check(T t, World world, int x, int y, int z)
check in interface IStructureElement<T>default boolean spawnHint(T t, World world, int x, int y, int z, ItemStack trigger)
spawnHint in interface IStructureElement<T>default boolean placeBlock(T t, World world, int x, int y, int z, ItemStack trigger)
placeBlock in interface IStructureElement<T>@Nullable default IStructureElement.BlocksToPlace getBlocksToPlace(T t, World world, int x, int y, int z, ItemStack trigger, AutoPlaceEnvironment env)
IStructureElement
BY OVERRIDING THIS TO NULL, YOU ACKNOWLEDGE THAT THE IStructureElement.check(Object, World, int, int, int) OF THIS
CLASS IS SIDE EFFECT FREE AND CAN HAVE ITS CHECK CALLED WITHOUT BREAKING ANYTHING. OTHERWISE OVERRIDE THE
IStructureElement.survivalPlaceBlock(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment) TO PROVIDE A SIDEEFFECT
FREE IStructureElement.PlaceResult.SKIP.
It should be noticed that this filter is only advisory and the actual IStructureElement.survivalPlaceBlock(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment)
or IStructureElement.check(Object, World, int, int, int) are free to reject/accept/place blocks not contained in this list,
e.g. when the element can be placed anywhere in the structure, but no more than 3 overall; when the structure
element cannot know all blocks it will accept at the time of calling; when this is backed by a legacy
IStructureElement that just didn't implement this API.
getBlocksToPlace in interface IStructureElement<T>trigger - trigger itemenv - autoplacing environmentIStructureElement.survivalPlaceBlock(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment)default IStructureElement.PlaceResult survivalPlaceBlock(T t, World world, int x, int y, int z, ItemStack trigger, IItemSource s, EntityPlayerMP actor, Consumer<IChatComponent> chatter)
IStructureElement
You might want to use StructureUtility.survivalPlaceBlock(Block, int, World, int, int, int, IItemSource, net.minecraft.entity.player.EntityPlayer)
or its overloads to implement this.
survivalPlaceBlock in interface IStructureElement<T>trigger - trigger items - drain resources from this placeactor - source of action. for very critical errors you can also just send the error messages here, bypassing
any filter that chatter might have.chatter - send error messages here. Caller will choose an appropriate way to forward it to player if the
other fallbacks also fails.default IStructureElement.PlaceResult survivalPlaceBlock(T t, World world, int x, int y, int z, ItemStack trigger, AutoPlaceEnvironment env)
IStructureElementIItemSource.
You might want to use StructureUtility.survivalPlaceBlock(Block, int, World, int, int, int, IItemSource, net.minecraft.entity.player.EntityPlayer)
or its overloads to implement this.
The default implementation provided will
IStructureElement.BlocksToPlace via IStructureElement.getBlocksToPlace(Object, World, int, int, int, ItemStack, AutoPlaceEnvironment). If not null
IStructureElement.check(Object, World, int, int, int). If this returns true, IStructureElement.PlaceResult.SKIP will be returned without further action.IStructureElement.BlocksToPlace retrieved earlier and passed in IItemSource to determine an item to placeStructureUtility#survivalPlaceBlock(ItemStack, NBTMode, NBTTagCompound, boolean, World, int, int, int, IItemSource, EntityPlayer, Consumer)IStructureElement.survivalPlaceBlock(Object, World, int, int, int, ItemStack, IItemSource, EntityPlayerMP, Consumer) if env.getActor() contains an EntityPlayerMPIStructureElement.PlaceResult.SKIPIStructureElement.check(Object, World, int, int, int) is not side effect free, or is not idempotent.
E.g. the IStructureElement.check(Object, World, int, int, int) will add current coord to a List. As
this method might be invoked at a location that is already accepted, this will cause the machine to have multiple
of this coord in its list.survivalPlaceBlock in interface IStructureElement<T>trigger - trigger itemenv - autoplacing environment