game-village-politics-backend/docs/roadmap.md

5.8 KiB

Roadmap

Each milestone ends with tests green, ConfigLint green, and something playable in the 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
  • 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
  • ConfigLint with 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 tests
  • Population (food budget, villagers, worker assignment by priority) with unit tests
  • BuildingRules (cost, time, workers, output, instance_cost_factor, levels from 0) with unit tests
  • Building space (per-type space, village budget, reserved for queued builds, unique types) with unit tests (replaced the first tile grid)
  • BuildQueue (builders by HQ level, next unblocked order) with unit tests
  • Event engine: game_events, game:events worker, 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|staff and a village:updated push
  • UI: resource bar with projected values, population and food budget, building table with staffing, village as a low-poly isometric diorama (full width), build queue with builders and countdowns

M2: Map and barbarian villages

  • Spawn placement, like Die Stämme: the world starts at 0|0 (negative coordinates, DS continent names) and grows ring by ring with all villages at DS density; players pick a direction (random, NW, NE, SW, SE) and never land right next to another player
  • Barbarian villages come with the players: 1.3 per join on average, within a few fields of the new village, random levels; game:reset-world starts a world over
  • Barbarian growth over time (world config)
  • map.view {world_id, x, y, w, h} with village owner, points and continent; village points from building levels
  • UI: Die Stämme-style coordinate map with rulers, continent lines, 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); only these advanced buildings get requirements, e.g. academy needs headquarters + barracks
  • 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
  • CombatResolver and LootCalculator (wall, morale, luck, night bonus, hiding place, rams, catapults), with levied militia defending, with unit tests
  • Beginner protection
  • Reports: list, detail, unread count, delete
  • Incoming-attack push and UI: rally point screen, troop movements, support, incoming box and badge, send from the map

M4.5: Tribal Wars essentials

What Die Stämme has at this stage that the game still lacks.

  • Quest book: construction, army and village lines with goals and rewards; a reward for every building level reached the first time
  • Scouts: a scout unit, scouts meet scouts first, scouting reports (troops, resources, buildings)
  • Battle simulator at the rally point (CombatResolver over WS, nothing changes)
  • Troop templates at the rally point, "repeat attack" from a report
  • Rename villages
  • Player and village profile pages (from the map, reports and movements)
  • Ranking: players by points, villages by points, opponents defeated (attack and defence)
  • Messages between players (inbox, threads)
  • Notebook and account settings (vacation mode later)

M5: Trade and encounters

  • Market and merchants: caravans with optional escort and travel mode, food_deliveries and 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

Later: the rest of Die Stämme

  • Quests and a tutorial for new players
  • Smithy-style unit research, church, paladin with items (world options)
  • Scavenging (Raubzug) with idle troops
  • Bonus villages, awards and statistics
  • Tribe forum, mass messages, tribe ranking (with M6 tribes)

M7: City view and Steam

  • Richer diorama: more detail per building type and level tier, animations (the basic diorama shipped with M1)
  • Steam build check: static output wrapped in Electron or Tauri