Project Name: Legion Gems Developer Credit: DEADLY_PLAYZ Target API: Minecraft Paper 1.21+ Objective.
Develop a highly configurable, feature-rich custom gem plugin for Paper 1.21+. The plugin revolves around 15 unique, permanent "Gems" (represented by Echo Shards) that grant players powerful active and passive abilities.
- Core Gem Mechanics
Item Type: All gems are represented by an ECHO_SHARD.
Properties: Gems are completely unbreakable, unplaceable, unthrowable (cannot be dropped via 'Q'), and cannot be moved into chests or item frames. They are permanently bound to the player's inventory.
Lore Structure Template (Must be fully configurable in gems.yml): &8&m----------------------------------- &7A glowing shard pulsing with ancient power...
&6&lPassive Ability: &e[Passive Name] &7&o[Description of passive effect] &8» &fCurrent Buff: &a[Dynamic Stat, e.g., Speed II]
&c&lActive Ability: &e[Active Name] &7&o[Description of active effect] &8» &fPower: &c[Dynamic Stat, e.g., 5 AoE Damage] &8» &fCooldown: &b[Dynamic Cooldown] seconds
&e&lLevel Information: &8» &fCurrent Level: &e[Current Level]/5 &8» &fNext Upgrade: &7Requires 1x Legion Star &8&m----------------------------------- &e&oShift + Right-Click to activate!
Name Format: [Gem_Name] [Level] [Tier] (e.g., &c&l[Inferno] &e&l[Level 2] &4&l[Legion]).
Abilities:
Passive Abilities: Always active as long as the gem is held in the Main Hand or Offhand (e.g., permanent Speed II, Fire Resistance, or dynamic Sharpness buffs).
Active Abilities: Triggered by Shift + Right-Clicking while holding the gem. These have varying powers and cooldowns based on the gem's level and tier.
Cooldown Display: When a gem is in the main hand or offhand, its active ability cooldown should be displayed dynamically on the player's Action Bar (e.g., &cInferno Cooldown: 14s). When ready, it should display &a&lReady to Use!.
- Gem Tiers & Rarity
There are 15 total gems divided into 3 distinct tiers:
Mythic: Basic active abilities and minor passive buffs.
Magical: Medium-level powers, more complex abilities.
Legion: Endgame, high-level powers with massive impact and visual effects.
- New Player Experience
When a new player joins the server for the first time, they are automatically granted 1 random gem out of the 15 available.
They are also given a written book named &6&lTutorial Guide, containing fully configurable instructions on how the plugin works.
Global Announcement: Send a configurable chat message: &a[Player] just joined and awakened the [Gem Name] gem!
- Upgrade System (The Legion Star)
Levels: Each gem can be upgraded up to Level 5. Each level increases passive/active power and reduces the active ability cooldown.
Upgrade Item: Players must craft a Legion Star to upgrade their gem.
Custom Recipe (Crafting Table):
Row 1: Obsidian | Diamond Block | Obsidian Row 2: Obsidian | Nether Star | Obsidian Row 3: Obsidian | Diamond Block | Obsidian
Upgrade Mechanic: When a player obtains a Legion Star, they can type /gem upgrade to open a custom INVENTORY GUI menu. Clicking their gem in the INVENTORY GUI consumes the star and upgrades the gem.
Announcement: Upgrading to Level 5 broadcasts a server-wide title/chat message.
- This FEATURES must ADDED
Particle Effects & Sounds: Active abilities and level-ups must trigger custom particle effects and Minecraft sound effects to make them feel powerful.
Gem Rerolling: Players can craft or buy a "Reroll Token" (configurable item) to swap their current gem for a new random one, resetting its level to 1.
PlaceholderAPI Support: Add placeholders like %legiongems_gem_name%, %legiongems_gem_level%, and %legiongems_cooldown% for scoreboards.
Database Support: Save player gem data in SQLite (default) or MySQL to prevent data loss.
- Safezones & World Support
Safezones: Admins can define safezones where gem active abilities are disabled.
Command: Running /legion setsafezone creates a 30x30 block protection radius (size configurable in config.yml) around the admin where gems cannot be used.
- Configuration Files
Everything must be strictly configurable via .yml files: config.yml: Global settings, safezone radius, database settings, enable/disable specific gems. messages.yml: Every chat message, action bar text, and error message. gems.yml: Lore lines, display names, ability multipliers, and cooldown times for all 15 gems.
- Commands & Permissions
Provide at least 20 commands. Base commands are /legion (Admin) and /gem (Player). Must include full Tab-Completion.
Admin Commands (Permission: legiongems.admin): /legion help - View admin commands. /legion give <player> <gem_name> - Force give a specific gem. /legion random <player> - Give a random gem to a player. /legion setlevel <player> <1-5> - Force set a player's gem level. /legion reset <player> - Delete a player's gem from their inventory/data. /legion giveitem legionstar <player> <amount> - Give the upgrade item. /legion giveitem rerolltoken <player> <amount> - Give the reroll item. /legion setsafezone - Creates a safezone at the admin's location. /legion removesafezone - Removes the safezone the admin is standing in. /legion listsafezones - Lists coordinates of all safezones. /legion toggle <gem_name> - Globally enable/disable a specific gem. /legion bypass - Toggles admin bypass for cooldowns and safezones. /legion spy - See when players use their active abilities. /legion reload - Reloads all configuration files.
Player Commands (Permission: legiongems.player):
- /gem help - View player commands.
- /gem info - Shows detailed stats, lore, and current cooldown of their equipped gem.
- /gem upgrade - Opens the INVENTORY GUI to consume a Legion Star and level up.
- /gem reroll - Opens the INVENTORY GUI to consume a Reroll Token and get a new gem.
- /gem tutorial - Gives the player the tutorial book again.
- /gem list - Opens a INVENTORY GUI showcasing all 15 gems and their max-level stats.
- /gem togglepassive - Temporarily disables the player's own passive effects (if they want to turn off particles/speed).
====================================================================== STRICT COMPILATION & API ACCURACY RULES (CRITICAL - DO NOT VIOLATE) ======================================================================
- DO NOT hallucinate, invent, or assume any custom utility methods or non-existent library classes (e.g., do NOT use fake methods like 'circle()', '_spawn()', or ghost particle frameworks).
- Every single method call MUST belong strictly to the official Paper/Bukkit 1.21+ API or standard Java library signatures.
- For particle shapes (like circles, rings, or spheres), you MUST write the mathematical trigonometry loops (Math.sin, Math.cos) manually inside the code using standard
World.spawnParticle(...)methods. - Every single Java class must be 100% self-contained with exact, correct imports. No placeholders, no incomplete methods, and no missing method signatures across 'PassiveEffectApplier.java' and 'AbilityExecutor.java'. If you use a helper method, you MUST write its full implementation inside the class.
======================================================================
The generation was stopped before any content could be produced.
No files in this session