docs: the seeded worlds and World 1's pace, its switch from speed 1, the pacing line in the roadmap

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Fabian @ Blax Software 2026-11-03 12:14:21 +01:00
parent 153e7eb19d
commit 7f07c3242c
2 changed files with 9 additions and 1 deletions

View File

@ -177,6 +177,13 @@ A village may fail through war or bad play, but it must never get stuck. Every l
`config/game/world.php`, `economy.php`, `buildings.php`, `units.php`, `combat.php`, `market.php` and the rest of `config/game/` hold the defaults. `worlds.config` (JSON) overrides any key, the way Die Stämme world settings do: speed, unit speed, morale, night bonus, beginner protection, map size, builders, refund rate, building space, staffing k, starvation grace, noble rules, and so on. `WorldConfig` merges the two and is the only reader. `config/game/world.php`, `economy.php`, `buildings.php`, `units.php`, `combat.php`, `market.php` and the rest of `config/game/` hold the defaults. `worlds.config` (JSON) overrides any key, the way Die Stämme world settings do: speed, unit speed, morale, night bonus, beginner protection, map size, builders, refund rate, building space, staffing k, starvation grace, noble rules, and so on. `WorldConfig` merges the two and is the only reader.
The seeded worlds are in `config/worlds.php`. `WorldSeeder` makes a world from there when it doesn't exist yet; a world that exists keeps its config.
- **World 1** runs at Die Stämme's classic pace: `{world: {speed: 4}, movement: {unit_speed: 0.5}}`. Building, production, recruiting and everything else at world speed run 4 times as fast, marches twice as fast (a spearman takes 9 minutes a field). Beginner protection, inactivity and raids stay in real time. A season's crowns come 7.5 real days after the start, and holding them takes 42 hours.
- The **dev world** runs at speed 100.
- The live World 1 ran at speed 1 until the migration `world_one_at_speed_four` set those two keys. It first settled every World 1 village at speed 1 (stock and loyalty), then set each food timer for the new rates, and moved `started_at` up so the world days already played stay played. Timers already set kept their times; only new ones run at speed 4.
- Feature tests seed World 1 at speed 1 (`tests/Pest.php`).
A building entry looks like this (numbers start TW-like): A building entry looks like this (numbers start TW-like):
```php ```php

View File

@ -9,7 +9,7 @@ Each milestone ends with tests green, `ConfigLint` green, and something playable
- [x] `WorldConfig` plus `config/game/world.php`, `economy.php`, `buildings.php`. Core set: headquarters, storage, farm, timber camp, clay pit, iron mine, hiding place, wall, rally point - [x] `WorldConfig` plus `config/game/world.php`, `economy.php`, `buildings.php`. Core set: headquarters, storage, farm, timber camp, clay pit, iron mine, hiding place, wall, rally point
- [x] `ConfigLint` with the lock checks from architecture.md - [x] `ConfigLint` with the lock checks from architecture.md
- [x] Migrations and models: worlds, players, villages, buildings, build_orders, game_events - [x] Migrations and models: worlds, players, villages, buildings, build_orders, game_events
- [x] Seeders: default world (speed 1) and dev world (speed 100) - [x] Seeders: default world (speed 4, armies at unit speed 0.5; speed 1 until the pacing change) and dev world (speed 100)
- [x] `Production` + `Settle` (base trickle, staffing curve, storage caps) with unit tests - [x] `Production` + `Settle` (base trickle, staffing curve, storage caps) with unit tests
- [x] `Population` (food budget, villagers, worker assignment by priority) with unit tests - [x] `Population` (food budget, villagers, worker assignment by priority) with unit tests
- [x] `BuildingRules` (cost, time, workers, output, instance_cost_factor, levels from 0) with unit tests - [x] `BuildingRules` (cost, time, workers, output, instance_cost_factor, levels from 0) with unit tests
@ -73,6 +73,7 @@ The world pushes back, so a world with few players is a game too: something thre
- [x] Scarce building space (5 per headquarters level instead of 20) and specialisation: a resource village produces more, a military village trains faster and defends better - [x] Scarce building space (5 per headquarters level instead of 20) and specialisation: a resource village produces more, a military village trains faster and defends better
- [x] Seasons: crown villages appear around 0|0 after some weeks; a player who holds most of them long enough wins the world, and the next world opens - [x] Seasons: crown villages appear around 0|0 after some weeks; a player who holds most of them long enough wins the world, and the next world opens
- [x] Lazarett: half of the own defenders who fall come back wounded into the hospital's beds and stand again after four hours - [x] Lazarett: half of the own defenders who fall come back wounded into the hospital's beds and stand again after four hours
- [x] Pacing like Die Stämme: build times from its formula and per-level table (10 s floor, 1.05 per HQ level), beginner protection in real days (5), World 1 at speed 4 with armies at unit speed 0.5
## M5: Trade and encounters ## M5: Trade and encounters