GemPlugin - Minecraft SMP Gem Abilities Plugin

GemPlugin is a Minecraft 1.21.x plugin centered around collectible gems, per-gem gadgets, custom crafting recipes, and combat-oriented abilities for SMP servers.

The plugin now targets the broader Bukkit-family API surface through spigot-api, so the same jar can be used on Paper, Purpur, and Spigot.

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> [level]

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