BeastMcMMORedeem

插件

· 作者 MrAxeTv

带有动画图形界面和安全存储的现代 mcMMO 信用兑换

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

最新 1.0.1 · 26.2 · Paper / Purpur

一键开服(送7天)

BeastMcMMoRedeem

现代 mcMMO 积分、动画兑换菜单与安全存储系统

给予玩家兑换积分,让他们将这些积分投入到自己选择的 mcMMO 技能中。

非常适合 生存 (Survival)、角色扮演 (RPG)、监狱 (Prison)、空岛 (Skyblock)、阵营 (Factions) 以及其他 基于进度 (progression-based) 的服务器。


BeastMcMMORedeem 是什么?

BeastMcMMORedeem 是一款专为 mcMMO 进度设计现代化的 Spigot/Paper 积分兑换插件。管理员和奖励系统可以向玩家发放兑换积分,而玩家则可以通过精美的技能菜单和可配置的交易选择器,决定将这些积分应用于哪些已启用的 mcMMO 技能。

积分可以用于增加完整的 mcMMO 等级,或者增加可配置的 mcMMO 经验值。该插件会追踪每个玩家的可用余额和累计消耗的积分总额,保护基于等级的兑换操作不超过 mcMMO 的技能上限,支持玩家之间的积分转移,并提供 File、SQLite 和 MySQL 三种存储方式。

必需依赖

依赖项 要求
BeastLib 必需 — 版本 1.6.23 或更高
mcMMO 技能兑换所必需

BeastMcMMORedeem 可以在没有安装 mcMMO 的情况下启动,但在安装并启用 mcMMO 之前,积分无法应用于任何技能。

主要功能

  • ✅ 完整的积分兑换系统,包含当前余额和累计消耗积分的追踪。
  • ✅ 现代化的 6 行技能选择 GUI,支持可配置的物品、布局、填充物、音效以及打开动画。
  • ✅ 专用的交易选择器,包含正向和负向控制、重置、最大值、返回、取消和确认操作。
  • ✅ 可配置的交易调整数值。默认值为 1、8 和 16。
  • ✅ 等级模式: 1 个积分恰好增加 1 级 mcMMO 技能等级。
  • ✅ 经验模式: 1 个积分增加可配置的 mcMMO 经验值数量。
  • ✅ 在扣除积分前,针对基于等级的兑换提供 mcMMO 技能上限保护。
  • ✅ 可配置的技能启用列表,以及独立的禁用技能系统。
  • ✅ 直接执行技能命令,可以以指定的起始金额打开交易选择器。
  • ✅ 当交易选择器被禁用时,可选通过聊天输入金额。
  • ✅ 支持玩家之间的积分转移。
  • ✅ 可配置初始余额和最大余额。
  • ✅ 支持按玩家的文件存储、本地 SQLite 存储、远程 MySQL 存储以及传统的单文件 YAML 支持。
  • ✅ 内置异步 YAML 到 MySQL 迁移命令。
  • ✅ 在线余额缓存,支持异步加入加载和队列保存。
  • ✅ 在重载和关闭期间进行安全的同步最终保存。
  • ✅ 支持对离线玩家执行管理平衡命令。
  • ✅ 可配置的命令别名、金额 Tab 补全建议、静默标志和确认标志。
  • ✅ 针对 give、take、set 和 reset 操作的大额变更确认机制。
  • ✅ 可配置的管理员余额变更、迁移和 BeastWithdraw 交换审计日志。
  • ✅ PlaceholderAPI 余额和累计消耗占位符。
  • ✅ 可选集成 BeastWithdraw 或 BeastWithdraw Plus 以支持实体积分券和技能绑定票据。
  • ✅ 支持传统 & 颜色代码、十六进制 &#RRGGBB 颜色以及 MiniMessage 风格格式化。
  • ✅ 兼容 Java 8。

兑换流程

  1. 通过管理员命令或其他插件的命令奖励给予玩家积分。
  2. 玩家打开 /mcmmoredeem 命令。
  3. 玩家选择一个已启用的 mcMMO 技能。
  4. 交易菜单允许玩家提高、降低、重置或最大化兑换金额。
  5. BeastMcMMORedeem 检查余额、技能状态、已安装的 mcMMO 技能以及适用的等级模式技能上限。
  6. 确认后,应用技能进度,扣除积分,并更新累计消耗积分。

兑换 GUI 与交易菜单

  • ♦ 可配置菜单标题、行数、物品槽位、技能物品、信息物品和填充布局。
  • ♦ 主菜单可显示可用积分、累计消耗积分、插件信息以及所有已配置的技能。
  • ♦ 交易菜单显示所选技能、当前等级、目标等级、等级上限、余额、剩余积分和最大可兑换金额。
  • ♦ 可配置的 +amount 和 -amount 控制按钮。
  • ♦ 可配置 使用最大值、重置金额、返回、取消 和 确认兑换 操作。
  • ♦ 分别配置点击、确认、成功、失败和无积分状态的音效,包括音量和高低音调节。
  • ♦ 单个菜单项可以覆盖其动作音效。
  • ♦ 重复点击保护有助于防止意外重复的 GUI 操作。
  • ♦ 交易菜单可以在成功确认后自动关闭。

GUI 打开动画

  • ✨ SLIDE_LEFT_TO_RIGHT(从左向右滑动)
  • ✨ SLIDE_RIGHT_TO_LEFT(从右向左滑动)
  • ✨ SNAKE(蛇形)
  • ✨ DIAGONAL_WAVE(对角波浪)
  • ✨ CENTER_OUT(由中心向外扩散)
  • ✨ SPIRAL(螺旋)
  • ✨ RANDOM_POP(随机弹出)
  • ✨ RAIN(雨滴下落)

动画速度、开始延迟、每刻物品数、行暂停、占位物品、点击锁定以及开始/物品/行/结束音效均在 Menus/redeem-menu.yml 中可配置。

高级 GUI 物品自定义

  • ⚙ Material(材质)、Amount(数量)、Slot(槽位)和 Slots(槽位范围)
  • ⚙ DisplayName(显示名称)、DisplayLores(显示描述)、Lores(描述)和共享技能描述
  • ⚙ CustomModelData 和支持版本的 ItemModelData
  • ⚙ 物品 Flags(标签)、附魔 (Enchants)、发光 (Glow) 和不可破坏 (Unbreakable)
  • ⚙ Durability/Data(耐久度/数据值)以及皮革盔甲颜色
  • ⚙ 带有数量、操作类型和装备槽位的物品属性
  • ⚙ 玩家头颅拥有者、自定义头颅纹理和自定义物品数据
  • ⚙ 单个物品的音效、音量和高低音调节

支持的 mcMMO 技能

默认配置包含以下技能。在能够兑换之前,该技能也必须存在于已安装的 mcMMO 版本中。

  • ⚔ Acrobatics
  • ⚗ Alchemy
  • ? Archery
  • ? Axes
  • ? Crossbows
  • ⛏️ Excavation
  • ? Fishing
  • ? Herbalism
  • ⚒️ Maces
  • ⛏️ Mining
  • ⚒️ Repair
  • ⚔ Swords
  • ? Taming
  • ? Tridents
  • ✊ Unarmed
  • ? Woodcutting

从 Settings.Redeem.Skills 中移除技能以将其排除在兑换系统之外,或使用 Settings.DisabledSkills 临时禁用选定的技能。

存储选项

  • ♦ File(文件) — 每个玩家一个文件,位于 plugins/BeastMcMMORedeem/Players/<uuid>.yml。
  • ♦ SQL / SQLite — 本地数据库,默认为 plugins/BeastMcMMORedeem/data/credits.db。
  • ♦ MySQL — 远程数据库存储,支持可配置的表和连接池。
  • ♦ Legacy_YAML / YAML — 对现有数据和迁移的旧版单文件存储支持。
  • ⚡ 在线数据会被缓存并异步加载。
  • ⚡ 余额变更会被排队存入存储,而不会阻塞正常游戏流程。
  • ✅ 重载和关闭时会等待排队的写入操作,并在关闭存储前执行最终的同步保存。
  • ? /beastmcmmoredeem migrate yaml mysql 将旧版 YAML 的信用额度和已花费数据复制到 MySQL。

安全与管理

  • ⚠ 大幅度的管理信用额度变更默认需要配置好的 --confirm 标志。
  • ⚠ 确认阈值和保护的操作完全可配置。
  • ? 在对支持的管理命令添加 -s 参数可以防止向目标发送通知。
  • ✅ Give、take、set、reset、migration(迁移)以及 BeastWithdraw 交换操作均可记录到审计日志中。
  • ✅ 审计条目包含操作者、动作、目标、UUID、金额、之前余额、新余额、静默状态、确认状态以及适用的命令来源。
  • ✅ 余额不能低于零。
  • ✅ Settings.Credits.MaxBalance 可用于限制存储的信用额度上限。设置为 0 表示无上限。
  • ✅ 等级模式下的技能上限验证会在正常兑换扣除信用额度之前进行。

支持的插件与挂钩

  • ✅ BeastLib — 必需依赖项。
  • ✅ mcMMO — 提供兑换所使用的技能、等级、经验和等级上限。
  • ✅ PlaceholderAPI — 可选的公共余额和已花费占位符。
  • ✅ BeastWithdraw 或 BeastWithdraw Plus — 可选的物理信用票据和技能绑定的 mcMMO 进度票据。

BeastWithdraw 与 BeastWithdraw Plus 集成

当安装了兼容版本的 BeastWithdraw 或 BeastWithdraw Plus 时,玩家可以将 BeastMcMMORedeem 信用额度转入物理票据,并安全地兑换这些票据。集成检查玩家的剩余信用额度容量,以确保在配置的最大余额会阻止其全额价值时,票据不会被消耗。

技能绑定票据还可以将已经存储在 mcMMO 技能中的进度转移到物理票据中,并在稍后恢复到同一技能中。

  • ★ 主 BeastMcMMORedeem 信用额度提取命令:/mcmmocreditwithdraw
  • ★ 技能票据语法:/mcmmocreditwithdraw <skill> <amount|all> [stack]
  • ★ AUTO 技能票据模式遵循正常的 BeastMcMMORedeem 等级/经验模式。
  • ★ LEVELS 模式存储完整的技能等级。
  • ★ EXPERIENCE 模式存储通过 Settings.Redeem.XPPerCredit 转换的经验值单位。
  • ★ 启用的和禁用的 BeastMcMMORedeem 技能均受尊重。
  • ★ 恢复技能进度时会检查技能上限。
  • ★ 信用额度票据和技能票据的交换可以记录在 BeastMcMMORedeem 审计日志中。

安装

  1. 将 BeastLib 1.6.23 或更高版本 安装到服务器的 /plugins 文件夹中。
  2. 安装 mcMMO。
  3. 将 BeastMcMMORedeem JAR 放入服务器的 /plugins 文件夹中。
  4. 仅在使用相关集成时安装可选的 PlaceholderAPI、BeastWithdraw 或 BeastWithdraw Plus。
  5. 重启服务器。
  6. 配置 plugins/BeastMcMMORedeem/config.yml。
  7. 自定义 plugins/BeastMcMMORedeem/Menus/redeem-menu.yml 中的两个菜单。
  8. 自定义 plugins/BeastMcMMORedeem/Lang/en-US.yml 中的消息。

重要配置路径

  • ⚙ plugins/BeastMcMMORedeem/config.yml — 语言、信用额度、存储、MySQL、SQLite、别名、安全确认、审计日志、BeastWithdraw 技能票据、兑换模式和技能设置。
  • ⚙ plugins/BeastMcMMORedeem/Menus/redeem-menu.yml — 技能菜单、交易菜单、物品、槽位、填充物、动画、声音、调整值和菜单行为。
  • ⚙ plugins/BeastMcMMORedeem/Lang/en-US.yml — 默认消息、帮助页面、命令用法、前缀和兑换反馈。
  • ♦ plugins/BeastMcMMORedeem/Players/<uuid>.yml — 默认文件存储的玩家数据。
  • ♦ plugins/BeastMcMMORedeem/data/credits.db — 默认 SQLite 数据库路径。
  • ✅ plugins/BeastMcMMORedeem/logs/credits-audit.log — 默认审计日志路径。
  • ★ plugins/BeastWithdraw/Withdraws/BeastMcMMORedeem/Withdraw-Skill.yml — BeastWithdraw 技能票据物品和提取设置。
  • ★ plugins/BeastWithdraw/Withdraws/BeastMcMMORedeem/Depositer-Skills.yml — BeastWithdraw 技能票据存款设置。

默认命令与别名

兑换命令

  • 主命令:/mcmmoredeem
  • 默认别名:/redeem、/bmr 和 /skillredeem

信用额度命令

  • 主命令:/mcmmocredits
  • 默认别名:/mcredits、/skillcredits 和 /credits

管理命令

  • 主命令:/beastmcmmoredeem
  • 默认别名:/bmcmmo、/bmcmmor 和 /bmradmin

所有别名列表均可在 Settings.Commands 下配置。

玩家命令

  • /mcmmoredeem — 打开技能兑换菜单。
  • /mcmmoredeem help — 显示兑换命令帮助。
  • /mcmmoredeem <skill> — 打开所选技能的交易菜单。
  • /mcmmoredeem <skill> <amount> — 打开以该起始金额进行的所选技能交易,或在禁用直接菜单模式时直接兑换。
  • /mcmmoredeem credits — 查看您当前的兑换积分余额。
  • /mcmmoredeem send <player> <amount> — 向其他玩家发送积分。
  • /mcmmocredits — 查看您当前的兑换积分余额。

管理员命令

专用管理命令

  • /beastmcmmoredeem help
  • /beastmcmmoredeem reload
  • /beastmcmmoredeem version
  • /beastmcmmoredeem balance <player>
  • /beastmcmmoredeem give <player> <amount> [-s] [--confirm]
  • /beastmcmmoredeem take <player> <amount> [-s] [--confirm]
  • /beastmcmmoredeem set <player> <amount> [-s] [--confirm]
  • /beastmcmmoredeem migrate yaml mysql

通过兑换命令进行管理

  • /mcmmoredeem credits <player>
  • /mcmmoredeem add <player> <amount> [-s] [--confirm]
  • /mcmmoredeem remove <player> <amount> [-s] [--confirm]
  • /mcmmoredeem take <player> <amount> [-s] [--confirm]
  • /mcmmoredeem set <player> <amount> [-s] [--confirm]
  • /mcmmoredeem reset <player> [-s] [--confirm]
  • /mcmmoredeem reload
  • /mcmmocredits <player>

权限

玩家权限

  • BeastMcMMORedeem.Redeem — 打开主兑换 GUI。
  • BeastMcMMORedeem.Redeem.SkillCommand — 使用直接技能兑换命令。
  • BeastMcMMORedeem.Credits.Balance — 查看自己的余额。
  • BeastMcMMORedeem.Credits.Send — 向其他玩家发送积分。
  • BeastMcMMORedeem.Help — 查看兑换帮助菜单。

管理员权限

  • BeastMcMMORedeem.Admin — 所有 BeastMcMMORedeem 管理命令的父级权限。
  • BeastMcMMORedeem.Admin.Reload
  • BeastMcMMORedeem.Admin.Version
  • BeastMcMMORedeem.Admin.Credits.ViewOthers
  • BeastMcMMORedeem.Admin.Credits.Give
  • BeastMcMMORedeem.Admin.Credits.Take
  • BeastMcMMORedeem.Admin.Credits.Set
  • BeastMcMMORedeem.Admin.Credits.Reset
  • BeastMcMMORedeem.Admin.Migrate

PlaceholderAPI 占位符

  • %beastmcmmoredeem_credits% — 玩家当前的兑换积分余额。
  • %beastmcmmoredeem_creditsspent% — 玩家累计已兑换的积分。
  • %beastmcmmoredeem_credits_spent% — 累计消耗积分的替代占位符。

本地菜单占位符

BeastMcMMORedeem 提供的大小写形式可用于支持的菜单文本中。

  • %player%, %version%
  • %mcmmocredits%, %credits%, %creditsspent%
  • %skill%, %skill_material%
  • %skilllevel%, %levelcap%
  • %skillxp%, %skillxp_needed%
  • %amount%, %selected_amount%
  • %balance%, %remaining%, %max%
  • %targetlevel%, %xp_per_credit%

自定义

  • ⚙ 在 Settings.Credits.Storage.Type 更改存储后端。
  • ⚙ 在 Settings.Credits.StartingBalance 配置首次获得的积分。
  • ⚙ 在 Settings.Credits.MaxBalance 配置余额上限。
  • ⚙ 通过 Settings.Redeem.UseExperienceMode 在等级和 XP 兑换之间切换。
  • ⚙ 在 Settings.Redeem.XPPerCredit 设置每积分授予的 XP。
  • ⚙ 在 Settings.Redeem.Skills 下选择可用技能。
  • ⚙ 通过 Settings.DisabledSkills 暂时屏蔽技能。
  • ⚙ 在 Settings.Commands.*.Aliases 下更改所有公共命令别名。
  • ⚙ 通过 Settings.Commands.AmountSuggestions 更改 Tab 补全的数量建议。
  • ⚙ 通过 Settings.Commands.Confirmations 配置安全确认。
  • ⚙ 在 Settings.Commands.SilentFlag 配置静默标志。
  • ⚙ 在 Settings.Audit 下配置审计日志。
  • ⚙ 在 Settings.BeastWithdraw.SkillNotes 下配置 BeastWithdraw 的技能说明行为。
  • ⚙ 在 Lang/en-US.yml 中自定义消息和前缀。
  • ⚙ 在 Menus/redeem-menu.yml 中自定义 GUI 菜单、动画、物品模型、声音和选择器值。

开发者 API

BeastMcMMORedeem 公开了一个静态 API:

me.mraxetv.beastmcmmoiredeem.api.BeastMcMMORedeemAPI

  • ✦ 检查积分系统是否可用。
  • ✦ 读取、添加和扣除玩家积分。
  • ✦ 在应用前预览增加的余额。
  • ✦ 读取玩家的剩余可兑换容量。
  • ✦ 读取启用的技能名称并验证技能。
  • ✦ 集成积分说明和技能说明交换。

社区与支持

需要帮助配置兑换、存储、菜单、BeastWithdraw 或 BeastWithdraw Plus 说明,或占位符吗?发现了 Bug 或想建议新功能?

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源