4.0 KiB
4.0 KiB
Roadmap
Each milestone ends with tests green, ConfigLint green, and something playable in the plain UI.
M1: Village, economy, buildings
- Backend scaffold: Laravel 13, Docker Compose with Traefik, MySQL, Redis, Pest, Sanctum, laravel-websockets
- Frontend scaffold: Nuxt 4, TS,
ssr: false, WS client, i18n (en), email + password login/register WorldConfigplusconfig/game/world.php,economy.php,buildings.php. Core set: headquarters, storage, farm, timber camp, clay pit, iron mine, hiding place, wall, rally pointConfigLintwith the lock checks from architecture.md- Migrations and models: worlds, players, villages, buildings, build_orders, game_events
- Seeders: default world (speed 1) and dev world (speed 100)
Production+Settle(base trickle, staffing curve, storage caps) with unit testsPopulation(food budget, villagers, worker assignment by priority) with unit testsBuildingRules(cost, time, workers, output, instance_cost_factor, levels from 0) with unit testsVillageGrid(per-type footprints, bounds, overlap, auto-place, unique types) with unit testsBuildQueue(builders by HQ level, next unblocked order) with unit tests- Event engine:
game_events,game:eventsworker, per-village catch-up, idempotent handlers - Actions: join world (HQ 0, storage 0, farm 0), build, upgrade, demolish with refund, cancel with refund, set priority. Feature tests with time travel
- WS controllers
village.show|build|upgrade|demolish|cancel|staffand avillage:updatedpush - UI: resource bar with projected values, population and food budget, building table with staffing, grid as a plain table of cells, build queue with builders and countdowns
M2: Map and barbarian villages
- Map generation and spawn placement
- Barbarian villages: seeding, optional growth over time (world config)
map.view {x, y, w, h}with village owner and points- UI: coordinate table map with jump-to and village info
M3: Units, upkeep, starvation
config/game/units.php: spear, sword, archer, light cav, heavy cav, ram, catapult, nobleman, with food upkeep- Barracks, stable, workshop, academy as building instances (several barracks run parallel recruit queues)
- Recruiting turns villagers into soldiers; lazy per-unit completion
- Levy: draft workers as militia, automatic return
- Starvation: zero-crossing event, grace timer, desertion order
- UI: recruit forms, troops overview, food balance warnings
M4: Attacks, combat, looting
TravelTime(slowest unit, distance, unit speed, travel mode) with unit tests- Travel modes from
movement.php; warning time from visibility and detection radius; watchtower - Send attack or support (host pays upkeep), send support home, recall, return trips
CombatResolverandLootCalculator(wall, morale, luck, hiding place, rams, catapults) with unit tests- Reports
- Incoming-attack push and UI
M5: Trade and encounters
- Market and merchants: caravans with optional escort and travel mode,
food_deliveriesand the 24h import average EncounterFinder(closest approach of two linear paths) with unit tests- Encounter events: field battles, caravan looting, skipping destroyed groups
- Barbarian ambushes with seeded RNG
- UI: trade form, caravan tracking, encounter reports
M6: Conquering, tribes, multiple villages
- Loyalty (lazy regeneration), noble drop per hit, conquest transfers the village
- Coins at the academy, rising noble cost per world config
- Tribes with ally/NAP/enemy relations, applied at encounter time
- Village switcher and overviews across villages
- Inactive villages turn barbarian; restart on the same world after losing every village
M7: City view
- Rendered village grid with sprites per building type and level (level 0 = tent, open storage, gatherers)
- Drag to place new buildings and move existing ones (server validates)
- Steam build check: static output wrapped in Electron or Tauri