经济

EconomyZZ 功能概述

• 提供玩家钱包余额、其他账户余额查询以及交易历史记录。
• 支持玩家之间以及玩家与内部系统账户之间的转账。
• 提供奖励流程，例如每日奖励、游戏时间收入和可领取的里程碑奖励。
• 通过专用可视化流程提供服务器购买和服务器出售功能。
• 提供管理员目录管理，用于管理游戏物品的买入和卖出价格。
• 提供部落金库流程，包括存款、取款、历史记录和管理员控制。
• 在 ZZCore 生态系统中注册自身为经济提供者。

命令与工作流程

• /economy 是根命令和入口点。
• 当前子流程包括余额、收入、奖励、购买、出售、转账、历史记录、金库和管理员。
• /economy buy 打开可视化商店，/economy buy catalog 打开购买目录管理流程。
• /economy sell hand 和 /economy sell all 支持快速出售。
• /economy sell catalog 打开出售目录管理流程。

运行时文件与数据

• config.json 存储货币、限额、账本行为及模块设置。
• messages.json 存储可编辑的本地化文本目录。
• sell-catalog.json 存储玩家出售给服务器的服务器回购价格。
• buy-catalog.json 存储玩家从服务器商店购买的价格。
• 模块的运行时数据存储在 ZonaZeroMc/ZZEconomy 下。
• data/ 存储账户、奖励档案、收入档案和持久化交易记录。
• income/profiles/ 存储在线分钟进度、周期性收入状态和已领取的里程碑。

可视配置示例

这是模块生成设置时你将看到的 config.json 文件类型：

{
  "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
}

以下部分将以平实的语言解释每一行配置更改所对应的含义。

配置参考

货币与账本

• version (数字): 内部配置模式版本。
• prefix (文本): 模块使用的聊天前缀。
• language (文本): 运行时语言代码。
• currencyCode (文本): 货币短代码，例如 ZZC。
• currencyName (文本): 显示的货币名称。
• currencySymbol (文本): 界面和消息中显示的货币符号。
• precision (数字): 金额的小数精度。
• playerStartingBalance (数字): 新玩家账户的初始余额。
• organizationStartingBalance (数字): 新组织账户的初始余额。
• allowNegativeBalances (是/否): 启用后允许负余额。
• maxTransactionAmount (数字): 单笔交易的硬性上限。
• playerTransferFeePercent (数字): 玩家转账时收取的手续费比例。
• clanTreasuryFeePercent (数字): 部落金库操作时收取的手续费比例。
• auditEnabled (是/否): 打开或关闭经济审计功能。
• allowConsoleCommands (是/否): 启用后允许控制台流程。

生态系统集成

• enableClanTreasury (是/否): 启用部落金库流程。
• enableBankIntegration (是/否): 启用与银行相关的经济集成。
• enableKitCosts (是/否): 启用套装（Kit）成本集成。

每日奖励设置

• enableDailyRewards (是/否): 启用或禁用每日奖励。
• dailyRewardAmount (数字): 每日奖励的基础金额。
• dailyRewardCooldownHours (数字): 领取下次每日奖励前需要等待的小时数。
• dailyRewardGraceHours (数字): 连续天数中断前的宽限期。
• dailyRewardStreakBonusPercent (数字): 连续登录提供的百分比奖励。
• dailyRewardMaxStreak (数字): 模块计算的最大连续天数。

游戏时间收入与里程碑

• enablePlaytimeIncome (是/否): 为游戏时间启用周期性收入。
• playtimeIncomeAmount (数字): 每个周期支付的金额。
• playtimeIncomeIntervalMinutes (数字): 游戏时间收入支付的间隔时间。
• playtimeIncomeDailyCap (数字): 每天游戏时间收入的上限。
• enablePlaytimeMilestones (是/否): 启用里程碑奖励。
• playtimeMilestoneRewards (文本): 以 分钟=奖励 格式表示的里程碑映射。
• notifyClaimableMilestonesOnJoin (是/否): 玩家加入时，如果存在可领取的里程碑，则通知他们。

市场与服务器交易

• enableServerSell (是/否): 启用玩家向服务器出售物品。
• enableServerBuy (是/否): 启用从服务器商店购买物品。
• enablePlayerMarket (是/否): 启用玩家市场流程。
• playerMarketFeePercent (数字): 玩家市场的手续费百分比。
• playerMarketListingLimit (数字): 玩家市场流程跟踪的最大总挂单数量。
• playerMarketMaxListingsPerPlayer (数字): 每个玩家的最大挂单数量。
• serverSellFeePercent (数字): 服务器出售时收取的手续费百分比。
• sellPreviewLimit (数字): 出售流程中显示的最大预览条目数。
• sellFromStorage (是/否): 允许从存储槽出售。
• sellFromHotbar (是/否): 允许从快捷栏出售。
• sellFromBackpack (是/否): 允许从背包出售。
• sellFromUtility (是/否): 允许从工具栏出售。
• sellFromTools (是/否): 允许从工具槽出售。
• sellFromArmor (是/否): 允许从护甲槽出售。

部落金库权限映射

• clanDepositPermission (文本): 用于金库存款的组织权限。
• clanWithdrawPermission (文本): 用于金库取款的组织权限。
• clanAdminPermission (文本): 用于金库管理员控制权限。
• clanOwnerBypass (是/否): 启用时允许部落所有者绕过这些检查。

历史记录、限制和管理员安全

• historyLimit (数字): 正常历史流程中显示的最大历史条目数。
• auditPreviewLimit (数字): 审计流程中显示的最大预览条目数。
• transferRateLimitSeconds (数字): 转账的反垃圾邮件速率限制。
• maxMetadataEntries (数字): 每笔交易存储的最大元数据条目数。
• recordFailedOperations (是/否): 启用后记录失败的操作。
• allowAdminSetBalance (是/否): 允许管理员执行直接设置余额操作。
• allowReverseTransactions (是/否): 允许支持交易回滚流程。
• showSystemAccountsInAdmin (是/否): 在管理员视图中显示系统账户。

权限

• 基本访问: zzeconomy.use
• 玩家流程: zzeconomy.balance, zzeconomy.transfer, zzeconomy.reward, zzeconomy.buy, zzeconomy.sell, zzeconomy.history
• 部落金库: zzeconomy.clan.*
• 管理员与审计: zzeconomy.admin.*, zzeconomy.audit, zzeconomy.reload

安装

1. 首先将 ZZCore.jar 复制到服务器的 mods 文件夹中。
2. 之后将 ZZEconomy.jar 复制到同一个服务器的 mods 文件夹中。
3. 如果你希望通过生态系统的社交提供商使用部落金库流程，还需要安装 ZZClan.jar。
4. 启动 Hytale。
5. 配置货币、目录价格、奖励流程和权限组。

许可证

保留所有权利。

未经作者书面许可，不得进行再分发、转载、修改销售或重新上传分支版本。