Package net.rodofire.easierworldcreator.shape.block.instanciator

Class AbstractBlockShape

java.lang.Object
net.rodofire.easierworldcreator.shape.block.instanciator.AbstractBlockShape
Direct Known Subclasses:
AbstractFillableBlockShape, LineGen, SpiralGen
public abstract class AbstractBlockShape extends Object
Class to create custom shapes
The Main purpose of this class is to generate the coordinates based on a shape. The coordinates are organized depending on a Map<ChunkPos, LongOpenHashSet>.

It emply some things:

  • The coordinates are divided in chunk
  • It uses LongOpenHashSet for several reasons.
    • First, We use a set to avoid doing unnecessary calculations on the shape. It ensures that no duplicate is present.
    • Second, it compresses the BlockPos: The BlockPos are saved under long using LongPosHelper. It saves some memory since that we save four bytes of data for each BlockPos, and there should not have overhead since that we use primitive data type.
    • Third, since that we use primitive data types and that they take less memory, coordinate generation, accession or deletion is much faster than using a Set<BlockPos>. Encoding and decoding blockPos and then adding it into LongOpenHashSetis extremely faster compared to only adding a BlockPos. ~60- 70% facter.

Dividing Coordinates into Chunk has some advantages :

  • Field Details

    • centerPos

      protected long centerPos

    • centerX

      protected int centerX
      precomputed ints for slightly higher performance

    • centerY

      protected int centerY

    • centerZ

      protected int centerZ

    • rotator

      protected Rotator rotator

    • chunkMap

      protected Map<net.minecraft.util.math.ChunkPos,it.unimi.dsi.fastutil.longs.LongOpenHashSet> chunkMap

    • covered

      protected it.unimi.dsi.fastutil.longs.LongOpenHashSet covered

    • lastChunkX

      protected int lastChunkX

    • lastChunkZ

      protected int lastChunkZ

  • Constructor Details

    • AbstractBlockShape

      public AbstractBlockShape(@NotNull @NotNull net.minecraft.util.math.BlockPos centerPos)
      init the Shape
      Parameters:
      centerPos - the center of the spiral

    • AbstractBlockShape

      public AbstractBlockShape(net.minecraft.util.math.BlockPos centerPos, Rotator rotator)
      init the shape
      Parameters:
      centerPos - the center BlockPos
      rotator - the rotator uses to rotate the shape

  • Method Details

    • setRotator

      public void setRotator(Rotator rotator)

    • getShapeCoordinates

      public abstract Map<net.minecraft.util.math.ChunkPos,it.unimi.dsi.fastutil.longs.LongOpenHashSet> getShapeCoordinates()
      method to get the coordinates that will be placed later
      Returns:
      a map of ChunkPos of blockPos for every shape

    • getCoveredChunks

      public abstract it.unimi.dsi.fastutil.longs.LongOpenHashSet getCoveredChunks()
      Method to know the chunks that will be covered by the shape. This avoids generating all the structure, enhancing performance
      Returns:
      a set of chunkPos. For performance reasons, we use long instead of ChunkPos.

      To convert the long into a ChunkPos, use the long in a constructor.

    • modifyChunkMap

      protected void modifyChunkMap(long pos)
      Method to add a pos to the map. We use MutableObject to avoid using too much Map.get(Object), enhancing performance
      Parameters:
      pos - the compressed BlockPos that will be added

    • shouldAddChunk

      protected void shouldAddChunk(int x, int z)

    • shouldAddChunkPrecomputedX

      protected void shouldAddChunkPrecomputedX(int z, boolean different, int chunkX)