BeastMcMMoRedeem
现代 mcMMO 积分、动画兑换菜单与安全存储系统
给予玩家兑换积分,让他们将这些积分投入到自己选择的 mcMMO 技能中。
非常适合 生存 (Survival)、角色扮演 (RPG)、监狱 (Prison)、空岛 (Skyblock)、阵营 (Factions) 以及其他 基于进度 (progression-based) 的服务器。
BeastMcMMORedeem 是什么?
BeastMcMMORedeem 是一款专为 mcMMO 进度设计现代化的 Spigot/Paper 积分兑换插件。管理员和奖励系统可以向玩家发放兑换积分,而玩家则可以通过精美的技能菜单和可配置的交易选择器,决定将这些积分应用于哪些已启用的 mcMMO 技能。
积分可以用于增加完整的 mcMMO 等级,或者增加可配置的 mcMMO 经验值。该插件会追踪每个玩家的可用余额和累计消耗的积分总额,保护基于等级的兑换操作不超过 mcMMO 的技能上限,支持玩家之间的积分转移,并提供 File、SQLite 和 MySQL 三种存储方式。
必需依赖
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。
兑换流程
- 通过管理员命令或其他插件的命令奖励给予玩家积分。
- 玩家打开
/mcmmoredeem 命令。
- 玩家选择一个已启用的 mcMMO 技能。
- 交易菜单允许玩家提高、降低、重置或最大化兑换金额。
- BeastMcMMORedeem 检查余额、技能状态、已安装的 mcMMO 技能以及适用的等级模式技能上限。
- 确认后,应用技能进度,扣除积分,并更新累计消耗积分。
兑换 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 表示无上限。
- ✅ 等级模式下的技能上限验证会在正常兑换扣除信用额度之前进行。
支持的插件与挂钩
BeastWithdraw 与 BeastWithdraw Plus 集成
当安装了兼容版本的 BeastWithdraw 或 BeastWithdraw Plus 时,玩家可以将 BeastMcMMORedeem 信用额度转入物理票据,并安全地兑换这些票据。集成检查玩家的剩余信用额度容量,以确保在配置的最大余额会阻止其全额价值时,票据不会被消耗。
技能绑定票据还可以将已经存储在 mcMMO 技能中的进度转移到物理票据中,并在稍后恢复到同一技能中。
- ★ 主 BeastMcMMORedeem 信用额度提取命令:
/mcmmocreditwithdraw
- ★ 技能票据语法:
/mcmmocreditwithdraw <skill> <amount|all> [stack]
- ★ AUTO 技能票据模式遵循正常的 BeastMcMMORedeem 等级/经验模式。
- ★ LEVELS 模式存储完整的技能等级。
- ★ EXPERIENCE 模式存储通过
Settings.Redeem.XPPerCredit 转换的经验值单位。
- ★ 启用的和禁用的 BeastMcMMORedeem 技能均受尊重。
- ★ 恢复技能进度时会检查技能上限。
- ★ 信用额度票据和技能票据的交换可以记录在 BeastMcMMORedeem 审计日志中。
安装
- 将 BeastLib 1.6.23 或更高版本 安装到服务器的
/plugins 文件夹中。
- 安装 mcMMO。
- 将 BeastMcMMORedeem JAR 放入服务器的
/plugins 文件夹中。
- 仅在使用相关集成时安装可选的 PlaceholderAPI、BeastWithdraw 或 BeastWithdraw Plus。
- 重启服务器。
- 配置
plugins/BeastMcMMORedeem/config.yml。
- 自定义
plugins/BeastMcMMORedeem/Menus/redeem-menu.yml 中的两个菜单。
- 自定义
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 或想建议新功能?
BeastMcMMoRedeem
Modern mcMMO Credits, Animated Redeem Menus & Safe Storage
Give players redeem credits and let them invest those credits into the mcMMO skills they choose.
Perfect for Survival, RPG, Prison, Skyblock, Factions, and other progression-based servers.
What Is BeastMcMMORedeem?
BeastMcMMORedeem is a modern Spigot/Paper credit redemption plugin built for mcMMO progression. Administrators and reward systems can give players redeem credits, while players decide which enabled mcMMO skills receive them through a polished skill menu and configurable transaction selector.
Credits can add full mcMMO levels or a configurable amount of mcMMO experience. The plugin tracks each player's available balance and lifetime credits spent, protects level-based redemption from exceeding mcMMO skill caps, supports player-to-player credit transfers, and includes File, SQLite, and MySQL storage.
Required Dependencies
| Dependency |
Requirement |
| BeastLib |
Required — version 1.6.23 or newer |
| mcMMO |
Required for skill redemption |
BeastMcMMORedeem can start without mcMMO, but credits cannot be applied to skills until mcMMO is installed and enabled.
Main Features
- ✅ Complete redeem-credit system with current balance and lifetime credits-spent tracking.
- ✅ Modern 6-row skill selection GUI with configurable items, layout, fillers, sounds, and open animation.
- ✅ Dedicated transaction selector with positive and negative controls, reset, maximum, back, cancel, and confirmation actions.
- ✅ Configurable transaction adjustment values. The defaults are 1, 8, and 16.
- ✅ Level mode: one credit adds exactly one mcMMO skill level.
- ✅ Experience mode: one credit adds a configurable amount of mcMMO XP.
- ✅ mcMMO skill-cap protection for level-based redemption before credits are deducted.
- ✅ Configurable enabled skill list and a separate disabled-skill system.
- ✅ Direct skill commands that can open the transaction selector with a chosen starting amount.
- ✅ Optional chat amount entry when the transaction selector is disabled.
- ✅ Player-to-player credit transfers.
- ✅ Configurable starting balance and maximum balance.
- ✅ Per-player File storage, local SQLite storage, remote MySQL storage, and legacy single-file YAML support.
- ✅ Built-in asynchronous YAML-to-MySQL migration command.
- ✅ Online balance cache with asynchronous join loading and queued saves.
- ✅ Safe synchronous final saves during reload and shutdown.
- ✅ Offline-player support for administrative balance commands.
- ✅ Configurable command aliases, amount tab suggestions, silent flag, and confirmation flag.
- ✅ Large-change confirmation gate for give, take, set, and reset operations.
- ✅ Configurable audit log for administrative balance changes, migrations, and BeastWithdraw exchanges.
- ✅ PlaceholderAPI balance and lifetime-spent placeholders.
- ✅ Optional BeastWithdraw or BeastWithdraw Plus integration for physical credit notes and skill-bound notes.
- ✅ Legacy
& colors, hex &#RRGGBB colors, and MiniMessage-style formatting.
- ✅ Java 8 compatible.
How Redemption Works
- Give a player credits with an admin command or another plugin's command reward.
- The player opens
/mcmmoredeem.
- The player selects an enabled mcMMO skill.
- The transaction menu lets the player raise, lower, reset, or maximize the redeem amount.
- BeastMcMMORedeem checks the balance, skill status, installed mcMMO skill, and the applicable level-mode skill cap.
- After confirmation, the skill progress is applied, credits are deducted, and lifetime credits spent is updated.
Redeem GUI & Transaction Menu
- ♦ Configurable menu titles, row counts, item slots, skill items, information items, and filler layouts.
- ♦ The main menu can show available credits, lifetime credits spent, plugin information, and every configured skill.
- ♦ The transaction menu shows the selected skill, current level, target level, level cap, balance, remaining credits, and maximum redeemable amount.
- ♦ Configurable
+amount and -amount controls.
- ♦ Configurable Use Maximum, Reset Amount, Back, Cancel, and Confirm Redeem actions.
- ♦ Separate click, confirm, success, failure, and no-credit sounds with configurable volume and pitch.
- ♦ Individual menu items can override their action sound.
- ♦ Duplicate-click protection helps prevent accidental repeated GUI actions.
- ♦ The transaction menu can close automatically after a successful confirmation.
GUI Open Animations
- ✨
SLIDE_LEFT_TO_RIGHT
- ✨
SLIDE_RIGHT_TO_LEFT
- ✨
SNAKE
- ✨
DIAGONAL_WAVE
- ✨
CENTER_OUT
- ✨
SPIRAL
- ✨
RANDOM_POP
- ✨
RAIN
Animation speed, start delay, items per tick, row pauses, placeholder item, click locking, and start/item/row/finish sounds are configurable in Menus/redeem-menu.yml.
Advanced GUI Item Customization
- ⚙
Material, Amount, Slot, and Slots
- ⚙
DisplayName, DisplayLores, Lores, and shared skill lore
- ⚙
CustomModelData and supported-version ItemModelData
- ⚙ Item
Flags, Enchants, Glow, and Unbreakable
- ⚙
Durability/Data and leather armor colors
- ⚙ Item attributes with amount, operation, and equipment slot
- ⚙ Player skull owners, custom skull textures, and custom item data
- ⚙ Per-item sounds, volume, and pitch
Supported mcMMO Skills
The default configuration includes the following skills. A skill must also exist in the installed mcMMO version before it can be redeemed.
- ⚔ Acrobatics
- ⚗ Alchemy
- ? Archery
- ? Axes
- ? Crossbows
- ⛏️ Excavation
- ? Fishing
- ? Herbalism
- ⚒️ Maces
- ⛏️ Mining
- ⚒️ Repair
- ⚔ Swords
- ? Taming
- ? Tridents
- ✊ Unarmed
- ? Woodcutting
Remove skills from Settings.Redeem.Skills to exclude them from the redeem system, or use Settings.DisabledSkills to temporarily block selected skills.
Storage Options
- ♦ File — one player file at
plugins/BeastMcMMORedeem/Players/<uuid>.yml.
- ♦ SQL / SQLite — one local database at
plugins/BeastMcMMORedeem/data/credits.db by default.
- ♦ MySQL — remote database storage with configurable table and pooled connections.
- ♦ Legacy_YAML / YAML — older single-file storage support for existing data and migration.
- ⚡ Online data is cached and loaded asynchronously.
- ⚡ Balance changes are queued for storage without blocking normal gameplay.
- ✅ Reload and shutdown wait for queued writes and perform a final synchronous save before closing storage.
- ?
/beastmcmmoredeem migrate yaml mysql copies legacy YAML credit and spent data into MySQL.
Safety & Administration
- ⚠ Large administrative credit changes require the configured
--confirm flag by default.
- ⚠ The confirmation threshold and protected actions are fully configurable.
- ? Add
-s to a supported administrative command to prevent the target notification.
- ✅ Give, take, set, reset, migration, and BeastWithdraw exchange actions can be written to the audit log.
- ✅ Audit entries include actor, action, target, UUID, amount, previous balance, new balance, silent state, confirmation state, and command source where applicable.
- ✅ Balances cannot fall below zero.
- ✅
Settings.Credits.MaxBalance can cap stored credit balances. Set it to 0 for no cap.
- ✅ Level-mode skill cap validation occurs before a normal redemption removes credits.
Supported Plugins & Hooks
- ✅ BeastLib — required dependency.
- ✅ mcMMO — provides the skills, levels, experience, and level caps used by redemption.
- ✅ PlaceholderAPI — optional public balance and spent placeholders.
- ✅ BeastWithdraw or BeastWithdraw Plus — optional physical credit notes and skill-bound mcMMO progress notes.
BeastWithdraw & BeastWithdraw Plus Integration
When a compatible version of BeastWithdraw or BeastWithdraw Plus is installed, players can move BeastMcMMORedeem credits into physical notes and redeem those notes safely. The integration checks the player's remaining credit capacity so a note is not consumed when the configured maximum balance would block its full value.
Skill-bound notes can also move progress that is already stored in an mcMMO skill into a physical note and restore it to the same skill later.
- ★ Main BeastMcMMORedeem credit withdraw command:
/mcmmocreditwithdraw
- ★ Skill-note syntax:
/mcmmocreditwithdraw <skill> <amount|all> [stack]
- ★ AUTO skill-note mode follows the normal BeastMcMMORedeem level/experience mode.
- ★ LEVELS mode stores full skill levels.
- ★ EXPERIENCE mode stores XP units converted through
Settings.Redeem.XPPerCredit.
- ★ Enabled and disabled BeastMcMMORedeem skills are respected.
- ★ Skill caps are checked when skill progress is restored.
- ★ Credit-note and skill-note exchanges can be recorded in the BeastMcMMORedeem audit log.
Installation
- Install BeastLib 1.6.23 or newer in your server's
/plugins folder.
- Install mcMMO.
- Put the BeastMcMMORedeem JAR in your server's
/plugins folder.
- Install optional PlaceholderAPI, BeastWithdraw, or BeastWithdraw Plus only if you use those integrations.
- Restart the server.
- Configure
plugins/BeastMcMMORedeem/config.yml.
- Customize both menus in
plugins/BeastMcMMORedeem/Menus/redeem-menu.yml.
- Customize messages in
plugins/BeastMcMMORedeem/Lang/en-US.yml.
Important Config Paths
- ⚙
plugins/BeastMcMMORedeem/config.yml — language, credits, storage, MySQL, SQLite, aliases, safety confirmations, audit logging, BeastWithdraw skill notes, redeem mode, and skill settings.
- ⚙
plugins/BeastMcMMORedeem/Menus/redeem-menu.yml — skill menu, transaction menu, items, slots, fillers, animations, sounds, adjustment values, and menu behavior.
- ⚙
plugins/BeastMcMMORedeem/Lang/en-US.yml — default messages, help pages, command usage, prefixes, and redemption feedback.
- ♦
plugins/BeastMcMMORedeem/Players/<uuid>.yml — default File storage player data.
- ♦
plugins/BeastMcMMORedeem/data/credits.db — default SQLite database path.
- ✅
plugins/BeastMcMMORedeem/logs/credits-audit.log — default audit log path.
- ★
plugins/BeastWithdraw/Withdraws/BeastMcMMORedeem/Withdraw-Skill.yml — BeastWithdraw skill-note item and withdraw settings.
- ★
plugins/BeastWithdraw/Withdraws/BeastMcMMORedeem/Depositer-Skills.yml — BeastWithdraw skill-note deposit settings.
Default Commands & Aliases
Redeem command
- Main command:
/mcmmoredeem
- Default aliases:
/redeem, /bmr, and /skillredeem
Credits command
- Main command:
/mcmmocredits
- Default aliases:
/mcredits, /skillcredits, and /credits
Administration command
- Main command:
/beastmcmmoredeem
- Default aliases:
/bmcmmo, /bmcmmor, and /bmradmin
All alias lists are configurable under Settings.Commands.
Player Commands
/mcmmoredeem — open the skill redeem menu.
/mcmmoredeem help — show the redeem command help.
/mcmmoredeem <skill> — open the selected skill's transaction menu.
/mcmmoredeem <skill> <amount> — open the selected skill transaction with that starting amount, or redeem directly when direct-menu mode is disabled.
/mcmmoredeem credits — view your current redeem-credit balance.
/mcmmoredeem send <player> <amount> — send credits to another player.
/mcmmocredits — view your current redeem-credit balance.
Admin Commands
Dedicated administration command
/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
Administration through the redeem command
/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>
Permissions
Player permissions
BeastMcMMORedeem.Redeem — open the main redeem GUI.
BeastMcMMORedeem.Redeem.SkillCommand — use direct skill redemption commands.
BeastMcMMORedeem.Credits.Balance — view your own balance.
BeastMcMMORedeem.Credits.Send — send credits to another player.
BeastMcMMORedeem.Help — view the redeem help menu.
Admin permissions
BeastMcMMORedeem.Admin — parent permission for all BeastMcMMORedeem administration commands.
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 Placeholders
%beastmcmmoredeem_credits% — player's current redeem-credit balance.
%beastmcmmoredeem_creditsspent% — player's lifetime redeemed credits.
%beastmcmmoredeem_credits_spent% — alternate lifetime-spent placeholder.
Local Menu Placeholders
The lowercase and uppercase forms provided by BeastMcMMORedeem can be used in supported menu text.
%player%, %version%
%mcmmocredits%, %credits%, %creditsspent%
%skill%, %skill_material%
%skilllevel%, %levelcap%
%skillxp%, %skillxp_needed%
%amount%, %selected_amount%
%balance%, %remaining%, %max%
%targetlevel%, %xp_per_credit%
Customization
- ⚙ Change the storage backend at
Settings.Credits.Storage.Type.
- ⚙ Configure first-time credits at
Settings.Credits.StartingBalance.
- ⚙ Configure the balance cap at
Settings.Credits.MaxBalance.
- ⚙ Switch between level and XP redemption with
Settings.Redeem.UseExperienceMode.
- ⚙ Set XP granted per credit at
Settings.Redeem.XPPerCredit.
- ⚙ Select available skills under
Settings.Redeem.Skills.
- ⚙ Temporarily block skills through
Settings.DisabledSkills.
- ⚙ Change every public command alias under
Settings.Commands.*.Aliases.
- ⚙ Change tab-completion amounts through
Settings.Commands.AmountSuggestions.
- ⚙ Configure safety confirmations through
Settings.Commands.Confirmations.
- ⚙ Configure the silent flag at
Settings.Commands.SilentFlag.
- ⚙ Configure audit logging under
Settings.Audit.
- ⚙ Configure BeastWithdraw skill-note behavior under
Settings.BeastWithdraw.SkillNotes.
- ⚙ Customize messages and prefixes in
Lang/en-US.yml.
- ⚙ Customize both GUI menus, animations, item models, sounds, and selector values in
Menus/redeem-menu.yml.
Developer API
BeastMcMMORedeem exposes a public static API at:
me.mraxetv.beastmcmmoiredeem.api.BeastMcMMORedeemAPI
- ✦ Check whether the credit system is available.
- ✦ Read, add, and take player credits.
- ✦ Preview an added balance before applying it.
- ✦ Read a player's remaining redeemable capacity.
- ✦ Read enabled skill names and validate skills.
- ✦ Integrate credit-note and skill-note exchanges.
Community & Support
Need help configuring redemption, storage, menus, BeastWithdraw or BeastWithdraw Plus notes, or placeholders? Found a bug or want to suggest a new feature?
评论 0
登录后参与评分
还没有评论,来抢沙发吧