A video game where you play as a misaligned AI, deceiving and building power. An experiment in spec-driven development.
Rust 100%

README.md

Supervillain #

A roguelike game where you design and build your evil lair, then defend it against waves of invading heroes.

Gameplay #

You are the Overlord — a supervillain building an underground lair. The game alternates between two phases:

Build Phase #

  • Move with hjkl or arrow keys to explore your lair
  • Press b to enter Build Mode — place rooms, traps, and facilities
  • Press r to open the Research Menu — unlock new technologies
  • Press SPACE to start the next wave of heroes

Defend Phase #

  • Watch your traps and minions fight off invading heroes
  • Heroes pathfind toward your Throne Room — if they reach it, you take damage
  • If the Overlord's HP reaches 0, it's game over

Build Mode Controls #

Key Action
hjkl / arrows Move cursor
TAB Cycle build category
n / p Cycle item in category
SPACE Place selected tile
x Demolish tile (50% refund)
ESC Exit build mode

Buildings #

Building Cost Effect
Dig / Corridor 0 Carve through walls
Spike Trap 50g 15 damage to heroes
Fire Trap 100g 25 damage + splash (requires research)
Electric Trap 150g 10 damage + stun (requires research)
Gas Trap 120g 8 damage + poison DOT (requires research)
Guard Post 200g Spawns a minion defender
Barracks 200g +2 minion capacity
Armory 250g Upgrades minion damage (requires research)
Med Bay 180g Heals nearby minions (requires research)
Research Lab 300g Generates research points
Vault 150g Gold storage bonus
Power Core 250g Powers traps and facilities
Door 30g Heroes must break through

Hero Types #

Hero HP Dmg Special
Soldier 40 10 Basic unit
Ninja 25 15 Fast, detects traps
Tank 80 8 High HP, slow
Hacker 30 12 Can disable traps
Superhero 120 20 Boss-level, resists traps

Installation #

cd ~/code/supervillain
cargo build --release
./target/release/supervillain

Requirements #

  • Rust 1.70+ (uses 2024 edition)
  • A terminal with color support

Tips #

  • Build Power Cores first — traps don't work without power
  • Create chokepoints with traps along corridors
  • Guard Posts auto-spawn minions that fight heroes
  • Use Research Labs to unlock advanced traps and upgrades
  • Heroes get stronger each wave — plan ahead!