Log inGet started
World

Deep Field

Branchmain
Branchesmain
Commit97b82cdc4f

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.

AnimalWhereThe shapeThe swimUnder the lamp
1Moon Jelly Aurelia aurita3–42 mA flat bell, twice as wide as tall, four pale horseshoes on topPulses and gets nowhereIgnores you completely
2Lanternfish Myctophum punctatum6–60 mDeep little body, an eye far too big, a deeply forked tailHangs dead still, then darts a body-lengthDarts faster — and puts its belly lights out
3Arrow Squid Nototodarus sloanii10–70 mAn arrowhead on a shaft: long mantle, fins at the very tipTravels tail-first in jets, fins sculling betweenDark bands flush across the mantle
4Siphonophore Praya dubia45–118 mNot a body — a chain, longer than the lamp reachesA contraction runs down the chainKinks, and fires blue lights head to tail
5Silver Hatchetfish Argyropelecus hemigymnus48–115 mA blade. Deep, flat, with two eyes pointing straight upHangs nose-up, then shivers and is elsewhereIts keel lights brighten to match you
6Vampire Squid Vampyroteuthis infernalis55–120 mA cloak: hooded body, two ear fins, eight arms under one webFlies on its fins and glides between beatsTurns 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.