DragonVault Book of Dragons NBT & genetics catalog

Dragon Vault mod Forge 1.20.1 · Book of Dragons 1.31+

Capture your tamed dragon into a crystal, share the file, and let anyone summon and tame it.

⤓ dragonvault-1.20.1-2.0.1.jar 79.7 KB ⤓ genopull-1.20.1-1.2.1.jar 31.8 KB ⤓ genosync-1.20.1-1.1.1.jar 49.3 KB
dragonvault — client + server (needs Book of Dragons + AzureLib; optional on either side). genopull — server only, no deps: pulls new marking/palette packs from this site into BODGeneticsPacks/ every 24 h and announces them. genosync — client + server: syncs the server's pack folder to players and (1.1+) fixes Book of Dragons' 1 MiB login-sync limit by gzipping + chunking its genetics packet — required on both sides if you run the big palette packs. GenoPull 1.2+ carries the same server-side bridge for servers without GenoSync.

How it works

Summoning Crystal
4 amethyst shards around a glass block. Empty; hold it and run /dvault import <file> to load a downloaded .nbt from your <instance>/dragonvault/ folder (/dvault folder opens it, /dvault local lists it), then right-click the ground → the dragon appears untamed, tame it like a wild one.
Vault Crystal
Amethyst ×3 + ender pearl. Right-click a tamed dragon you own → it vanishes into the crystal and the .nbt is saved on your PC (<instance>/dragonvault/<name>_<date>.nbt) — nothing is kept on the server. Right-click the ground → re-emerges untamed.
Bonding Crystal
Same + gold. Whoever summons it becomes the owner. Servers can disable it (enableBondingCrystal=false).
Server controls
allowImport, importPermissionLevel, allowImportBind, stripItemsOnSummon, serverKeepsCaptureCopy. Admins also have /dragonvault summon|list|info for files in the server's own folder.
File format
gzip NBT { Format:1, Entity:{…}, Captured:{ By, Time, Species, Name, Bonding, Packs:[…], Textures:[…] } }. Packs/Textures record which genetics packs the dragon uses (from BODGeneticsPacks/) so this site can name third-party packs. Bare entity compounds are accepted too.
Config
config/dragonvault-common.toml: commandName, folder, summon/capture permission levels, requireOwnership, opsBypassOwnership, allowAnyTamable, enableBondingCrystal, crystalSummonEnabled, deleteFileOnCrystalSummon, keepCustomName, recordGeneticsPacks, extraStripKeys.

GenoPull (server auto-updater)

What
Checks /api/list?cat=marking&cat=palette on this site every 24 h (and ~60 s after each server start), downloads packs not already in BODGeneticsPacks/ (matched by sha1 or file name — silently skipped), sha1-verifies them, then broadcasts “# New genetics packs have been added to the server and will be available on the next restart!”. GenoSync ships them to clients.
Config
config/genopull-common.toml: catalogUrl (set to this site), intervalHours, categories, creatorFilter, announceMessage, redownloadDeleted, maxPackSizeMB…
Commands
/genopull check · /genopull status (op)

Icons are Dragon's Prophet dragon crystals (teal = Vault, purple = filled, gold = Bonding, red = filled Bonding).