premium banner

EconomyZZ

EconomyZZ is the ZZ ecosystem economy provider for Hytale. It combines a persistent ledger, player wallet, rewards and income flows, server buy/sell flows, audit tooling, and clan treasury support.

Description

What EconomyZZ Does

  • Provides player wallet balances, balance checks for other accounts, and transaction history.
  • Supports transfers between players and internal system accounts.
  • Provides reward flows such as daily reward, playtime income, and claimable milestones.
  • Provides server buying and server selling through dedicated visual flows.
  • Provides admin catalog management for buy and sell prices across game items.
  • Provides clan treasury flows with deposit, withdraw, history, and admin controls.
  • Registers itself as the economy provider inside ZZCore for the rest of the ecosystem.

Commands And Workflow

  • /economy is the root command and entry point.
  • Current subflows include balance, income, reward, buy, sell, transfer, history, treasury, and admin.
  • /economy buy opens the visual shop and /economy buy catalog opens the buy-catalog admin flow.
  • /economy sell hand and /economy sell all support quick selling.
  • /economy sell catalog opens the sell-catalog admin flow.

Runtime Files And Data

  • config.json stores currency, limits, ledger behavior, and module settings.
  • messages.json stores the editable localized text catalog.
  • sell-catalog.json stores server buyback prices for player selling.
  • buy-catalog.json stores server shop prices for player buying.
  • The module stores its runtime data under ZonaZeroMc/ZZEconomy.
  • data/ stores accounts, reward profiles, income profiles, and persisted transactions.
  • income/profiles/ stores online-minute progress, periodic income state, and claimed milestones.

Visible Config Example

This is the kind of config.json file you will see when the module generates its settings:

{
  "version": 3,
  "prefix": "&6[&eZZEconomy&6] &r",
  "language": "es-ES",
  "currencyCode": "ZZC",
  "currencyName": "ZZ Credits",
  "currencySymbol": "Z$",
  "precision": 2,
  "playerStartingBalance": 250.0,
  "organizationStartingBalance": 0.0,
  "allowNegativeBalances": false,
  "maxTransactionAmount": 1000000.0,
  "playerTransferFeePercent": 0.0,
  "clanTreasuryFeePercent": 0.0,
  "auditEnabled": true,
  "allowConsoleCommands": true,
  "enableClanTreasury": true,
  "enableBankIntegration": true,
  "enableKitCosts": true,
  "enableDailyRewards": true,
  "dailyRewardAmount": 50.0,
  "dailyRewardCooldownHours": 24,
  "dailyRewardGraceHours": 24,
  "dailyRewardStreakBonusPercent": 10.0,
  "dailyRewardMaxStreak": 7,
  "enablePlaytimeIncome": true,
  "playtimeIncomeAmount": 20.0,
  "playtimeIncomeIntervalMinutes": 20,
  "playtimeIncomeDailyCap": 240.0,
  "enablePlaytimeMilestones": true,
  "playtimeMilestoneRewards": "15=15,30=35,60=80,120=175,240=400,480=900",
  "notifyClaimableMilestonesOnJoin": true,
  "enableServerSell": true,
  "enableServerBuy": true,
  "enablePlayerMarket": true,
  "playerMarketFeePercent": 2.0,
  "playerMarketListingLimit": 60,
  "playerMarketMaxListingsPerPlayer": 12,
  "serverSellFeePercent": 5.0,
  "sellPreviewLimit": 24,
  "sellFromStorage": true,
  "sellFromHotbar": true,
  "sellFromBackpack": true,
  "sellFromUtility": false,
  "sellFromTools": false,
  "sellFromArmor": false,
  "clanDepositPermission": "bank_deposit",
  "clanWithdrawPermission": "bank_withdraw",
  "clanAdminPermission": "manage_bank",
  "clanOwnerBypass": true,
  "historyLimit": 48,
  "auditPreviewLimit": 64,
  "transferRateLimitSeconds": 3,
  "maxMetadataEntries": 16,
  "recordFailedOperations": true,
  "allowAdminSetBalance": true,
  "allowReverseTransactions": true,
  "showSystemAccountsInAdmin": true
}

The section below explains what each line changes in normal language.

Configuration Reference

Currency And Ledger

  • version (number): internal config schema version.
  • prefix (text): chat prefix used by the module.
  • language (text): runtime language code.
  • currencyCode (text): short code such as ZZC.
  • currencyName (text): display currency name.
  • currencySymbol (text): symbol shown in UI and messages.
  • precision (number): decimal precision for amounts.
  • playerStartingBalance (number): starting balance for new player accounts.
  • organizationStartingBalance (number): starting balance for new organization accounts.
  • allowNegativeBalances (true/false): allows negative balances when enabled.
  • maxTransactionAmount (number): hard cap for one transaction.
  • playerTransferFeePercent (number): fee applied to player transfers.
  • clanTreasuryFeePercent (number): fee applied to clan treasury operations.
  • auditEnabled (true/false): turns economy audit on or off.
  • allowConsoleCommands (true/false): allows console flows when enabled.

Ecosystem Integrations

  • enableClanTreasury (true/false): enables clan treasury flows.
  • enableBankIntegration (true/false): enables bank-related economy integration.
  • enableKitCosts (true/false): enables kit cost integration.

Daily Reward Settings

  • enableDailyRewards (true/false): enables or disables the daily reward.
  • dailyRewardAmount (number): base daily reward amount.
  • dailyRewardCooldownHours (number): hours before the next daily reward claim.
  • dailyRewardGraceHours (number): grace period before streak loss.
  • dailyRewardStreakBonusPercent (number): percent bonus applied by streak.
  • dailyRewardMaxStreak (number): max streak counted by the module.

Playtime Income And Milestones

  • enablePlaytimeIncome (true/false): enables periodic income for time played.
  • playtimeIncomeAmount (number): amount paid each interval.
  • playtimeIncomeIntervalMinutes (number): interval between playtime payouts.
  • playtimeIncomeDailyCap (number): max playtime income per day.
  • enablePlaytimeMilestones (true/false): enables milestone rewards.
  • playtimeMilestoneRewards (text): milestone map in minutes=reward format.
  • notifyClaimableMilestonesOnJoin (true/false): notifies players on join when claimable milestones exist.

Market And Server Trading

  • enableServerSell (true/false): enables player selling to the server.
  • enableServerBuy (true/false): enables server shop buying.
  • enablePlayerMarket (true/false): enables the player market flow.
  • playerMarketFeePercent (number): fee percent for the player market.
  • playerMarketListingLimit (number): max total listings tracked by the player market flow.
  • playerMarketMaxListingsPerPlayer (number): max listings per player.
  • serverSellFeePercent (number): fee percent applied on server sell.
  • sellPreviewLimit (number): max preview entries shown in sell flows.
  • sellFromStorage (true/false): allows selling from storage slots.
  • sellFromHotbar (true/false): allows selling from hotbar slots.
  • sellFromBackpack (true/false): allows selling from backpack slots.
  • sellFromUtility (true/false): allows selling from utility slots.
  • sellFromTools (true/false): allows selling from tool slots.
  • sellFromArmor (true/false): allows selling from armor slots.

Clan Treasury Permission Mapping

  • clanDepositPermission (text): organization permission used for treasury deposits.
  • clanWithdrawPermission (text): organization permission used for treasury withdrawals.
  • clanAdminPermission (text): organization permission used for treasury admin control.
  • clanOwnerBypass (true/false): lets the clan owner bypass those checks when enabled.

History, Limits, And Admin Safety

  • historyLimit (number): max history entries shown in normal history flows.
  • auditPreviewLimit (number): max preview entries shown in audit flows.
  • transferRateLimitSeconds (number): anti-spam rate limit for transfers.
  • maxMetadataEntries (number): max metadata entries stored per transaction.
  • recordFailedOperations (true/false): records failed operations when enabled.
  • allowAdminSetBalance (true/false): enables direct balance set actions for admins.
  • allowReverseTransactions (true/false): enables supported transaction reversal flows.
  • showSystemAccountsInAdmin (true/false): shows system accounts in admin views.

Permissions

  • Base access: zzeconomy.use
  • Player flows: zzeconomy.balance, zzeconomy.transfer, zzeconomy.reward, zzeconomy.buy, zzeconomy.sell, zzeconomy.history
  • Clan treasury: zzeconomy.clan.*
  • Admin and audit: zzeconomy.admin.*, zzeconomy.audit, zzeconomy.reload

Installation

  1. Copy ZZCore.jar into the server mods folder first.
  2. Copy ZZEconomy.jar into the same server mods folder after that.
  3. If you want clan treasury flows through the ecosystem social provider, also install ZZClan.jar.
  4. Start Hytale.
  5. Configure currency, catalog prices, reward flows, and permission groups.

License

All Rights Reserved.

Redistribution, reposting, resale edits, or reuploading forks is not allowed without written permission from the author.