Ancient Battle Arena - First Playable Setup
==========================================

REQUIREMENTS
------------
1. Spring/Recoil Engine (105.0 or newer recommended)
   Download from: https://springrts.com/wiki/Download

2. A map file (.sd7 or .sdz)
   - Download any Spring map, or use a flat test map
   - Place in Spring's maps folder

3. Placeholder models (see MODELS section below)


DIRECTORY STRUCTURE
-------------------
Place the 'game' folder contents into your Spring game directory:

  Spring/
    games/
      AncientBattleArena.sdd/    <- This is our 'game' folder renamed
        modinfo.lua
        modoptions.lua
        gamedata/
        LuaRules/
        LuaUI/
        unitdefs/
        weapons/
        scripts/
        objects3d/


MODELS REQUIRED
---------------
The game needs 3D models (.s3o files) for units to display.

OPTION A: Use placeholder from another Spring game
  1. Copy any simple .s3o model from BAR or Zero-K
  2. Rename to 'placeholder.s3o'
  3. Place in objects3d/ folder

OPTION B: Create simple primitives
  Use Upspring or other .s3o editor to create a simple box/sphere

OPTION C: Download test models
  The Spring community has test models available


TESTING WITHOUT MODELS
----------------------
The game may still load without models (units will be invisible or use
engine fallback). To verify systems work:

1. Launch Spring with the game selected
2. Start a game on any map
3. Check infolog.txt for gadget load messages
4. Units should auto-spawn (see 050_game_spawner.lua)


RUNNING THE GAME
----------------
Method 1: Spring Lobby (Recommended)
  1. Use SPADS, Chobby, or another Spring lobby
  2. Select "Ancient Battle Arena" as the game
  3. Select a map
  4. Start game

Method 2: Direct Launch
  spring.exe --game AncientBattleArena --map [MapName]

Method 3: pr-downloader test
  pr-downloader --filesystem-writepath . --game AncientBattleArena


VERIFYING SYSTEMS
-----------------
Check infolog.txt for these messages:

  [DeterminismGuard] Determinism guard active
  [UnitStats] Unit Stats Registry initialized
  [UnitStrength] Unit Strength System initialized
  [OrderState] Unit Order State system initialized
  [AbilitySystem] Ability System initialized
  [Combat] Unit Combat System initialized
  [Morale] Unit Morale System initialized
  [Routing] Unit Routing System initialized
  [EventLog] Event Log initialized
  [DesyncSig] Desync Signature system initialized
  [WinCondition] Win Condition gadget initialized
  [Spawner] Game Spawner initialized


TEST CHECKLIST
--------------
[ ] Game loads without Lua errors
[ ] Units spawn at game start
[ ] Units can be selected and moved
[ ] Melee units engage when close
[ ] Ranged units fire at distance
[ ] Morale drops during combat
[ ] Units route when morale is low
[ ] Desync signature prints every 5 seconds
[ ] Game ends when one team is eliminated


KNOWN ISSUES / TODO
-------------------
- No actual 3D models (need placeholder.s3o)
- Formation movement not implemented
- Ranged projectiles use engine system (visuals may be basic)
- UI panel is minimal
- No army composition screen (uses test spawner)


CONSOLE COMMANDS (during game)
------------------------------
/cheat                 - Enable cheats
/give infantry_swords  - Spawn a swordsmen unit
/give infantry_archers - Spawn an archers unit
/godmode               - Units don't take damage
