137 lines
8.0 KiB
Markdown
137 lines
8.0 KiB
Markdown
# 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.
|