carvey_xd.yml

โšก FuryXenchantments โ€” Complete Plugin Development Prompt

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

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

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

  1. 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%.

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

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

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

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

  1. Additional Custom Enchanted Books

Add these extra enchantments to make FuryXenchantments more unique.

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

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

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

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

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

  1. 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.
  1. 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.
  1. Final Deliverables

Provide a complete, compilable Maven project containing:

  1. All Java source files.
  2. "pom.xml".
  3. "plugin.yml".
  4. Default configuration files.
  5. All implemented enchantment mechanics.
  6. Command handlers and permission definitions.
  7. Enchanted book creation and identification logic.
  8. GUI implementation, if enabled.
  9. Installation instructions.
  10. Build instructions.
  11. A compiled "FuryXenchantments.jar", when the build environment supports compilation.
  12. 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.

Kodari AI
KodariOct 21 at 1:57 pm 7
FuryXenchantments
A premium custom enchantment plugin for Paper 1.21.11, introducing 18 unique enchanted books with combat, armor, mining, summoning, and magical abilities. Features Thunderclaps lightning strikes, Doom Crusher mace knockback, Ghost regeneration, Aquaman underwater breathing, Slasher sharpness, Luck ore multiplication, Summoner entity spawning, Dragon breath/fireball attacks, plus Lifesteal, Phoenix, Frostbite, Excavator, Windwalker, Vampire Hunter, Titan, Magnetism, Shadowstep, and Berserker. Includes configurable enchanted book system, anvil application, commands with permissions, GUI menu, MiniMessage support, WorldGuard integration, and anti-exploit protections.
  1. Set up the Maven project, plugin metadata, and configurable defaults.

  2. Implement persistent custom books, anvil application, commands, and the optional inspection menu.

  3. Implement the 18 enchantments, cooldowns, safety checks, and summon/flight cleanup.

  4. Add usage and compatibility notes in the README.

Created the FuryXenchantments Maven project with all 18 enchantments, persistent custom books and anvil application, commands and permissions, configurable settings, an optional inspection menu, and optional WorldGuard checks. The README documents ability controls, configuration, compatibility notes, and installation.

To build and download the jar in Kodari: click Compile in the desktop top bar (or โ‹ฎ โ†’ Compile Project on phone), click Compile in the window, then click Download when it succeeds.

Kodari can make mistakes. Review important code before using.
Files
src
pom.xml
README.md
Code
14 1,806
src/main/java/com/furystudio/furyxenchantments/FuryXEnchantmentsPlugin.java
package com.furystudio.furyxenchantments;

import com.furystudio.furyxenchantments.command.FuryCommand;
import com.furystudio.furyxenchantments.gui.EnchantMenu;
import com.furystudio.furyxenchantments.listener.EnchantmentListener;
import org.bukkit.NamespacedKey;
import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.plugin.java.JavaPlugin;

import java.io.File;
import java.util.List;

public final class FuryXEnchantmentsPlugin extends JavaPlugin {
    private FileConfiguration enchants;
    private FileConfiguration messages;
    private FileConfiguration loot;
    private NamespacedKey enchantmentsKey;
    private NamespacedKey summonedOwnerKey;
    private NamespacedKey summonedKey;
    private NamespacedKey projectileKey;
    private EnchantMenu menu;
    private EnchantmentListener listener;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        saveResource("enchants.yml", false);
        saveResource("messages.yml", false);
        saveResource("loot.yml", false);
        enchantmentsKey = new NamespacedKey(this, "custom_enchantments");
        summonedOwnerKey = new NamespacedKey(this, "summon_owner");
        summonedKey = new NamespacedKey(this, "summoned_entity");
        projectileKey = new NamespacedKey(this, "dragon_projectile");
        reloadPluginFiles();
        menu = new EnchantMenu(this);
        listener = new EnchantmentListener(this);
        getServer().getPluginManager().registerEvents(listener, this);
        getServer().getPluginManager().registerEvents(menu, this);
        FuryCommand command = new FuryCommand(this);
        getCommand("fxenchants").setExecutor(command);
        getCommand("fxenchants").setTabCompleter(command);
        getLogger().info("FuryXenchantments enabled with " + EnchantType.values().length + " enchantments.");
    }

    @Override
    public void onDisable() {
        if (listener != null) listener.cleanup();
    }

    public void reloadPluginFiles() {
        reloadConfig();
        enchants = YamlConfiguration.loadConfiguration(new File(getDataFolder(), "enchants.yml"));
        messages = YamlConfiguration.loadConfiguration(new File(getDataFolder(), "messages.yml"));
        loot = YamlConfiguration.loadConfiguration(new File(getDataFolder(), "loot.yml"));
    }

    public FileConfiguration enchants() { return enchants; }
    public FileConfiguration messages() { return messages; }
    public FileConfiguration loot() { return loot; }
    public NamespacedKey enchantmentsKey() { return enchantmentsKey; }
    public NamespacedKey summonedOwnerKey() { return summonedOwnerKey; }
    public NamespacedKey summonedKey() { return summonedKey; }
    public NamespacedKey projectileKey() { return projectileKey; }
    public EnchantMenu menu() { return menu; }
    public EnchantmentListener listener() { return listener; }

    public boolean isWorldDisabled(String world) {
        return getConfig().getStringList("settings.disabled-worlds").stream().anyMatch(world::equalsIgnoreCase);
    }

    public boolean isPvPDisabled(String world) {
        return getConfig().getStringList("settings.pvp-disabled-worlds").stream().anyMatch(world::equalsIgnoreCase);
    }

    public boolean isEnabled(EnchantType type) {
        return enchants.getBoolean(type.id() + ".enabled", true);
    }

    public String message(String key) {
        return messages.getString(key, "&cMissing message: " + key);
    }

    public String prefix() { return message("prefix"); }

    public String format(String key, String... replacements) {
        String text = prefix() + message(key);
        for (int i = 0; i + 1 < replacements.length; i += 2) {
            text = text.replace(replacements[i], replacements[i + 1]);
        }
        return org.bukkit.ChatColor.translateAlternateColorCodes('&', text);
    }

    public List<String> configuredItemNames(EnchantType type) {
        return enchants.getStringList(type.id() + ".items");
    }
}