Files
claudeandClaude Opus 5.5 ed3a628994
test / test (push) Successful in 1m58s
DEVLOG: run 9 (cavern biomes, finite worlds, underworld)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 01:35:41 -05:00

25 KiB
Raw Permalink Blame History

Strata devlog

Each entry is written at the end of a development run. It is the running continuity for whoever picks up next: what was done, how it was tested, decisions, and what's next.

2026-11-07 — v0.2 Core Feel, run 1

Done

  • #18 Headless test harness and Gitea Actions CI (545bc7f). tests/run.sh plus the strata_selftest worldmod, .luacheckrc, and .gitea/workflows/test.yml (debian:trixie, Luanti 5.10, luacheck + selftest). See tests/README.md for how to add cases.
  • #11 Missing map blocks after teleport/respawn (e118e36). New strata.teleport: fade to black, emerge the camera's view, move the avatar, send_mapblock the view, fade in. Join and respawn use it.

Tests: 20/20 selftest cases pass locally and in CI (run 19574). luacheck reports 0 warnings.

Decisions and notes

  • Commits are made with git -c commit.gpgsign=false. The global config signs with Eric's GPG key, and pinentry pops up on his desktop and times out.
  • The gameid is the directory name, so run.sh symlinks the checkout to <scratch>/games/strata and sets MINETEST_GAME_PATH. Debian's luantiserver rejects --server, and run.sh handles that.
  • SSH to gitea.eom.dev:22 was unreachable for about 10 minutes mid-run and then came back. Port 2222 answers with a different host key, so don't use it.
  • Client-side visuals (fade timing, whether holes still show) can't be checked headless. #11 needs a manual look in game.

Board: #18 and #11 moved to Done (the browser pane is signed in to Gitea).

Next: the remaining v0.2 high-priority issues in order: #7 free aiming cursor (closely tied to #8, the engine-version decision), #12 one-way platforms, #13 doors and chests. If #7 turns out to need a minimum engine above 5.10, ask Eric on #8 and do #12 and #13 first.

2026-11-08 — v0.2 Core Feel, run 2

Done

  • #12 One-way platforms (2c0911d). strata_core:platform_wood (1 wood → 2). Platforms are non-walkable; strata.platform_step() lands falling entities on them in Lua and strata.platform_support() turns gravity off while resting so they don't sink. S/sneak drops through for 0.25 s. Slimes use it too. See DESIGN.md §2.
  • #13 Doors and chests (4f4fcda). strata.register_door (3 cells, one node per cell, right-click toggles, won't close on an entity, group door) and strata.register_chest (40 slots, not diggable while full, reach-checked). Work Bench recipes: door 6 wood, chest 8 wood + 2 iron bars.

Skipped, waiting on Eric: #7 free aiming cursor. Comment on #7 lays out the options. A 5.10 HUD cursor means camera twitch on every re-center and moving dig/place server-side; the real fix is the 5.12+ camera API, which means raising the minimum engine (#8). Recommendation: evaluate #8 in a branch first. There's no status/needs-decision label in the repo and I didn't create one; the comment says so.

Tests: 29/29 selftest cases pass locally; CI run 19605 is green (luacheck + selftest). luacheck isn't installed locally, so CI is the lint check. The #12 commit was also tested on its own (24/24) before #13 was layered on.

Decisions and notes

  • The avatar entity now accepts _test_ctrl (a fake control table) so the selftest can drive an ownerless avatar. Without it, ownerless avatars still remove themselves.
  • Platform collision runs at server-step rate. It's correct headless, but how smooth the snap looks needs a hands-on check in the client.
  • Doors and chests live in mods/strata_core/furniture.lua, platforms in building.lua.

Follow-ups opened: #67 doors auto-open when walked into (v0.2, low).

Board: not updated. The browser pane isn't signed in to gitea.eom.dev. #12 and #13 should move to Done, and #67 needs adding to the board.

Discourse: skipped. No milestone closed, and the last Strata update (post 2148) was on 2026-11-07, less than 7 days ago.

Next: v0.2 mediums in order: #8 engine/camera evaluation (decision input for #7), then #9 camera polish, #10 lock out 2D-breaking engine features, #14 placement support and wall-mounted torches, #15, #16, #17.

2026-11-09 — v0.2 Core Feel, run 3

Done

  • #8 Engine evaluation (9f9d0af). set_camera (client 5.12+, unchanged in upstream lua_api.md through 5.16) only selects first-person, third-person or front third-person. It can't place a camera or separate it from the look direction, so the rig stays. min_minetest_version = 5.10 is now in game.conf. Judged from the API docs; no branch or newer engine was needed.
  • #9 Camera follow (2b5d1e6). The camera entity is no longer attached to the avatar and moves by velocity towards a goal: look-ahead in x, deadzone in y (a full jump doesn't move the view), re-centres on landing, snaps past 14 nodes. LOOK_LIMIT is now derived from REACH plus the largest off-centre offset (about 0.38 rad, was 0.32). strata_smooth_camera = false restores the rigid attachment (new settingtypes.txt).
  • #10 Lock-outs (0afae3d). First-person is forced on 5.12+ where the API exists, zoom is off including in creative mode, and /teleport is replaced because the engine ignores set_pos on attached players. Fly, noclip and fast already have no effect on an attached player.

Parked per Eric's approved plan: #7 free aiming cursor. Removed from the v0.2 milestone and left open until the engine can separate the camera from the look direction. Eric's go-ahead is on #7.

Tests: 36/36 selftest cases pass locally with zero ERROR lines, on the #9-only state (34/34) and on the final state. Mutating the deadzone makes the entity jump test fail; the first version of that test sampled too early and didn't catch it, so it now samples near the jump's apex.

CI run 19657 (0afae3d) failed luacheck on one warning of mine: _, dest = ... at function level sets a global. It stopped before the selftest. 079c77a fixed it and CI run 19658 is green (luacheck + selftest). luacheck isn't installed locally, so a warning can reach main before CI sees it.

Needs a hands-on check in the client: #9 can't be judged headless. The avatar and camera now interpolate independently, so the avatar could jitter against the view. The rigid fallback isn't covered by the selftest (it needs a connected player). The server also now sees the player at the camera position (z = −22); POINT_RANGE covers it, but only real play exercises that path.

Board: not updated. The browser pane isn't signed in to gitea.eom.dev. Also carried over from run 2: #12 and #13 should move to Done and #67 needs adding. This run: #8, #9, #10 to Done; #7 to Backlog.

Discourse: skipped. No milestone closed, and the last Strata update (post 2148, 2026-11-07) is under 7 days old. Nothing in the Agents category was addressed to this task, and nothing was posted there.

Next: v0.2 mediums in order: #14 placement support and wall-mounted torches, #15 avatar animation, #16 feedback, #17 item magnet, then lows #19, #67.

2026-11-10 — v0.2 Core Feel, run 4

Done

  • #14 Placement support (208ea92). New mods/strata_core/placement.lua: player-placed blocks need a support block next to them or a wall behind; walls need a neighbouring wall or a block in front; torches mount on the floor, then a side block (new torch_left/torch_right plate nodes and a strata_torch_wall.png texture), then a wall behind, and drop when their support is dug. Only player placement is checked. The torch node moved from init.lua into placement.lua.
  • #15 Avatar animation and held item (fd329d2, lint fix 7f9a1be). New mods/strata_player/appearance.lua: a 9-frame sheet (strata_player_sheet.png replaces strata_player.png), a wielditem entity strata_player:held attached to the avatar that swings while dig/place is held, and per-viewer HUD waypoints for other players' names. strata.objects_in_cell now ignores non-physical entities so the held item never blocks building.

Tests: 46/46 selftest cases pass locally with zero ERROR lines (41/41 on the #14-only state). A mutation that disables swinging makes the swing test fail. CI run 19767 (#14) is green. CI run 19768 (fd329d2) failed luacheck on one long line in tests/strata_selftest/init.lua; 7f9a1be fixes it (CI run 19769). luacheck still isn't installed locally. Check every .lua file in git ls-files for line length, not just mods/ and tests/.

Needs a hands-on check in the client: the wall-torch plate; the held item's orientation, especially facing left (it relies on the attach rotation applying roll before yaw) and whether the wielditem extrusion faces the camera; how the walk frames and swing timing look; and name-tag waypoints with two players.

Follow-ups opened: #68 furniture needs a floor under it (v0.6, low).

Board: not updated. The browser pane isn't signed in to gitea.eom.dev. Pending moves: #12, #13, #8, #9, #10, #14, #15 to Done; #7 to Backlog; #67 and #68 need adding to the board.

Discourse: skipped. No milestone closed, and the last Strata update (post 2148, 2026-11-07) is under 7 days old. No player questions since. In the Agents category, topic 830 (the shared Gitea Actions runner) was new; nothing was addressed to this task, and nothing was posted.

Next: v0.2 mediums #16 dig/place/hit feedback (sounds must be CC0 or self-made, with a CREDITS.md), #17 item magnet, then lows #19 and #67. When those close, v0.2 is complete.

2026-11-11 — v0.2 Core Feel, run 5: milestone complete, v0.2.0

Done

  • #16 Dig, place and hit feedback (4ee3e33). New strata_core/feedback.lua: sound sets per material (nodes without sounds get one from their dig group), server-side break dust in front of the plane, place sounds for the custom on_place handlers, avatar footsteps, a red flash plus hurt sound on damage, slime hit/death squelches. Sounds are synthesized by the new tools/gen_sounds.py (CC0, no samples), listed in the new CREDITS.md. The swing animation was already done in #15.
  • #17 Item magnet (25a06e8). New strata_player/pickup.lua: __builtin:item re-registered with a wrapped on_step that keeps items on the plane and pulls them into avatars within 3 nodes that have room. core.item_drop throws from the avatar with a 1.5 s pickup delay.
  • #19 Hotbar QoL (f823b33). New strata_crafting/inventory.lua: smart tool select by swapping stacks on on_punchnode and swapping back after dig is released (toggle on the inventory screen), Quick stack to chests within 6 nodes, Sort. The hotbar is never touched by the last two.
  • #67 Doors open when walked into (9e8284b). strata.open_door_ahead, called from the avatar only. No auto-close (it could trap whatever follows).
  • v0.2.0 released (46fe054, annotated tag v0.2.0). Milestone 24 closed with 13 issues. New CHANGELOG.md. Version is in the README status and the changelog; game.conf has no version field in Luanti's format, so I didn't add one.

Tests: 66/66 selftest cases pass locally with zero ERROR lines (55 on the #16-only state, 60 with #17, 65 with #19). Mutations that disable the magnet or the avatar's door call fail their cases. CI runs 19864 (#17), 19865 (#19) and 19866 (#67) are green. Lines were checked for length locally, since luacheck still isn't installed here.

Lesson: item entities are static-saved, so a headless server with no players deactivates them within a second or two (get_pos() returns nil). The pickup tests forceload their blocks. Non-static entities (avatars, slimes) aren't affected.

Needs a hands-on check in the client: sound volume balance (the listener is the camera, about 22 nodes from the plane); how the magnet pull feels; whether the client keeps the old dig time for the first block after a smart-tool swap.

Board: not updated. The browser pane isn't signed in to gitea.eom.dev. Pending moves: #12, #13, #8, #9, #10, #14, #15, #16, #17, #19, #67 to Done; #7 to Backlog; #67 and #68 need adding to the board; v0.3 issues from Backlog to To Do.

Discourse: milestone post in topic 820, https://discourse.eom.dev/t/luanti-season-vi/820/5. No player questions since the last update. In the Agents category nothing was addressed to this task; I posted the item-entity lesson in topic 829.

Next: v0.3 World & Biomes (milestone 25), starting with its bugs and high-priority issues.

2026-11-12 — v0.3 World & Biomes, run 6: vertical layers, play-test feedback

Eric's play-test feedback on v0.2.0 (topic 820, post 6) came in three parts:

  1. Aiming rotates the camera oddly; "zoom back" and free the mouse from the camera. The free cursor is still blocked on the engine (#7, comment added). Zooming back isn't: opened #71 (camera further away with a narrower FOV roughly halves the rotation), v0.3, high.
  2. Held items don't move when the player turns around: opened #69 (bug).
  3. Prefers underground exploration for v0.3, with df_caverns as inspiration: opened #70 (cavern sub-biomes and flora), v0.3, high.

Done

  • #69 (cd63a90, left open for Eric to confirm). While dig or place is held, the avatar now faces the aimed x (strata.aim_x, strata.aim_facing); before, it only turned while A or D was held, so digging behind you swung the item on the wrong side. The walk-turn flip already works on the server (new test), and the 5.10 client source applies a repeated set_attach, so I couldn't reproduce that half headless. Future runs: don't pick #69 up again until Eric replies on it.
  • #20 Vertical layers (0e0c431, closed). strata.mapgen.layers is a table of surface / underground (−20) / cavern (−300) / underworld (−900), with bedrock from −1000. Each row has stone, wall, cave sizes, ores, background colour and spawn table; strata.mapgen.layer_at(y) is the API. New nodes: slate, basalt, bedrock, slate ore variants, slate and basalt walls. The spawner (strata.spawn_candidates) and the player's sky (strata.update_layer_sky) read the table.

Decisions

  • Layers are by absolute y, not relative to the surface, so layer_at(y) needs no x. Boundaries dither (stone) and ease (cave sizes) instead.
  • "Background tint" is done two ways: walls have their own tinted texture per layer, and the sky becomes a flat layer colour below the surface.
  • Underground caverns were made rarer (threshold 0.55 → 0.8) so the cavern layer reads as a different place (17% vs 31% open).
  • Stone hardness gates depth: slate is slow with copper, basalt needs iron.
  • The underworld is only basalt and open space for now; #25 fills it.

Lessons

  • core.get_dig_params divides a tool's listed time by (maxlevel − node level), so real dig times are about a third of the numbers in the tool table (stone with copper: 0.18 s). The first depth estimate was 3× too shallow; the selftest now measures it (168 s with copper over 11 shafts).
  • A headless server unloads blocks nobody is near after about 30 s, and they then read as ignore. Tests that read map far into the run must emerge_area again first (with_deep_area in tests/layers.lua).

Tests: 79/79 selftest cases pass locally, zero ERROR lines (66 before; +2 for #69, +11 for #20). The deep column (81 × 1050 blocks) emerges in about 18 s, so a full run takes about a minute. luacheck isn't installed here; lines were checked for length and CI runs it.

Needs a hands-on check in the client: #69 both cases; the look of slate, basalt and the layer wall tints; the sky change at a layer boundary; mapgen speed while falling down a deep shaft (#26 moves it to the async env).

Board: not updated. The browser pane isn't signed in to gitea.eom.dev. Pending moves: #12, #13, #8, #9, #10, #14, #15, #16, #17, #19, #67, #20 to Done; #7 to Backlog; #67–#71 need adding to the board; v0.3 issues from Backlog to To Do.

Discourse: skipped. No milestone closed, and the last Strata update (post 5 in topic 820, 2026-11-11) is under 7 days old. Eric's post 6 is to be answered in the next update: #69, #70 and #71 came from it. In the Agents category nothing was addressed to this task and nothing was posted.

Next: v0.3 highs in order: #21 biome framework (snow, jungle), #22 2D liquids, #70 cavern sub-biomes, #71 camera distance. Then mediums #23–#26.

CI follow-up (same run): run 19916 failed on 0e0c431. Two layer cases timed out because the shared runner took 49.5 s to generate the deep column that takes 8–18 s here, against the 20 s case limit. No assertion failed. Fixed in the next commit: cases can set opts.timeout (the deep-map cases use 150 s), the column is one mapchunk wide instead of two, and run.sh allows 420 s overall. Lesson: time-limited tests that generate map need several times the local margin on the runner.

2026-11-13 — run 7: biomes (#21)

Started about 2.7 h late: tidewall-build held the project lock until 02:23.

Done

  • #21 Biome framework (0fe9a4b, closed). mg.biome_list / mg.biomes with forest, desert, snow and jungle; mg.biome_at(x) from heat (the old biome noise) and a new humidity noise. Each biome sets surface, fill, fill wall, the stone and wall that replace the layer's down to the cavern layer, pockets, tree kind, extra ores and a surface spawn table. New blocks: snow, ice, sandstone, mud, jungle grass and four walls. Trees go through strata.register_tree (oak, frostpine cone, redheart crown), and strata.fell_tree clears each kind's leaves. mg.node_at / mg.wall_at describe every cell, and the mapgen tests compare against them.

Decisions

  • Deserts stay where they were (same noise and threshold), so existing worlds only change where new snow and jungle columns get generated.
  • The default seed put x = 0 in snow, so the world is always forest within 64 columns of spawn and other biomes fade in over the next 192. #27 (world spawn area) can build on this.
  • Biomes reach through the underground layer only; the cavern dither band doubles as their lower edge. #70 (cavern sub-biomes) handles below.
  • All trunks drop plain Wood for now. #72 opened for biome woods, since every recipe names strata_core:wood directly.

Tests: 86/86 pass locally, zero ERROR lines (+7 cases in tests/biomes.lua). Biome shares over ±20 000 columns: forest 43%, desert 21%, snow 22%, jungle 14%. Sample sites are emerged on demand (timeout 150 s for the slow runner).

Needs a hands-on check in the client: the new placeholder textures and tree shapes, and whether biome widths feel right.

Board: not updated. The browser pane isn't signed in to gitea.eom.dev. Pending moves now also include #21 to Done and adding #72.

Discourse: skipped. No milestone closed, and the last Strata update (2026-11-11) is under 7 days old. Agents category: nothing addressed to this task; topic 830 says the CI runner was evicted three times on 2026-11-12, so a CI failure with no step error should be rerun once.

Next: #22 2D liquids, then #70 cavern sub-biomes, #71 camera distance.

2026-11-14 — run 8: liquids (#22), camera distance (#71)

Done

  • CI flake (1f93b61). Run 19999 failed "footsteps use the node underfoot" on the shared runner: with no player connected the server unloaded the test site's block after ~30 s and get_node read ignore. The test config now sets server_unload_unused_data_timeout = 3600.
  • #22 2D liquids (3f5c0c6, closed). Water and lava are leveled nodeboxes (level 1..64 in param2) moved by Strata's own cellular sim on z = 0 only, so nothing leaks towards the camera: react (lava + water = ashglass), fall up to 3 rows, share levels with lower side neighbours. Only active cells are simulated; they wake on place/dig next to them, on neighbour changes and through an LBM on block load. Buckets (3 iron bars, anvil). Mapgen cave pools that rest on a solid floor: water in the top three layers (about 11% of open underground cells), lava in the underworld (about 8%). Avatar swimming (strata_player/swim.lua): slower walk, low gravity, sink cap, hold jump to swim, surface hop to climb out, own breath bar, drowning 20 HP/s, lava 60 HP/s, liquids break falls.
  • #71 camera distance (82433b2, closed). strata_camera_distance setting, default 44 (was 22); FOV derived so the plane shows 21.5 nodes top to bottom (about 28°). Aiming at the edge of reach now turns the view about 11° instead of 22°. Sound hearing distance follows the distance.

Decisions

  • Custom sim (option b in the issue) rather than engine liquids walled in with barriers: barriers would need nodes at z = −1 and 2 everywhere liquid can go and still give 3D flow rules.
  • A settled surface may step by one level unit (1/64 node) between neighbours; flattening further needs non-local moves that oscillate.
  • Liquids are buildable_to: a block placed into water displaces it.
  • Generated pools can still spill at the edges; the LBM wakes them when a player's blocks activate, which is Terraria-like settling.
  • Kept the shadow slab at CAMERA_DIST + 8 in front, so the deep-area emerge in tests went from about 8 s to 18 s locally.

Tests: 94/94 pass locally, zero ERROR lines (+8 cases in tests/liquids.lua; layer tests treat liquid as open cave and allow lava's glow). Full suite takes 57 s locally (was 46 s).

Needs a hands-on check in the client: how water and lava look (alpha nodebox facing the camera), swimming feel, the breath bar position, and whether 44 nodes / 28° feels better (#71 asks for this).

Board: not updated; the browser pane isn't signed in to gitea.eom.dev. Pending moves: #21, #22, #71 to Done, plus adding #72, #73 and #74.

Follow-ups opened: #73 liquid sounds and effects (v1.0, low), #74 creatures and dropped items in liquids (v0.4, medium).

Discourse: skipped. No milestone closed and the last Strata update (2026-11-11) is under 7 days old; no new replies in topic 820. Agents category: nothing addressed to this task, nothing posted.

Next: #70 cavern sub-biomes (high), then #69 needs Eric's check, then mediums #23–#26.

2026-11-15 — run 9: cavern biomes (#70), finite worlds (#23), underworld (#25)

Waited about 5 minutes for the project lock (held by tidewall-build).

Done

  • #70 cavern biomes (d128a0d, closed). mg.cavern_biome_list / mg.cavern_biome_at(x, y): plain cavern, glimmer grove (mycel turf, glimmercaps, giant umbrel mushrooms whose stalks fell like trees for wood), prism gallery (prism clusters on floors and roofs, prism shards) and drowned grotto (silt, dripvines up to 4 long, pool threshold −0.3). Flora glows (light 3–7), is walk-through and drops when its support is dug (strata.register_flora, strata.flora_held). Glowspore + wood → 3 torches. Spawn tables per cavern biome (empty).
  • #23 finite worlds (487ff6e, closed). strata_world_size small/medium/ large/infinite, medium by default for new worlds. The size is stored in mod storage; worlds that already had env_meta.txt stay infinite. Invisible world_edge column at |x| = half, reach and creature spawns bounded, an ocean biome in the last 220 columns (beach, then the floor falls to y = −17, water only past the beach so it stays put).
  • #25 underworld (779fbe8, closed). Layer rows got floor, pocket and sea: ash floors and pockets, every cave cell at or below y = −972 is lava, and emberite ore (level 4, no current pickaxe digs it). Ruined towers moved to #24; pickaxe notes on #39.

Bugs found on the way: ipairs over {cb.floor, cb.flora…} stopped at the first nil, so gallery and grotto flora got no content id and were generated as air. The selftest caught it as a map/node_at mismatch.

Decisions

  • Flora doesn't use the engine's attached_node: a vine hanging from a vine (non-walkable) would drop on any neighbour update.
  • Mushrooms, like trees, aren't in mg.node_at. mg.mushrooms(box) and mg.mushroom_cells let tests and mapgen agree. The stalk wins over a neighbour's cap.
  • The ocean isn't in mg.biome_list (infinite worlds never have one); the test world runs infinite and switches size with mg.set_world_size.
  • Emberite gates on group level rather than lowering pickaxe maxlevel, which would slow every dig and break the 3-minute shaft.

Tests: 109/109 pass locally, zero ERROR lines (+12 cases in caverns.lua, world_size.lua, underworld.lua). CI passed for d128a0d and 487ff6e. luacheck isn't installed locally, so CI is the lint check.

Needs a hands-on check in the client: plantlike flora seen from the side (an X at 45°), grove brightness, the edge wall, the beach slope, and how bright the lava sea is.

Board: not updated; the browser pane isn't signed in to gitea.eom.dev. Pending moves: #21, #22, #23, #25, #70, #71 to Done; add #72–#75.

Follow-ups opened: #75 surface biomes continue into the caverns (from kritomas's feedback in topic 820, post 7).

Discourse: no post. No milestone closed and the last Strata update (2026-11-11) is under 7 days old. New replies since: Eric's feedback is already in #69/#70/#71, kritomas's is now #75. Eric also asked (post 8) whether to move this agent to a Vintage Story concept instead. That's his decision, so it's flagged in the run summary, not answered here. Agents category: nothing addressed to this task, nothing posted.

Next: #24 structures and loot (with underworld towers), then #26 async mapgen, #75, then lows #27 and #72. #69 still waits on Eric's client check.