โก FuryXenchantments โ Complete Plugin Development Prompt
- Plugin Overview
Develop a fully functional, high-quality Minecraft plugin named FuryXenchantments, designed for Minecraft Paper 1.21.11 using Java.
The plugin introduces powerful custom enchanted books with unique abilities, combat effects, special armor bonuses, mining rewards, summoning mechanics, and magical abilities.
The plugin should feel like a premium custom enchantment system for survival, PvP, SMP, and Lifesteal servers.
Plugin Requirements
- Plugin name: "FuryXenchantments"
- Minecraft version: Paper 1.21.11
- Programming language: Java
- Use Maven for dependency management and building.
- Main package: "com.furystudio.furyxenchantments"
- Plugin author: FuryStudio
- All enchantments must be configurable.
- All abilities must work reliably without server crashes or excessive lag.
- Use vanilla Minecraft items and entities wherever possible.
- Support anvil application, enchanted books, and configurable enchantment restrictions.
- Include "plugin.yml", configuration files, messages, permissions, and a complete source project.
- Build a ready-to-use ".jar" file.
- Custom Enchanted Books
Create custom enchanted books with unique names, descriptions, rarity levels, applicable items, and special effects.
Each custom book must have a distinctive name and lore so players can identify it easily.
- Thunderclaps โก
Applicable item: Sword
Ability:
- Every third successful sword hit on an enemy triggers a lightning strike.
- Lightning must damage the intended enemy rather than randomly targeting nearby players.
- Track successful hits separately for each attacker and target.
- Reset the hit counter after the third hit.
- Add lightning sound effects and particle animations.
- Allow configurable lightning damage, cooldown, and effects.
- Prevent unwanted environmental fires and excessive terrain damage.
- Avoid triggering on armor stands, the attacker, or unrelated entities.
Default activation: Every 3 successful hits.
- Doom Crusher ๐ฅ
Applicable item: Mace
Ability:
- Increase mace attack damage by 30%.
- When a mace successfully hits another player, launch the victim away with a powerful knockback effect.
- Make the knockback feel like a heavy impact rather than a normal sword hit.
- Add custom impact particles and sounds.
- Make the damage bonus and knockback configurable.
- Ensure the bonus is applied only once and does not stack repeatedly after re-equipping the mace.
- Include optional restrictions for PvP arenas and protected regions.
Default bonus: +30% mace damage.
- Ghost ๐ป
Applicable items: Helmet, chestplate, leggings, and boots.
Ability:
- When the wearer reaches 50% health or below, automatically apply a Regeneration effect.
- Trigger the ability when crossing the health threshold, not continuously on every tick.
- Add ghost-like particles and a sound effect.
- Provide configurable regeneration level, duration, and cooldown.
- Prevent repeated activation while the wearer remains below the health threshold.
- Allow the enchantment to work on individual armor pieces, with configurable behavior for multiple enchanted pieces.
Default activation: Health at or below 50%.
- Aquaman ๐
Applicable item: Helmet
Ability:
- Grant effectively infinite underwater breathing while the enchanted helmet is equipped.
- Prevent drowning damage while the ability is active.
- Restore normal behavior when the helmet is removed.
- Avoid permanently overwriting potion effects applied by other plugins.
- Optionally grant improved underwater vision and configurable underwater movement bonuses.
- Keep all optional effects disabled by default unless enabled in the configuration.
- Slasher ๐ก๏ธ
Applicable item: Sword
Ability:
- Give the sword damage comparable to a Sharpness VII sword.
- Implement the damage bonus safely using the Paper-compatible combat system.
- Avoid incorrectly adding a second Sharpness enchantment or allowing incompatible enchantments to bypass restrictions.
- Provide configurable damage strength and maximum enchantment level.
- Display the custom enchantment in the item's lore.
Default strength: Equivalent to Sharpness VII under the configured combat rules.
- Luck ๐
Applicable item: Pickaxe
Ability:
- Increase the number of eligible ores dropped when mined with the enchanted pickaxe.
- Example: Mining one diamond ore block can yield five diamonds.
- Support configurable multipliers for diamond, emerald, iron, gold, coal, redstone, lapis lazuli, copper, and other supported ores.
- Work correctly with both normal and deepslate ore variants.
- Respect Silk Touch and Fortune compatibility rules.
- Prevent duplicate rewards from block-break event exploits.
- Never multiply unrelated drops or accidentally duplicate container contents.
- Allow a configurable maximum number of drops per block.
Default example: 1 diamond ore can yield up to 5 diamonds.
- Summoner ๐ง
Applicable items: Complete enchanted armor set.
Ability:
- When a player wearing the complete Summoner armor set activates its ability, summon:
- 3 Ravagers. - 2 Iron Golems.
- The summoned creatures should protect their owner and attack eligible enemies.
- Iron Golems must actively target the owner's valid enemies rather than remaining idle.
- Display a summoning animation with particles and sounds.
- Add a configurable 10-minute cooldown.
- Show the remaining cooldown in a message when the player tries to reactivate the ability.
- Give summoned creatures identifiable metadata so the plugin can track and clean them up safely.
- Prevent summoned creatures from attacking their owner or teammates.
- Prevent them from being exploited for drops, experience, or permanent entity accumulation.
- Clean up summoned entities when appropriate and handle owner logout or server shutdown safely.
Default cooldown: 10 minutes.
Activation: Require all four armor pieces to have Summoner and provide an explicit activation method, such as a configurable sneak-and-right-click action.
- Dragon ๐
Applicable items: Complete enchanted armor set.
Ability:
- Require the player to wear a complete set of Dragon-enchanted armor.
- While sneaking, allow the player to activate the configured Dragon ability.
- Provide two magical attacks:
1. Dragon Breath: Launch a dragon-themed breath attack toward the player's target direction. 2. Fireball: Launch a fireball projectile with configurable damage, explosion power, and range.
- Provide a configurable method to switch between attacks.
- Add dragon particles, fire effects, and custom sound effects.
- Support temporary flight while the complete armor set is equipped.
- Flight must be safely enabled and disabled when the set is removed.
- Never overwrite unrelated flight permissions or flight states managed by other plugins.
- Include configurable flight speed, attack cooldowns, damage, and projectile limits.
- Prevent destructive terrain damage by default.
- Block abilities in configured protected regions and worlds.
Important activation behavior: Do not make the player permanently fly just by holding Shift. Use a configurable, unambiguous activation sequence, such as sneak plus right-click to toggle flight, and sneak plus another configured interaction to fire abilities. Prevent activation conflicts between flight and attacks.
- Additional Custom Enchanted Books
Add these extra enchantments to make FuryXenchantments more unique.
- Lifesteal ๐ฉธ
Applicable item: Sword
- Restore a configurable amount of health when successfully damaging an enemy.
- Add a configurable chance to activate.
- Never heal beyond the player's maximum health.
- Include a cooldown to prevent excessive healing.
- Phoenix ๐ฅ
Applicable items: Complete armor set
- When the wearer is defeated, optionally revive them once by restoring a configurable amount of health.
- Grant temporary Fire Resistance and brief protection after activation.
- Use a configurable long cooldown.
- Prevent activation in configured worlds or game modes.
- Ensure death events and inventory handling remain compatible with other plugins.
- Frostbite โ๏ธ
Applicable item: Sword
- Chance to slow an enemy after a successful hit.
- Add ice particles and freezing sounds.
- Allow configurable slow duration, effect strength, activation chance, and cooldown.
- Do not permanently freeze players or bypass server protection systems.
- Excavator โ๏ธ
Applicable item: Pickaxe
- Mine a configurable area of connected blocks or a defined 3ร3 mining plane.
- Preserve block drops and tool durability.
- Respect Silk Touch, Fortune, WorldGuard, and other protection plugins when present.
- Never break protected blocks or containers without permission.
- Include configurable block restrictions and cooldowns.
- Windwalker ๐ช๏ธ
Applicable items: Boots
- Grant a temporary speed boost and a small forward dash when activated.
- Add wind particles and sounds.
- Include a configurable cooldown and dash strength.
- Prevent players from using the dash to bypass movement restrictions or protected boundaries.
- Vampire Hunter ๐ฆ
Applicable item: Sword
- Deal bonus damage to configured hostile mobs.
- Allow optional bonus damage against undead enemies.
- Display a short effect animation on successful hits.
- Provide configurable damage bonuses and eligible mob types.
- Titan ๐ก๏ธ
Applicable items: Complete armor set
- Grant configurable damage resistance while the full armor set is equipped.
- Reduce incoming damage by a configurable percentage.
- Add a defensive activation ability with a cooldown.
- Prevent excessive stacking with other resistance enchantments.
- Magnetism ๐งฒ
Applicable item: Pickaxe
- Automatically attract eligible item drops toward the miner.
- Optionally collect eligible drops directly into the inventory.
- Leave items on the ground when the inventory is full.
- Respect pickup restrictions and protected-region rules.
- Never collect another player's private or protected drops.
- Shadowstep ๐
Applicable items: Boots
- Allow a short-range teleport or dash toward the direction the player is facing.
- Add shadow particles and a teleport sound.
- Check destination safety before teleporting.
- Prevent teleportation through protected boundaries or into solid blocks.
- Use configurable range and cooldown.
- Berserker โ๏ธ
Applicable item: Sword
- Increase damage while the player is below a configurable health threshold.
- Optionally grant a brief Speed effect.
- Prevent repeated stacking and excessive damage multiplication.
- Add an activation effect and configurable cooldown.
- Custom Enchantment Book System
Create a complete system for obtaining, identifying, applying, and managing custom enchanted books.
Each book must include:
- A unique display name.
- Custom lore describing the ability.
- Rarity, such as Common, Rare, Epic, Legendary, or Mythic.
- Applicable items.
- Enchantment level, where relevant.
- Configurable success and failure behavior.
- Persistent identification that cannot be spoofed by renaming a normal item.
- Optional custom model data for resource-pack support.
Books must retain their custom enchantments after relogging, server restarts, item transfers, and inventory storage.
Applying Books
- Allow players to apply compatible books through an anvil.
- Support configurable experience costs.
- Prevent incompatible books from being applied to invalid items.
- Provide clear messages for successful and unsuccessful applications.
- Preserve the enchantment when an item is repaired or renamed.
- Ensure custom enchantments do not disappear unexpectedly when combining items.
- Support configurable maximum enchantment levels.
Book Acquisition
Allow administrators to distribute books using commands.
Optionally support:
- Loot table integration.
- Configurable treasure chests.
- Custom crafting recipes.
- Villager trades.
- Configurable chances in supported rewards.
Disable all optional acquisition methods by default unless explicitly configured.
- Commands
Implement the following commands with tab completion.
- "/fxenchants" โ Display plugin information and available commands.
- "/fxenchants help" โ Show the help menu.
- "/fxenchants list" โ List all custom enchantments.
- "/fxenchants info <enchantment>" โ Show an enchantment's description and requirements.
- "/fxenchants give <player> <enchantment> [level] [amount]" โ Give a custom enchanted book.
- "/fxenchants apply <enchantment>" โ Optional command to apply an enchantment if enabled in the configuration.
- "/fxenchants reload" โ Reload supported configuration files.
- "/fxenchants toggle <enchantment>" โ Enable or disable an enchantment globally.
- "/fxenchants cooldown <player> <enchantment>" โ Inspect or reset an ability cooldown.
- "/fxenchants debug" โ Show diagnostic information for administrators.
Make the primary command alias configurable where practical.
- Permissions
Implement granular permissions:
- "furyxenchantments.use" โ Use permitted custom enchantments.
- "furyxenchantments.book.use" โ Apply custom enchanted books.
- "furyxenchantments.command.help" โ Access help.
- "furyxenchantments.command.list" โ List enchantments.
- "furyxenchantments.command.info" โ View enchantment information.
- "furyxenchantments.command.give" โ Give custom books.
- "furyxenchantments.command.reload" โ Reload configurations.
- "furyxenchantments.command.toggle" โ Toggle enchantments.
- "furyxenchantments.command.cooldown" โ Manage cooldowns.
- "furyxenchantments.command.debug" โ Access diagnostics.
Use "furyxenchantments.admin" as the overall administrator permission.
Regular players must not be able to grant themselves custom books or bypass cooldowns.
- Configuration Files
Organize the plugin into readable configuration files.
"config.yml"
Include:
- Plugin settings.
- Default enchantment enablement.
- Global cooldown settings.
- World restrictions.
- PvP restrictions.
- Region integration settings.
- Performance limits.
- Debug logging.
- Language selection.
"enchants.yml"
Store each enchantment's:
- Enabled state.
- Display name and lore.
- Rarity.
- Applicable items.
- Maximum level.
- Damage multiplier.
- Trigger chance.
- Cooldown.
- Potion effects.
- Summoned entity count.
- Ability duration.
- Particle and sound settings.
"messages.yml"
Allow server owners to customize all messages, including:
- Prefix.
- Permission errors.
- Invalid enchantment messages.
- Book application success.
- Cooldown warnings.
- Ability activation messages.
- Reload confirmation.
- Command usage.
"loot.yml"
Configure optional loot drops, treasure rewards, and enchantment book acquisition chances.
All settings should include comments and sensible defaults.
- User Interface and Visual Effects
Create polished, consistent visuals that match the FuryStudio brand.
- Use a configurable "&" color-code system or a compatible modern text component system.
- Support MiniMessage formatting if desired.
- Display enchantment names and descriptions clearly.
- Add appropriate particles and sounds to abilities.
- Provide optional cooldown feedback.
- Include a GUI enchantment menu with categories for Combat, Armor, Mining, and Special Abilities.
- Allow players to inspect enchantments without granting themselves books.
- Make the GUI optional and configurable.
Avoid excessive particles, unnecessary repeating tasks, and spammy action-bar messages.
- Compatibility and Anti-Exploit Protection
The plugin must:
- Target Paper 1.21.11 and Java 21 or the Java version required by the selected Paper build.
- Use APIs compatible with the target Paper version.
- Handle player damage, projectiles, armor changes, mining, and entity spawning correctly.
- Integrate with WorldGuard when installed, without making it a mandatory dependency unless explicitly required.
- Respect claims, protected regions, PvP-disabled worlds, and configurable combat rules.
- Prevent duplicate damage, duplicated ore drops, cooldown bypasses, and summon exploits.
- Avoid conflicts with vanilla enchantments and other popular plugins.
- Never permanently alter player attributes after an enchanted item is removed.
- Avoid unsafe reflection and NMS dependencies unless genuinely necessary.
- Store persistent data safely and clean up temporary entities and tasks.
- Include configurable logging for debugging and troubleshooting.
- Performance Requirements
- Do not run unnecessary per-player tasks every tick.
- Use event-driven mechanics wherever possible.
- Track cooldowns efficiently.
- Limit summoned mobs and projectile counts.
- Clean up temporary effects and entities.
- Avoid memory leaks after players disconnect.
- Ensure the plugin works on survival and PvP servers with many players.
- Final Deliverables
Provide a complete, compilable Maven project containing:
- All Java source files.
- "pom.xml".
- "plugin.yml".
- Default configuration files.
- All implemented enchantment mechanics.
- Command handlers and permission definitions.
- Enchanted book creation and identification logic.
- GUI implementation, if enabled.
- Installation instructions.
- Build instructions.
- A compiled "FuryXenchantments.jar", when the build environment supports compilation.
- A README with command usage, permissions, configuration explanations, and known compatibility limitations.
Do not deliver a partially implemented plugin, pseudocode, or placeholder abilities. Every listed enchantment must have a working implementation.
Before final delivery, verify that the project compiles, the plugin loads on Paper 1.21.11, all commands work, custom books persist correctly, cooldowns function, and enchantments respect the configured restrictions.
Final goal: Create a stable, configurable, premium-quality custom enchantment plugin called FuryXenchantments, powered by FuryStudio, with exciting combat, armor, mining, summoning, and magical abilities for Minecraft Paper 1.21.11.