BankZZ

ZZBank is a persistent storage mod for Hytale focused on clean in-game workflows. It adds personal banks, optional shared clan or guild banks, admin management tools, optional economy support, and audit history with dedicated UIs.

File Details

ZZbank.jar

  • R
  • Mar 22, 2026
  • 249.68 KB
  • 23
  • Early Access

File Name

ZZbank.jar

Supported Versions

  • Early Access

Main Changes In This Build

  • Added a full shared guild bank system with optional HyGuild / GuildPlugin compatibility.
  • Added dedicated audit UIs for both player banks and guild banks.
  • Expanded /bank admin so staff can manage both players and guild banks from the same workflow.
  • Improved guild detection and UI stability for real server use.

How Guild Banks Work In This Update

  • /guildbank now opens a separate guild bank dashboard instead of reusing the personal bank flow.
  • Each guild bank is stored by guildId, so every guild has its own independent persistent account.
  • Deposit and withdraw permissions follow the member's real guild rank.
  • /guildbank npc <player> [page] can open the guild bank that belongs to the target player's guild.
  • If HyGuild / GuildPlugin is not present, /guildbank stays disabled and explains why.

Relevant config:

  • guildBankEnabled
  • guildDefaultMaxPages
  • guildHardMaxPages
  • guildDepositMinRank
  • guildWithdrawMinRank

How Audit Works In This Update

  • Audit history now exists for both personal banks and guild banks.
  • The log tracks deposits, withdrawals, admin opens, NPC opens, and admin deletions.
  • /bank audit [player] [limit] opens a dedicated audit UI.
  • /guildbank audit [player] [limit] opens a dedicated guild audit UI.
  • Audit is no longer rendered as chat spam for these commands.

Audit storage:

  • audit/players/
  • audit/guilds/

Relevant config:

  • auditEnabled
  • auditMaxEntries

How The Admin Workflow Changed

  • /bank admin still opens the player bank directory.
  • Each player row now includes Open and Audit.
  • The admin panel now includes a Guilds button.
  • That button switches to a guild bank directory with the same Open and Audit actions used for players.
  • Staff can now browse known guild bank accounts without using separate commands for every case.

Important note:

  • the guild admin list shows known guild bank accounts, meaning guild banks that already have stored data

Technical / Stability Changes

  • Improved HyGuild detection so the mod can resolve GuildPlugin more reliably across different classloader situations.
  • Added safer UI close handling around player references to reduce invalid entity reference issues during dismiss/disconnect flows.
  • Guild bank admin access now uses a dedicated admin view instead of relying only on command-based access.

Storage Summary

  • player banks: accounts/
  • guild banks: guild-accounts/
  • player audit logs: audit/players/
  • guild audit logs: audit/guilds/

Quick Summary

  • Shared guild banks are now fully integrated.
  • Audit history is now visual and easier to review.
  • Admins can manage players and guild banks from one UI flow.
  • Guild support is more robust for live servers.