Deep Field
README.md
The Sunlit Fringe and The Twilight Reach — six animals
The first six things that rise to your lamp. Three live in the top forty metres, where you can still half-remember what you are looking at; three live below that, in the reach where the colour drains out of the water and the only bright thing left is a fish's own flank.
They are built to be told apart in the dark. Each one has a shape you could draw from memory, a way of moving that none of its neighbours shares, and one thing it does when you turn the lamp up.
| Animal | Where | The shape | The swim | Under the lamp | |
|---|---|---|---|---|---|
| 1 | Moon Jelly Aurelia aurita | 3–42 m | A flat bell, twice as wide as tall, four pale horseshoes on top | Pulses and gets nowhere | Ignores you completely |
| 2 | Lanternfish Myctophum punctatum | 6–60 m | Deep little body, an eye far too big, a deeply forked tail | Hangs dead still, then darts a body-length | Darts faster — and puts its belly lights out |
| 3 | Arrow Squid Nototodarus sloanii | 10–70 m | An arrowhead on a shaft: long mantle, fins at the very tip | Travels tail-first in jets, fins sculling between | Dark bands flush across the mantle |
| 4 | Siphonophore Praya dubia | 45–118 m | Not a body — a chain, longer than the lamp reaches | A contraction runs down the chain | Kinks, and fires blue lights head to tail |
| 5 | Silver Hatchetfish Argyropelecus hemigymnus | 48–115 m | A blade. Deep, flat, with two eyes pointing straight up | Hangs nose-up, then shivers and is elsewhere | Its keel lights brighten to match you |
| 6 | Vampire Squid Vampyroteuthis infernalis | 55–120 m | A cloak: hooded body, two ear fins, eight arms under one web | Flies on its fins and glides between beats | Turns inside out, and every arm tip lights violet |
Two of these are a deliberate pair. The lanternfish and the hatchetfish are both small, both silver, both hang in the same dark. Light them and they answer in exactly opposite ways: one goes dark, one gets brighter. Learning that is learning the game.
What is in here
df_fauna_upper.module the workshop — parts, joints, swim curves, plate frame
df_sp_*.module one animal each
materials/dfu_*.material the sixteen surfaces they are made of
Each species module returns the spec game/df_core.module documents: the facts,
the three field-note strings, build(parent, opts), animate(root, t, ctx) and
plate(size).
Notes for anyone building alongside these
Primitives are unit sized. A scale is the part's full extent in metres, not
its radius. sphere / cube / cone / cylinder / octahedron are 1×1×1,
plane is 1×0×1 flat in Y, torus is 1×0.3×1, and capsule is 0.5×1×0.5 —
half as wide as its scale says.
A membrane needs render: cull: none in its mat.yaml. The pbr shader's
double_sided property only flips the shading normal on a back face; it does
not stop the face being culled, so a fin authored without the render: block is
invisible from one side.
A flattened octahedron is a far better fin than a plane — a rhombus
reads as a fin, a square reads as a card.
Plates are SVG. W.plate(size, body) wraps a species' markup in the svg
widget on a 100×100 viewBox, stroked in Core.PALETTE.ink, so the journal gets
real ink line-work rather than a stack of boxes. A plate draws in currentColor
where it wants the journal's own ink and names a colour only for the parts that
are luminous in life.
Every surface carries a floor of self-luminance. The water is genuinely black and the lamp is weak on purpose, so a purely reflective animal returns nothing at a low setting. The emissive floor is what lets a silhouette read at 0.06 while the lamp still does the work of resolving detail.