Files
aeternalis/docs/MILESTONE-3.md
T

8.0 KiB
Raw Blame History

Milestone 3: terrain, movement, and gathering

Implemented for manual playtesting. Model rigs, equipment attachments, animation, sound, and arbitrary model uploads remain in milestone 4.5. Combat/mob editors remain milestone 4. Required build and Go checks remain; Playwright runs are deferred.

Terrain and movement

New worlds use generator 2: deeper hills/valleys and weighted forest, meadow, and highland regions. Meshes and authoritative movement use the same triangle heights. Forest resources provide denser tree cover. Resource models use the existing tree, ore, and herb presets. Caves, mountains, stacked spaces, collision against trees, fall damage, and animated jumping are not part of this slice.

Existing generator-1 worlds keep their heights, resource coordinates, and depleted IDs. Create a new world in Control to test the new terrain and resource spawning. An explored chunk's biome and resource layout are saved and kept across eviction, restart, and catalog publication. New definitions affect unexplored chunks in generator-2 worlds. Publishing content never relocates an already known node.

The camera starts closer (30). Space jumps, F attacks, E gathers, I opens inventory; movement remains WASD/arrows and mobile direction buttons. There is also a Jump button. Go owns jump velocity, gravity, and landing. Menus continue to block input.

Reusable gathering design

Control → Content now contains Gathering, Resources, Biomes, and Consumables tabs. Each follows the existing server-assigned IDs, preview, version check, audited publication, and retry-safe transaction path. Definitions are append-only.

Skills contain name, XP curve, and maximum level. Lumberjack, herbalist, and miner are initial definitions; adding a fourth profession needs no new gameplay branch. Resources select a skill, required level, yield, XP, gathering interval, respawn, model preset, density, and allowed biomes. They can yield wood/ore/herb or a new material named after the resource. Maximum generated nodes per chunk is 128 (plus the three arrival nodes). Selection order is bounded; a saturated chunk can omit later resource definitions. Density 0 disables procedural spawning.

Skill XP belongs to the character. The cost of each next level is baseXp + (currentLevel - 1) × xpPerLevel. Travel preserves earned XP; replacement starts at level 1 with zero XP. Legacy shared gathering XP stays available to existing title requirements; it is not copied into all three new professions.

Four modifier channels use the same flat-then-percent calculation as existing stats:

Modifier Base and use
Gathering level Earned skill level; floor/clamp the result to effective level 1–10,000
Gathering yield Existing final gather-rate stat, normally 100%; scales resource amount
Gathering speed 100%; final range 10–1,000%; interval = base seconds × 100 / final speed
Gathering XP Existing final XP-gain stat, normally 100%; scales profession XP

Modifiers can apply to every gathering skill or one selected skill. Equipment, earned titles, reusable effect sets, and consumables share these modifier channels. Earned levels and XP never change when a level bonus is equipped, used, or expired. Negative modifiers are supported. Yield retains the existing per-action cap and fractional roll; profession XP rounds down and grants nothing on failure. Character XP still uses its existing separate gathering reward and general XP-gain modifier.

Gathering currently resolves one attempt immediately when its server cooldown is ready; speed changes the interval between attempts. There is no hold-to-channel animation. Starting another node or changing gear cannot bypass the prior cooldown.

Control's full-stat inspection and the player's Character → Inspect all stats show base, flat, percent, final values, earned/effective levels, and effect expiry. Inventory also shows profession XP and remaining XP to the next level.

Risky gathering

The hard attempt ceiling is 20 levels above effective gathering level, including temporary level bonuses. Larger gaps are rejected without consuming an attempt or changing the node. Meeting the required level has no random failure in this pass.

For an under-level gap g from 1 through 20, initial balance.yaml tuning is:

Outcome Chance / consequence
Failure min(98%, 70% + 1.4% × g)
Node destruction, conditional on failure min(100%, 75% + 1% × g)
Negative effect, conditional on failure 65%
Negative consequence 2 × g direct health damage and 20 seconds of −40% gathering speed for that skill

At +20 this is 98% failure, with a 95% destruction chance on failure. Damage can kill and uses the existing permanent-death/corpse path. Failure grants no materials or XP. Destroyed nodes return after their configured respawn period; they are not deleted from the world's definition or moved elsewhere. All numbers except the 20-level ceiling are provisional tuning, not final balancing decisions.

Select a node to see authoritative risk and interval. A dangerous attempt first shows the risks and requires Gather again. Each completed attempt stops, including a failure that leaves the resource intact. No automatic repeated risky attempts.

Consumables and persistence

Control can create gathering consumables and grant them through Characters → Manage items and titles. A starter Gatherer's tonic gives +5 effective levels, +20% speed, and +20% profession XP to all skills for 120 seconds.

Players use a consumable from their bag. One stack item is consumed; same-source reuse refreshes duration instead of stacking another copy. Different sources combine. Effect values and absolute expiry are copied into the character, persisted with inventory consumption, and preserved on travel. Time offline still counts. Fatigue refreshes per skill. Active bonuses do not transfer to replacement lives. Corpse loot retains unused consumable items through the existing inventory path.

The future hub/housing XP policy and resurrection activation remain in their planned milestones. This slice does not enable either system or alter title-ledger ownership. No tested-capacity claim is increased.

Manual playtest

  1. Create a new world. Check hills/valleys, forest density, the closer camera, Space/mobile Jump, F attack, and movement across a chunk edge. Open a menu: jumping/movement should stop accepting input; Esc should close the focused menu.
  2. Gather the three arrival resources. Check that only the corresponding profession gains XP, the node disappears, and it returns after respawn. No second reward should come from a depleted node.
  3. In Control, create a gathering skill and resource with low difficulty, 2-second interval, short respawn, and a matching biome. Choose its own material output. Explore previously unvisited chunks of a new-generation world to find it.
  4. Create equipment with skill-specific level/yield/speed/XP modifiers; grant and equip it. Inspect base/final values in Control. Unequip: effective bonuses should disappear while earned XP and levels remain unchanged.
  5. Grant and use a tonic. Check its consumption, expiry, same-source refresh, persistence after reconnect, and that only owned consumables have a Use button.
  6. With a disposable test character, inspect a level-15 resource at low skill. Check the second-press risk flow, failure messages, damage/fatigue, and depletion. Create a level-22 resource: effective level 1 must be rejected. A +1 level bonus should make that +20 gap attemptable. A lethal failure must leave one corpse.
  7. Restart a world after depleting a node and consuming a tonic. Check unchanged node locations, depletion deadline, remaining items, skill XP, and effect expiry. Survive/travel to another world: skill XP stays; replacing a dead character resets it.

Server coverage includes new-definition publication/replay, invalid scope rejection, scoped bonuses, consumption/expiry, risk limits, lethal failure, replacement, daily cap, survivor import, jump landing, and layout persistence/legacy terrain.