venoxfr

Create a Minecraft Paper 1.21.11 plugin named EnergyPvP.

General Requirements Language: Java 21 Server: Paper 1.21.11 Build Tool: Gradle Fully optimized for PvP servers.

No bugs or memory leaks.

All values configurable in config.yml.

Support PlaceholderAPI.

Support reload command.

Clean and modular code.

Main System

When a player joins the server for the first time, they must receive a Weapon Spin Wheel INVENTORY GUI.

The player cannot move until the wheel finishes.

The wheel should look like a casino wheel animation.

It spins for around 6 seconds.

Randomly selects ONE weapon.

Possible Weapons:

Iron Sword Iron Axe Trident Bow Shield Mace

After the animation:

Give the player the selected weapon.

Save it permanently.

Never give another weapon unless an admin resets it.

Permanent Weapon

The weapon is permanent.

Player can never lose it.

If:

dies drops it throws it burns lava cactus void explosion hopper chest inventory move

The weapon must never disappear.

Instead:

Cancel dropping.

Cancel moving.

Keep Inventory for weapon only.

Restore after death automatically.

Even if KeepInventory is false.

Energy System

Every player has Energy.

Default:

Energy: 0

Gain Energy

Every player kill

+1 Energy

Maximum configurable.

Lose Energy

When player dies

-1 Energy

Never below 0.

Display Energy:

ActionBar

Example

Energy: ⚡3

Also PlaceholderAPI:

%energypvp_energy%

Weapon Powers

Only active when

Energy >=5

If Energy becomes

4

Immediately remove powers.

Everything updates instantly.

Sword Ability

Weapon:

Iron Sword

Passive:

Player can critical hit

WITHOUT jumping.

Standing still criticals work.

Every third consecutive hit

deals a guaranteed critical strike.

Sequence:

Hit 1

Normal

Hit 2

Normal

Hit 3

Critical

Then reset.

Axe Ability

Weapon:

Iron Axe

Every successful hit

Roots target

for

3 seconds.

Target:

Cannot move.

Cannot jump.

Cannot sprint.

Can still attack.

Particles around feet.

Cooldown configurable.

Trident Ability

Every successful trident hit

Summons lightning directly on target.

Lightning lasts

3 seconds

Deals damage every second.

Shows lightning effects.

Cooldown configurable.

Bow Ability

When arrow hits player

Victim receives

Void Damage

for

5 seconds.

Meaning:

Every second

deal magic damage

while showing purple particles.

No fall damage.

No fire.

Pure void-style damage.

Cooldown configurable.

Shield Ability

Right click while holding shield.

Become invincible

for

5 seconds.

Block:

Sword

Axe

Bow

Trident

Mace

Explosion

Projectiles

Everything.

Shows blue particle aura.

Cooldown configurable.

Mace Ability

Holding mace

Removes mace smash cooldown.

Player can instantly perform another mace smash attack.

No waiting.

Cooldown configurable.

INVENTORY GUI

Command

/energy

Shows INVENTORY GUI.

Contains:

Weapon

Energy

Current Ability

Cooldown

Status

ACTIVE

or

LOCKED

Green if unlocked.

Red if locked.

Commands

/energy

Open INVENTORY GUI

/adminenergy set <player> <amount>

/adminenergy add <player> <amount>

/adminenergy remove <player> <amount>

/weaponreset <player>

Resets spin wheel.

Player gets new wheel next join.

Config

Everything configurable.

Spin duration

Weapons

Cooldowns

Energy required

Messages

Particles

Sounds

ActionBar

Titles

Lightning damage

Void damage

Root duration

Shield duration

Critical multiplier

Maximum Energy

INVENTORY GUI titles

Item names

Lore

Permissions

Data

Store player data in SQLite.

Save:

UUID

Weapon

Energy

Cooldowns

Statistics

Never lose progress.

Permissions

energypvp.use

energypvp.admin

energypvp.reset

Polish Beautiful sounds.

Titles when unlocking ability.

BossBar animation while spin wheel.

ActionBar energy counter.

No exploits.

No duplication.

Works with 100+ players.

Highly optimized for PvP.

Kodari AI
KodariJul 6 at 11:27 pm 3

I’ll create a comprehensive EnergyPvP plugin with spin wheel, permanent weapons, energy system, and 6 weapon abilities.

EnergyPvP
A PvP-focused Paper plugin featuring a weapon spin wheel for new players, permanent weapon system that prevents loss by any means, energy tracking with action bar display and PlaceholderAPI support, and six unique weapon abilities (Sword critical combo, Axe root, Trident lightning, Bow void damage, Shield invincibility, Mace smash) unlocked at 5+ energy. SQLite storage, fully configurable, optimized for 100+ players.

Let me start building all files.

I’ll create the complete EnergyPvP plugin. Let me start with the build files and config, then all source files.

Now creating all source files:

Now let me verify the proj is complete and fix any issues. Let me check the structure:

Let me create all the files properly. The project is empty, so I’ll write everything from scratch using <create> tags.

Now let me verify the file structure was created properly

All 24 source files are created. Let me also verify the build files

All 26 files created. Here’s the complete EnergyPvP plugin structure:

Project Structure

Plain Text
EnergyPvP/
├── build.gradle.kts          # Paper 1.21.1, Java 21, PAPI
├── settings.gradle.kts
├── src/main/resources/
│   ├── plugin.yml
│   └── config.yml            # All values configurable
└── src/main/java/com/energypvp/
    ├── EnergyPvP.java                     # Main class
    ├── util/
    │   ├── ColorUtil.java                 # MiniMessage color
    │   └── ConfigManager.java             # config.yml wrapper
    ├── data/
    │   ├── PlayerData.java                # UUID, weapon, energy, cooldowns
    │   └── DataManager.java               # SQLite persistence
    ├── weapon/
    │   ├── WeaponType.java                # Enum: IRON_SWORD, IRON_AXE, TRIDENT, BOW, SHIELD, MACE
    │   ├── WeaponManager.java             # Give weapon, check ownership, slot tracking
    │   ├── SpinWheelGUI.java              # Casino wheel animation GUI
    │   └── ability/
    │       ├── AbilityManager.java        # Routes abilities, checks energy >=5
    │       ├── SwordAbility.java          # 3-hit combo crits
    │       ├── AxeAbility.java            # 3s root on hit
    │       ├── TridentAbility.java        # Lightning strike on hit
    │       ├── BowAbility.java            # 5s void damage on arrow hit
    │       ├── ShieldAbility.java         # 5s invincibility on right-click
    │       └── MaceAbility.java           # Remove smash cooldown
    ├── energy/
    │   └── EnergyManager.java             # +1 kill, -1 death, actionbar, cap
    ├── gui/
    │   └── EnergyGUI.java                 # /energy inventory GUI
    ├── listener/
    │   ├── WeaponProtectionListener.java  # Cancel drop/move/throw/hopper/chest/death loss
    │   ├── PlayerListener.java            # First join → spin wheel, death restore
    │   └── CombatListener.java            # Kill/death tracking, ability attacks
    ├── command/
    │   ├── EnergyCommand.java             # /energy
    │   ├── AdminEnergyCommand.java        # /adminenergy set/add/remove
    │   └── WeaponResetCommand.java        # /weaponreset <player>
    └── placeholder/
        └── EnergyPlaceholder.java         # %energypvp_energy%

Key Features Delivered

Spin Wheel — Locks player movement, 6s casino animation with BossBar, random weapon selection, auto-give + save

Permanent Weapon — Cancels drop, inventory move, hopper extract, chest deposit. Auto-restores on death/respawn regardless of KeepInventory. Uses persistent data slot tracking

Energy System — ±1 per kill/death, action bar display (⚡), never below 0, configurable max, PlaceholderAPI

6 Weapon Abilities (all require Energy ≥5, auto-disable if <5):

  • Sword: Every 3rd hit = guaranteed critical (no jump needed)

  • Axe: Roots target 3s (no move/jump/sprint), particle feet

  • Trident: Lightning for 3s, damage every second

  • Bow: 5s void magic damage, purple particles

  • Shield: Right-click = 5s invincibility (all damage), blue aura

  • Mace: Instant smash, no cooldown

Commands: /energy, /adminenergy set/add/remove <player> <amount>, /weaponreset <player>

Permissions: energypvp.use, energypvp.admin, energypvp.reset

Storage: SQLite via JDBC — UUID, weapon, energy, cooldowns, stats

Config: Everything in config.yml — durations, cooldowns, max energy, messages, particles, sounds, titles, GUI names/lore, weapons list

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle.kts
Energy Smp
settings.gradle.kts
Code
29 2,050
src/main/java/com/energypvp/EnergyPvP.java
package com.energypvp;

import com.energypvp.command.AdminEnergyCommand;
import com.energypvp.command.EnergyCommand;
import com.energypvp.command.WeaponResetCommand;
import com.energypvp.data.DataManager;
import com.energypvp.energy.EnergyManager;
import com.energypvp.listener.CombatListener;
import com.energypvp.listener.PlayerListener;
import com.energypvp.listener.WeaponProtectionListener;
import com.energypvp.placeholder.EnergyPlaceholder;
import com.energypvp.util.ConfigManager;
import com.energypvp.weapon.WeaponManager;
import com.energypvp.weapon.ability.AbilityManager;
import net.kyori.adventure.text.minimessage.MiniMessage;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

import java.util.Objects;

public class EnergyPvP extends JavaPlugin {

    private static EnergyPvP instance;
    private ConfigManager configManager;
    private DataManager dataManager;
    private EnergyManager energyManager;
    private WeaponManager weaponManager;
    private AbilityManager abilityManager;

    @Override
    public void onEnable() {
        instance = this;
        saveDefaultConfig();

        this.configManager = new ConfigManager(this);
        this.dataManager = new DataManager(this);
        this.energyManager = new EnergyManager(this);
        this.weaponManager = new WeaponManager(this);
        this.abilityManager = new AbilityManager(this);

        // Register listeners
        Bukkit.getPluginManager().registerEvents(new PlayerListener(this), this);
        Bukkit.getPluginManager().registerEvents(new WeaponProtectionListener(this), this);
        Bukkit.getPluginManager().registerEvents(new CombatListener(this), this);

        // Register commands
        Objects.requireNonNull(getCommand("energy")).setExecutor(new EnergyCommand(this));
        Objects.requireNonNull(getCommand("adminenergy")).setExecutor(new AdminEnergyCommand(this));
        Objects.requireNonNull(getCommand("weaponreset")).setExecutor(new WeaponResetCommand(this));
        Objects.requireNonNull(getCommand("energy")).setTabCompleter(new AdminEnergyCommand(this));

        // Register PlaceholderAPI expansion
        if (Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null) {
            new EnergyPlaceholder(this).register();
            getLogger().info("PlaceholderAPI expansion registered!");
        }

        // Load all player data
        dataManager.loadAll();

        getLogger().info("EnergyPvP v" + getDescription().getVersion() + " enabled!");
    }

    @Override
    public void onDisable() {
        if (dataManager != null) {
            dataManager.saveAll();
        }
        getLogger().info("EnergyPvP disabled!");
    }

    public void reload() {
        reloadConfig();
        configManager.reload();
        dataManager.loadAll();
        getLogger().info("EnergyPvP reloaded!");
    }

    public static EnergyPvP getInstance() {
        return instance;
    }

    public ConfigManager getConfigManager() {
        return configManager;
    }

    public DataManager getDataManager() {
        return dataManager;
    }

    public EnergyManager getEnergyManager() {
        return energyManager;
    }

    public WeaponManager getWeaponManager() {
        return weaponManager;
    }

    public AbilityManager getAbilityManager() {
        return abilityManager;
    }
}