SkinBoosts
一个适用于 Paper 1.21.x 的插件,根据玩家手持工具的 CustomModelData(皮肤)为其应用奖励倍率。支持 RivalHarvesterHoes、RivalMobSwords、RivalPickaxes 和 CyberLevels。
工作原理
SkinBoosts 监听由各个支持的插件触发的原生奖励事件。当奖励事件触发时,它会读取玩家主手工具中的 CustomModelData,并检查该值是否注册了加成。如果找到,它会在事件被处理之前直接乘以奖励——没有回退机制,也没有近似计算。
玩家收割 → RivalHoes 触发 HoeEssenceReceiveEnchantEvent
→ SkinBoosts 从手中读取 CMD(例如 1001)
→ 找到加成:essence x1.5
→ event.setEssence(essence * 1.5)
→ 玩家获得加成后的数量
该系统是无状态的——不存在每个玩家的缓存。加成是在每次事件发生时实时解析的,因此在会话期间更换工具会立即在下次收割时生效。
支持的插件
| 插件 |
事件 |
| RivalHarvesterHoes |
Essence, Money, Tool XP |
| RivalMobSwords |
Essence, Money, XP |
| RivalPickaxes |
Essence, Money, XP |
| CyberLevels |
XP |
所有集成均为软依赖——即使缺少其中任何一个,该插件也能正常加载和运行。
要求
- Paper 1.21.x
- Java 21
- 一个或多个支持的插件(可选,但需要它们才能触发加成)
- PlaceholderAPI(可选,用于占位符)
安装
- 将
SkinBoosts.jar 放入你的 plugins/ 文件夹中。
- 重启服务器 ——
plugins/SkinBoosts/config.yml 会自动生成。
- 通过
/skinboost set 或直接在 config.yml 中编辑来注册你的皮肤。
配置
skins:
1001:
name: '&cFire Pick' # 显示名称(可选,仅用于外观)
multipliers:
essence: 1.5 # 1.0 = 无变化,2.0 = 双倍
money: 1.2
tool-xp: 1.5
cyber-xp: 1.3
max-multipliers: # 每种类型的硬性上限。0.0 = 无限制
essence: 5.0
money: 5.0
tool-xp: 5.0
cyber-xp: 5.0
prefix: '&8[&6SkinBoosts&8] &r'
所有消息可在 messages: 部分进行配置。更改在 /skinboost reload 后生效。
命令
所有命令都需要 skinboosts.admin 权限(默认:op)。
| 命令 |
描述 |
/skinboost set <cmd|hand> [name] <essence> <money> <tool-xp> <cyber-xp> [player] |
注册或更新皮肤加成。使用 hand 从手中的物品读取 CMD。名称和玩家为可选参数。如果提供了玩家,则将其 CMD 应用到他们手中的物品上。 |
/skinboost remove <cmd> |
移除已注册的皮肤加成。 |
/skinboost list |
列出所有已注册的皮肤和当前限制。 |
/skinboost info [cmd] |
显示某个 CMD 的倍率。如果省略 CMD,则从手中读取。 |
/skinboost apply <cmd> [player] |
将 CustomModelData 应用到手中的物品。在游戏中玩家为可选参数,从控制台执行时为必需参数。 |
/skinboost reset [player] |
移除手中物品的 CustomModelData 并删除其注册的加成。在游戏中玩家为可选参数,从控制台执行时为必需参数。 |
/skinboost reload |
无需重启即可重新加载 config.yml。 |
示例
# 为 CMD 1001 注册加成(名称可选)
/skinboost set 1001 1.5 1.2 1.5 1.3
# 从手中物品读取 CMD 进行注册
/skinboost set hand Fire_Pick 2.0 1.5 2.0 1.5
# 注册加成并将 CMD 应用到你手中的物品(游戏中)
/skinboost set 730 3.0 3.0 3.0 3.0
# 注册加成并将 CMD 应用到某玩家手中的物品(控制台或游戏中)
skinboost set 730 3.0 3.0 3.0 3.0 Steve
# 将你手中的物品应用 CMD 730
/skinboost apply 730
# 将 CMD 730 应用到另一名玩家手中的物品
/skinboost apply 730 Steve
# 重置你手中的物品
/skinboost reset
# 从控制台重置
/skinboost reset Steve
占位符
需要 PlaceholderAPI。所有占位符均读取玩家主手中的物品。
| 占位符 |
示例值 |
描述 |
%skinboosts_essence% |
1.50 |
Essence 倍率 |
%skinboosts_money% |
1.20 |
Money 倍率 |
%skinboosts_toolxp% |
1.50 |
Tool XP 倍率 |
%skinboosts_cyberxp% |
1.30 |
Cyber XP 倍率 |
%skinboosts_essence_fmt% |
x1.50 |
带 x 前缀的 Essence 倍率 |
%skinboosts_money_fmt% |
x1.20 |
带 x 前缀的 Money 倍率 |
%skinboosts_toolxp_fmt% |
x1.50 |
带 x 前缀的 Tool XP 倍率 |
%skinboosts_cyberxp_fmt% |
x1.30 |
带 x 前缀的 Cyber XP 倍率 |
%skinboosts_name% |
Fire Pick |
当前激活皮肤的显示名称 |
%skinboosts_cmd% |
1001 |
原始 CustomModelData 值 |
%skinboosts_active% |
true |
该物品是否有注册的加成 |
如果物品没有注册的加成,则返回 1.00 / false / None / -1。
? 重要提示:
此插件是使用 AI 创建的,但我进行了广泛的测试以确保其在功能和性能方面完全可用。
SkinBoosts
A Paper 1.21.x plugin that applies reward multipliers to players based on the CustomModelData (skin) of the tool they are holding. Supports RivalHarvesterHoes, RivalMobSwords, RivalPickaxes, and CyberLevels.
How It Works
SkinBoosts listens to the native reward events fired by each supported plugin. When a reward event triggers, it reads the CustomModelData of the tool in the player's main hand and checks if a boost is registered for that value. If found, it multiplies the reward directly in the event before it is processed — no fallbacks, no approximations.
Player harvests → RivalHoes fires HoeEssenceReceiveEnchantEvent
→ SkinBoosts reads CMD from hand (e.g. 1001)
→ Finds boost: essence x1.5
→ event.setEssence(essence * 1.5)
→ Player receives boosted amount
The system is stateless — there is no per-player cache. The boost is resolved in real time on every event, so changing tools mid-session takes effect immediately on the next harvest.
Supported Plugins
| Plugin |
Events |
| RivalHarvesterHoes |
Essence, Money, Tool XP |
| RivalMobSwords |
Essence, Money, XP |
| RivalPickaxes |
Essence, Money, XP |
| CyberLevels |
XP |
All integrations are soft-depend — the plugin loads and runs normally even if any of them are absent.
Requirements
- Paper 1.21.x
- Java 21
- One or more of the supported plugins (optional but needed for boosts to fire)
- PlaceholderAPI (optional, for placeholders)
Installation
- Place
SkinBoosts.jar in your plugins/ folder.
- Restart the server —
plugins/SkinBoosts/config.yml is generated automatically.
- Register your skins with
/skinboost set or edit config.yml directly.
Configuration
skins:
1001:
name: '&cFire Pick' # Display name (optional, cosmetic only)
multipliers:
essence: 1.5 # 1.0 = no change, 2.0 = double
money: 1.2
tool-xp: 1.5
cyber-xp: 1.3
max-multipliers: # Hard cap per type. 0.0 = no limit
essence: 5.0
money: 5.0
tool-xp: 5.0
cyber-xp: 5.0
prefix: '&8[&6SkinBoosts&8] &r'
All messages are configurable under the messages: section. Changes take effect after /skinboost reload.
Commands
All commands require the skinboosts.admin permission (default: op).
| Command |
Description |
/skinboost set <cmd|hand> [name] <essence> <money> <tool-xp> <cyber-xp> [player] |
Register or update a skin boost. Use hand to read CMD from item in hand. Name and player are optional. If player is provided, applies the CMD to their item in hand. |
/skinboost remove <cmd> |
Remove a registered skin boost. |
/skinboost list |
List all registered skins and active limits. |
/skinboost info [cmd] |
Show multipliers for a CMD. Reads from hand if CMD is omitted. |
/skinboost apply <cmd> [player] |
Apply a CustomModelData to the item in hand. Player is optional in-game, required from console. |
/skinboost reset [player] |
Remove the CustomModelData from the item in hand and delete its registered boost. Player is optional in-game, required from console. |
/skinboost reload |
Reload config.yml without restarting. |
Examples
# Register a boost for CMD 1001 (name optional)
/skinboost set 1001 1.5 1.2 1.5 1.3
# Register reading CMD from item in hand
/skinboost set hand Fire_Pick 2.0 1.5 2.0 1.5
# Register boost and apply CMD to your item in hand (in-game)
/skinboost set 730 3.0 3.0 3.0 3.0
# Register boost and apply CMD to a player's item in hand (console or in-game)
skinboost set 730 3.0 3.0 3.0 3.0 Steve
# Apply CMD 730 to the item in your hand
/skinboost apply 730
# Apply CMD 730 to another player's item in hand
/skinboost apply 730 Steve
# Reset item in your hand
/skinboost reset
# Reset from console
/skinboost reset Steve
Placeholders
Requires PlaceholderAPI. All placeholders read the item in the player's main hand.
| Placeholder |
Example value |
Description |
%skinboosts_essence% |
1.50 |
Essence multiplier |
%skinboosts_money% |
1.20 |
Money multiplier |
%skinboosts_toolxp% |
1.50 |
Tool XP multiplier |
%skinboosts_cyberxp% |
1.30 |
Cyber XP multiplier |
%skinboosts_essence_fmt% |
x1.50 |
Essence multiplier with x prefix |
%skinboosts_money_fmt% |
x1.20 |
Money multiplier with x prefix |
%skinboosts_toolxp_fmt% |
x1.50 |
Tool XP multiplier with x prefix |
%skinboosts_cyberxp_fmt% |
x1.30 |
Cyber XP multiplier with x prefix |
%skinboosts_name% |
Fire Pick |
Display name of the active skin |
%skinboosts_cmd% |
1001 |
Raw CustomModelData value |
%skinboosts_active% |
true |
Whether the item has a registered boost |
Returns 1.00 / false / None / -1 if the item has no registered boost.
? Important:
This plugin was created using AI, but I ran extensive tests to ensure it is 100% functional in terms of both features and performance.
评论 0
登录后参与评分
还没有评论,来抢沙发吧