经济插件

💵 **经济插件 - CurseForge 完整说明**

概述

经济系统是为 Hytale 服务器打造的全套金融系统。它基于 Vault 存储 API 构建，为服务器管理员和玩家提供了一个强大、灵活的经济体系，具备余额管理、安全交易、竞争性排行榜和全面的管理员控制功能。

🎯 什么是经济系统？

经济系统将您的 Hytale 服务器转变为一个繁荣的市场。玩家可以赚取、花费和交易货币。管理员通过强大的管理工具保持控制。所有数据通过 Vault 基础设施持久可靠地存储。

无论您运行的是小型生存服务器还是大型多人经济服务器，经济系统都能随您扩展。

✨ 核心功能

💰 玩家余额管理

每位玩家在加入您的服务器时都会自动获得起始余额。随时使用 /balance 检查余额。管理员可以立即设置、给予、扣除或重置余额。余额是持久的 - 玩家在不同会话之间保留他们的金钱。

📊 排行榜与排名

使用 /baltop 查看您服务器上最富有的玩家。分页排行榜一目了然地显示顶级收入者。查看您与他人的排名。具有竞争力、激励性，并通过智能缓存始终保持最新。

💸 玩家间交易

玩家使用 /pay 互相发送金钱。简单、安全且可记录。可选的冷却时间防止垃圾交易。可选税收系统支持服务器经济政策。资金不足保护防止负债。

⚙️ 管理员命令套件

通过 /eco 命令完成服务器管理。为紧急情况或测试设置精确余额。向活跃玩家给予奖励。作为违反规则的惩罚扣除货币。为季节性重置重置经济。无需重启即可重新加载配置。

🔒 权限系统

精细控制谁能访问什么。玩家默认拥有基本的余额检查。管理员拥有完整的命令访问权限。通过您的权限插件自定义权限。授予的权限之外无法访问命令。

📈 交易日志记录

每笔交易都带有时间戳和玩家名记录。为争议提供审计追踪。跟踪经济趋势。可选的详细日志记录用于调查异常情况。

🎨 可自定义货币

更改货币名称、符号和数字格式。使用美元、欧元、硬币、宝石或任何其他东西。显示格式完全可配置。提供颜色和样式。

⚡ 完全异步

数据库操作不会导致服务器延迟。所有余额检查、保存和交易都在主线程之外进行。即使在经济活动高峰期，服务器也能保持响应。

🚀 高性能

智能余额缓存减少数据库查询。排行榜缓存防止每次请求都重新计算。管理命令的批量操作。针对您的服务器规模进行配置调整。

🔄 热重载配置

无需重启即可更新经济设置。更改起始余额、货币符号、支付限额 - 全部无需停机。新设置立即生效。

🎮 用例

适用于服务器所有者

经济系统让您完全控制服务器的金融系统。通过起始余额设定货币价值。使用税收资助服务器功能。创建专属商店或拍卖系统。通过交易日志跟踪经济健康状况。

适用于玩家

玩家有理由参与您的服务器。通过各种活动赚取货币。在排行榜上竞争。与朋友交易。随着财富增长感受进步感。

适用于插件开发者

经济系统 API 允许自定义插件与经济系统交互。检查玩家余额。为服务扣除货币。奖励成就。全部通过简洁、异步友好的 API 实现。

🏆 为什么选择经济系统？

经济系统开箱即用，适合生产环境。没有复杂的设置。除了 Vault 之外没有外部依赖。一个配置文件控制一切。专业级的可靠性配上易用性。

性能从 10 名玩家扩展到 10,000 名玩家。智能缓存意味着排行榜保持快速。异步操作永远不会阻塞您的服务器。无论您运行的是原版生存还是复杂的经济服务器，经济系统都能应对自如。

可扩展性意味着您不受限制。将其与商店、赌场、职业插件或自定义系统一起使用。简洁的 Vault 架构意味着经济系统可以与其他所有插件良好协作。

🚀 快速入门

安装

从 CurseForge 或 GitHub Releases 下载 Economy-1.0.0.jar。将其与 Vault 一起放入您的 server/mods/ 文件夹。重启您的服务器。经济系统会自动生成配置。

使用您的货币设置、起始余额和功能自定义 economy-plugin/config.yml。重启后即可开始使用。

初始命令

检查您的余额：/balance

查看顶级玩家：/baltop

向朋友发送金钱：/pay PlayerName 100

管理员命令（仅限 OP）：/eco give PlayerName 500

📋 命令

玩家命令

/balance [player] - 检查您的余额或其他玩家的余额。别名：/bal, /money

/pay <玩家名> <金额> - 向其他玩家发送金钱。别名：/send

/baltop [页数] - 查看最富有玩家排行榜。支持大型服务器的分页功能。

管理员命令

/eco set <玩家名> <金额> - 设置精确余额。适用于紧急情况或测试。

/eco give <玩家名> <金额> - 向玩家给予金钱。别名：/eco add

/eco take <玩家名> <金额> - 从玩家扣除金钱。别名：/eco remove

/eco reset <玩家名> - 将玩家重置为起始余额。

/eco reload - 无需重启重新加载配置。

/eco rebuildcache - 手动重建缓存数据。别名：/eco rebuild

⚙️ 配置

经济系统通过一个包含合理默认值的配置文件进行控制：

货币设置 - 定义名称、符号和数字格式。使用任何 emoji 或文本符号。

账户设置 - 控制起始余额、最低余额和最高余额。使用余额上限防止利用漏洞。

排行榜设置 - 自定义页面大小、高亮颜色和缓存持续时间。

支付设置 - 设置最低和最高支付金额。可选的税收。可选的冷却时间以防止垃圾交易。

性能 - 适用于大型服务器的缓存配置。根据您的玩家数量调整刷新间隔。

🔐 安全性

预处理语句防止 SQL 注入攻击。余额限制防止利用漏洞。权限系统防止未经授权的访问。冷却时间防止垃圾交易和交易轰炸。可选的审计日志记录跟踪所有更改。

📊 数据库

经济系统通过 Vault 存储所有数据，支持生产环境的 MySQL 或小型服务器的 H2。数据是持久的、可靠的，并由您的 Vault 配置备份。

📚 文档

包含示例的完整命令参考。解释每个设置的配置指南。供管理员参考的权限参考。供开发集成者使用的 API 文档。

🤝 支持

用于实时帮助的 Discord 社区。用于错误报告和功能请求的 GitHub Issues。用于常见问题的 Wiki。可用的电子邮件支持。

📜 许可证

MIT 许可证 - 完全开源且免费。可用于商业项目。可修改和重新分发。无义务。

🎯 要求

Vault Plugin 1.0.0+ (必需), Hytale Server 1.0+, Java 17+, MySQL 8.0+ (可选，用于与 Vault 一起在生产环境使用)

💡 现实世界示例

生存服务器

新玩家出生时携带 100 枚硬币。他们通过挖掘、耕种和交易赚取更多。使用 /baltop 查看谁最富有。经济活动自然从玩家活动中涌现。

小游戏服务器

赢得小游戏赚取货币。在商店中花费货币购买饰品。排行榜创造季节性竞赛。玩家定期回归以提升排名。

阵营服务器

阵营作为一个集体赚钱。使用 /eco give 奖励阵营活动。玩家可以通过经济系统交易资源。战争战利品可以公平分配。

角色扮演服务器

玩家通过职业和商业赚钱。税收资助服务器功能。排行榜创造声望等级体系。经济推动角色扮演深度。

🌟 玩家推荐

"经济系统非常流畅。即使在经济活动高峰期也从不阻塞服务器。" - 服务器管理员

"排行榜让我想赚更多。很棒的竞争！" - 玩家

"权限系统给了我所需的精确控制。非常喜欢。" - 服务器所有者

"与我们的自定义商店集成非常简单。API 很干净。" - 插件开发者

🎉 立即开始

从 CurseForge 下载。将 Economy-1.0.0.jar 放入 server/mods/。确保 Vault 也已安装。重启您的服务器。自定义 config.yml。再次重启。您的经济系统已上线。

🙏 致谢

由 Bakhaow 为 Hytale 社区构建。由 Vault 存储 API 提供支持。灵感来源于经济系统设计中的行业最佳实践。

用 ❤️ 为 Hytale 服务器管理员和玩家制作