Package ke.ric.renderer.api

Interface SceneBuilder

public interface SceneBuilder
Builds a complete caller-supplied engine-neutral scene owned by one RendererClient. Missing world, chunk, block, entity, structure, or resolved visual evidence is rejected rather than guessed by the provider.

  • Method Summary

    Modifier and Type
    Method
    Description
    SceneBuilder
    block(int x, int y, int z, String namespacedBlockState, int blockLight, int skyLight, String biome)
    Adds one world-block sample with namespaced state/biome keys and block/sky light levels in 0..15.
    Scene
    build()
    Returns an immutable scene or throws a typed failure such as MISSING_CHUNK; the provider never invents absent evidence.
    SceneBuilder
    camera(double x, double y, double z, double yawRadians, double pitchRadians, double fovRadians)
    Sets the camera in world-block coordinates and orientation/field of view in radians.
    default SceneBuilder
    camera(SceneCamera camera)
    Sets a camera including local roll; older providers accept only zero roll.
    SceneBuilder
    chunkSection(int sectionX, int sectionY, int sectionZ, boolean present)
    Records legacy section presence at section coordinates (block coordinates divided by 16): false means missing; true permits empty or populated evidence.
    default SceneBuilder
    chunkSection(int sectionX, int sectionY, int sectionZ, ChunkSectionState state)
    Records MISSING, known EMPTY, or PALETTED evidence for a section; known air must not be recorded as missing.
    SceneBuilder
    dimensions(int width, int height)
    Sets positive output dimensions in pixels; these must match the submitted RenderSettings.
    SceneBuilder
    entity(SceneEntity entity)
    Adds resolved immutable entity visuals and their stable nonzero object ID; metadata alone cannot supply missing visuals.
    SceneBuilder
    requireChunk(int chunkX, int chunkZ)
    Marks chunk coordinates (block coordinates divided by 16) as required; every world-height section needs explicit evidence.
    SceneBuilder
    structure(SceneStructure structure)
    Adds one structure key and bounds.
    SceneBuilder
    weather(boolean raining, boolean snowy)
    Sets explicit rain and snow evidence; this does not query or mutate any live world.
    SceneBuilder
    world(String namespacedEnvironment, String worldName, long time, int minHeight, int maxHeight)
    Sets world/environment names, time in Minecraft ticks, and minimum/maximum build heights in blocks.

  • Method Details

    • dimensions

      SceneBuilder dimensions(int width, int height)
      Sets positive output dimensions in pixels; these must match the submitted RenderSettings.

    • camera

      SceneBuilder camera(double x, double y, double z, double yawRadians, double pitchRadians, double fovRadians)
      Sets the camera in world-block coordinates and orientation/field of view in radians.
      Parameters:
      x - world X coordinate in blocks
      y - world Y coordinate in blocks
      z - world Z coordinate in blocks
      yawRadians - horizontal orientation, in radians (not Bukkit degrees)
      pitchRadians - vertical orientation, in radians (not Bukkit degrees)
      fovRadians - camera field of view, in radians
      Returns:
      this builder

    • camera

      default SceneBuilder camera(SceneCamera camera)
      Sets a camera including local roll; older providers accept only zero roll.

    • world

      SceneBuilder world(String namespacedEnvironment, String worldName, long time, int minHeight, int maxHeight)
      Sets world/environment names, time in Minecraft ticks, and minimum/maximum build heights in blocks.

    • weather

      SceneBuilder weather(boolean raining, boolean snowy)
      Sets explicit rain and snow evidence; this does not query or mutate any live world.

    • block

      SceneBuilder block(int x, int y, int z, String namespacedBlockState, int blockLight, int skyLight, String biome)
      Adds one world-block sample with namespaced state/biome keys and block/sky light levels in 0..15.

    • entity

      SceneBuilder entity(SceneEntity entity)
      Adds resolved immutable entity visuals and their stable nonzero object ID; metadata alone cannot supply missing visuals.

    • structure

      SceneBuilder structure(SceneStructure structure)
      Adds one structure key and bounds.

    • chunkSection

      SceneBuilder chunkSection(int sectionX, int sectionY, int sectionZ, boolean present)
      Records legacy section presence at section coordinates (block coordinates divided by 16): false means missing; true permits empty or populated evidence. Use the state overload to distinguish known empty from paletted sections.

    • chunkSection

      default SceneBuilder chunkSection(int sectionX, int sectionY, int sectionZ, ChunkSectionState state)
      Records MISSING, known EMPTY, or PALETTED evidence for a section; known air must not be recorded as missing.

    • requireChunk

      SceneBuilder requireChunk(int chunkX, int chunkZ)
      Marks chunk coordinates (block coordinates divided by 16) as required; every world-height section needs explicit evidence.

    • build

      Scene build()
      Returns an immutable scene or throws a typed failure such as MISSING_CHUNK; the provider never invents absent evidence.