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

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

License

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

EconomyZZ

CoreZZ