GemPlugin

# GemPlugin - Minecraft SMP Gem Abilities Plugin GemPlugin is a Minecraft 1.21.x plugin that adds gems and coresponding gadgets for them, looking to expand PVP for SMPs ## Features ### 16 Unique Gems Each gem has three core abilities activated by click combinations, with cooldown scaling based on gem level. Available gem types: - **Fire** - **Ice** - **Lava** - **Sand** - **Iron** - **Lightning** - **Strength** - **Healing** - **Air** - **Water** - **Shadow** - **Speed** - **Pain** - **Mining** - **Ender** - **Gluttony** ### Per-Gem Gadgets Every gem type has a matching gadget with its own 4th ability. Gadget system highlights: - **One gadget per gem type** - **Crafted from the matching gadget recipe layout with a Gadget Core in the center** - **Normal right-click opens the gadget binding menu** - **Shift + right-click activates the gadget ability** - **Gadgets can bind to any gem using persistent item metadata** - **Bindings can be removed and reassigned with `/gem unbind`** ### Gem Upgrading Gems support level progression from **1 to 5**. Each higher level reduces ability cooldowns using the configured `gem.gemlevelsteppercent` value. ### Other Included Items - **Gem Core** for gem crafting - **Gadget Core** for gadget crafting ## Commands ### `/gem gemrecipes` - **Permission**: `gemplugin.use` - **Description**: Open the recipe GUI for gems, gadgets, and cores ### `/gem unbind` - **Permission**: `gemplugin.use` - **Description**: Remove the bound gadget from the gem in your main hand ### `/gem givegem <player> <gemtype> ` - **Permission**: `gemplugin.givegem` - **Description**: Give a gem to a player - **Example**: `/gem givegem Steve fire 3` ### `/gem givegadget <type>` or `/gem givegadget <player> <type>` - **Permission**: `gemplugin.givegadget` - **Types**: `fire`, `ice`, `lava`, `sand`, `iron`, `lightning`, `strength`, `healing`, `air`, `water`, `shadow`, `speed`, `pain`, `mining`, `ender`, `gluttony`, `shadowcore` ### `/gem reload` - **Permission**: `gemplugin.admin` Legacy commands `/givegem`, `/givegadget`, `/gemrecipes`, and `/gemplugin reload` are still available for backward compatibility. ## Permissions - `gemplugin.givegem` (default: op) - `gemplugin.givegadget` (default: op) - `gemplugin.admin` (default: op) - `gemplugin.use` (default: true) ## Installation 1. Download the latest release 2. Place the `.jar` file in your server's `plugins` folder 3. Restart your server 4. Configure permissions as needed ## Configuration Key flags in `src/main/resources/config.yml`: - `dropgemondeath` (bool): whether gems drop on death - `dogadgets` (bool): enables gadget crafting, binding, and gadget abilities - `dogemupgrading` (bool): enables gem upgrading recipes - `nodoublegemuser` (bool): limits concurrent use of the same gem type - `debug` (bool): optional debug logging - `gem.gemlevelsteppercent` (double): cooldown reduction per gem level above 1 ## Compatibility - **Minecraft Version**: 1.21.x - **Supported Platforms**: Paper, Purpur, Spigot - **Build Target**: `spigot-api` - **Java Version**: 21 For issues, suggestions, or questions about the plugin, please create an issue in the repository. ## License Licensed under the **MIT License**. See the `LICENSE` file for details.