Zombie Village 4.57.263 — release notes

Covers everything since 4.57.252 (the last CurseForge release): the Soul Well UX cluster plus component-aware storage.

What's new

• Distinct-item storage. The Soul Well storage now shows every item variant on its own row — each enchanted book, each differently-damaged tool, each filled shulker box is separate — so you can see and grab exactly the one you want instead of a random one of the type.
• Store shulker boxes, bundles, and backpacks in the Soul Well with their contents intact — shift-click them in; each shows its own inventory in the grid.
• Smooth scrolling storage. The storage screen is now one continuous scrolling list (mouse wheel or the scrollbar) instead of pages, always sorted alphabetically. Search still filters by item name.
• Deliberate wand upgrades. Sneak + empty-hand on a Soul Well opens its hub: drop a Spells & Spellcrafting Wand into the slot and press Confirm to raise the village's power tier. No more losing a wand to an accidental click — nothing is consumed until you confirm, and a weaker wand is handed straight back.
• Tethered gates live in the hub too — the same sneak + empty-hand menu lists your Soul Gates as clickable slots to teleport to.
• Soul Gate limit. A Soul Well is capped to 3 Soul Gates by default; a 4th placement is refused (and the gate item is not consumed, with a "3/3 — break one" message). Change the cap with /zv gatecap <n>.

Fixed

• Fixed the storage bug where picking up an item from a full, scrolled storage screen could hand you the wrong item — you now always get exactly what you clicked, even while villagers are depositing loot into the same well.
• A wand placed in the upgrade slot is returned if you close the screen without confirming — including on logout (it drops at your feet), so it can no longer be lost.

Under the hood

• Withdraw is component-aware (matches the exact item + NBT you clicked); the by-type paths the villager economy uses (salvage/cook/gather deposits and withdrawals) are unchanged.
• Storage ordering uses Minecraft's canonical NBT serializer so client and server agree byte-for-byte; per-stack key memoization keeps large stores cheap on every deposit.

Requires / compatible with

• Minecraft 1.21.1
• NeoForge 21.1.224+

All three sibling mods are REQUIRED — Zombie Village will not load without any of them:

• Freedom Lib 0.7.1+ (CF slug freedom)
• ZV-Houses 0.1.148+ (CF slug zvhouses)
• Spells & Spellcrafting 2.12.0+ (CF slug spells)

Migration notes

• None. Existing villages, storage contents, and wand tiers carry over untouched — the storage change is display/handling only; the backing save data is unchanged.