Zombie Village 4.57.317 — release notes

What's new

• Friends & enemies. Mark other players with /zv friend add|remove|list <player> and /zv enemy add|remove|list <player>. Your villagers never attack your friends — even if a friend accidentally hits one — while unmarked strangers still get the usual retaliation.
• Marked enemies are fought for real. Defenders and Gate Guards attack a marked enemy on sight; every other villager joins in when the enemy comes within 16 blocks. Enemy status survives death and logout.
• Anti-ambush timer. Marking someone friend or enemy is announced to the whole server and takes effect after 10 seconds — no luring a guest into your village and flipping them to enemy for an instant execution. Removing a mark is instant (peace never lags) and cancels a pending change.
• Friends can use your Soul Well. Storage and Soul Crafting open for friends; breaking the well and the hub (wand sacrifice, gate management) stay owner-only.
• Friends HUD. A new "Friends" readout lists your online friends with a live direction dart — the arrow points the way to your friend relative to where you're facing, and fades out once they're within 20 blocks. Position sharing requires BOTH players to friend each other.

Fixed

• Any player could browse and withdraw a Soul Well's entire storage through a crafting table placed near it — the Soul Crafting screen now enforces the same owner-or-friend access as the storage screen; everyone else just gets a normal crafting table.
• Hoppers, pipes, and storage terminals could silently drain any Soul Well with no owner check. Direct automation against the well block is now closed; the Soul Interface remains the sanctioned automation surface.
• Outpost gatherers no longer break Lootr's per-player loot containers or loot minecarts (breaking one destroyed loot other players had not rolled yet). Vanilla structure-loot gathering is unchanged.

Under the hood

• New player-gated API (ZvSoulWellApi) replaces the open well capability for the Spells & Spellcrafting Reagent Pouch — pouch pulls now respect owner-or-friend access automatically.
• Friend positions sync at 4 Hz; relations are stored world-level and follow the owner even while offline.

Requires / compatible with

• Pair with Spells & Spellcrafting 2.12.61 (published together with this release). On the older SS, villager attacks against marked enemies deal zero damage (an SS-side bug fixed in 2.12.61) and Reagent Pouch pulls from wells no-op harmlessly.
• Freedom Lib and ZV-Houses requirements unchanged — no dependency floor bumps.
• Server and clients must update together: this release adds a required network channel, so pre-4.57.310 clients are refused at connect with a clear mismatch screen.

Migration notes

• Existing worlds carry over untouched; the friend/enemy lists start empty.
• Server owners: villager-vs-marked-enemy damage is mob-sourced, so it applies even with pvp=false — the vanilla flag only gates player-sourced damage. Enemy marking is opt-in per player, but worth knowing on no-PvP servers.