Class SceneEntity.Builder

java.lang.Object
ke.ric.renderer.api.SceneEntity.Builder
Enclosing class:
SceneEntity

public static final class SceneEntity.Builder extends Object
Mutable builder for immutable entity evidence; do not share it concurrently. Defaults to origin, zero yaw, unit bounds, living/adult, cube size 1, air equipment and a UUID-derived nonzero ID. Callers still supply complete resolved targets when the scene requires entity visuals.
  • Method Details

    • position

      public SceneEntity.Builder position(double x, double y, double z)
      Sets entity position in world blocks.
    • yaw

      public SceneEntity.Builder yaw(float yawDegrees)
      Sets horizontal orientation in degrees, not radians.
    • transform

      public SceneEntity.Builder transform(ResolvedTransform transform)
      Copies position and degree-based yaw from this transform.
    • bounds

      public SceneEntity.Builder bounds(double minX, double minY, double minZ, double maxX, double maxY, double maxZ)
      Sets finite world-space minimum/maximum bounds, in blocks.
    • displayName

      public SceneEntity.Builder displayName(String displayName)
      Sets the optional display name used with a primary resolved label.
    • living

      public SceneEntity.Builder living(boolean living)
      Sets the immutable classification used by living-only scene selection.
    • baby

      public SceneEntity.Builder baby(boolean baby)
      Sets baby/adult metadata.
    • variant

      public SceneEntity.Builder variant(String variant)
      Sets optional variant metadata; does not resolve missing visual evidence.
    • cubeSize

      public SceneEntity.Builder cubeSize(int cubeSize)
      Sets a positive cube-entity size; default 1.
    • model

      public SceneEntity.Builder model(String model)
      Sets model metadata; complete resolved visual targets remain the caller's responsibility.
    • skin

      public SceneEntity.Builder skin(String skin)
      Sets optional skin metadata without performing a network lookup.
    • material

      public SceneEntity.Builder material(String material)
      Sets optional material metadata.
    • pose

      public SceneEntity.Builder pose(String pose)
      Sets optional pose metadata.
    • containedBlock

      public SceneEntity.Builder containedBlock(String containedBlock)
      Sets optional contained-block state metadata.
    • objectId

      public SceneEntity.Builder objectId(int objectId)
      Sets a nonzero stable output object ID, replacing the UUID-derived default.
    • resolvedTarget

      public SceneEntity.Builder resolvedTarget(ResolvedRenderTarget target)
      Selects one legacy target, placed at this entity's transform/bounds when built; clears any target list.
    • resolvedTargets

      public SceneEntity.Builder resolvedTargets(List<ResolvedRenderTarget> targets)
      Copies independently placed targets, replacing the legacy single target.
    • label

      public SceneEntity.Builder label(ResolvedLabel label)
      Sets optional primary label evidence; build requires a display name and at least one target.
    • equipment

      public SceneEntity.Builder equipment(String mainHand, String offHand, String helmet, String chestplate, String leggings, String boots)
      Sets namespaced equipment item keys in main-hand, off-hand, helmet, chestplate, leggings, boots order.
    • build

      public SceneEntity build()
      Validates and builds immutable evidence without reading any live Bukkit object.