How simhacker/micropolis works
Micropolis is a city-building simulation distributed here as several historical implementations and interfaces. The principal workflow is a player opening a client, issuing city-building or simulation commands, and viewing the resulting city state. The newer MicropolisCore separates simulation, Python-facing engines, and tile rendering; the repository also contains a Java desktop client, Python/GTK and TurboGears frontends, and the legacy Tcl/Tk activity. Several legacy links are documented only at a high level, so those relationships are dashed and uncited.
Main entry points: micropolisgenericengine.py Python Engine · micropolisturbogearsengine.py Web Game Engine · controllers.py Web Controller · micropolisrobot.py City Robots
Components 23
City Simulation
- City Engine
MicropolisCore/src/MicropolisEngine/src/micropolis.cpp - Simulation Rules
MicropolisCore/src/MicropolisEngine/src/simulate.cpp - Map State
MicropolisCore/src/MicropolisEngine/src/map.cpp - Tile Renderer
MicropolisCore/src/TileEngine/src/tileengine.cpp
Python Clients
- Python Engine
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisgenericengine.py - City Zones
MicropolisCore/src/pyMicropolis/micropolisEngine/micropoliszone.py - City Robots
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisrobot.py - City Tools
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolistool.py - GTK Frontend
MicropolisCore/src/pyMicropolis/gtkFrontend/main.py - GTK Views
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisgtkengine.py - Cell Automata
MicropolisCore/src/CellEngine/src/cellengine.cpp - Cell Interface
MicropolisCore/src/pyMicropolis/cellEngine/cellengine.py
Web Game
- Web Client
turbogears/micropolis/htdocs/static/javascript/micropolis.js - Web Controller
turbogears/micropolis/controllers.py - Web Game Engine
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisturbogearsengine.py - City Persistence
turbogears/micropolis/model.py
Java Client
- Desktop Entry
micropolis-java/src/micropolisj/Main.java - Desktop Window
micropolis-java/src/micropolisj/gui/MainWindow.java - Java Simulation
micropolis-java/src/micropolisj/engine/Micropolis.java
Legacy Activity
- Tcl/Tk Interface
micropolis-activity/src/tclx/tkucbsrc/main.c - Legacy Simulator
micropolis-activity/src/sim/sim.c - Activity Shell
micropolis-activity/micropolisactivity.py
Other components
- Player
Connections 23
- Player → GTK Frontend: opens
- GTK Frontend → GTK Views: starts
- GTK Views → Python Engine: uses
- Python Engine → City Zones: creates zones
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisgenericengine.py - Python Engine → Tile Renderer: renders tiles
- Python Engine → City Engine: extends engine
- Python Engine → City Robots: simulates robots
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisgenericengine.py - City Zones → City Robots: uses tools
MicropolisCore/src/pyMicropolis/micropolisEngine/micropoliszone.py - Player → Cell Interface: interacts
- Cell Interface → Cell Automata: controls
- Player → Web Client: plays
- Web Client → Web Controller: sends commands
- Web Controller → Web Game Engine: creates sessions
turbogears/micropolis/controllers.py - Web Game Engine → Python Engine: inherits
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisturbogearsengine.py - Web Game Engine → City Robots: uses
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisturbogearsengine.py - Web Controller → City Persistence: queries
turbogears/micropolis/controllers.py - Web Game Engine → City Persistence: uses persistence
MicropolisCore/src/pyMicropolis/micropolisEngine/micropolisturbogearsengine.py - Player → Desktop Entry: launches
micropolis-java/src/micropolisj/Main.java - Desktop Entry → Desktop Window: opens window
micropolis-java/src/micropolisj/Main.java - Desktop Window → Java Simulation: uses
micropolis-java/src/micropolisj/gui/MainWindow.java - Player → Activity Shell: starts activity
- Activity Shell → Tcl/Tk Interface: launches
- Tcl/Tk Interface → Legacy Simulator: drives simulation