Structure Encyclopedia

Structure Encyclopedia

Explore the world, unlock its ruins, and fill a leather-bound tome of discovery. Structure Encyclopedia turns structure visits into encyclopedia pages — lore, description, mobs, and notable loot — presented in a book-style GUI.

Features

• Unlock on visit — pages start locked (???). Stand inside a listed structure to unlock it.
• Open anytime — press K (configurable) or use the craftable encyclopedia item.
• Craftable book — Book + Compass + Amethyst Shard.
• Index & detail pages — paged grid of structure icons; open a page for lore, mobs, and loot (icons with hover names).
• Vanilla coverage — ships curated entries for many vanilla structures.
• Datapack extensible — other mods and datapacks can add or replace entries with no Java required.

How to play

1. Craft the Structure Encyclopedia (or grab it from the creative tab).
2. Open it with the item or the keybind.
3. Explore — when you enter a catalogued structure, an action-bar message confirms the unlock.
4. Return to the book to read the page.

For datapack & mod authors

Entries are ordinary datapack JSON. Anything under data/<namespace>/structure_encyclopedia/*.json is loaded on the server and synced to clients.

Adding a new structure

Create a new JSON file. The structure field must be the exact registry ID (from /locate structure or the structure registry), for example minecraft:desert_pyramid or yourmod:cool_dungeon.

{
  "structure": "yourmod:cool_dungeon",
  "icon": "minecraft:mossy_cobblestone",
  "sort_order": 200,
  "lore": "yourpack.entry.cool_dungeon.lore",
  "description": "yourpack.entry.cool_dungeon.desc",
  "mobs": ["minecraft:zombie", "minecraft:skeleton"],
  "loot_items": ["minecraft:diamond", "minecraft:emerald"],
  "loot_tables": ["yourmod:chests/cool_dungeon"],
  "tags": ["overworld", "dungeon"]
}

Field reference

Optional display name override (resource pack / mod lang file):

"structureencyclopedia.name.yourmod.cool_dungeon": "Cool Dungeon"

If that key is missing, the client falls back to the vanilla structure.<namespace>.<path> translation.

Overriding an existing entry

Pages are unique by structure ID — the book never shows two pages for the same structure.

• Recommended: replace the same resource path as the entry you want to change. Example — override this mod’s fortress page by shipping:
  data/structureencyclopedia/structure_encyclopedia/fortress.json
  in a datapack or mod jar that loads after Structure Encyclopedia. Minecraft keeps only the winning file for that path.
• Also valid: a different filename that still sets "structure": "minecraft:fortress". The loader keeps one entry per structure ID (you may see a duplicate warning in the log). Prefer same-path replaces when pack order matters.

Tips

• Look at the shipped vanilla JSON under data/structureencyclopedia/structure_encyclopedia/ for working examples.