✦ Dechantments
一款 Paper 插件,为原版附魔增添叛逆的美学风格。
正面附魔有几率转化为负面附魔——你的装备现在自带时尚的风险。
✨ 这是什么插件?
Dechantments 通过概率机制,将原版附魔转换为对应的负面附魔(de_*),适用于多种来源场景。
目前支持以下场景:
- 附魔台结果转换
- 战利品附魔转换(宝箱 / 钓鱼等)
- 村民交易结果转换
此外还包含:
- 兼容 Paper
1.21 ~ 1.21.11
- 内置本地化:
zh_CN / en
- 样式化的命令面板与启动日志
- 转换发生时向玩家发送通知(类似“你的附魔看起来有点奇怪”的提示)
? 依赖项
? 安装
- 将
Dechantments-*.jar 放入服务器的 plugins/ 文件夹中。
- 启动服务器一次以生成默认的配置文件和本地化文件。
- 根据需要编辑
plugins/Dechantments/ 下的文件:
config.yml
locale/zh_CN.yml
locale/en.yml
- 使用
/de reload 热重载配置。
? 命令
主命令:/dechantments(别名:/dechant、/de)
/de reload:重新加载配置
/de add <enchantment> [level]:向手持物品添加一个负面附魔
/de remove <enchantment>:从手持物品移除一个负面附魔
/de list:列出手持物品上的所有负面附魔
/de info:显示插件信息
权限节点:
⚙️ 配置(快速概览)
config.yml 的核心结构:
global.locale: 语言(例如 zh_CN / en)
global.default-probability: 默认转换概率(0~1)
global.enable-enchant-table-transform: 附魔台转换开关
global.enable-loot-transform: 战利品转换开关
global.enable-villager-trade-transform: 村民交易转换开关
enchantments.<vanilla_key>: 针对单个附魔的控制项,包括 enabled/probability/max-level
? 本地化
本地化文件位于:plugins/Dechantments/locale/
内置的本地化文件会在首次运行时自动提取,之后可以直接编辑。
? 本地开发
./gradlew build
构建产物生成于以下位置:
? 设计理念
这不是为了削弱你的实力。
而是为你的附魔系统增添一份不可控的优雅。
❓ 常见问题
1) 为什么我看不到负面附魔?
请先检查以下几点:
- 你正在运行 Paper
1.21+
- 目标附魔在
config.yml 中设置了 enabled: true
- 相关的来源开关已启用(附魔台 / 战利品 / 村民交易)
2) 如何调整转换概率?
- 全局默认概率:
global.default-probability
- 单个附魔覆盖设置:
enchantments.<vanilla_key>.probability
数值范围为 0 ~ 1。例如,0.15 表示 15%。
3) 为什么我有时收不到“奇怪附魔”的通知?
该消息仅在事件实际发生转换时才会出现。
如果随机数未触发,或者该来源事件被禁用,则不会显示消息。
4) 我可以将插件切换为英文显示吗?
可以。在 config.yml 中将 global.locale 设置为 en,然后执行 /de reload。
5) 我可以自定义附魔名称和消息文本吗?
可以。请编辑:
plugins/Dechantments/locale/zh_CN.yml
plugins/Dechantments/locale/en.yml
? 灵感来源
本项目受以下项目启发:
基于这一理念,本项目独立实现并扩展了对新版 Paper 注册表系统、本地化以及命令/日志体验的支持。
✦ Dechantments
A Paper plugin that adds a rebellious aesthetic to vanilla enchantments.
Positive enchantments can turn into negative ones by chance—your gear now comes with stylish risk.
✨ What is this plugin?
Dechantments converts vanilla enchantments into matching negative enchantments (de_*) by probability across multiple sources.
Currently supported scenarios:
- Enchanting table result conversion
- Loot enchantment conversion (chests / fishing, etc.)
- Villager trade result conversion
Also includes:
- Compatibility with Paper
1.21 ~ 1.21.11
- Built-in localization:
zh_CN / en
- Styled command panel and startup logs
- Player notification when a conversion happens ("your enchantment looks a bit strange" vibe)
? Requirements
? Installation
- Put
Dechantments-*.jar into your server's plugins/ folder.
- Start the server once to generate default config and locale files.
- Edit files under
plugins/Dechantments/ as needed:
config.yml
locale/zh_CN.yml
locale/en.yml
- Use
/de reload to hot-reload configuration.
? Commands
Main command: /dechantments (aliases: /dechant, /de)
/de reload: Reload config
/de add <enchantment> [level]: Add a negative enchantment to the item in hand
/de remove <enchantment>: Remove a negative enchantment from the item in hand
/de list: List negative enchantments on the item in hand
/de info: Show plugin info
Permission node:
⚙️ Configuration (Quick Overview)
Core structure of config.yml:
global.locale: language (e.g. zh_CN / en)
global.default-probability: default conversion probability (0~1)
global.enable-enchant-table-transform: enchanting table conversion toggle
global.enable-loot-transform: loot conversion toggle
global.enable-villager-trade-transform: villager trade conversion toggle
enchantments.<vanilla_key>: per-enchantment controls for enabled/probability/max-level
? Localization
Locale files are located in: plugins/Dechantments/locale/
Built-in locale files are auto-extracted on first run, and can be edited directly afterward.
? Local Development
./gradlew build
Build artifacts are generated at:
? Design Philosophy
This is not about nerfing you.
It's about adding a bit of uncontrollable elegance to your enchantment system.
❓ FAQ
1) Why can’t I see negative enchantments?
Check these first:
- You are running Paper
1.21+
- The target enchantment has
enabled: true in config.yml
- The relevant source toggle is enabled (enchanting table / loot / villager trade)
2) How do I adjust conversion probability?
- Global default probability:
global.default-probability
- Per-enchantment override:
enchantments.<vanilla_key>.probability
The value range is 0 ~ 1. For example, 0.15 means 15%.
3) Why do I sometimes not get the “strange enchantment” notification?
The message only appears when a conversion actually occurs in that event.
If RNG doesn’t trigger, or that source event is disabled, no message is shown.
4) Can I switch the plugin to English display?
Yes. Set global.locale in config.yml to en, then run /de reload.
5) Can I customize enchantment names and message texts?
Yes. Edit:
plugins/Dechantments/locale/zh_CN.yml
plugins/Dechantments/locale/en.yml
? Inspiration
This project is inspired by:
Based on that idea, this project independently implements and extends support for the new Paper registry system, localization, and command/log experience.
评论 0
登录后参与评分
还没有评论,来抢沙发吧