Dechantments

## **✦ Dechantments** (https://img.shields.io/badge/Java-21-ff7f50?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net/) (https://img.shields.io/badge/Paper-1.21%2B-3cb371?style=for-the-badge&logo=papermc&logoColor=white)](https://papermc.io/) (https://img.shields.io/badge/Locale-zh__CN%20%7C%20en-6a5acd?style=for-the-badge)](#-localization) (https://img.shields.io/badge/Build-Gradle-1e90ff?style=for-the-badge&logo=gradle&logoColor=white)](#-local-development) > 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 - Java `21` - Paper `1.21+` --- ## 📦 Installation 1. Put `Dechantments-*.jar` into your server's `plugins/` folder. 2. Start the server once to generate default config and locale files. 3. Edit files under `plugins/Dechantments/` as needed: - `config.yml` - `locale/zh_CN.yml` - `locale/en.yml` 4. Use `/de reload` to hot-reload configuration. --- ## 🎮 Commands Main command: `/dechantments` (aliases: `/dechant`, `/de`) - `/de reload`: Reload config - `/de add <enchantment> `: 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: - `dechantments.admin` --- ## ⚙️ 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/` - `zh_CN.yml` - `en.yml` Built-in locale files are auto-extracted on first run, and can be edited directly afterward. --- ## 🧪 Local Development ```bash ./gradlew build ``` Build artifacts are generated at: - `build/libs/` --- ## 🖤 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: - (https://github.com/Iseason2000/DeEnchantment) Based on that idea, this project independently implements and extends support for the new Paper registry system, localization, and command/log experience.