XConomy_Reload - 现代经济系统
XConomy 是一款功能丰富的 Minecraft 服务器现代经济插件。本项目是原版 XConomy 的 分支与完全重写,带来了性能增强、新功能以及对最新 Minecraft 版本的支持。
⚠️ 重要通知:这是原版 XConomy 项目的 新版本分支。我们从头重构了该插件,以提供更好的稳定性、更多功能以及与现代服务器环境的兼容性。
? 项目状态
这是对 XConomy 项目的 复兴与现代化改造。我们在原有概念的基础上进行了显著增强,包括:
- ? 性能优化,适用于大规模服务器
- ✨ 新功能,包括交易追踪和统计功能
- ? 现代经济管理支持,API 得到改进
- ? Bug 修复,并支持最新的 Minecraft 版本
- ? 玩家收入/支出追踪,提供更佳的财务洞察
- ? 数据迁移工具,实现无缝升级
? 特性
- 支持 Vault API 集成的基础经济插件
- MySQL 支持用于玩家数据存储,具备 Bungeecord/Redis 同步能力
- 新增:玩家收支追踪系统
- 新增:具有增强功能的现代经济管理模块
- 新增:数据迁移工具,便于数据库转换
- 多平台支持(Bukkit/Spigot/Paper/Folia/Sponge)
- 完整的 PlaceholderAPI 支持,包含扩展占位符
- 交易历史记录与清理工具
- 完善的权限系统
平台支持
- Bukkit:旧版本(1.12.2 及以下)
- Paper:1.13+(推荐以获得最佳性能)
- Folia:最新 Paper/Folia 版本(1.20+)
- Sponge:支持 API 7 和 API 8
? 命令
玩家命令
| 命令 | 描述 |
|---|---|
balance/money |
显示你的余额 |
balance/money <player> |
显示 <player> 的余额 |
pay <player> <amount> |
向 <player> 支付 <amount> |
balancetop |
显示 TOP10 最富有的玩家 |
paytoggle |
切换是否接受付款 |
xconomy help |
查看所有命令 |
xconomy track income/expense [page] |
查询你的收支记录 |
xconomy track <player> income/expense [page] |
查询特定玩家的记录 |
管理员命令
| 命令 | 描述 |
|---|---|
balance/money give <player> <amount> |
给予 <player> <amount> |
balance/money take <player> <amount> |
从 <player> 扣除 <amount> |
balance/money set <player> <amount> |
设置 <player> 的余额 |
balance/money give * <all/online> <amount> <reason> |
给予所有/在线玩家 |
balance/money take * <all/online> <amount> <reason> |
从所有/在线玩家扣除 |
balancetop hide/display <player> |
在 TOP10 中隐藏/显示玩家 |
paytoggle <player> |
切换玩家接受付款的状态 |
paypermission set <player> true/false |
设置玩家的付款权限 |
paypermission remove <player> |
重置玩家的付款权限 |
xconomy reload |
重新加载配置文件 |
xconomy deldata <player> |
删除玩家的经济数据 |
xconomy track cleanup [days] |
清理旧的交易记录 |
xconomy migrate <SQLite|MySQL> |
将数据迁移到不同类型的数据库 |
? 权限
用户权限
| 权限 | 描述 |
|---|---|
xconomy.user.balance |
查看自己的余额 |
xconomy.user.balance.other |
查看他人的余额 |
xconomy.user.pay |
向他人转账 |
xconomy.user.pay.receive |
接收他人的转账(需要 LuckPerms) |
xconomy.user.balancetop |
查看 TOP10 排行榜 |
xconomy.user.paytoggle |
切换是否接受付款 |
管理员权限
| 权限 | 描述 |
|---|---|
xconomy.admin.give |
给玩家发放金钱 |
xconomy.admin.take |
从玩家处扣除金钱 |
xconomy.admin.set |
设置玩家余额 |
xconomy.admin.balancetop |
在 TOP10 中隐藏/显示玩家 |
xconomy.admin.paytoggle |
设置玩家接受付款的状态 |
xconomy.admin.permission |
设置付款权限 |
xconomy.admin.hidden |
在 Tab 列表中隐藏 |
xconomy.admin.track |
查看交易记录 |
xconomy.admin.migrate |
执行数据迁移 |
? 依赖项
- Vault 或 Enterprise 用于经济 API
- MySQL 8.0+:较旧的服务器版本需要 DatabaseDrivers(1.17+ 无需额外驱动)
- Redis(可选):用于跨服务器数据同步
? PlaceholderAPI 支持
| 占位符 | 描述 |
|---|---|
%xconomy_balance% |
玩家余额 |
%xconomy_balance_value% |
原始余额值 |
%xconomy_balance_formatted% |
格式化后的余额 |
%xconomy_top_hidden% |
玩家是否在排行榜中隐藏 |
%xconomy_top_player_#% |
排名 # 的玩家名称 |
%xconomy_top_balance_#% |
排名 # 的格式化余额 |
%xconomy_top_balance_value_#% |
排名 # 的原始余额 |
%xconomy_sum_balance% |
服务器总余额 |
%xconomy_sum_balance_value% |
服务器总余额(原始值) |
%xconomy_top_rank% |
玩家当前排名 |
%xconomy_top_rank_#% |
玩家在位置 # 的排名 |
%xconomy_global_paypermission% |
全局付款权限状态 |
%xconomy_paypermission% |
玩家的付款权限 |
%xconomy_paytoggle% |
付款接受状态 |
XConomy_Reload - Modern Economy System
XConomy is a modern, feature-rich economy plugin for Minecraft servers. This project is a fork and complete rewrite of the original XConomy, bringing enhanced performance, new features, and support for the latest Minecraft versions.
⚠️ Important Notice: This is a new version fork of the original XConomy project. We have rebuilt the plugin from the ground up to provide better stability, more features, and improved compatibility with modern server environments.
? Project Status
This is a revival and modernization of the XConomy project. We've taken the original concept and significantly enhanced it with:
- ? Performance optimizations for large-scale servers
- ✨ New features including transaction tracking and statistics
- ? Modern economy manager support with improved API
- ? Bug fixes and support for latest Minecraft versions
- ? Player income/expense tracking for better financial insights
- ? Data migration tools for seamless upgrades
? Features
- Basic economy plugin supporting Vault API integration
- MySQL support for player data storage with Bungeecord/Redis sync capability
- NEW: Player income and expense tracking system
- NEW: Modern economy manager with enhanced features
- NEW: Data migration tools for easy database transitions
- Multi-platform support (Bukkit/Spigot/Paper/Folia/Sponge)
- Full PlaceholderAPI support with extended placeholders
- Transaction history and cleanup tools
- Comprehensive permission system
Platform Support
- Bukkit: Legacy versions (1.12.2 and below)
- Paper: 1.13+ (recommended for best performance)
- Folia: Latest Paper/Folia versions (1.20+)
- Sponge: API 7 & API 8 support
? Commands
Player Commands
| Command | Description |
|---|---|
balance/money |
Displays your balance |
balance/money <player> |
Displays <player>'s balance |
pay <player> <amount> |
Pay <player> <amount> |
balancetop |
Displays TOP10 richest players |
paytoggle |
Toggle accepting payments |
xconomy help |
View all commands |
xconomy track income/expense [page] |
Query your income/expense records |
xconomy track <player> income/expense [page] |
Query specific player's records |
Admin Commands
| Command | Description |
|---|---|
balance/money give <player> <amount> |
Give <player> <amount> |
balance/money take <player> <amount> |
Take <amount> from <player> |
balance/money set <player> <amount> |
Set <player>'s balance |
balance/money give * <all/online> <amount> <reason> |
Give to all/online players |
balance/money take * <all/online> <amount> <reason> |
Take from all/online players |
balancetop hide/display <player> |
Hide/show player in TOP10 |
paytoggle <player> |
Toggle player's payment acceptance |
paypermission set <player> true/false |
Set player's pay permission |
paypermission remove <player> |
Reset player's pay permission |
xconomy reload |
Reload configuration files |
xconomy deldata <player> |
Delete player's economy data |
xconomy track cleanup [days] |
Clean up old transaction records |
xconomy migrate <SQLite|MySQL> |
Migrate data to different database type |
? Permissions
User Permissions
| Permission | Description |
|---|---|
xconomy.user.balance |
Look up your balance |
xconomy.user.balance.other |
Look up others' balance |
xconomy.user.pay |
Transfer money to others |
xconomy.user.pay.receive |
Receive money from others (requires LuckPerms) |
xconomy.user.balancetop |
View TOP10 ranking |
xconomy.user.paytoggle |
Toggle payment acceptance |
Admin Permissions
| Permission | Description |
|---|---|
xconomy.admin.give |
Give money to players |
xconomy.admin.take |
Take money from players |
xconomy.admin.set |
Set player balances |
xconomy.admin.balancetop |
Hide/show players in TOP10 |
xconomy.admin.paytoggle |
Set players' payment acceptance |
xconomy.admin.permission |
Set payment permissions |
xconomy.admin.hidden |
Hide in Tab list |
xconomy.admin.track |
View transaction records |
xconomy.admin.migrate |
Perform data migration |
? Requirements
- Vault or Enterprise for economy API
- MySQL 8.0+: DatabaseDrivers required for older server versions (1.17+ no additional drivers needed)
- Redis (optional): For cross-server data sync
? PlaceholderAPI Support
| Placeholder | Description |
|---|---|
%xconomy_balance% |
Player's balance |
%xconomy_balance_value% |
Raw balance value |
%xconomy_balance_formatted% |
Formatted balance |
%xconomy_top_hidden% |
Whether player is hidden from ranking |
%xconomy_top_player_#% |
Player name at rank # |
%xconomy_top_balance_#% |
Formatted balance at rank # |
%xconomy_top_balance_value_#% |
Raw balance at rank # |
%xconomy_sum_balance% |
Total server balance |
%xconomy_sum_balance_value% |
Total server balance (raw) |
%xconomy_top_rank% |
Player's current rank |
%xconomy_top_rank_#% |
Player's rank at position # |
%xconomy_global_paypermission% |
Global pay permission status |
%xconomy_paypermission% |
Player's pay permission |
%xconomy_paytoggle% |
Payment acceptance status |
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xconomy_Reload
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 新增 PostgreSQL 作为支持的存储类型,包括配置、内置 JDBC 驱动以及跨数据库 SQL 处理。
- 重写
/xconomy migrate命令,用于在 SQLite、MySQL、MariaDB 和 PostgreSQL 之间迁移完整的经济数据。玩家余额、非玩家账户、UUID 映射、交易记录和登录数据均会被迁移,且仅在每个表写入成功后才更新目标数据库。 - 为所有接受金额的命令添加了金额缩写支持:
k、m和b均支持大小写,因此/pay Notch 10k和/money give Notch 1.3m均可正常工作。该功能由Settings.amount-abbreviations控制。 - 将基于字段的配置迁移替换为基于模板的合并。现有
config.yml或database.yml中缺失的条目现在会自动从内置模板中填充,且现有值不会被覆盖。
修复
- 修复了在 Paper 上因着色 JAR 过滤了 JDBC 服务注册而导致 PostgreSQL 启动失败并报错
No suitable driver的问题,通过显式设置驱动程序类来解决。 - 修复了在禁用
transaction-record时离线支付提示仍会查询交易表的问题。 - 修复了重载时连接池状态未重置的问题,并修正了在判断异步访问和事务跟踪时将远程数据库误认为 SQLite 的情况。
- 修复了
CConfig(URL)无法读取插件 JAR 内部捆绑的模板的问题。 - 修复了在 Paper 上数据导入模式不可用的问题。
/xconomy导入命令现在通过命令映射注册,不再依赖plugin.yml声明。 - 导入数据现在以 UUID 而非玩家名称作为键,因此在离线模式下重命名或重复名称不再导致读取错误的余额。现有的按名称键控的
data.yml文件仍可被读取。 - 修复了包含点号(
.)的玩家名称在导入后余额不可读的问题,并在遇到无效 UUID 时跳过相应资料,而不是写入null条目。 - 导入操作现在会报告已导入、跳过和失败的数量,并在已有导入任务运行时拒绝启动新的导入。
从其他经济插件导入余额
导入模式通过 Vault 从当前提供服务的那个经济插件读取余额,并将其存储在 XConomy/importdata/data.yml 中。需要安装 Vault 和一个正常运行的经济插件提供程序。
- 备份
XConomy插件文件夹,如果数据库存储在其他位置,也请一并备份。 - 在
XConomy/config.yml中设置Importdata-mode: true。 - 重启服务器。XConomy 将以仅导入模式加载,不会接管经济系统。日志中应显示
Convertion mode enable。 - 以操作员身份运行
/xconomy。导入操作会报告已导入、跳过和失败的数量。 - 对照源插件检查
XConomy/importdata/data.yml。 - 将
Importdata-mode设置为false并重启。此时 XConomy 将正式接管经济系统。
余额不会批量写入数据库。每个玩家的余额会在其首次加入服务器创建账户时从 data.yml 中恢复,因此请保留该文件直到所有玩家至少登录过一次。仅导出存在于服务器离线玩家数据中的玩家;从未加入过此服务器的玩家不会被包含在内。
如果日志显示 Conversion mode enable error,则说明 Vault 未能找到已注册的经济插件提供程序,且没有导出数据。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
Vault2.0 是什么? Vault2.0 是一个经济插件,它注册了一个兼容 Vault API 的 Bukkit Economy 服务,允许其他插件(商店、等级等)使用货币而无需依赖原始的 Vault.jar。它包含菜单、支付/收费流程
插件
一款旨在与 Multiverse-Core 紧密结合的库存管理插件
插件
一个功能丰富、完全动画化的箱子插件,适用于 Paper 1.21.x,支持 IA、Vault、PlaceholderAPI 和 Citizens
插件
一个现代且高度可配置的 Essentials 插件,类似于 EssentialsX
插件
城镇现在可以要求建造具有特定功能的建筑
PressureWarp - 当你与压力板或按钮交互时,将你传送至指定位置
评论 0
登录后参与评分
还没有评论,来抢沙发吧