UCExchange

插件

· 作者 hohotutecalme.

适用于 Paper 的每日轮换交易市场的插件,具有图形用户界面(GUI)、Vault 支持、Discord 日志记录、PlaceholderAPI 集成以及自动刷新功能。

0 本站下载 0 关注 更新于 3 个月前

最新 2.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

UCExchange

UCExchange 是一款专为 Paper 和 Folia 服务器设计的完整每日轮换交易市场插件。

它允许玩家通过简洁且可配置的用户界面,将普通资源兑换为货币或更稀有的物品。

可用商品可以自动轮换,使市场保持新鲜感,并鼓励玩家定期返回。

UCExchange 旨在为生存、经济、公共及自定义服务器提供动态交易系统,而无需安装完整的商店插件。

该插件包含游戏内管理功能、交易追踪、SQLite 和 MySQL 支持、审计日志、Discord Webhook 通知、PlaceholderAPI 集成、bStats 指标统计以及更新检查功能。

所有内容均可配置,包括菜单、可用商品、轮换行为、消息、数据库设置、Webhook 通知、权限和管理工具。


功能

  • 每日轮换交易市场
  • 基于简洁 GUI 的交易菜单
  • 使用 Vault 进行资源换货币交易
  • 资源换物品交易
  • 市场自动轮换
  • 可配置的轮换间隔
  • 手动市场轮换
  • 完整的游戏内商品管理
  • 使用管理员手持物品创建商品
  • 在特定 GUI 槽位激活商品
  • 删除已配置的商品
  • 列出所有已配置的商品
  • SQLite 本地数据库支持
  • MySQL 数据库支持
  • 详细的玩家交易追踪
  • 管理员审计日志
  • 控制台交易日志
  • Discord Webhook 日志
  • PlaceholderAPI 支持
  • bStats 集成
  • Modrinth 更新检查器
  • Vault 交易验证
  • 支付失败时自动退还物品
  • 可配置的消息
  • 可配置的菜单标题和大小
  • 可配置的商品槽位
  • 可配置的物品名称和描述
  • 支持 Shift+点击以进行最大数量交换
  • 独立的管理员权限
  • 专用于 Paper 1.21.11 的版本
  • 专用于 Paper 和 Folia 26.1 的版本

命令

玩家命令

/dailyexchange

别名:

/de

/exchange

打开每日交易市场。


管理员命令

/de list

显示所有已配置的交易商品。

/de create money <id> <price>

使用管理员主手所持物品创建一个物品换货币的商品。

/de create item <id>

创建一个物品换物品的商品,主手作为所需物品,副手作为奖励物品。

/de activate <id> <slot>

立即在选定的 GUI 槽位中激活现有商品。

/de delete <id>

删除已配置的商品。

/de logs

显示最近的玩家交易记录。

/de logs <amount>

显示指定数量的最近玩家交易记录。

/de refresh

强制进行新的市场轮换。

/de reload

重新加载 UCExchange 配置文件。


创建货币商品

在主手持有所需的物品。

手持堆叠中的数量将成为所需的兑换数量。

示例:

在主手中持有 64 个小麦并执行:

/de create money wheat_sale 250

将创建以下兑换选项:

64 小麦 → $250

标识符 wheat_sale 随后可用于激活、列出或删除该报价。

激活示例:

/de activate wheat_sale 10

这将在 GUI 的第 10 个槽位激活该报价。


创建物品兑换

在主手中放置所需物品。

在副手中放置奖励物品。

每个手持堆叠的数量将被用作兑换数量。

示例:

主手:

16 钻石

副手:

32 绿宝石

执行:

/de create item diamond_emerald

将创建以下兑换选项:

16 钻石 → 32 绿宝石

激活示例:

/de activate diamond_emerald 12


权限

玩家权限

ucexchange.use

允许玩家打开并使用每日兑换市场。

默认值:

true


全局管理员权限

ucexchange.admin

授予对 UCExchange 所有管理员功能的访问权限。

默认值:

OP

此权限包括:

  • ucexchange.admin.view
  • ucexchange.admin.logs
  • ucexchange.admin.edit
  • ucexchange.admin.rotate
  • ucexchange.admin.reload

详细管理员权限

ucexchange.admin.view

允许管理员查看已配置的报价和管理信息。

ucexchange.admin.logs

允许管理员查看玩家交易历史。

ucexchange.admin.edit

允许管理员创建、激活、修改和删除兑换报价。

ucexchange.admin.rotate

允许管理员强制进行新的市场轮换。

ucexchange.admin.reload

允许管理员重新加载 UCExchange。


数据库支持

UCExchange 支持两种存储系统:

  • SQLite
  • MySQL

SQLite 为默认启用项,且不需要外部数据库服务器。

本地 SQLite 数据库会自动创建在:

plugins/UCExchange/ucexchange.db

管理操作和交易错误也会记录在:

plugins/UCExchange/audit.log


跟踪的交易信息

每次完成的兑换均可存储以下信息:

  • 玩家 UUID
  • 玩家用户名
  • 报价标识符
  • 报价类型
  • 输入材料
  • 输入数量
  • 奖励材料
  • 奖励数量
  • 获得金额
  • 完成的兑换次数
  • 交易日期
  • 交易时间
  • 服务器标识符

这使得追踪交换物品、获得的奖励、玩家活动以及市场使用情况成为可能。


SQLite 配置

对于使用单个 Paper 或 Folia 实例的服务器,推荐使用 SQLite。

示例:

storage:
  type: SQLITE

数据库文件将自动创建。

无需额外的数据库配置。


MySQL 配置

当需要将交易数据存储在远程位置或在多个服务器实例之间共享时,推荐使用 MySQL。

示例:

存储: 类型:MYSQL

mysql: host: 127.0.0.1 port: 3306 database: ucexchange username: ucexchange password: change-me use-ssl: false

请确保配置的 MySQL 用户拥有以下权限:

  • 创建表
  • 插入数据
  • 读取数据
  • 更新数据
  • 删除数据

审计日志

UCExchange 会在以下位置创建审计日志文件:

plugins/UCExchange/audit.log

审计日志可包含以下内容:

  • 玩家交易记录
  • 报价创建
  • 报价删除
  • 报价激活
  • 强制市场轮换
  • 插件重载
  • Vault 交易错误
  • 物品退款错误
  • 数据库错误
  • 管理操作

Vault 安全机制

UCExchange 在完成交换前会验证 Vault 经济交易。

如果经济支付失败:

  • 交易将被取消
  • 已移除的物品将退还
  • 错误信息将写入审计日志
  • 玩家将收到错误提示
  • 失败的交易不会被视为成功

进行货币交换需要安装兼容 Vault 的经济插件。

示例包括通过 Vault 暴露其经济系统的经济插件。


PlaceholderAPI

UCExchange 内置了 PlaceholderAPI 支持。

PlaceholderAPI 是可选的,仅在使用其他插件中的 UCExchange 占位符时才需要。

可用的占位符:

%ucexchange_next_rotation%

显示下次市场轮换的剩余时间或日期。

%ucexchange_last_rotation%

显示上次市场轮换的日期或时间。

%ucexchange_auto_rotate_hours%

显示配置好的自动轮换间隔。

%ucexchange_menu_title%

显示配置的交易菜单标题。

%ucexchange_webhook_enabled%

显示是否启用了 Discord webhook 日志记录。

%ucexchange_version%

显示已安装的 UCExchange 版本。

%ucexchange_money_slots_count%

显示配置的货币报价槽位数。

%ucexchange_rare_slots_count%

显示配置的稀有物品报价槽位数。

%ucexchange_shift_click_max%

显示是否启用了使用 Shift+点击的最大交易次数限制。

这些占位符可用于兼容的插件中,例如:

  • 计分板(Scoreboards)
  • 全息图(Holograms)
  • Tab 列表(Tablists)
  • 菜单(Menus)
  • 聊天格式(Chat formats)
  • NPC 全息图(NPC holograms)
  • 信息面板(Information panels)
  • 兼容 PlaceholderAPI 的插件

Discord Webhook

UCExchange 可以发送 Discord webhook 通知。

Webhook 通知可用于:

  • 玩家交易
  • 收到的货币
  • 收到的物品
  • 市场轮换
  • 管理操作
  • 交易错误
  • 数据库错误

可以在配置中启用或禁用 webhook 日志记录。

管理员可以配置以下内容:

  • Webhook URL
  • 用户名
  • 头像
  • 交易通知
  • 轮换通知
  • 错误通知

bStats

UCExchange 使用 bStats 收集匿名使用统计数据。

bStats 插件 ID:

30365

收集的信息可能包括:

  • 使用 UCExchange 的服务器数量
  • 使用 UCExchange 的服务器上的玩家数量
  • Minecraft 版本
  • 服务器实现类型
  • Java 版本
  • 插件版本

不会向 bStats 发送任何私人玩家数据、交易历史、数据库凭据或配置密钥。

可以在 UCExchange 配置中启用或禁用指标收集。

示例:

metrics:
  enabled: true

更新检查器

UCExchange 内置了更新检查器。

当有更新的插件版本可用时,它可以通知管理员。

更新通知可以显示在:

  • 服务器控制台
  • 当管理员加入服务器时
  • 通过配置好的插件消息

可以在配置中启用或禁用更新检查器。


Paper 1.21.11 版本

兼容性

此构建兼容:

  • Paper 1.21.11
  • 兼容的 Paper 1.21.x 环境
  • Java 21 或更高版本

推荐的 Java 版本:

Java 21

构建文件:

UCExchange-2.0.0-1.21.11.jar

要求

  • Paper 1.21.11
  • Java 21 或更高版本
  • Vault
  • 一个兼容 Vault 的经济插件
  • PlaceholderAPI(可选)
  • MySQL(可选)
  • Discord webhook(可选)

重要提示

此构建必须使用 Java 21 编译。

不要在运行 Java 21 或 Java 22 的服务器上使用该 Java 25 构建。


Paper 和 Folia 26.1 版本

兼容性

此构建兼容:

  • Paper 26.1.x
  • Folia 26.1.x
  • Java 25

所需的 Java 版本:

Java 25

构建文件:

UCExchange-2.0.0-26.1.jar

要求

  • Paper 26.1.x 或 Folia 26.1.x
  • Java 25
  • Vault
  • 一个兼容 Vault 的经济插件
  • PlaceholderAPI(可选)
  • MySQL(可选)
  • Discord webhook(可选)

重要提示

此构建仅适用于 Paper 或 Folia 26.1.x。

请勿将此构建安装在 Paper 1.21.11 服务器上。

对于 Paper 1.21.11,请使用:

UCExchange-2.0.0-1.21.11.jar


UCExchange 2.0.0 – Paper 1.21.11 更新

兼容性更新

✅ 添加了对 Paper 1.21.11 的完整支持

✅ 添加了专用的 Java 21 构建

✅ 改进了与现代 Paper 1.21.x 服务器的兼容性

✅ 改进了 Minecraft 版本检测


新数据库系统

✅ 添加了 SQLite 本地数据库支持

✅ 添加了 MySQL 数据库支持

✅ 添加了自动数据库表创建功能

✅ 添加了异步事务存储

✅ 添加了详细的玩家交易追踪

✅ 添加了安全的数据库关闭处理


游戏内管理

✅ 添加了游戏内货币报价创建

✅ 添加了游戏内物品报价创建

✅ 添加了通过 GUI 槽位激活报价

✅ 添加了已配置报价列表显示

✅ 添加了报价删除功能

✅ 添加了最近交易历史记录

✅ 添加了强制市场轮换功能

✅ 添加了配置重载命令


管理员权限

✅ 添加了 ucexchange.admin

✅ 添加了 ucexchange.admin.view

✅ 添加了 ucexchange.admin.logs

✅ 添加了 ucexchange.admin.edit

✅ 添加了 ucexchange.admin.rotate

✅ 添加了 ucexchange.admin.reload


交易追踪

现在每次交易都可以记录:

  • 玩家 UUID
  • 玩家名称
  • 交易 ID
  • 交易类型
  • 输入物品
  • 输入数量
  • 奖励物品
  • 奖励数量
  • 货币奖励
  • 交易次数
  • 交易日期
  • 服务器标识符

安全改进

? 改进了 Vault 交易验证

? 当经济支付失败时,自动退还物品

? 增加了对无效库存交互的保护

? 提升了 Shift+点击交易的稳定性

? 增加了管理员审计日志

? 改进了错误处理

? 改进了数据库错误处理


集成支持

? 集成了 bStats(插件 ID 30365)

? 更新了 PlaceholderAPI 支持

? 改进了 Discord Webhook 日志记录

? 改进了更新检测器行为


技术改进

? 使用 Java 21 编译

? 改进了配置加载

? 改进了插件启动验证

? 改进了插件关闭行为

? 改进了异步数据库操作

? 改进了代码组织

? 整体性能和稳定性提升


重要提示

此构建版本适用于 Paper 1.21.11。

需要 Java 21 或更高版本。

请使用:

UCExchange-2.0.0-1.21.11.jar

请勿在运行 Java 21 或 Java 22 的服务器上安装 Java 25 构建版本。


UCExchange 2.0.0 – Paper 和 Folia 26.1 更新

兼容性更新

✅ 新增对 Paper 26.1.x 的支持

✅ 新增对 Folia 26.1.x 的支持

✅ 新增了专用的 Java 25 构建版本

✅ 改进了对现代 Paper 服务器环境的支持

✅ 改进了对 Folia 调度环境的支持

✅ 改进了 Minecraft 版本检测


新数据库系统

✅ 新增 SQLite 本地数据库支持

✅ 新增 MySQL 数据库支持

✅ 新增自动创建数据库表功能

✅ 新增异步交易存储

✅ 新增详细的玩家交易追踪

✅ 新增安全的数据库关闭处理


游戏内管理

✅ 新增游戏内货币交易创建

✅ 新增游戏内物品交易创建

✅ 新增通过 GUI 槽位激活交易

✅ 新增已配置交易列表显示

✅ 新增交易删除功能

✅ 新增近期交易历史记录

✅ 新增强制市场轮换功能

✅ 新增配置重载命令


管理员权限

✅ 新增 ucexchange.admin

✅ 新增 ucexchange.admin.view

✅ 新增 ucexchange.admin.logs

✅ 新增 ucexchange.admin.edit

✅ 新增 ucexchange.admin.rotate

✅ 新增 ucexchange.admin.reload


交易追踪

每次交易现在可以记录以下信息:

  • 玩家 UUID
  • 玩家名称
  • 交易 ID
  • 交易类型
  • 输入物品
  • 输入数量
  • 奖励物品
  • 奖励数量
  • 货币奖励
  • 交易次数
  • 交易日期
  • 服务器标识符

Folia 改进

⚡ 改进了调度器兼容性

⚡ 改进了玩家任务调度

⚡ 改进了全局任务调度

⚡ 改进了异步数据库处理

⚡ 减少了不安全的 Bukkit 调度器使用

⚡ 提升了区域化服务器上的稳定性


安全改进

? 改进了 Vault 交易验证

? 当经济支付失败时,自动退还物品

? 增加了对无效库存交互的保护

? 提升了 Shift+点击交易的稳定性

? 增加了管理员审计日志

? 改进了错误处理

? 改进了数据库错误处理


集成支持

? 集成了 bStats(插件 ID 30365)

? 更新了 PlaceholderAPI 支持

? 改进了 Discord Webhook 日志记录

? 改进了更新检测器行为


技术改进

? 使用 Java 25 编译

? 适配了现代 Paper 26.1 API

? 改进了配置加载

? 改进了插件启动验证

? 改进了插件关闭行为

? 改进了异步数据库操作

? 改进了代码组织

? 整体性能和稳定性提升


重要提示

此构建版本仅适用于 Paper 或 Folia 26.1.x。

需要 Java 25。

请使用:

UCExchange-2.0.0-26.1.jar

对于 Paper 1.21.11,请使用:

UCExchange-2.0.0-1.21.11.jar

请勿在 Java 21 或 Java 22 服务器上安装 Java 25 构建版本。


备注

UCExchange 旨在保持轻量、实用且易于配置,同时为公共服务器和自定义经济设置提供足够的灵活性。

管理员可以直接在游戏中管理交易,无需手动编辑配置文件中的每一项交易。

交易数据可以使用 SQLite 本地存储,也可以使用 MySQL 远程存储。

数据库和审计日志使得追踪交换物品、获得的奖励、玩家活动、管理员操作以及整体市场使用情况成为可能。

请始终使用与您的 Minecraft 和 Java 版本匹配的 UCExchange 构建版本。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源