[stellarfeline]

What this adds

Entities, each transcribed from its 1.21.11 client model class (the layer method named in the model's source) and posed as its setupAnim poses it at rest at tick 0:

• the happy ghast, its ghastling (its own baby model, BABY_TRANSFORMER 0.2375) and its harness (the body slot's equipment asset on HappyGhastHarnessModel; the body squeezes to 0.9375 under it and the goggles are up unless it is ridden);
• sheep wool: the dyed undercoat and the fleece (Color, Sheared, jeb_), and glowing eyes on spiders, cave spiders and endermen, through one new mechanism, model layers;
• boats and chest boats of all nine woods, the bamboo raft and chest raft (paddles at rowing time 0), and the minecart with its six kinds and their display blocks (DisplayState/DisplayOffset or the kind's default; a chest through the chest model);
• the warden with its bioluminescent layer;
• the firework rocket (its FireworksItem, turned to the camera as FireworkEntityRenderer turns it);
• the ravager, allay, parrot (five variants), squid, glow squid, dolphin, turtle (with its baby model), axolotl (five variants), camel (saddle, 0.45 baby) and wither. The bat is not drawn: its pose is a keyframe animation.

Banners as blocks (standing and wall, with patterns) were already drawn; they are unchanged.

entity_models.json gains layers, baby, parts_from, placement (living, boat, minecart, squid), block_light and numbered texture_variants.names. The lineup has 96 models.

HQ mode's water plane, ported from Chunky's water world: HqOptions::water_plane / --water-plane [SEA_LEVEL] draws an unbounded sea outside the loaded chunks, level with the loaded sea, so a level frame over an ocean shows sea to the horizon instead of the loaded sea's edge and a band of sky. Off by default, as in Chunky. What the game draws there and what is ported: docs/research/sea-horizon.md, with before and after renders.

How the models were read

The geometry and the rest poses are read from the official client jar's classes as javap (the local JDK) prints them, through Mojang's mappings, by a small interpreter that runs the layer method and setupAnim. It reproduces the bundled pig, sheep, iron golem, llama (without the chests the bundle leaves out) and ghast (its seeded tentacle lengths included) part for part, and the warden's rest pose agrees with a reading of its bytecode by hand. Nothing of the jar is shipped; textures are read at run time as before.

Breaking changes

PartPose has a scale, EntityLight a block_light, HqOptions a water_plane, and ModelDef, LayerDef, TextureVariants new fields: a struct literal of any of them no longer compiles. Params is 27 vec4s (432 bytes).

Checks

• cargo fmt --all --check, cargo clippy --workspace --all-targets -- -D warnings, cargo doc --no-deps with -Dwarnings, cargo publish --dry-run --workspace: clean (toolchain 1.97.1).
• cargo test --workspace --no-fail-fast with the client jar and the Unifont: 155 passed, 0 failed, 0 skipped for the jar or a GPU (Apple M2 Pro, Metal).
• New: the entity gallery in quick and HQ mode on the CPU (every case counted and drawn at its spot, layer and variant colours, a woolly sheep larger than a sheared one); the glow at midnight; the water plane's edge (largest row step 12.45 without, 2.51 with); the gallery and the ocean in the CPU/Metal HQ parity test (0.000% of pixels off); unit tests of the happy ghast's size, the boats' and minecart's heading, the sheep's layer colours and the shared parts. Each colour and area check was perturbed and seen to red.
• scripts/build-ptx.sh: 21633 lines, 0 f64 instructions, no calls but panics.

🤖 Generated with Claude Code