Skip to content

Latest commit

 

History

153 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Minecraft CityGen - Customizable AI City Generator

Minecraft CityGen app icon

Release 1.2.0 Minecraft >= 26.1.2

Turn your own Minecraft builds into an entire city.

Download Windows Installer (.exe) or Compressed Portable (.zip)

Rendering Result

Modern CityMedieval City
Modern City Medieval City

In-Game Result

Modern City Medieval City
Modern City Medieval City
Modern City Medieval City

Built-in Assets (Modern + Medieval)

Assets Overview Individual Asset
Modern built-in asset sheet Modern built-in assets animated preview
Medieval built-in asset sheet Medieval built-in assets animated preview

User Interface

Extraction Preview & Generation
UI Image 1 UI Image 2

Tutorial - Marking Your Own Assets

Minecraft CityGen builds cities from structures you mark up inside your own Minecraft world, using a handful of marker blocks.

For buildings, place:

  • a Gold block and a Diamond block at two opposite corners of each region you want captured.
  • an Emerald block horizontally adjacent to the bottom gold block to mark the authored ground level.

One gold/diamond pair creates a one-piece building. Three vertically aligned pairs with the same footprint create a stackable building with bottom, middle, and top pieces. Placement type is independent from layer count: type-1 controls repeatable city buildings, type-2 controls unique landmarks, and either type can be authored as a one-piece or three-piece asset. A sign above the emerald can set stack options.

You can tune any three-piece building with a sign directive above its emerald: stack: 3-7 — how many middle sections it may grow (min–max)

One-layer build marker convention

Three-layer build marker convention

The exact rules for roads and buildings are in the in-world asset conventions.

Technical Details

python -m pip install -e .
python -m pytest -q
pythonw application.pyw

Start at the source architecture overview, then follow the package guides: config, engine, pipeline, and gui. Releases follow the release guide.

AI Disclaimer

Every asset in this app was hand-built by the author, placed block by block, over a development period spanning 2017 to 2026. Code and implementation were developed with AI assistance from Claude Fable and GPT Astra.