World Simulator
A downloadable game for Windows
PLEASE NOTE: This is 100% generated by Claude Code.
WorldPlan - Procedural World Evolution Visualizer
A mesmerizing simulation where worlds are born, civilizations rise and fall, languages evolve, cultures bloom, and history unfolds before your eyes.
- **Procedural World Generation**: Terrain with tectonic plates, rivers, climate zones, and biomes
- **Civilization Simulation**: Nations form, expand, go to war, and collapse
- **Language Evolution**: Procedurally generated languages that diverge over time
- **Religion System**: Belief systems spread, evolve, and schism
- **Technology Progression**: From Stone Age through Modern era
- **Trade Routes**: Economic connections between settlements
- **Character System**: Rulers with dynasties, traits, and lineages
- **Historical Events**: Wars, plagues, golden ages, great works, and more
Download
Install instructions
## Installation
Note that you will have to tell Windows that it is safe to install this game.
### Requirements
- Python 3.10 or higher
- Windows, macOS, or Linux
## Controls
| Key | Action |
|-----|--------|
| **Mouse wheel** | Zoom in/out |
| **Middle drag / Arrows** | Pan the map |
| **Left click** | View tile details (nation, language, religion, etc.) |
| **Space** | Pause/Play simulation |
| **< >** (comma/period) | Decrease/Increase simulation speed |
| **1-9** | Change map mode |
| **N** | Generate new world |
| **Home** | Reset view |
| **ESC** | Close info panel / Quit |
## Map Modes
1. **Terrain** - Elevation, rivers, vegetation
2. **Biome** - Climate-based biome types
3. **Temperature** - Heat distribution
4. **Rainfall** - Precipitation levels
5. **Political** - Nation territories
6. **Language** - Language distribution
7. **Religion** - Religious spread
8. **Trade** - Trade routes and resources
9. **Population** - Settlement density
## Optional: AI-Generated Narratives
The game includes optional AI-powered narrative generation using OpenAI's API. This is **not required** - the game works perfectly fine without it using built-in template narratives.
If you want AI narratives:
1. Get an OpenAI API key from https://platform.openai.com
2. Set the environment variable before running:
**Windows (Command Prompt):**
```cmd
set OPENAI_API_KEY=your-api-key-here
python main.py
```
**Windows (PowerShell):**
```powershell
$env:OPENAI_API_KEY="your-api-key-here"
python main.py
```
**macOS/Linux:**
```bash
export OPENAI_API_KEY=your-api-key-here
python main.py
```
## Project Structure
```
worldpplan/
├── main.py # Entry point
├── config.py # Configuration settings
├── world/ # World generation (terrain, climate, rivers)
├── entities/ # Game entities (nations, populations, characters)
├── systems/ # Game systems (economy, religion, technology)
├── simulation/ # Simulation engine
├── visualization/ # Rendering and camera
└── generators/ # Name and flag generation
```
## Tips
- Start paused and explore the initial world before hitting Space to begin
- Click on territories to see detailed information about nations, rulers, languages, and religions
- Use different map modes to see various aspects of your world
- Higher simulation speeds (32x+) work best for watching long-term history unfold
- Each seed generates a unique world - share seeds with friends!
## License
MIT License - Feel free to modify and share!
