Interface OutputExtent

All Known Subinterfaces:
Clipboard, Extent, IChunk, IChunkExtent<T>, IChunkSet, IQueueChunk<T>, IQueueExtent<T>, ReorderingExtent, SimpleWorld, World
All Known Implementing Classes:
AbstractBufferingExtent, AbstractDelegateExtent, AbstractExtentFilterBlock, AbstractFilterBlock, AbstractSingleFilterBlock, AbstractWorld, ArrayFilterBlock, BiomeQuirkExtent, BitSetBlocks, BlockArrayClipboard, BlockBagExtent, BlockChangeLimiter, BlockQuirkExtent, BlockTransformExtent, BlockTranslateExtent, ChangeSetExtent, CharFilterBlock, CharSetBlocks, ChunkBatchingExtent, ChunkFilterBlock, ChunkHolder, ChunkLoadingExtent, CPUOptimizedClipboard, DataValidatorExtent, DisallowedBlocksExtent, DiskOptimizedClipboard, EditSession, EmptyClipboard, ExtentBatchProcessorHolder, ExtentBuffer, ExtentFilterBlock, ExtentHeightCacher, FaweRegionExtent, FilterBlock, ForgetfulExtentBuffer, FuzzyRegionSelector, HeightBoundExtent, HistoryExtent, LastAccessExtentCache, LimitExtent, Linear3DTransform, LinearClipboard, LinearTransform, MaskingExtent, MemoryCheckingExtent, MemoryOptimizedClipboard, MultiRegionExtent, MultiStageReorder, MultiTransform, NullChunk, NullExtent, NullExtent, NullWorld, OffsetTransform, ParallelQueueExtent, PassthroughExtent, PatternTransform, PositionTransformExtent, ProcessedWEExtent, RandomOffsetTransform, RandomTransform, ReadOnlyClipboard, RequestExtent, ResettableExtent, ScaleTransform, SelectTransform, SideEffectExtent, SimpleClipboard, SingleFilterBlock, SingleRegionExtent, SingleThreadQueueExtent, SlowExtent, SourceMaskExtent, StripNBTExtent, SupplyingExtent, SurvivalModeExtent, TemporalExtent, ThreadUnsafeCharBlocks, TracingExtent, TransformExtent, VectorizedCharFilterBlock, WatchdogTickingExtent, WorldCopyClipboard, WorldWrapper

public interface OutputExtent
Accepts block and entity changes.
  • Method Details

    • setBlock

      @Deprecated default <T extends BlockStateHolder<T>> boolean setBlock(BlockVector3 position, T block) throws WorldEditException
      Deprecated.
      It is recommended that you use setBlock(int, int, int, BlockStateHolder) in FAWE
      Change the block at the given location to the given block. The operation may not tie the given BlockStateHolder to the world, so future changes to the BlockStateHolder do not affect the world until this method is called again.

      The return value of this method indicates whether the change was probably successful. It may not be successful if, for example, the location is out of the bounds of the extent. It may be unsuccessful if the block passed is the same as the one in the world. However, the return value is only an estimation and it may be incorrect, but it could be used to count, for example, the approximate number of changes.

      Parameters:
      position - position of the block
      block - block to set
      Returns:
      true if the block was successfully set (return value may not be accurate)
      Throws:
      WorldEditException - thrown on an error
    • setBlock

      default <B extends BlockStateHolder<B>> boolean setBlock(int x, int y, int z, B block) throws WorldEditException
      Throws:
      WorldEditException
    • setTile

      @Deprecated(forRemoval=true, since="2.11.2") default boolean setTile(int x, int y, int z, CompoundTag tile) throws WorldEditException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Throws:
      WorldEditException
    • tile

      boolean tile(int x, int y, int z, FaweCompoundTag tile) throws WorldEditException
      Sets a tile/block entity at the given location.
      Parameters:
      x - the x position
      y - the y position
      z - the z position
      tile - the tile/block entity to set
      Returns:
      true if the tile/block entity was placed
      Throws:
      WorldEditException
      Since:
      2.11.2
    • fullySupports3DBiomes

      default boolean fullySupports3DBiomes()
      Check if this extent fully supports 3D biomes.

      If false, the extent only visually reads biomes from y = 0. The biomes will still be set in 3D, but the client will only see the one at y = 0. It is up to the caller to determine if they want to set that biome instead, or simply warn the actor.

      Returns:
      if the extent fully supports 3D biomes
    • setBiome

      @Deprecated default boolean setBiome(BlockVector2 position, BiomeType biome)
      Deprecated.
      Biomes in Minecraft are 3D now, use setBiome(BlockVector3, BiomeType)
      Set the biome.
      Parameters:
      position - the (x, z) location to set the biome at
      biome - the biome to set to
      Returns:
      true if the biome was successfully set (return value may not be accurate)
    • setBiome

      @NonAbstractForCompatibility(delegateName="setBiome", delegateParams={int.class,int.class,int.class,BiomeType.class}) default boolean setBiome(int x, int y, int z, BiomeType biome)
    • setBiome

      Set the biome.

      As implementation varies per Minecraft version, this may set more than this position's biome. On versions prior to 1.15, this will set the entire column. On later versions it will set the 4x4x4 cube.

      Parameters:
      position - the (x, y, z) location to set the biome at
      biome - the biome to set to
      Returns:
      true if the biome was successfully set (return value may not be accurate)
    • setBlockLight

      default void setBlockLight(BlockVector3 position, int value)
      Set the light value.
      Parameters:
      position - position of the block
      value - light level to set
    • setBlockLight

      default void setBlockLight(int x, int y, int z, int value)
    • setSkyLight

      default void setSkyLight(BlockVector3 position, int value)
      Set the sky light value.
      Parameters:
      position - position of the block
      value - light level to set
    • setSkyLight

      default void setSkyLight(int x, int y, int z, int value)
    • setHeightMap

      default void setHeightMap(HeightMapType type, int[] heightMap)
    • commit

      @Nullable Operation commit()
      Return an Operation that should be called to tie up loose ends (such as to commit changes in a buffer).
      Returns:
      an operation or null if there is none to execute