Chest Loot and Configuration

Chest Loot and Configuration

How structure loot works

Biblio uses NeoForge global loot modifiers. It adds books to a chest's generated loot without replacing the chest's normal items.

The built-in rules target vanilla 1.21.1 structure chest loot tables, including villages, strongholds, trial chambers, shipwrecks, ruins, temples, dungeons, mineshafts, ancient cities, bastions, Nether fortresses, End cities, woodland mansions, buried treasure, and other vanilla structure chests.

Chest group	Biblio rolls
Ordinary vanilla structure chest	1
Village chest	2–4
Stronghold library chest	6–10

These counts assume that at least one eligible physical volume remains enabled. The player's normal Luck attribute does not add bonus Biblio rolls to these injected pools.

Biome and location selection

Built-in loot uses Biblio's biome/location groups to choose appropriate work pools. A book's damaged condition also reflects where that copy was found—for example, waterlogged, salt-stained, frostbitten, smoke-stained, or sand-scoured where appropriate.

Village selection uses a 12:1 standard-to-pristine dispatch weight, giving a 1-in-13 pristine First Edition opportunity on each village Biblio roll.

When loot is generated

Minecraft does not reroll a container that has already generated its loot. After changing Biblio, its datapacks, or its settings, test with:

• newly generated structures, or
• containers whose loot has not yet been generated or opened.

Open the settings catalog

The settings menu requires permission level 2—the normal operator/cheats level.

/biblio
/biblio settings

In the menu:

• Left-click a shelf to open that catalog section.
• Right-click a shelf to toggle the entire section.
• A green strip means enabled, red means disabled, and amber means partially enabled.
• Changes are committed when the screen closes.

You can toggle a top-level collection, a genre or tradition, a work, a natural division, or a single physical volume.

Where settings are stored

Chest enable/disable choices are server-side world data. They default to all books enabled and persist with the world. Newly added catalog entries are enabled when older saved settings are loaded.

These choices are also respected by the tag-driven third-party loot integration API. If every volume matching an integration is disabled, that integration adds nothing.

Datapack reloads

Data-driven integration files are discovered during a server resource reload. After adding or changing an integration datapack, run:

/reload

Then test with an unopened target chest. See Data-Driven Loot Integration API.