- 版权类型
- 原创
- 插件中文名称
- ALEMC兑换所
- 插件英文名称
- ALEMCExchange
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- 其他核心
- 语言支持
- 中文（简体）
- 前置组件
- PlaceholderAPI（可选）：https://www.minebbs.com/resources/8229
- 适配版本（Java）
- 26.x
- 1.21
ALEMCExchange – 全能物品兑换插件
插件概述ALEMCExchange 是一款功能全面的 Minecraft 服务器经济管理插件，提供完整的物品兑换、自动出售和物品解锁系统。基于 EMC（Energy Matter Covalence） 货币体系，为服务器打造动态经济生态，鼓励玩家通过挖掘与出售解锁更多内容。
核心功能
物品兑换系统- 兑换菜单 – 使用 EMC 购买已解锁物品
- 批量购买 – 左键买 1 个，右键买 64 个
- 自定义价格 – 在 items.yml 中设置每个物品的 EMC 价格
- 分类显示 – 物品按类别排列，快速查找
自动出售系统- 智能识别 – 自动识别玩家拾取的可出售物品
- 批量处理 – 达到阈值（默认 64 个）时一次性出售，降低服务器负载
- 分级税率：
| 玩家类型 | 税率 |
|---|---|
| 普通玩家 | 5% |
| VIP | 3% |
| 高级用户 | 1% |
| 特权用户 | 0% |
- 出售消息 – 可选择是否显示成功提示
物品解锁系统- 双条件解锁 – 通过挖掘 和/或 出售物品解锁
- 进度追踪 – 实时显示挖掘/出售进度
- 解锁提示 – 成功时发送系统消息
- 自定义要求 – 在 items.yml 中为每个物品单独设置解锁条件
浏览系统- 物品预览 – 查看所有物品的 EMC 价格
- 解锁状态 – 显示每个物品是否已解锁
- 进度显示 – 未解锁物品显示当前进度
- 分类浏览 – 按物品类型分类
经济管理- 余额查询 – /alemcexchange balance
- 转账系统 – 玩家间互相转账
- 给予 EMC
- 设置余额
- 解锁所有物品
- 重载配置
技术特点
性能优化- 数据库优化 – 批量插入/更新、高效 SQL 查询、连接池管理
- 缓存机制 – 物品缓存、玩家数据缓存（余额/解锁状态/进度），带时间戳与定期清理
多服务器兼容- Folia – 内置区域化调度器
- Paper / Spigot – 完美支持传统服务端
- 版本支持 – Minecraft 1.13+
配置灵活性| 配置文件 | 作用 |
|---|---|
| config.yml | 自动出售、税率、批量出售阈值 |
| items.yml | 物品 EMC 价格、解锁要求、显示名称 |
| lang.yml | 所有消息自定义，支持多语言 |
| menus.yml | 菜单布局、按钮、玻璃面板配置 |
安全与稳定- 权限系统 – 基于 Bukkit 权限
- 异常处理 – 完善的错误捕获
- 数据安全 – SQLite 数据库，持久化存储
- 内存管理 – 定期清理缓存，防止内存泄漏
安装与配置安装步骤
- 下载 ALEMCExchange-1.0.0.jar
- 将文件放入服务器的 plugins 目录
- 重启服务器（插件会自动生成配置文件）
初始配置
- 打开 plugins/ALEMCExchange 目录
- 编辑 items.yml 添加物品价格和解锁要求
- 编辑 config.yml 调整税率和自动出售设置
- 编辑 lang.yml 自定义消息内容
- 执行 /alemcexchange reload 重载配置
命令与权限
玩家命令| 命令 | 说明 | 权限节点 |
|---|---|---|
| /alemcexchange | 打开主菜单 | alemcexchange.use |
| /alemcexchange help | 显示帮助 | alemcexchange.use |
| /alemcexchange sell | 打开出售菜单 | alemcexchange.use |
| /alemcexchange exchange | 打开兑换菜单 | alemcexchange.use |
| /alemcexchange browse | 打开浏览菜单 | alemcexchange.use |
| /alemcexchange balance | 查看余额 | alemcexchange.use |
| /alemcexchange autosell | 切换自动出售 | alemcexchange.autosell |
| /alemcexchange pay <玩家> <金额> | 转账 | alemcexchange.use |
管理员命令| 命令 | 说明 | 权限节点 |
|---|---|---|
| /alemcexchange reload | 重载配置 | alemcexchange.admin |
| /alemcexchange give <玩家> <金额> | 给予 EMC | alemcexchange.admin |
| /alemcexchange unlockall <玩家> | 解锁所有物品 | alemcexchange.admin |
| /alemcexchange unlock <玩家> <物品ID> | 解锁单个物品 | alemcexchange.admin |
| /alemcexchange set <玩家> <金额> | 设置余额 | alemcexchange.admin |
权限列表| 权限节点 | 作用 |
|---|---|
| alemcexchange.use | 基本功能权限 |
| alemcexchange.autosell | 自动出售权限 |
| alemcexchange.admin | 管理员权限 |
| alemcexchange.notax | 免税率 |
| alemcexchange.premium | 高级用户税率（1%） |
| alemcexchange.vip | VIP 用户税率（3%） |
性能表现基准测试
- 菜单打开时间：< 100ms
- 自动出售处理：< 50ms
- 数据库批量操作：< 10ms
- 内存使用：稳定，无泄漏
优化效果
- 服务器 TPS 提升 5-15%
- 数据库操作时间减少 30-40%
- 菜单打开时间减少 20-30%
- 支持 100+ 在线玩家
测试服务端版本：1.21.11
常见问题Q：物品解锁后在兑换菜单中不显示？
A：可能是缓存问题，尝试重新打开菜单或使用 /alemcexchange reload。
Q：自动出售不工作？
A：请检查：
- autosell.enabled 是否为 true
- 玩家是否拥有 alemcexchange.autosell 权限
- 物品是否已在 items.yml 中配置
Q：税率如何计算？
A：优先级：notax > premium > vip > 普通税率。
Q：支持哪些服务器版本？
A：Minecraft 1.13+，兼容 Folia、Paper、Spigot 等服务端。
插件更新更新步骤
- 下载新版 JAR 文件
- 停止服务器
- 替换旧 JAR 文件
- 启动服务器（插件会自动处理数据库迁移）
作者信息- 作者：Allen_Linong
- 支持：请在评论区留言
- 许可证：MIT
结语ALEMCExchange 是一款功能全面、性能优异的经济插件，通过智能缓存与异步处理，在高负载下依然稳定运行。灵活的配置与多服务端兼容性，使其成为各类服务器管理经济的理想选择。
