darksoul8094

Create a production-ready Minecraft Java plugin called "VyronEnchantments".

TARGET:

  • Minecraft: Java Edition 1.21.11
  • Server software: Paper
  • Java: 21+
  • Plugin must be optimized for public SMP servers.
  • Use Adventure API / MiniMessage for messages.
  • Use Bukkit/Paper API only where possible.
  • Do NOT require NMS unless absolutely necessary.

MAIN PURPOSE:

Create a custom enchantment system with 60 unique custom enchantments.

The plugin must support:

  • Custom enchanted books
  • Custom enchantment levels I, II and III
  • Custom enchantment effects
  • Custom particles
  • Custom sounds
  • Cooldowns
  • Activation chances
  • Item compatibility
  • Villager trading
  • Custom Enchanting Table system
  • Configuration files
  • Permissions
  • Admin commands
  • Persistent data using PersistentDataContainer
  • Reload support
  • Performance optimization

================================================== CUSTOM ENCHANTMENTS ==================================================

Create these 60 enchantments:

SWORD / AXE:

  1. Soul Reaper
  2. Void Strike
  3. Thunderlord
  4. Bloodlust
  5. Lifesteal
  6. Berserker
  7. Executioner
  8. Frostbite
  9. Venom
  10. Gravity
  11. Repulse
  12. Inferno
  13. Doom Mark
  14. Chain Reaction
  15. Vampiric Aura
  16. Rage Core
  17. Shadow Blade
  18. Armor Breaker
  19. Impact
  20. Soul Slash

ARMOR:

  1. Phoenix
  2. Titan
  3. Guardian
  4. Reflector
  5. Enderbound
  6. Shadowstep
  7. Windrunner
  8. Time Breaker
  9. Fortress
  10. Second Heart
  11. Astral Guard
  12. Ice Skin
  13. Infernal Skin
  14. Featherfall+

BOW / CROSSBOW:

  1. Storm Arrow
  2. Toxic Arrow
  3. Frost Arrow
  4. Death Mark
  5. Void Arrow
  6. Explosive Shot
  7. Piercing Soul
  8. Hunter's Eye

TOOLS:

  1. Miner's Fury
  2. Prospector
  3. Magnetism
  4. Blast Miner
  5. Ore Vision
  6. Chain Miner
  7. Tunnel Vision
  8. Fortune Master

FARMING / UTILITY:

  1. Lumberjack
  2. Harvester
  3. Hydro Boost
  4. Green Thumb
  5. Beekeeper
  6. Deep Fisher

SPECIAL:

  1. Elytra Surge
  2. Mace Mastery
  3. Reality Rift
  4. Chronoshift

================================================== RARITY SYSTEM ==================================================

Add 5 rarities:

COMMON RARE EPIC LEGENDARY MYTHIC

Distribution:

  • Common: 15
  • Rare: 15
  • Epic: 12
  • Legendary: 10
  • Mythic: 8

Every enchantment must have:

  • ID
  • Display name
  • Description
  • Rarity
  • Max level
  • Compatible items
  • Activation chance
  • Cooldown
  • Particle effect
  • Sound effect
  • Level I ability
  • Level II ability
  • Level III ability

Do NOT make all enchantments simple percentage damage increases.

Abilities should feel unique and powerful.

================================================== ENCHANTMENT BOOKS ==================================================

Custom enchanted books must be identifiable using PersistentDataContainer.

Example:

Item:

Enchanted Book

Display: "⚡ Thunderlord III"

Lore: "Summons lightning when attacking." "Rarity: LEGENDARY" "Level: III"

Custom books must not be confused with vanilla enchanted books.

Books must preserve their custom enchantment data when:

  • dropped
  • picked up
  • stored in chest
  • moved through inventory
  • traded
  • placed in an anvil

================================================== LEVEL SYSTEM ==================================================

Every enchantment supports:

Level I Level II Level III

Higher levels must improve the ability.

Example:

Thunderlord:

Level I: 15% activation chance.

Level II: 25% activation chance and stronger effect.

Level III: 35% activation chance, stronger lightning and chain effect.

Do similar progression for every enchantment.

================================================== VILLAGER SYSTEM ==================================================

Create a special Custom Enchantment Villager system.

Requirement:

A Villager must have 4 Lecterns positioned around it.

When the plugin detects the required 4 Lecterns around the Villager, the Villager becomes a Custom Enchantment Trader.

The trader should offer custom enchanted books.

The trade pool must include all 60 enchantments.

Trade rarity must affect:

  • Emerald price
  • Book level
  • Availability
  • Rarity

Common enchantments should be cheaper.

Mythic enchantments should be extremely expensive/rare.

Prevent exploits such as:

  • infinite trade generation
  • duplicated books
  • duplicated emeralds
  • invalid trade manipulation

Make the required Lectern arrangement configurable.

================================================== CUSTOM ENCHANTING TABLE ==================================================

Create a custom enchanting system.

Requirement:

  • Enchanting Table
  • 30 valid Bookshelves
  • Bookshelves must be within 10 blocks radius.

If 30 valid Bookshelves are detected:

Enable Custom Enchanting.

Players can then receive custom enchantments from the Enchanting Table.

Custom enchanting should use a weighted random system based on rarity.

Possible rarity chances should be configurable.

Example default:

Common: 40% Rare: 30% Epic: 18% Legendary: 9% Mythic: 3%

Do not replace vanilla enchanting completely.

Allow both vanilla enchantments and custom enchantments.

================================================== ANTI EXPLOIT ==================================================

Prevent:

  • Book duplication
  • Villager trade duplication
  • Inventory duplication
  • Anvil duplication
  • Item stacking exploits
  • Custom enchantment data loss
  • Invalid item combinations

Do not trust item display names alone.

Always identify custom enchantments using PersistentDataContainer.

================================================== ITEM COMPATIBILITY ==================================================

Each enchantment must have strict item compatibility.

Examples:

Soul Reaper:

SWORD

Mace Mastery:

MACE

Elytra Surge:

ELYTRA

Miner's Fury:

PICKAXE

Lumberjack:

AXE

Harvester:

HOE

Do not allow incompatible enchantments through anvils or commands unless explicitly forced by an admin command.

================================================== ANVIL SUPPORT ==================================================

Allow players to combine compatible custom enchanted books with compatible items using an Anvil.

Support:

Book + Item Book + Book

Book + Book should upgrade:

Thunderlord I + Thunderlord I = Thunderlord II

Thunderlord II + Thunderlord II = Thunderlord III

Do NOT allow:

Thunderlord III + Thunderlord III

Different custom enchantments may coexist if compatible.

Add configurable maximum enchantments per item.

================================================== COMMANDS ==================================================

Create:

/venchant

/venchant give <player> <enchantment> <level> [amount]

/venchant list

/venchant info <enchantment>

/venchant reload

/venchant debug

/venchant remove <player> <enchantment>

Tab completion is REQUIRED.

Examples:

/venchant give Steve thunderlord 3

/venchant give Steve soul_reaper 2 1

================================================== PERMISSIONS ==================================================

Create:

vyronenchantments.admin vyronenchantments.give vyronenchantments.reload vyronenchantments.list vyronenchantments.info vyronenchantments.debug

Default:

  • Normal players: no admin permissions
  • Admin: all permissions

================================================== CONFIGURATION ==================================================

Create:

config.yml enchantments.yml messages.yml trades.yml gui.yml

Everything important must be configurable.

Examples:

activation chances cooldowns damage multipliers particle types particle count sound rarity villager prices villager requirements bookshelf radius required bookshelf count enchanting rarity chances maximum enchantments per item messages prefix

================================================== PARTICLES & SOUNDS ==================================================

Every combat enchantment should have unique particles and sounds.

Examples:

Thunderlord:

Lightning + electric particles + thunder sound

Soul Reaper:

Soul particles + sculk/soul sound

Frostbite:

Snowflake-like particles + freeze sound

Void Strike:

Portal/dragon-like particles + teleport sound

Phoenix:

Flame particles + resurrection sound

Do not spam particles every tick.

Use efficient scheduled tasks.

================================================== COOLDOWNS ==================================================

Every active/triggered ability that could be abused must have cooldown support.

Cooldowns must be configurable per enchantment.

Store cooldowns efficiently.

Avoid creating unnecessary repeating tasks.

================================================== PERFORMANCE ==================================================

This plugin will run on a public SMP server.

Optimize for:

  • Low CPU usage
  • Low memory usage
  • No unnecessary repeating tasks
  • Event-driven architecture
  • Efficient nearby entity detection
  • Efficient bookshelf detection
  • Efficient cooldown handling

Never scan every loaded block/entity every tick.

Use caching where appropriate.

Clean caches when players leave.

================================================== GUI ==================================================

Create a professional GUI for:

/venchant list

Show:

  • Enchantment name
  • Rarity
  • Max level
  • Compatible items
  • Description

Clicking an enchantment should show detailed information.

Use a clean SMP-style design.

================================================== MESSAGES ==================================================

Use configurable MiniMessage messages.

Examples:

<green>✔ Custom enchantment applied!

<red>✘ This enchantment cannot be applied to this item.

<yellow>⚡ Thunderlord III activated!

<gray>Cooldown: 8 seconds

================================================== PLUGIN STRUCTURE ==================================================

Use clean OOP architecture.

Suggested structure:

com.vyronmc.enchantments

  • VyronEnchantments.java
  • enchantment/
  • enchantment.impl/
  • book/
  • villager/
  • enchanting/
  • anvil/
  • command/
  • listener/
  • gui/
  • rarity/
  • cooldown/
  • config/
  • util/

Create an Enchantment interface/base class.

Example:

CustomEnchantment

with methods such as:

getId() getDisplayName() getDescription() getRarity() getMaxLevel() getCompatibleItems() onAttack() onDamage() onBreak() onProjectileHit() onEquip() onUnequip() onKill() onDeath()

Only implement relevant event methods per enchantment.

================================================== IMPORTANT ==================================================

Do NOT create fake placeholder enchantments.

All 60 enchantments must have real functional abilities.

Do NOT use commands as the primary mechanic.

The enchantments must actually work on real Minecraft items.

Make the plugin compile successfully.

Provide:

  1. Complete source code
  2. plugin.yml
  3. config.yml
  4. enchantments.yml
  5. messages.yml
  6. trades.yml
  7. gui.yml
  8. README.md
  9. Build instructions
  10. Installation instructions

Use Maven or Gradle.

Prefer Maven unless there is a strong reason to use Gradle.

Make the final project directly buildable into a .jar.

Before finishing, check the entire project for:

  • compile errors
  • missing imports
  • API incompatibilities
  • duplicate classes
  • invalid Material names
  • incorrect Paper API usage
  • null pointer risks
  • event listener issues
  • item duplication exploits
  • thread-safety problems

The final result must be a professional, production-ready Paper plugin.

Kodari AI
KodariSep 22 at 5:58 am 4
VyronEnchantments
A comprehensive Paper plugin introducing 60 unique custom enchantments with a full progression system. Features custom enchanted books identified via PersistentDataContainer, a rarity system (Common to Mythic), and configurable activation chances, cooldowns, particles, and sounds. Includes a villager trading system requiring 4 lecterns, a custom enchanting table mechanic with 30 bookshelves, anvil combining support, and anti-exploit protections. Provides admin commands with tab completion, a professional GUI, and full configuration files. Built with event-driven architecture for optimal SMP performance.

Implementation plan:

  1. Build the Maven project, plugin entrypoint, configuration/messages, rarity and enchantment registry for all 60 enchantments.

  2. Add PDC-backed custom books/items, compatibility checks, cooldowns, and shared ability engine with event-driven triggers.

  3. Add enchanting-table, anvil, villager-trade, command/tab-completion, and GUI systems.

  4. Add all resource files and README with build/install instructions.

Implemented the initial VyronEnchantments project with:

  • Maven build targeting Java 21 and Paper 1.21.11

  • 60 registered custom enchantments

  • Five rarity tiers

  • PersistentDataContainer-backed custom enchantment books and item data

  • Custom enchantment levels I–III

  • Item compatibility validation

  • Cooldowns and activation chances

  • Combat, projectile, armor, mining, farming, fishing, Elytra, Mace, and survival abilities

  • Custom enchanting-table bookshelf requirements

  • Weighted rarity selection

  • Custom villager trading with lectern detection

  • Anvil book combining and application support

  • /venchant commands with tab completion

  • Permissions

  • MiniMessage messages

  • Enchantment list/detail GUI

  • Configuration files:

    • config.yml

    • enchantments.yml

    • messages.yml

    • trades.yml

    • gui.yml

  • README with build and installation instructions

The project files are now created under the Maven project structure.

Kodari can make mistakes. Review important code before using.
Files
src
pom.xml
README.md
Code
24 841
src/main/java/com/vyronmc/enchantments/VyronEnchantments.java
package com.vyronmc.enchantments;

import com.vyronmc.enchantments.anvil.AnvilListener;
import com.vyronmc.enchantments.command.VEnchantCommand;
import com.vyronmc.enchantments.config.ConfigManager;
import com.vyronmc.enchantments.cooldown.CooldownManager;
import com.vyronmc.enchantments.enchanting.CustomEnchantingListener;
import com.vyronmc.enchantments.enchantment.EnchantmentRegistry;
import com.vyronmc.enchantments.gui.EnchantmentGui;
import com.vyronmc.enchantments.item.ItemService;
import com.vyronmc.enchantments.listener.AbilityListener;
import com.vyronmc.enchantments.listener.PlayerCleanupListener;
import com.vyronmc.enchantments.villager.VillagerTradeListener;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

public final class VyronEnchantments extends JavaPlugin {
    private ConfigManager config;
    private EnchantmentRegistry registry;
    private ItemService items;
    private CooldownManager cooldowns;
    private EnchantmentGui gui;
    @Override public void onEnable() {
        config = new ConfigManager(this); registry = new EnchantmentRegistry(config); items = new ItemService(this, registry, config); cooldowns = new CooldownManager(); gui = new EnchantmentGui(this);
        register(new AbilityListener(this, items, cooldowns)); register(new PlayerCleanupListener(cooldowns)); register(new AnvilListener(items)); register(new CustomEnchantingListener(this, items)); register(new VillagerTradeListener(this, items)); register(gui);
        VEnchantCommand command = new VEnchantCommand(this); getCommand("venchant").setExecutor(command); getCommand("venchant").setTabCompleter(command);
        getLogger().info("Loaded " + registry.all().size() + " custom enchantments.");
    }
    public void reloadPlugin() { reloadConfig(); config.reload(); registry.load(config); }
    private void register(org.bukkit.event.Listener listener) { Bukkit.getPluginManager().registerEvents(listener, this); }
    public ConfigManager config() { return config; }
    public EnchantmentRegistry registry() { return registry; }
    public ItemService items() { return items; }
    public CooldownManager cooldowns() { return cooldowns; }
    public EnchantmentGui gui() { return gui; }
}