Tome / Grimoire
Tome / Grimoire
Tome (formerly Grimoire) is a tool that generates detailed settlements in Minecraft using procedural generation techniques. It was created as a part of the Generative Design In Minecraft Competition (GDMC), a yearly contest where participants strive to create AI algorithms that create believable settlements within Minecraft.
Tome won second place in GDMC 2025, while its predecessor Grimoire won second place in GDMC 2024, accruing over 600 USD in prize money across both years.
The Stack
Tome is written in Rust, using HTTP requests to communicate via a Minecraft mod that allows it to read and write to the game world. It uses procedural techniques such as voronoi partitions, a* pathfinding, and constraint solvers to generate a settlement layout and populate it with buildings, roads, and decorations.
For Tome, we also use an LLM to write a chronicle, which is an optional challenge for GDMC entrants to generate books that tell the story of the settlement. To do this, I used the OpenAI API and fed it details about the settlement, such as surrounding biomes and buildings.
The previous version of Tome, Grimoire, was written in Python, leveraging a library created by the GDMC community to interface with the same HTTP mod. We rewrote the entire codebase in Rust not just for performance, but also to take advantage of Rust's excellent type system.
Gallery
