MaxEnchant

# MaxEnchant A lightweight Minecraft Bukkit/Spigot plugin that applies the highest survival-obtainable (vanilla) enchantments to items. ## Description MaxEnchant automatically adds all applicable positive enchantments to items while respecting vanilla compatibility and mutually exclusive enchantments. It excludes cursed enchantments and uses a preference order to resolve conflicts (for example, Sharpness vs Smite, Fortune vs Silk Touch). ## Features - Apply maximum survival-obtainable enchantments to the item in your main hand. - Apply max enchantments to the entire player inventory (including armor and offhand) with a single command. - Respects vanilla enchantment conflicts and excludes curses (Binding & Vanishing). - Preference order for mutually exclusive enchantments (configured in code). - Tab-completion for the inventory argument (`inv`). - Colorized messages with hex color support for modern server versions. ## Commands - `/maxenchant` (aliases: `/maxench`, `/enchantmax`) - No args: enchants the item in your main hand. - `inv`: enchants all enchantable items in the player's inventory, armor, and offhand. Examples: - `/maxenchant` — max out enchantments for the held item. - `/maxench inv` — max out enchantments for the entire inventory. ## Permissions - `maxenchant.use` — required to run the command (default: op). ## Installation 1. Build the plugin (Gradle/Maven or use the provided JAR in `build/libs`). 2. Place the produced `MaxEnchants-<version>.jar` into your server's `plugins/` folder. 3. Start or restart the server. Plugin main class and command are declared in `plugin.yml`: - main: `vadlox.dev.maxEnchants.MaxEnchants` - api-version: `1.19` ## Configuration All preferences for conflict resolution are defined in code (the `getPreferenceOrder()` method). If you want different priority rules, edit that method and recompile. ## Development - Java 17+ recommended depending on your server build. - The project uses the Bukkit/Spigot API. Building with Gradle (example): - `./gradlew build` (or `gradlew.bat build` on Windows) ## Troubleshooting - If the command does nothing, verify you have `maxenchant.use` permission or are OP. - If enchantments are not applied to certain items, they may not be compatible with those enchantments according to vanilla rules. ## Contributing Pull requests and issues are welcome. Adjust preference ordering or improve compatibility handling as needed. ## License Include your preferred license in this file or in a separate `LICENSE` file. (No license is specified by default.)