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.)