public class SphereGen extends AbstractFillableBlockShape
Class to generate sphere related 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 :

  • Constructor Details

    • SphereGen

      public SphereGen(@NotNull @NotNull net.minecraft.util.math.BlockPos pos, Rotator rotator, int radiusX, int radiusY, int radiusZ, SphereGen.SphereType halfSphere)
      init the Sphere Shape
      Parameters:
      pos - the center of the spiral
      radiusX - the radius on the x-axis
      radiusY - the radius on the y-axis
      radiusZ - the radius on the z-axis
      halfSphere - determines if the sphere is half or not
    • SphereGen

      public SphereGen(@NotNull @NotNull net.minecraft.util.math.BlockPos pos, int radius)
      init the shape generation
      Parameters:
      pos - the pos of the structure center
      radius - the radius of the sphere
  • Method Details

    • getHalfSphereDirection

      public net.minecraft.util.math.Direction getHalfSphereDirection()
      Gets the direction of the half-sphere. * * @return The direction of the half-sphere.
    • setHalfSphereDirection

      public void setHalfSphereDirection(net.minecraft.util.math.Direction direction)
      Sets the direction of the half-sphere. * * @param direction The direction to set.
    • isHalfSphere

      public SphereGen.SphereType isHalfSphere()
      Checks if it is a half sphere. * * @return The type of the half-sphere.
    • setHalfSphere

      public void setHalfSphere(SphereGen.SphereType halfSphere)
      Sets the half-sphere type. * * @param halfSphere The half-sphere type to set.
    • getRadiusX

      public int getRadiusX()
      Gets the X radius of the sphere. * * @return The X radius.
    • setRadiusX

      public void setRadiusX(int radiusX)
      Sets the X radius of the sphere. * * @param radiusX The X radius to set.
    • getRadiusY

      public int getRadiusY()
      Gets the Y radius of the sphere. * * @return The Y radius.
    • setRadiusY

      public void setRadiusY(int radiusY)
      Sets the Y radius of the sphere. * * @param radiusY The Y radius to set.
    • getRadiusZ

      public int getRadiusZ()
      Gets the Z radius of the sphere. * * @return The Z radius.
    • setRadiusZ

      public void setRadiusZ(int radiusZ)
      Sets the Z radius of the sphere. * * @param radiusZ The Z radius to set.
    • getShapeCoordinates

      public Map<net.minecraft.util.math.ChunkPos,it.unimi.dsi.fastutil.longs.LongOpenHashSet> getShapeCoordinates()
      Description copied from class: AbstractBlockShape
      method to get the coordinates that will be placed later
      Specified by:
      getShapeCoordinates in class AbstractBlockShape
      Returns:
      a map of ChunkPos of blockPos for every shape
    • generateHalfEmptyEllipsoid

      public void generateHalfEmptyEllipsoid()
    • generateEmptyEllipsoid

      public void generateEmptyEllipsoid()
    • generateEmptyEllipsoid

      public void generateEmptyEllipsoid(int minLarge, int maxLarge, int minHeight, int maxHeight)
    • generateHalfFullEllipsoid

      public void generateHalfFullEllipsoid()
    • generateFullEllipsoid

      public void generateFullEllipsoid()
    • generateFullEllipsoid

      public void generateFullEllipsoid(int minX, int maxX, int minY, int maxY, int minZ, int maxZ)
      allow you to generate a full ellipsoid
      Parameters:
      minX - the start of the circle on the x-axis
      maxX - the end of the circle on the x-axis
      minY - the start of the circle on the y-axis
      maxY - the end of the circle on the y-axis
      minZ - the start of the circle on the z-axis
      maxZ - the end of the circle on the z-axis