A two-player, turn-based military strategy game on a procedurally generated isometric map.

1. Overview
2. Download
3. Screenshots
4. Getting Started
5. LAN Multiplayer
6. Controls
7. Gameplay at a Glance
8. The Map
9. Turn System
10. Economy
11. Base Progression
12. Units
13. Unit Abilities
14. Structures
15. Combat
16. Capture Mechanics
17. Fog of War
18. Ruins (Scavenging)
19. Save & Load
20. HUD
21. Tech Stack
22. Developer Notes
23. Roadmap
24. License

Militopia is a hot-seat, 2-player strategy game where both players share the same machine and take alternating turns. Each player captures territory, manages an economy, builds structures, and deploys military units across Land, Sea, and Air domains — all with the goal of destroying every enemy base.

The game features a tactically deep combat system with Fog of War, base progression, unique unit abilities, and a procedurally generated isometric map powered by Simplex noise.

Grab the latest release from the Releases page.

Windows

1. Download and extract Militopia-v1.0.0-windows.zip
2. Open the roast folder
3. Double-click Militopia.exe

macOS (Apple Silicon)

1. Download and extract Militopia-v1.0.0-mac-arm64.zip
2. Right-click Militopia.app → Open
3. If blocked by Gatekeeper: System Settings → Privacy & Security → Open Anyway

Universal JAR

java -jar Militopia-v1.0.0-universal.jar

Screenshots coming soon.

Want to just play? See Download above.

• Java 8+ (or Java 17) installed and on your PATH.

Verify your Java installation:

java -version

git clone https://github.com/Hanzm10/Militopia.git
cd Militopia

# Windows
gradlew.bat lwjgl3:run

# macOS / Linux
./gradlew lwjgl3:run

# Cross-platform JAR (requires Java on target machine)
./gradlew lwjgl3:jar

# Standalone bundles (Java bundled — no install needed)
./gradlew lwjgl3:packageWinX64      # Windows
./gradlew lwjgl3:packageMacM1       # macOS Apple Silicon
./gradlew lwjgl3:packageMacX64      # macOS Intel
./gradlew lwjgl3:packageLinuxX64    # Linux

Output:

• JAR → lwjgl3/build/libs/
• Bundles → lwjgl3/build/construo/

Tip: On macOS you may need to run chmod +x gradlew once before the ./gradlew commands work.

Militopia supports LAN play — each player runs the game on their own machine on the same network.

1. Launch the game and select LAN from the main menu.
2. Configure your player name, game seed, and map mode.
3. Click Host Game — the lobby waits for a client to connect (TCP port 7777).
4. Once the client joins, the game starts automatically.

1. Launch the game and select LAN from the main menu.
2. Switch to the Join tab — hosts on the same network are auto-discovered via UDP broadcast.
3. Click Join next to a discovered host, or enter the host's IP address manually.
4. The host sends the initial game state and both players enter the game.

Note: In LAN mode each player sees only their own fog of war — there is no shared screen like hot-seat.

• Bases (P1/P2) — One per player, placed in opposite quadrants. Capturable.
• Towns — Neutral structures; capture them for +1 income/turn.
• Oil Reservoirs — Required tile for building an Oil Derrick.
• Ruins — Interactive tiles with randomized scavenging rewards.
• Trees — Can be cut down for +1 Funding. Provide +1 defense bonus.
• Cacti, Boulders — Aesthetic terrain objects.

Aesthetic fauna spawn around bases and during capture events:

• Horse — Grass tiles
• Deer — Near Trees
• Zebra — Sand tiles
• Fish — Water/Deep Water

Units can hunt animals for +3 Funding each.

1. The active player takes all their actions (move, attack, capture, build, summon).
2. They click "End Turn" when done.
3. A fade transition plays while the economy resolves and fog of war updates.
4. The camera snaps to the new player's base and gameplay continues.

Note: Income is not distributed on Turn 1 — the first round is free.

Each player has a Funding pool. At the start of each turn (after Turn 1), income from all owned structures is added.

Bases accumulate XP each turn and level up to unlock new units and structures.

• Natural Growth: 250 + (level - 1) × 10 XP/turn
• Structure Bonus: Each linked structure contributes additional XP/turn

Level 5 Super Unit: At Level 5, a choice popup appears letting the player select one super unit to unlock for that base (Juggernaut, Wraith/B2, or Submarine). One is spawned immediately.

A Level-Up popup appears on every promotion showing funding bonuses and newly unlocked content.

• Each unit may move once and act once (attack, capture, or use ability) per turn.
• After acting, a unit is grayed out and cannot act again that turn.
• All units reset at the start of the owner's turn.
• Units summoned this turn cannot act until the next turn (hasActed = true on spawn).

Cost — = Super units unlocked via Level 5 base promotion, not purchased directly.

Every unit has a unique special ability.

Structures are built within a base's border zone and linked to the parent base, contributing XP per turn.

Damage = ATK - DEF + terrain_bonus - range_penalty

• Attacking at maximum range incurs a −1 damage penalty.

• Move a unit onto an unowned or enemy Base/Town to trigger the capture menu.
• Capturing a Town converts it to a Base for the capturing player (+50 XP, income starts).
• Capturing an enemy Base transfers it fully (+250 XP). The base retains its current level.
• After capture, the capturing unit's hasActed = true.
• Capturing a base spawns wild animals in the surrounding area.

• Each player sees only tiles within the vision range of their own units and structures.
• Fog updates on every turn transition.
• Stealth/Cloak (Sniper Camouflage, Wraith/B2, Submarine) hides units even within enemy vision unless the enemy is within 1 tile or a Radar Station is in range.
• A Signal Jammer forces any unit inside its 4-tile radius to see only 1 tile.

When a unit stands on a Ruins tile, they can perform a Scavenge action (consumes the unit's turn). The ruins are permanently removed and a random reward is granted:

• Game state saves to JSON under saves/<gameName>_<seed>.json.
• Persisted data includes: seed, player names, turn count, XP, funding, map state, unit positions, and per-unit action flags (hasMoved, hasActed).
• Loading fully reconstructs all entities and preserves mid-turn action limits.

Set GameConfig.TESTING_MODE = true to disable action-per-turn enforcement — useful for rapidly testing combat and mechanics.

Militopia/
├── core/                   # All game logic
│   └── src/main/java/com/militopia/
│       ├── config/         # Static configs (unit stats, base levels, combat constants)
│       ├── components/     # Ashley ECS components
│       ├── systems/        # ECS systems (combat, fog, render, economy...)
│       ├── factories/      # Entity creation (UnitFactory, EntityFactory)
│       ├── screen/         # Screens (Menu, Game, NewGame, LoadGame, GameOver)
│       ├── managers/       # Asset, Audio, Save, Turn managers
│       └── data/           # Game state and save data models
├── lwjgl3/                 # Desktop launcher
├── assets/                 # Textures, sounds, fonts, skins
└── saves/                  # Runtime save files (auto-generated)

This project is a personal project. All rights reserved by the author unless otherwise stated.