Skip to content

About

Creating an adventure game with Codex and Claude Code

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

763 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Azhora

A playable 3D adventure and strategic campaign simulation prototype. In the Lizeemi War, the player is a wizard inside a war that continues without them: armies move, supplies change, battles resolve and regions change hands. Joining a 3D tactical encounter feeds its outcome back into that campaign.

Start here: Browser version · Demo 7: recorded playthrough · Development post · Short local demo

The current local release candidate offers Story (the Lizeemi War) and Explore (free exploration with progressive loading). Continue appears when compatible progress is saved. A desktop keyboard, mouse and WebGL-capable browser are recommended. Explore's first load can take about a minute; Story is the quicker introduction. This is a prototype, not a finished commercial game. Render publishing is manual: the browser link may run an older version until the next approved deployment. See the release review and preparation record. The subsequent development integration review records the combined Night Elf and portfolio candidate.

Engineering worth exploring

  • Independent simulation: a seeded campaign core, validated commands, army orders, resource accounting and battle resolution in src/simulation. Rendering and player input consume this state rather than owning the war.
  • Tactical/strategic integration: player battles apply casualties and results to the shared campaign, including its event log and clock. The simulation can also resolve unattended battles. See the Lizeemi source trace.
  • World construction: authored atlas data drives procedural terrain, towns, vegetation and collision geometry; cooperative regional jobs support progressive loading. The full world is expensive to construct and remains a developer option.
  • Persistence and verification: mode-specific saves, validation and migration, isolated test profiles, pure-model tests and native Chromium checks of built web assets. Coverage is substantial but not a guarantee that every prototype is stable.
  • Local rendering and audio: JavaScript ES modules, vendored Three.js/WebGL, Canvas interfaces and synthesized Web Audio; an Electron desktop host shares the browser game. The game needs no AI API calls or keys at runtime.

The architecture guide maps source responsibilities. The simulation design includes historical experiments as well as the playable campaign. Chapters Two/Three, combat exercises, older adventures and economic rehearsals remain development features. Campaign food, housing and population are abstract values over fixed scenery; they do not claim a one-building-per-household simulation. Broader skills and story plans are not prerequisites for demonstrating the working Lizeemi loop.

Run and verify

Use Node.js 22.15 or newer; 24.15.0 was used for the portfolio checks. The lookout asset build requires APIs introduced in Node 22.15. Dependencies are locked; install with:

npm ci
npm start

The native launcher deliberately retains Chapters 1–3, Explore with Full/Fast choices, Combat Testing and folded rehearsals. Choose Chapter 1: Lizeemi War for the recommended demo. The built browser defaults to Story/Explore; append ?launcher=developer to expose the same developer choices. This is a UI presentation distinction, not a security boundary. Existing mode IDs, explicit diagnostic routes and save slots are preserved.

npm run check:layout
npm run check:modules
npm run check:tests
npm run test:unified-war
npm run build:web
npm run test:portfolio:web

See the demo guide for serving public/ locally. npm test runs the registered suite sequentially; it can take substantial time. Explicit test exclusions distinguish known legacy failures from manual heavy-world checks. The verification record lists what was actually run and its limits. Browser saves stay in their browser and origin; they do not share the native desktop save directory.

AI-assisted development and authorship

Michael directs the project: requirements, game and systems design, tradeoffs, behavioral evaluation, playtesting, and integration decisions. OpenAI Codex and Claude Code have produced substantial implementation code and tests under that direction. This repository should not be read as a claim that Michael manually wrote every implementation detail. It is evidence of designing, evaluating and integrating a complex software prototype with coding agents, alongside conventional engineering tools and tests.

Concrete interview topics include separating simulation from rendering, preserving old scenario rules in saved games, converting tactical outcomes into strategic commands, bounding progressive construction work, and checking the shipped web artifact rather than assuming a Git push updated production.


Detailed development documentation and historical notes

The material below is retained for contributors. It describes several generations of the project, including the original Drent adventure. Controls, prototype status and historical launcher descriptions in those sections may differ from current Story/Explore; use the introduction and demo guide above for a first visit.

Testing combat: Choose Combat Testing on the homepage, then pick an exercise. The 3D world loads only after you choose an exercise. WASD moves and faces, X strikes the gold-ring target, Space + direction dodges, R retries, and Esc returns to exercise selection. H / Help pauses the encounter to show the full controls and sound toggle. Press H or Esc to resume; Esc outside Help returns to exercise selection. The active display keeps health, dodge readiness and one changing instruction. The first exercise prepares a bounded Minora camp with its existing tents and city backdrop; it skips the global world builder and campaign atlas. Subsequent exercises reuse it. npm run start:combat opens this selector directly. For the Ovesos ride, armies and geopolitical outcomes, use Lizeemi War Scenario and its F8 computer demonstrations.

First playtest: Try the three exercises in order without extra coaching. Note whether the shield block, dodge direction and counter opening make sense, and describe the moment of any confusing hit. Then try an Ovesos intervention yourself in Lizeemi War, or watch its F8 demonstration, to check whether the encounter’s effect on the campaign is clear.

Finding your way around the code: start with the codebase guide, follow Chapter 1 through the source, or search the file index. The October 6 cleanup groups existing features into folders while retaining gameplay behavior. See the change and verification record.

5 October update: 33 northern and island environments are integrated, including Gorgiwood, South Gorgi Mountains and both Ithzel regions. Unbuilt countries are gray on the map. Southern jungle development is on hold; further loading optimization is paused.

Additional 5 October integration: Eshtor Plateau is built, and Claude's South/North Ibenal, Henborth and Mithala city are reviewed and integrated into the desktop working copy. Find them in F8 travel.

A standalone 3D adventure across six authored regions of Azhora: Drent, the Ambroni Empire’s quietest forested province; Luscia beyond the Caloss; the open Moros Plain; West Suval and the walled city of Solis above the sea; Pueth, the cold timber country north of Drent; and the stone hills of East Suval, whose frontier is shut. Their shapes, sizes and positions come straight from the World Builder atlas at 100 metres per authored hex. A mercenary hired from across the sea lands at Tidehaven on Drent’s east coast during a goblin attack, carries Jojo’s introduction to the Ambroni Legion, and follows the road south-west through the forest, over the Caloss, past the Legion’s outpost on the Moros and on to the parley at Solis, where the war forks. North of Tidehaven the road crosses the Tessen into Pueth. The regions connect without loading screens, and the road stays open for return visits.

Drent’s forest includes small working places, optional woodland errands, deer, insects and understory plants; the goblin scout camp that raids it now sits across the Tessen in Pueth. Along the way there are towns with their own people, Legion posts, a hired mercenary company that walks the road on its own clock, a horse to ride from Lumber Town on, and birding, the first of the traveler’s skills: Jean teaches Birding and Animal Husbandry beside the departing village road. Twenty-five kinds of bird can be recorded, repeat observations earn practice, and familiar bird calls open at level 2. Her feeder garden remains in Tidehaven, and her two tame sheep give the traveler livestock to practise with. The traveler’s chart begins blank and is charted as you walk, naming the ground you reach. A separate developer ghost mode inspects the authored world atlas, flies through the playable regions, visits a Cape Thalmagar fortress prototype, or surveys terrain from the wider map.

The Drent road also offers optional skill lessons: Stanley's repeatable Farming plots and farm cooking in Avrel; Jean's Birding and Animal Husbandry; Mark and Glun's different Geology introductions; Glun's guided Woodcutting; Amanda's Acting; and Sylvia's Visual Arts cottage on the Sunken Lane. Sylvia also offers Room to paint, a favor to clear four harmless Drent ivy patches around her cottage for Farming XP and a copper reward. Lee Anne teaches Fire Making before Jojo's Cooking lesson, while Martin introduces Smithing. Glun, Mark, Jean and Stanley can each lead an outing to a pond and demonstrate Fishing. These lessons share permanent skill progress, so changing teachers never resets experience. See farming, guided fishing, fire making and smithing, woodcutting, and Visual Arts.

The Greenway ambushers keep their individual health and positions between attacks and saves. They wait in visible brush camouflage, emerge to fight, and surviving raiders walk back into cover after driving someone off. Dead raiders stay dead. See ambush persistence.

The civil-war campaign runs to the border battle and the day after it in 3D; the branches beyond are designed and executable but not yet built. See docs/campaign-design.md. Every authored region has a difficulty level (0 tutorial to 5 deadly), a controlling faction and its threats (src/content/chapters/civil-war/campaign-world.js); the main quest runs Drent → Luscia → Moros Plain → West Suval, forks at Solis between the Ambroni Empire and the Republican Coalition, and continues along mirrored branches to the South Oremindi Mountains (src/content/chapters/civil-war/campaign.js). Regional side arcs flip provinces on the political map, faction trust rises and falls, and double-dealing is eventually exposed. The journal’s The civil war section shows the current chapter, your standing, and the regions around Drent; the developer atlas tints every region by level.

Suval now has terrain climbing: Space grips a reachable steep face, WASD climbs or traverses, Space boosts upward, and X releases. Moving and hanging consume stamina; clear ledges restore it. The first grip introduces Climbing, and practice improves efficiency. Checkpoints return a suspended climber to the last foothold with skill progress retained. The sealed East Suval border remains closed.

Canerd

Canerd now stands directly on the flat plain in North Celder. Follow the direct approach from the horse-fair ground to the open south gate, the chief lord's court and hall, and the stair to the southern battlement outlook. Successive bands of older rough stone, refaced curtain walls and tall upper works give the castle its layered silhouette above the plain. The highest tower is an exterior landmark; the ruler, residents, seasonal fair and political quests remain future work.

Use F8 → Go anywhere → Canerd to visit, or approach across North Celder. The castle and fairground appear on the traveler's chart as you explore. npm run test:canerd checks terrain, scenery and actual traveler movement; npm run review:canerd runs the native build and captures four views. See the Canerd build record.

Play

For the five-region agriculture review, run npm run review:farmland and use Region to compare them. Open a region directly with npm run review:farmland -- --region=isareos for Minora, or use --region=caricas, --region=ovesos or --region=nesdor. Inspect the fields and river towns from above or walk through them as Teresod. Food production tests their regional capacities through one shared campaign clock. Nesdor has more woodland and fewer cultivated clearings; disrupting its farms shows food arriving from Caricas and the resulting reduction in Minora's imports. Isareos keeps Minora's existing city and adds fresh surrounding farms. Close its two import routes under Food production to test its fourteen-day reserves. Population & housing shows actual population separately from accommodation. This is a separate review scene; see the farmland walkthrough.

To play the war in these reviewed landscapes, choose Begin Lizeemi War. Speak with Taleth, choose your side inside his tower, then leave at dawn and explore the five regions. M → Food and housing shows regional stores, deliveries, rations, stability, army supplies and housing capacity. Supplies update once per completed adventure minute. Tower visits, reading, training and local battles hold that clock; rest on quiet ground to preview a wait to the next event. F8 provides mounts, region travel and reveal controls; F5 saves your campaign. Earlier saves retain their original countryside and economy; start a new campaign to use the combined version. See the unified campaign. Fields now reflect regional production condition, battle disruption and unrest. In the earlier Food world test, F8 → Nesdor shortage and recovery runs a temporary supply exercise at 20x with map explanations, Pause/Next controls and Return to my game (or Esc) to restore your current session. Army movements are held in this exercise; food still uses campaign.js. Farm protection/repair encounters are not yet implemented.

For the new simulation prototype, run npm run start:lizeem-world or double-click Test Lizeem World.cmd. Begin at Minora, use M to run the five-region war, and approach a discovered battlefield before its deadline to join with F. See the world-test walkthrough. npm run start:lizeem opens the faster map-only experiment; npm run start:exploration opens ordinary exploration.

Double-click the Azhora desktop icon, Play Azhora.cmd in this folder, or run npm start. Close an existing game window and reopen it after an update.

The desktop game opens in native fullscreen, covering the Windows title bar and taskbar. F11 or Alt+Enter switches between fullscreen and a window. Escape pauses without leaving fullscreen.

The launcher uses this project's Electron runtime if installed, otherwise the runtime in the neighboring world-builder/map project. On another computer, install Node.js, run npm install, then npm start. The game works offline: Three.js, the atlas, procedural models, interface, and synthesized sound are local. It needs no API keys or external asset requests.

Control Action
WASD / arrow keys Walk relative to the camera
Q / E Move forward-left / forward-right
Shift / hold Tab Run; Tab navigates controls inside menus
Space Jump
Right mouse drag Turn the camera
Mouse wheel Zoom
F Talk, continue dialogue, gather, repair, restore a waymarker, cast/reel, or tend a fire
Left click / R Swing the equipped weapon; timed presses chain a three-hit combo
Ctrl + movement direction Dodge; with no direction, dodge backward
Enter Begin / continue dialogue
I Open or close the satchel; hover for hints, then select items, equipment, or food
J Journal and journey notes
L / click the minimap Open the local trails map; L also closes it
M Open the traveler’s chart of Azhora
K Open your skills; B observes a bird you have in view
Escape Pause, dismiss a panel, or cancel fishing
F8 Open testing tools, including from the opening screen
Esc Pause. Leaving the window does not pause — Azhora goes on without you, so a fight you walk away from is still happening. Held keys are released and a cast is reeled in, because neither can be worked from another window.
P Start autoplay (also Watch the computer play on the opening screen or Autoplay the road in Pause); any key or click takes control back
F11 / Alt+Enter Toggle fullscreen

Pause offers lighter graphics, a return to the pier, testing tools, and Save adventure after stepping ashore, outside an active fight.

Autoplay lets the computer play the main quest while you watch or step away. Press P, choose Watch the computer play on the opening screen, or Autoplay the road in Pause. The autopilot uses only ordinary inputs: it walks the Greenway and the road out of Drent, talks to Jojo, Eren, Corvan, Hollis, Sava and Iven at a readable pace, practises at the straw post, fights the goblins and the meadow raiders with the same dodge-and-counter rules you use, gathers driftwood for the bridge, restores the waymarkers, and stops when Iven files the report (the campaign chapter beyond Drent is not built). A badge shows what it is doing. Any real key press or click hands control straight back; the game does not pause on losing window focus while autoplay is on, so it can run unattended. Autosaves happen exactly as in normal play. Switching to another window pauses play. Named signposts point to the next place along the road, back toward Tidehaven, and along the smaller woodland paths. Flowers, ferns, riverbank leaves, and heather change with the landscape. Sound starts off; enabling it adds sea, forest, field, river, and ridge ambience, nearby animal calls, combat effects, and footfalls that change on wood, earth, and stone.

The minimap stays centered on the traveler, with true north up and a constant 62-metre radius across all four regions. It shows nearby roads, smaller trails, buildings, and water. The Local trails journal tab opens with L or a click on the minimap and adapts to compact windows. Browse any of the four regional charts, or choose Where I am to return to your current region. District ground and dashed borders on both charts are drawn from the authored hex outlines, not from bands of Z. Use + / − or the mouse wheel to zoom around a selected place, and Fit to show the whole region again. Browsing pauses play and does not teleport the traveler or discover places.

Discovered places and destinations learned through quests have names; unexplored places remain anonymous and cannot be marked. Select a known place and choose Mark to follow its teal optional pin, alongside the gold main journey objective. Clear it from the map or the small pin label beside the minimap. Optional pins last for the current run only. Existing discoveries continue to autosave through adventure checkpoints. J still opens journey notes, and M opens the developed World Builder atlas.

The four-region journey

North is world -Z, east is +X, and one authored hex is 56 m. Region shapes come from regionOutline() over assets/azhora-dev-regions.json; the road runs through the anchors routeAnchors() returns.

Region Shape and biome Places and people Main errand
1 · Drent 39 authored hexes, about 530 m by 310 m on the north-east coast. Dense broadleaf forest throughout, with the Stills to the east. Tidehaven's pier and village, the Greenway, Willowmere Pond, Fernway Rest and its shelter, six quiet woodland places, Bramble Scout Camp, the Caloss Gate gatehouse and guard hut, the wayside on the forest road (charcoal burners, a forester’s hut, a shrine, a timber landing), and the Avrel farmsteads (farmhouse, barn, byre, stack yard, field walls) with Corvan's Legion post, the old Rena road running north off the main road through the ruins of Rena to the orchard village of Applegarth, and the sunken lane, the toll house and the pedlar's stone on the road west; Jojo, Tobin, Eren, Lysa, Orris, Bran, Tamsin, quartermaster Corvan, miller Enna, and the two Ardrys who remember Rena — Lorn on the Tidehaven shingle and his sister Hesta at Applegarth, whose letters you carry Receive Jojo's message, learn movement and combat, defeat three goblins, inspect the message, and walk the forest road to the Caloss Gate. Then deliver the letter at the Avrel clearing, recover three parcels, deal with two raiders, and return to Corvan for two cooked fish.
2 · Luscia 23 hexes south-west across the Caloss. Rolling grass with copses that thin toward the Moros. The Caloss bridge with Hollis's timber yard and the ferryman's hut, the reedcutters' landing, the marked fishing bank, Sava's shrine in its walled court, three waymarkers, the Lauvel relay and its yard, the field at the Lauvel with its field hospital and cairn, the burned hamlet's ruins and scorched orchard, and Lumber Town between its palisade gates (smithy, hall, stable yard); Elod's closed frontier on the East Suval border; keeper Hollis, Sava, relay clerk Iven, and reed worker Merren Gather three sticks, repair the damaged bridge lane, report to Hollis for four spare branches, restore three waymarkers, then let Iven copy Jojo's report at the relay.
3 · Moros Plain 31 hexes west of Luscia. Flat treeless grassland under a very large sky. The Moros gate with its watch platform, the wayside (milestones, a shepherd's fold, a Legion picket), the Ambroni outpost (a timber fort to the shared fortification standard: rampart, palisade, wall walk, twelve towers, a ditch, two gates; tent lines, the Legate's tent and standard, a smithy with a repair bench, a mess fire, the parade ground, the horse line), and the border stockade to the same pattern Not yet a quest: the camp, the horses and the stockade are placed scenery for the chapter that follows.
4 · East Suval 23 hexes south of Luscia. Grey stone hills, heather and ridge rock, with the Stills again to the east. Closed. Elod keeps out of the war: its stone frontier and black-clad guard stand on the Luscian side, pickets watch the rest of the border, and nobody may cross. Behind it: Elod's old border post, the roofless waystation and its shelter, the gate of Elod above the sea, and a hill-bandit lookout; shelter keeper Oda None: the region cannot be entered (the F8 travel tools still reach it for testing).

Tidehaven's tutorial

Walk ashore and speak to Jojo with F. Your simple sword is equipped from arrival; Jojo gives you her message and points out the practice post and repair bench. Land two hits on the straw post and complete a directional dodge nearby, then follow the woodland road to the warning bell.

The three bramble goblins enter with staggered arrivals. Amber ground arcs show their committed strikes; dodge, then counter during recovery. Goblins take turns attacking, stamina recovers between actions, and melee has light aim assistance and a short input buffer. Defeat offers a full-health encounter retry, retaining items and completed lessons. Retreating to the safe side also gives you another attempt. Neither action repairs weapon wear.

Report to Eren beyond the village for his travel token. Press I, hover over Jojo's message for its tooltip, and select the message to read it. Dismiss the satchel with I, Escape, or Close. Follow the minimap marker through Fernway Rest to the open field gate travelers call the Caloss Gate. The forest thins there and the Avrel clearing opens out, and the next quest begins.

Army service and the people called rebels

Jojo's letter sends the hired mercenary from Tidehaven to Quartermaster Corvan of the Ambroni Legion at the Avrel clearing. Corvan records the letter, inducts the traveler into Legion field service, and assigns supply recovery for the campaign against the rebels. He presents the Legion as bringing order while goblin raids out of Pueth threaten the roads. Legion soldiers are men by default; named exceptions can be written later.

The mandatory regional conversations change that picture gradually. Hollis, at the Caloss where Drent ends, reveals that most households feed and shelter the resistance. Sava, on the Luscia side, tells you the Legion broke a rebel army at the Lauvel crossing ten days ago and that most of Luscia wanted what those rebels wanted: a republic in place of the emperor. The people are caught between goblin raids from the north and an empire squeezing harder as it slips. Iven records that truth while the player remains employed by the Empire; choosing whose sellsword you are belongs to the fork at Solis.

The Ambroni Empire and its capital Ambron in Elagos, Drent as a loosely held subject province, the Pebbles offshore, Luscia’s Lauvel valley and the neutral Elodi of East Suval all come from the existing lore in ../world-builder/azhora_lore. The Republican Coalition, the Legion, Corvan, Solis’s role, and the battle at the Lauvel are new campaign material. This arc changes the meaning of the existing errands without adding rebel battles or a resolved war; the allegiance choice is modeled in the campaign and reached in play only after the road. Existing checkpoints remain compatible; a save without a campaign loads with a fresh one.

Work and conversation along the road

Corvan's parcels lie east of the main road among the field walls. Each is a distinct pickup; returning them is a one-time exchange. The meadow encounter has its own retreat and retry behavior, so leaving its area does not keep later camp activities locked in combat.

Hollis's bridge still has a sound eastern walkway before the repair. Spending three sticks restores the damaged side as an actual walkable lane. If you have burned or broken all available wood, ask “I need sound wood for the repair.” Hollis supplies enough marked repair timber to bring your stack to three. This remains available while the accepted repair is unfinished, so spending the timber cannot strand the quest. Borrowing wood does not complete the repair for you.

The waymarkers on the Luscian road are reflective road stones. Restoring them uses no firewood or tinderbox. Iven serves at the Legion’s relay on the Luscia side: he copies the warning and the people's account, then returns the original. Filing it completes the campaign’s first chapter; the onward road west to the Moros is the second. The branch south-east toward Elod ends at Elod's shut gate.

All four road NPCs have optional conversations before and after their errands. Corvan talks about caravans and field mornings; Hollis explains river repairs and fishing; Sava describes tending a small working shrine; Iven explains how reports move along the road. These branches do not advance the main quests.

The woods around Tidehaven

Take the smaller signed paths off the Greenway. Each of these six places has an inspection prompt with F and a short entry under Woodland notes in the J journal. You can discover them in any order; they never replace the main tutorial objective.

Place What is there
Old Charcoal Hearth · western trail A cold charcoal mound, working shelter, stacked wood, and Tamsin's abandoned red-tied tool bundle.
The Bee Fold · east of the village A tended flower garden, old hives, a resting stool, and bees moving near their hives.
Stormfall Oak · eastern woods A large fallen oak, exposed roots, and a path left around the trunk. Its timber tag explains why the woodcutter left it standing as habitat.
Mosskeeper's Shrine · western woods Three mossy stones and a fallen wooden wayboard. Use one forest stick to fit a new peg and visibly set the board upright.
Fern Hollow · northern western trail A sheltered pocket of ferns with a sitting stone and a quiet woodland note.
Saltwind Lookout · western shore A coastal resting place with old fishing knots and a view back across the sheltered landing.

Tamsin, the woodcutter at the village's northwestern edge, wears a patched short apron, rolled sleeves, a faded red headcloth, and tied brown hair. Her idle pose includes a small tired shoulder roll. Speak with her about the work people do in these woods, or accept A working day interrupted: recover her tools from the charcoal hearth and return them for two cooked fish. You can find the bundle before meeting her. It is tracked in the optional errand, and the reward is given only once. Afterward she remembers who made it possible for her to work again.

The shrine repair is a separate small kindness, with no item reward or prerequisite quest. It spends a spare stick through the weapon system, preserving a partly worn branch if another remains. Tamsin notices the repair in later conversation. Her comments about an army timber levy add local pressure without giving away the later story reveal.

Between these places, 410 ground details—ferns, sorrel, pale flowers, violets, and mossy logs with small fungi—break up the forest floor. Three adult deer and a fawn browse and flee from an approaching traveler. Five woodland thrushes peck, look around, and hop through the leaf litter, then take short flights to clear ground when you approach. Eight butterflies move above flowers, six bees work the Bee Fold, and four dragonflies skim Willowmere. The existing squirrels still forage and climb. These animals are scenery, and the planting leaves paths, gathering spots, conversation approaches, and the goblin camp clear. Shared instanced geometry and distance culling keep this detail inexpensive; pausing also freezes the birds in flight.

Bramble Scout Camp

Follow the scraps of blue cloth along the eastern woodland trail to find a rough camp with two goblin lookouts and sacks stolen from Tidehaven. F lets you inspect it from the approach and decide whether to fight. You can scout the place earlier, but challenging the scouts becomes available after defeating the first three goblins on the Greenway. Simply walking past never starts this encounter.

Choose Challenge the two scouts when ready. The encounter uses the same readable attack tells, dodging, weapon wear, and forgiving retry as the main tutorial. You can retreat toward the Greenway and return later. After winning, press F at the marked sacks beyond the camp, then return the village supplies to Tamsin for three ripe pawpaws, awarded once. The supplies are tracked in the journal rather than taking a satchel slot. This errand does not advance the army assignment or change the original tutorial sequence.

Weapons, food, and campcraft

The traveler wears simple brown cloth and a patched cloak, without armor. His simple sword has 24 condition and deals 24 / 26 / 34 damage across its combo. Every landed strike costs one condition, including practice hits; misses cost none. At zero condition the sword cannot attack but remains owned and repairable.

Forest sticks are gatherable weapons and camp materials. Fourteen woodland pickup sites include four on the village side of the first ambush; further bundles lie along the new road. A stick has 6 condition, 80% sword reach, and a 14 / 16 / 20 combo. Breaking one consumes it and readies the next carried stick. Switching equipment preserves wear. Spending spare sticks on repairs or fire also preserves the partly worn stick while one remains.

Use F at a repair bench to restore carried weapons free of charge. There is one in Tidehaven, one at the Avrel clearing, one at the Caloss crossing and one at Sava's shrine. The satchel shows condition and provides Equip buttons; changing weapons waits until a swing or dodge has finished. A broken weapon never prevents dodging or retreat.

Lysa, squirrels, and pawpaws

Lysa lives beside the western village cottage and its outdoor kitchen. Bring her five acorns for one reusable tinderbox. Previously gathered acorns count, only five are consumed, and her favor is independent of the road tutorial. Afterward she remembers the kindness, becomes fond of you, and offers warmer conversation with light flirting. You can also ask about squirrels, acorn cookery, or forest fruit without accepting the favor.

Four tiny squirrels forage in Tidehaven's wood, flee faster than the traveler, climb real tree trunks, and perch on branches. There are 24 acorn pickups in six woodland pockets. The outer regions add 23 ambient animals: two flocks of sheep on the Moros, sheep on the Avrel farmsteads, bank birds at the bridge and at the ferry, and two rock hares in East Suval. Their bodies and articulated parts use three instanced meshes per flock, with distant groups paused and hidden. These critters add movement and character without blocking quests or becoming combat targets.

Drent's forest has 12 ripe pawpaws in six patches, with four available before the ambush, and additional fruit bundles along the road. Look beneath broad, drooping leaves and press F to gather. Open I, select Ripe pawpaws, and choose Eat for up to 25 health. Gathering saves food for later; full health preserves it. Eating requires an idle, living character and cannot revive defeat.

The fruit's habitat and appearance draw on National Park Service pawpaw ecology and NC State Extension's description. Its health effect is a game mechanic. Lysa's distinction between raw acorns and leached meal follows US Forest Service acorn food research; her dialogue supplies background, not a cooking recipe.

Fishing and cooking

Bran teaches fishing at Willowmere Pond, east of the forest road beyond Eren's watch. Hollis also teaches it at the Caloss and can lend a spare rod if you do not already have one. The marked riverbank is upstream of the bridge. The rod is reusable; repeat lessons do not duplicate it.

At either marked bank, press F to cast. Wait about three seconds for the float to dip and the A bite! Reel now prompt, then press F or click during the bite window. An early or late reel misses without a cost. Escape cancels. Each catch becomes one raw fish in the satchel.

Bring a tinderbox and two sticks to any of the five prepared fire rings. Light fire consumes the sticks and retains the tinderbox. A fire lasts 120 seconds of active play, pausing during conversations and menus. Cook one raw fish makes one cooked fish, which restores up to 40 health through its satchel Eat button. Raw fish cannot be eaten. Fishing and cooking do not advance the road quests.

The wider larder

Beyond pawpaws and cooked fish, the satchel knows 29 more foods drawn from Drent and its trade: forest foraging (wood sorrel, hazelnuts, bramble berries, honeycomb, dried venison), Tidehaven and Avrel kitchens (boiled eggs, oatcakes, Avrel apples, Lysa's acorn flatbread and honey cakes, rye loaf, ewe's cheese, smoked forest-hog sausage, roast duck, mutton pie), the Stills and the Pebbles (marsh samphire, oysters, salt shoal-fish, dressed crab, smoked eel, fish stew), and Legion rations and traders' goods (hardtack, salt pork, Elagosi smoked whitefish, Galan olives, Maroshi figs, Ovesian dried pears, Amod chestnuts, Narcoshi cheese). Each restores between 10 and 50 health under the same rules as fruit and fish, and each has its own satchel icon. Nothing in the world hands them out yet: they are defined in src/gameplay/inventory/consumables.js and src/gameplay/inventory/inventory.js, ready for vendors, rewards, and foraging sites. The sources follow the lore in world-builder/azhora_lore (Drent oysters and flat-water crab, the Pebbles' salted shoal catch, Avrel orchards, Amod chestnuts, Galan olives and figs, Narcoshi cheese).

Orris and the distant cape

Orris, the hooded doomsayer with a gnarled staff, stands near Lysa and also explains cooking. His optional warning introduces the dark lord of Cape Thalmagar without establishing a personal name or deeds. The cape lies far to the northwest of Drent, beyond the Oremindi, on the existing World Builder geography; the campaign’s orc arc leads toward it.

Orris introduces the cape as rumor rather than pointing to it on a chart. Cape Thalmagar now has normal revealable atlas lettering: learned country knowledge or the developer map override can show its name, while unexplored terrain stays behind ordinary fog. In the adventure it remains distant foreshadowing. The separate ghost-mode fortress study is available for inspection, but has no boss encounter or story route from Drent.

Adventure checkpoints

Saving is available from the first step ashore, including during the unfinished tutorial. Normal play saves at supported lesson and quest transitions, discoveries, gathering, favors, fishing/cooking events, repairs, and eating. You can also choose Save adventure in Pause. Use Continue on the next opening screen to resume the last checkpoint. Active fights, defeat, and testing overrides cannot overwrite it.

The desktop stores one slot at saves/road-checkpoint.json through the isolated Electron IPC bridge. It survives restarts and does not depend on the asset server's randomly assigned loopback port. Writes validate the checkpoint and replace the previous file only after the new data has been written. Storage failures are reported without stopping the game; automated smoke runs use an isolated memory slot.

A checkpoint restores:

  • First-shore lesson progress, including partial practice hits and dodges, plus ordered road quests, recovered parcels, waymarkers, the repaired bridge, and the cleared meadow encounter.
  • Satchel quantities, equipment selection, exact weapon wear, health, and a valid saved position.
  • Collected woodland acorns, sticks, and pawpaws; collected road supplies; discovered places and woodland journal notes.
  • Lysa's available, active, or completed favor; Tamsin's accepted/recovered/returned bundle state; the restored shrine board; and whether Orris's warning was heard.
  • The scouted, accepted, or cleared goblin camp, recovered village supplies, and their completed return to Tamsin. An unfinished camp fight resumes from its accepted errand, without saving a battle in progress.
  • Fishing instruction, catch history, and each campfire's remaining fuel at the time of the checkpoint.

The storage key and file keep their original road-checkpoint names. Older version-1 road saves remain compatible: missing woodland history starts from its default state while the already saved satchel and road progress remain intact. Current saves restore collected forage and completed acts without granting their items or rewards again. Ambient animal positions and a cast or battle in progress are not serialized. Fire timers pause in menus and ghost view; reopening resumes the fuel recorded at the last checkpoint.

Testing tools

Press F8, use the opening screen's testing button, or choose Testing tools from Pause. F8 also works from a defeat screen.

Quest playtests follows Hacks, grouped as Gold (main quests), Silver (side stories), then named quest-givers. The six gold cards cover the peninsula tutorial, the road to Nothom, the lost courier, the Moros muster, and both Solis branches; each stops after its selected stage. Silver cards run Glun's Drent investigation and the Republican introduction in Luscia (stopping after the briefing because the next local job is unfinished). The named character demos remain below. Each card starts a fresh isolated run; magic quests stop at the reward choice. Any key or click takes control, and P resumes the selected quest. Normal saved adventures remain unchanged.

Frontier command opens the first strategic prototype on the actual Isareos, Caricas and Yunethre hexes. Select the Imperial force, select the White Bridge, give a March order, then advance time. A meeting with the centaur raid pauses strategic time and offers a local battle. Orders save separately; returning restores your adventure. See the prototype guide.

Main story jumps offers Iven's satchel assignment, the Republican at the relay, and the Imperial recall decision.

General travel is visible directly in the panel. Go anywhere lists countries and named places from the world and searches for standable ground near each destination. Go to a point accepts coordinates such as -1050, 982 or stand-at:-806.1,-521,-1.57. Regional travel advances earlier main-road prerequisites as before.

Hacks is at the top, with the developer dragon, developer bat, fast developer horse and whole-map reveal. Older character jumps, individual location buttons, supplies, ordinary horses, and ghost view are removed from the panel.

The Developer dragon breathes fire with the attack control: hold LMB or R for a sustained jet, or tap for a short burst. Hold RMB and move the view to aim the dragon. Fire kills enemies and wildlife, burns trees, collapses small buildings and wooden props, and leaves brief ground fires and charred wreckage. Stone fortifications remain standing. Returning to the normal adventure restores the testing destruction. The dragon uses the existing flight controls, including Tab turbo and G to land.

npm run test:testing-tools checks the gold, silver and named playtests, repeatable resets, story jumps, travel controls, and hacks while verifying that the normal checkpoint is unchanged. npm run test:silver-autoplay plays both silver demos through ordinary movement, dialogue and combat. Review the panel with --smoke-test --review-views=testing-tools.

The TESTING SESSION badge identifies the override. Testing supplies and travel never overwrite the normal road checkpoint. Reopen the game and choose Continue to recover the normal saved road, or begin from the boat for a fresh playthrough.

Developer ghost view

Ghost view remains available through automated developer checks and review hooks, including npm run test:developer; it is no longer an F8 control. The current adventure pauses, and a translucent traveler becomes your spectator. Choose a region on the actual World Builder atlas, then use its Fly into button. All 131 authored region outlines are clickable. Scroll and drag to inspect the map, or use the Drent and Thalmagar focus buttons.

The four playable regions each carry their own pin on their own authored hexes: Drent, Luscia, the Moros Plain and East Suval. A separate schematic shows their order along the road. Tidehaven's exact place on Drent's coast is still provisional. Every region is tinted by its campaign difficulty level, with provisional levels labeled. Cape Thalmagar opens its own fortress prototype. Every other mapped region opens a Terrain survey · gameplay not built scene, using the authored region's hex layout and terrain categories. Survey elevations and scenery are illustrative. These visits do not imply that the whole continent has quests, settlements, or connected playable terrain.

Ghost control Action
WASD / arrows; Q / E Fly relative to the view; forward diagonals
Space / Ctrl Rise / descend
Shift / hold Tab Boost from the default 28 m/s to 100 m/s
Right mouse drag Look freely
Mouse wheel Adjust cruise speed from 6–120 m/s, with boost up to 360 m/s
M Open the atlas / resume flight
Escape Open the atlas, or dismiss it when a flight is available
F8 / Return to adventure Leave ghost mode and return to the paused traveler

Ghost visits do not move the ordinary player, grant supplies, complete quests, or write checkpoints. The separate scene is released when you leave it. Flight passes through scenery within generous inspection bounds.

The Cape Thalmagar study contains a basalt approach, dead forest, broken arches, drifting cinders, and fortress spires reaching 219.5 metres. It is a distant atmosphere and scale prototype, with no boss, combat encounter, allegiance choice, or ordinary route into it. The cape's region location comes from the authored atlas; the fortress and dark wasteland are new gameplay material, not a rewrite of the source map's terrain or existing Thalmagar lore.

Scope and lore provenance

The four playable regions are the authored Drent, Luscia, Moros Plain and East Suval hexes, laid out north-up at 56 m per hex, so the minimap, the compass and the world chart now agree with the atlas. Tidehaven, the Greenway and the woodland places keep their original layout, carried over as one piece onto Drent's east-facing coast. The chapters that use the Lauvel field, the Legion camp, Elod's border post and the town of Elod are designed in the campaign and placed as scenery here, but their quests, dialogue and encounters are unbuilt. Building interiors, a seamless continent, and Clashvergence's broader simulation systems are not implemented.

The chart marks where you are: a red marker follows the traveler, and Where I am centres on it. Bearings are true to the chart: today's hand-built road runs west-south-west across Drent toward Luscia, so the compass, the minimap (turned so north stays up) and the marker all agree (src/world/terrain/region-layout.js, LEGACY_ROAD_TRANSFORM). The planned rebuild of Drent, Luscia, the Moros Plain and East Suval on the atlas's own hex outlines is specified in docs/region-rebuild.md.

The journal atlas is an inked parchment chart generated from the developed World Builder map: the same hex geography, region borders and rivers, drawn with smoothed coastlines, a hatched sea, mountain, hill, forest, marsh and dune glyphs, calligraphic province names tilted along elongated provinces, ships, a compass rose and a cartouche. Cape Thalmagar is labeled when discovered or when developer map reveal is enabled. Zoom, pan and regional focus are unchanged. The minimap and the local trail charts use the same parchment-and-ink palette. The playable terrain is an authored interpretation of this opening locality, not a map-scale terrain conversion. Developer selection reuses the region polygon paths from that atlas. The documented game correction in src/world/terrain/game-atlas-adjustments.js assigns Tidehaven’s northeast bank to Drent and aligns the Tessen’s journal course with its real water; see docs/game-atlas-corrections.md.

The local trails chart and minimap read the playable world's existing roads, buildings, and landmarks. Shared water metadata copies the rendered shoreline, pond, and river outlines for those charts; it changes neither the world geometry nor the continental atlas.

assets/azhora-dev-regions.json contains 3,733 region-assigned hexes across 131 regions, exported read-only from azhora.wwmap. It uses the same pointy-top axial projection and source SHA-256 as the normal atlas. The checked-in export is based on b36c32babaf85213a93459c87eeabe79455268db714681f88444831a221588df. The developer loader rejects mismatched map and survey exports instead of silently combining different geography.

Existing sources were read from ../world-builder/ and ../../python/Clashvergence/. Key references are:

  • ../world-builder/azhora_lore/geography/regions/drent.md, luscia.md, elagos.md, moros.md, suval.md, peblos.md, pueth.md, amod.md, nesdor.md
  • ../world-builder/azhora_lore/geography/regions/izol.md
  • ../world-builder/azhora_lore/geography/regions/thalmagar.md
  • ../world-builder/azhora_lore/geography/regions/oremindi.md
  • ../world-builder/azhora_lore/geography/regions/north_azhora.md
  • ../world-builder/saved_maps/azhora.azmap and azhora.cmap.json
  • ../world-builder/map/resources/examples/azhora.wwmap, exported into the offline journal atlas.

The spelling Azhora, Drent, Luscia, Elagos, Izol, and Izolveth follows those files. Tidehaven, the Avrel clearing, the named local NPCs, ponds, roadside landmarks, errands, and dialogue are new connective material; the region shapes, names and neighbours are the authored atlas. They do not modify the source lore or claim to be previously established canon.

The first goblin encounter adapts the requested pacing of ../../cromonsters: a village introduction, audible warning, visible goblin arrivals, readable combat, and a forgiving retry. The bramble raiders and these particular encounters are original procedural creatures and scenes.

West Oremindi and the drowned capital

West Oremindi Mountains is now playable through F8's Go anywhere selector. Four mountain routes cross steep climbable country, sheltered conifer woods, coastal siege ruins and high wildlife habitat. Two goblin-held traverses are dangerous at early levels. Follow the southern approach and look for repaired stone passages to find Sevron; the ordinary map does not disclose the hidden city.

Press F at a passage to enter its dry galleries above a sea-level drowned dwarf city. Pale-skinned, red-eyed Night Elves inhabit the upper court. They shun sunlight and venture onto the surface only at night, unlike the woodland way of life of the wood elves, also called Day Elves. A covered garden arcade shelters Sevron's terrace tender while the plants retain their light well. These residents currently stay inside; scheduled surface travel is not yet implemented. A concealed inspection store contains coins that can only be recovered once. Discovery, the opened store and defeated threats persist; saves made inside return safely to the exterior entrance. Flooded lower districts remain visible ruins, without diving. The first entrance transition abstracts the descent through the mountain.

npm run test:west-oremindi covers geography, habitats, routes and interior state. npm run test:sevron:desktop checks the real scenery, approach and room traversal in an isolated native game. Add --fast-load to the launch command to exercise streamed region construction. See the design and build record.

Optional peninsula tutorial

After loading, Start tutorial begins the new Drent peninsula lessons; Start game skips fifteen game minutes to Glun's letter. Full/Fast loading remains independent. Learn Walking from Chris, Running and Cooking from Jojo, combat from Glun, Cartography from Bear, Swimming from Jess and Fishing from Ryan. Jojo's sandwich introduces the satchel. A real caught fish becomes your cooking lesson.

Walking, Running and Swimming improve through actual use. The peninsula exit opens after Glun signs your letter, starting Ed's arrival. Chris follows his own lessons and waits in Tidehaven until your sign-off. Swimming or flying out early triggers a visible, overwhelming creature encounter and returns you to training with your lessons and possessions intact. Existing saves keep their previous opening.

F8 > Quest playtests > Main quests > Peninsula tutorial plays the lessons automatically and stops at the letter. npm run test:peninsula runs the focused rules; npm run test:peninsula-native exercises the live tutorial and recovery. See the design and implementation record.

Dwarfland in the Baldro Mountains

For a guided introduction, use F8 > Quest playtests > Silver > Dwarfland. A Place at the Forge earns West Hold entry, walks into its underground city, and teaches repair-riveting, the first secret Dwarven Smithing specialization. Any key takes control; P resumes the focused quest, including inside the city. The playtest leaves your normal save unchanged. In a normal adventure, ask the western gatekeeper for a place at the forge; existing admitted visitors can ask the artisan directly. Further techniques and political branches are future arcs.

West and East Baldro Mountains are now playable. Each holds an independent dwarf city kingdom within the Dwarfland confederation. Short, broad gatekeepers and civic residents inhabit underground hearths, workshops and memorial halls beside abandoned homes. Earn entry separately: restore three western route cairns or three eastern drainage works, then report to that kingdom's gatekeeper.

Both regions include connected mountain paths, climbable rock faces, named tree species and persistent ground wildlife. Use F8 > Go Anywhere to visit either Baldro region. These first city districts are playable foundations; royal names, large city expansions and personal stories remain to be designed.

See the implementation record. Run npm run test:baldro for focused checks or npm run test:baldro:desktop for the isolated desktop admission, traversal and climbing playtest.

Startup performance

The desktop game caches the generated base terrain between launches. It checks the actual source and atlas inputs on every load, including renderer reloads, so editing the world automatically rebuilds the cache. Missing, corrupt or unwritable caches fall back to normal generation. This cache is separate from adventure saves; browser builds work without it.

Loading now reports its current stage. Named human rigs are constructed when needed, regional wildlife loads nearby with separate load/unload distances, and the dwarven city interiors are built on first entry. Logical characters, animals, routes and quest progress remain present while their detailed visuals are absent. Full mode builds the complete outdoor world before play. At launch, Full is the first/default button and starts automatically after ten seconds; clicking it starts immediately. The second button selects experimental Fast mode for that launch only.

Fast prepares Drent first, then builds nearby terrain and scenery in cooperative batches while play continues. It favors the current region, its neighbors and the direction of travel; faster flight looks farther ahead. Explicit destinations interrupt background work at a safe yield. Unvisited distant regions stay queued, and loading sleeps when the nearby work is done. The indicator returns when travel wakes the queue. F8 jumps, Continue, ferries, quest travel and flight wait safely if their destination is unfinished. Shared builders can load several regions together.

The background budget is two milliseconds, reduced after slow frames; explicit travel waits allow eight milliseconds. Individual geometry operations and garbage collection can still exceed these budgets. Distant completed scenery is detached and its eligible GPU buffers released, then restored on return. CPU objects, collisions, terrain and gameplay changes remain in memory: this is not full CPU eviction. Fast reads a compatible terrain cache but never writes a partial one. See Fast loading locality for measurements and limits.

World metadata and quest state remain available throughout. Late trees preserve saved stumps, roads and collision queries see newly built objects, and elevated walkways join the live surface catalog. Switching loading modes does not reset an adventure or remember Fast as the next launch's default.

On this Windows 10 development machine (Core i5-10600K, 16 GiB RAM), the isolated native comparison on October 2, 2026 reached the initialized opening screen and two rendered frames in about 134 seconds before this pass, 85 seconds with an empty terrain cache, and 64 seconds on a cached reload. These are single-run desktop measurements, not frame-rate claims. Source edits deliberately invalidate the terrain cache. Static scenery construction was the main remaining startup cost before the experimental mode.

Run npm run profile:startup for an isolated native cold launch and cached reload, with JSON results under tests/artifacts/startup.json. It leaves the adventure save untouched. npm run test:startup checks cache invalidation, exact terrain and road-query behavior, loading choices, regional scheduling, and deferred visual lifecycles. Use node scripts/launch.cjs --smoke-test --fast-load-checks for actual Fast-mode travel, dwarf autoplay and whole-queue completion checks, or --load-choice-checks to validate and capture the startup chooser. All use isolated test saves.

Validation before the regional loading experiment: 34 startup tests and 61 save/checkpoint/Kayla tests passed. Native checks passed for both Baldro cities (49 assertions), the complete dwarf autoplay (31), and Willowmere character loading and fishing (39), with no renderer errors. The dwarf run included mid-lesson save/resume and a fresh repeat.

The original loading-mode pass passed 71 startup/scheduling/scenery tests and 59 save, woodcutting, walk-surface and road tests. The native chooser confirms the button order, ten-second countdown and successful Fast launch. An isolated Full run took 96.4 seconds cold and 67.2 seconds with a cache hit, with no renderer errors (tests/artifacts/loading-modes-full.json). The native Fast run reached its initialized opening in 14.8 seconds, then completed all 90 background jobs and made all 53 supported regions ready. Its 21 loading checks and 31 dwarf quest checks passed, including deferred travel, late collisions and walkways, saved progress, and a fresh quest repeat. The conservative background run took about twenty minutes to finish the remaining world while rendering continued; nearby regions and requested destinations become available earlier. These are single-run historical timings. Fast now intentionally leaves distant jobs pending; the exhaustive test explicitly requests the whole queue. Fast remains experimental.

Code and validation

New to the code? docs/codebase-map.md is a guided map of it: how the page, the host and the pure modules fit together, one module and its test read line by line, a tour by area, and an index of every file in src/.

Module Responsibility
src/content/regions/babon/babon-world.js, src/content/regions/babon/babon-ground.js, src/content/regions/babon/babon-scenery.js, src/content/regions/babon/babon-wildlife.js Babon's jungle ridges, ancient tropical trees, natural routes and island fauna (design and validation)
src/world.js, src/world/terrain/regions.js Terrain, regional layouts, paths, props, collision, fishing banks, landmarks, and completed-site visuals
src/app/startup/startup.js, scripts/terrain-cache.cjs, scripts/profile-startup.cjs Staged initialization, validated desktop terrain cache and isolated native cold/warm timing
src/world/loading/lazy-character.js, src/world/terrain/road-distance-index.js, src/world/terrain/terrain-point-cache.js, src/world/terrain/hex-boundary-distance.js Deferred human rigs and exact indexed/cached terrain queries
src/content/characters/characters.js Procedural traveler/NPC/goblin models, clothing, and articulated animation
src/gameplay/movement/game-state.js Movement, collision, and first-shore tutorial transitions
src/world/scenery/signs.js The one sign language: fingerposts, place boards, notice plaques, border stones and milestones from one lettering atlas
src/gameplay/skills/languages.js, src/gameplay/skills/language/linguist.js, src/gameplay/skills/word-frequency.js The fourteen tongues of Azhora and their dialects; what the traveler understands of what is said to him, and the commonest words of this game's own speech, which is the order he learns them in (docs/languages.md)
src/world/scenery/fortification.js, src/world/scenery/fortworks.js The shared fortification standard (wall, wall walk, towers, two gates, ditch) as a ground plan, and its drawing in timber or stone
src/content/regions/drent/outpost.js, src/content/regions/moros/moros-works.js The Ambroni outpost and the border stockade to that standard, the Moros gate and the Moros wayside
src/content/regions/minora-frontier/frontier.js, src/content/regions/minora-frontier/frontier-works.js, src/content/regions/minora-frontier/frontier-ridges.js, src/content/regions/minora-frontier/frontier-ridge-works.js, src/world/travel/closed-border.js Elod's closed frontier with Luscia, solid limestone ridges and guarded barred hill passes around East Suval, and the closed-region entry rule
src/world/scenery/places.js, src/world/scenery/place-works.js, src/content/quests/roadside/wayside.js, src/world/scenery/scenery-builder.js The built-up places of Drent and Luscia, the wayside on the empty roads, and the merged vertex-coloured builder they share
src/content/quests/rena/rena.js, src/content/quests/rena/rena-works.js, src/content/quests/rena/rena-people.js, src/content/quests/rena/rena-letters.js The three Renas: the razed town at Drent's centre, Applegarth to its west, the old road between them, their people, and the Ardrys' letters
src/world/life/town-life.js Townsfolk, the outpost's Legion and Coalition garrisons (staked through occupation.js), Elod's frontier guard and the figures on the walls
src/content/chapters/journey/journey.js, src/content/chapters/journey/journey-content.js Ordered road quests, rewards, versioned progress, and optional NPC dialogue
src/content/chapters/civil-war/campaign-world.js Campaign atlas: difficulty levels, factions, threats, settlements, transcript name aliases, hex adjacency and terrain summaries
src/content/chapters/civil-war/campaign.js The branching civil-war main quest: fork, battles with side-quest odds, regional arcs, trust and exposure, missions, map control, validated saves
src/gameplay/autoplay/autopilot.js, src/dev/checks/autoplay-smoke.js Autoplay: quest planner, trail-following navigation with collision probing and stall detours, combat policy, dialogue pacing; the rendered end-to-end check
src/content/quests/forest/forest-places.js, src/content/quests/forest/forest-story.js Six woodland places, optional Tamsin errand, shrine repair, journal notes, dialogue, and exactly-once rewards
src/world/life/forest-ecology.js Instanced understory plants, mossy logs, deer, foraging/fleeing thrushes, butterflies, bees, and dragonflies
src/content/quests/spider/spider-den-scenery.js Permanent thorn canopy, spiked bramble canes and web strands screening the spider's emergence in Ben's quest
src/world/terrain/nothom-thickets.js Varied bramble patches in the exact west and northwest Nothom hexes; roads and quest approaches stay clear
src/content/quests/homes/quest-homes.js Named Ambron homes, mailboxes, thresholds and porch approaches for Cagney, Ben and Troy
src/content/quests/homes/home-residents.js, src/content/quests/homes/home-resident-host.js, src/content/quests/homes/home-return-routes.js, src/content/quests/homes/home-ferry-view.js Saved independent walks home, ferry leg, indoor residents and knocking to ask them outside
src/dev/checks/home-residents-smoke.js Native reward-to-home, checkpoint and doorstep interaction checks (--homes-checks)
src/content/quests/forest/forest-hideout.js, src/content/quests/forest/forest-hideout-world.js, src/content/quests/forest/forest-hideout-watch.js Optional two-scout encounter, marked approach, camp and lookout props, stolen supplies, and Tamsin's one-time reward
src/world/life/woodland-life.js, src/content/regions/drent/road-life.js, src/content/regions/drent/road-verges.js Squirrels, forage, instanced regional animals, and small botanical patches
src/content/regions/drent/drent-wildlife.js, src/content/regions/drent/drent-birds.js Resident woodland animals and bird habitats across Drent; stable homes, local animation and distance culling
src/world/life/regional-wildlife.js, src/content/regions/western-regions/west-regions-life.js Regional animal habitats and shared instanced wildlife; West Suval has persistent ground-animal bands throughout its usable countryside, with Solis, road and quest-site exclusions
src/content/quests/forest/acorn-quest.js Lysa's atomic turn-in and relationship memory
src/gameplay/inventory/inventory.js, src/gameplay/combat/weapons.js, src/gameplay/inventory/consumables.js Satchel UI, item stacks, wear, equipment, repairs, and guarded food consumption
src/gameplay/skills/crafting/campcraft.js Fishing timing, catches, fire fuel, and cooking exchanges
src/gameplay/combat/combat.js, src/gameplay/combat/combat-view.js Deterministic encounters, stamina, tells, coordinated enemies, effects, and retry/retreat
src/world/environment/road-audio.js Optional local ambience, surface footfalls, nearby calls, and effects
src/app/saves/road-checkpoint.js, src/content/chapters/journey/woodland-progress.js Validated first-shore/road saves, woodland gathering/history, camp state, and legacy compatibility
src/ui/map/world-map.js, scripts/export-world-map.mjs Offline parchment chart generated from the World Builder map (coast, border and river chaining, terrain glyphs, tilted labels, uncharted names), zoom/pan/focus
src/ui/map/local-map-data.js, src/ui/map/trail-map.js, src/ui/map/minimap.js Read-only regional chart data, discovery-aware journal maps, optional pins, and the player-centered local minimap
src/dev/tools/developer-atlas.js, scripts/export-developer-atlas.mjs Exact atlas selection polygons, authored hex survey export, destination provenance, and schematic local route
src/dev/tools/developer-mode.js, src/dev/tools/ghost-camera.js Paused adventure isolation, developer controls, translucent spectator, free flight, atlas UI, and scene switching
src/content/regions/thalmagar/thalmagar-world.js, src/dev/tools/survey-world.js Separate fortress study and illustrative terrain survey scenes, with resource cleanup
src/main.js and the CSS files Renderer, input, camera, game flow, HUD, journals, and panels
main.cjs, preload.cjs, scripts/checkpoint-store.cjs Desktop window, local asset server, isolated IPC, and atomic disk checkpoint storage
src/dev/checks/road-smoke.js, src/world/travel/road-traversal.js, src/dev/checks/road-check-smoke.js Rendered gameplay, continuous walking, intermediate saves/reload, audio, and F8 checks
src/dev/checks/forest-smoke.js, src/dev/checks/developer-smoke.js Rendered woodland errands, saved forest state, developer flight, atlas selection, and scene-isolation checks
src/dev/checks/local-map-smoke.js Actual local-map controls, anonymous unexplored places, physical discovery, independent tracking, and adventure/save isolation
vendor/ Three.js 0.185.1 modules and MIT license

npm test runs the Node test suite for the campaign atlas and branching campaign, the autopilot planner and navigator, movement, ordered and optional quests, inventory, repair supplies, weapon condition, combat, campcraft, collectible reachability, ecology, audio lifecycle, checkpoint compatibility/storage failures, exact atlas selection, ghost flight, the Thalmagar scene, and local-map projection, discovery privacy, and rendering.

npm run test:game runs the actual renderer in an offscreen Electron window. It exercises the boat arrival, movement, dialogue, tutorial practice, defeat/retry, the tutorial and meadow battles, satchel tooltips and food, atlas navigation, Lysa's favor, forest campcraft, all three road quests, replacement bridge timber, river fishing, physical bridge traversal, checkpoints, and F8 travel. Enemy travel is shortened with test-only positioning while attacks still use normal input, timing, and damage. This is a correctness walkthrough, not a performance benchmark.

npm run test:autoplay starts autoplay on the opening screen and watches the computer play the whole road to Iven's relay at real walking speed, checking that no step teleports, that a synthetic key press cannot take control, and that a hand-over and resume work. It takes several minutes.

npm run test:road holds real movement controls for the complete northern road and return trip, checking collision and the final boundary. npm run test:checkpoints checks intermediate autosaves, actual WebAudio, testing from meadow defeat, and Continue in a fresh renderer. It restores an unfinished bridge quest while standing on the repaired deck. Both commands use the isolated test save slot.

npm run test:forest exercises the optional woodland trail, Tamsin's bundle, the shrine repair, journal notes, and a fresh-renderer reload of saved forest progress. npm run review:forest captures the six places, wildlife, and dialogue at desktop and compact sizes. The full story walkthrough has also passed with these forest additions in place.

npm run test:hideout exercises the optional goblin camp, its supply recovery and reward, and restoration of saved camp progress. npm run review:hideout captures the approach, camp, dialogue, and cleared state for visual review.

npm run test:local-map exercises L, the clickable minimap, all four regional charts, anonymous unexplored markers, physical woodland discovery, marking and clearing a known place, paused movement, and unchanged adventure/save data. It also checks that J and M retain their journey and World Builder behavior. npm run review:local-map captures the local charts and minimap at desktop and compact sizes.

npm run test:developer exercises atlas selection, local/Cape/survey visits, ghost movement and boost controls, return to the ordinary player, and isolation from saved progress. npm run review:developer captures the developer atlas and inspection scenes. These are correctness and visual checks, not claims that terrain surveys contain finished gameplay or that a target frame rate has been established.

The landscape keeps large static scenery batches local to each region, groups every region's trees, rocks and ground cover into small per-hex-block instanced batches, and divides the whole ground into 49 tiles sharing one vertex buffer. This preserves terrain resolution while letting the renderer skip ground and scenery behind the camera. Across twelve matched camera views, district batching submitted about 14% fewer triangles than the single-batch baseline for 11% more draw calls (tests/regions-world.test.js prints the totals). The rendered traversal of the whole road observed mean frame intervals of 21-26 ms per region (tests/artifacts/road-traversal.json). These are geometry, call and wall-clock observations, not an FPS benchmark.

For a fresh visual/culling comparison, run node scripts/launch.cjs --smoke-test --road-review, then add --unbatched-world for the baseline. Normal play always uses district batching. The comparison does not write a player checkpoint.

Focused native checks are available through npm run test:road-skills:desktop, test:fishing-lessons:desktop, test:fire-making:desktop, test:woodcutting:desktop, test:visual-arts:desktop, and test:ambush:desktop. They use real dialogue choices, interactions and frame updates; only player travel used to reach a test location is shortened.

The harness writes results and desktop/compact screenshots to tests/artifacts/. npm run test:window separately verifies native fullscreen coverage, F11/Alt+Enter toggles, and Escape behavior. After changing the source World Builder map, run both npm run map:refresh and npm run map:developer to regenerate matching normal-atlas and developer-survey assets. Neither export writes to the World Builder source.

Each test launch uses its own temporary Electron profile under tests/.electron-profiles/, removed when that test exits. Offscreen checks keep their saves in memory and do not share the normal game's Chromium cache.

The three coastal ferry hosts are Jess in Tidehaven, Hallie in Port Calos, and Maddie in Cobble. Each offers both other ports and a Swimming lesson; they remain residents of their home port. Port Calos is a five-building settlement on its single land hex, with the harbor extending to the water. npm run test:port-calos exercises all six crossings, lessons, and reloading at each destination.

Paradise Springs (Vaervelm Caelazh) occupies the land hex southeast of Port Calos, reached by a lane from town. Its three residents are Rob, KAT and MAT. KAT and MAT introduce the standalone Wine skill, as can Ben, Liz and Troy; Wine requires no Farming experience. Rob's viticulture lessons are a future Farming branch with a provisional level-5 requirement. His muted book-and-padlock marker shows when that prerequisite is unmet; his dialogue displays the player's level and clearly identifies the lessons as not yet available.

Liz now lives beside a small cottage, a working apiary with straw skeps and wooden hives, and a fenced flower-and-herb garden. Her original interaction point and Olive's return approach remain open.

Cagney and the Cagnappers is an optional escort west from Caelom's fork to Ambron. F8 includes a dedicated quest playtest; npm run test:cagney:autoplay checks the complete walk, ambush, and reward through ordinary game inputs.

The desktop icon is an abstract gold sun and winding coastal path over teal water. scripts/create-icon.ps1 generates its seven ICO sizes; scripts/create-desktop-shortcut.ps1 updates the shortcut without restarting a live game.

npm run test:winery checks the five Wine teachers through their actual dialogue buttons, Rob's Farming-gated viticulture placeholder and marker, the three-winemaker cast, and Catie's Port Calos greeting. src/content/regions/winery/winery-lessons.js keeps viticulture separate from the Wine skill.

Kayla and the Cobble character update

src/content/quests/kayla/kayla.js owns Kayla's persistent honey rounds and dialogue; kayla-host.js joins her ordinary resident health to her physical roaming and self-defense. kayla-character.js is her articulated brown-bear model. Her authored circuit visits Drent, Liz's clearing in Pueth, and Luscia; kayla-world.test.js walks the full route against real scenery and the initially broken Caloss bridge. npm run test:kayla checks her race invitation, peaceful refusal, combat, checkpoints and corpse restoration in an isolated Electron run.

Ari, Imani and Jesse now live in Port Calos. Ari retains her long black curls and violet dress; Jesse retains twelve hair colors and workshop clothing. Port residents await characterization. Troy's Cobble investigation now follows Brenna Vell, Orren Pell and Sivra Noll, preserving its clues and saved progress. Jess, Hallie (Port Calos) and Maddie (Cobble) wear nautical clothing and still operate the three-port ferry network.

Bear family quests

Kayla waits at Ambron's east gate for The Honey Race. Ride her along the Ossen road against Ed the Chameleon on his unicycle. Her unnamed cub offers A Cub's Share, a Stealth lesson at the Drent river crossing. Liz retaliates against a detected honey theft with ten bee swarms. The two bears resume their honey rounds only after both quests and their physical reunion.

F8 / Quest playtests includes separate Kayla and Bear cub autoplay cards. npm run test:bear-quests runs both real pilots, mounted and carrying checkpoints, reunion, bee damage, escape, and normal defeat recovery in an isolated save. The state machines live in kayla-race.js, cub-honey-quest.js, and bear-family.js; their hosts own movement and dialogue, while apiary-bees.js owns the NPC spell.

Suval vigilante and terrain

Catie in Port Calos offers A Kindness with Wings. A hidden highland cave leads to a peaceful two-minute scenic flight through South, West and East Suval, a first Flying lesson, or the opposing bounty from Officer Verradross. Landing reveals all 63 Suval hexes; the route does not visit every hex. The journey resumes from mid-flight checkpoints and finishes in northern West Suval; Batman then returns home. F8 Hacks ? Developer bat provides test-only free flight. F8 Quest playtests > Catie runs the peaceful search and complete carried tour; npm run test:catie:autoplay verifies the live demo.

West and South Suval now have tall ridges and switchbacks. Imlamdris is a ruined stone city with a small wooden rebuilding quarter; the ten Iscare islands have Zecron and settlement ruins plus wildlife. East Suval remains closed behind varied cliffs, walls, gates, and four false passages.

npm run test:batman runs focused Node checks; npm run test:batman:desktop exercises actual quest choices, flight, save/reload, the bounty, and the developer mount. See implementation and validation, terrain, residents and Cobble witnesses, and the Riding and Boating design draft.

Ari's sunflower garden

Ari now lives in Applegarth in western Drent, close to Stanley's Avrel farming area. Her green-book lesson teaches Farming: accept two sunflower seed packets, sow either garden bed, water it, wait ninety seconds of active play, harvest, then report to Ari. Plants grow visibly; watering and harvesting pay ordinary Farming XP and the report pays a single 24 XP bonus. The flowers and saved seeds are yours, and the beds stay usable. This does not consume Stanley's independent introduction. Lesson and bed state survive checkpoints, including older saves that predate the lesson.

ari-garden.js owns Ari's established appearance and positions; sunflower-lesson.js observes actual farming events. npm run test:sunflowers:desktop exercises the real dialogue and F-key garden menus, mid-growth and completed reloads, the green marker, and exactly-once rewards.

Ambron has a dedicated gold capital symbol and label on the journal map, plus its actual interlake city footprint at closer zoom. Ordinary exploration fog still applies.

Drent homes, trees and new lessons

Every ordinary forest tree is now registered by species and shares Woodcutting's harvest, visible felling, collision removal and saved regrowth. Kept fruit and garden trees and the sentient Old Tree have named species and explicit protection reasons. tree-registry.js links the instanced scenery to the sparse Woodcutting checkpoint.

Ari's sunflower quest has its own F8 computer autoplay card. Her Applegarth cottage has lavender trim, sunflower details and an Ari mailbox. Glun walks back to the training dummy after his Woodcutting lesson; Hacks is the first F8 section.

Ryan fishes and teaches Fishing at Willowmere beside Barrett, his and Jess's son. Barrett chooses one unknown region from the complete atlas when asked about geography; the chart gains its name/location and normal Cartography XP. The saved 120-second active-play cooldown prevents repeated or reloaded conversations from granting extra discoveries. Rip is their yellow family dog.

family-homes.js assigns the requested households and relationship dialogue; family-homes-scenery.js adds distinct decor and named mailboxes to existing cottages. Only Mark's cottage outside Tidehaven is a new building. These home assignments do not add interior routines.

Focused checks: node scripts/launch.cjs --smoke-test --ari-autoplay-checks completes the live planting, watering, growth and harvest quest; --willowmere-family-checks exercises Ryan's lesson and catch plus Barrett's dialogue, chart, cooldown and checkpoint reload. --glun-wood-checks checks the return to post and felling/restoring an ordinary forest tree. All use disposable profiles and isolated saves.

West Lotharn Mountains

West Lotharn is integrated into the main desktop build. In F8 testing tools, use Go anywhere > West Lotharn Mountains to arrive in the Long Valley. The developer dragon and bat can fly above the crest and land on safe summit ground.

The range has seven summits, forested limestone and sandstone ledges, two main valleys, four watercourses, and nine empty caves. Climbing, falling, the discovery map, and persistent wildlife use the same systems as the surrounding world. Its seven woodland species support ordinary woodcutting, visible felling, and saved regrowth. This terrain pass adds no people or settlements.

npm run test:northern-regions:desktop covers F8 travel to both Lotharn regions and Feradom, named trees and wildlife, cave entry/checkpoint recovery, and the live climbing controls. Focused geometry and traversal coverage lives in tests/west-lotharn-*.test.js. The integration and visual refinements are recorded in docs/west-lotharn-integration.md.

Pyra is now built across East and West Pyros: golden city walls, a river bridge, markets and quays, and an immaculate suspended palace reached by a walkable spiral staircase. Use F8 / Go anywhere and search for Pyra. Design and validation: docs/pyra.md; npm run test:pyra and npm run review:pyra.

About

Creating an adventure game with Codex and Claude Code

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages