ayasopgo-svg

Create a complete, polished Minecraft Java Paper 1.21.11 plugin called EyeSMP.

The plugin should feel like a cinematic anime-style PvP SMP called VOID SMP, NOT a basic plugin.

Do NOT use BossBars.

━━━━━━━━━━━━━━━━━━━━ 🌌 SMP START SYSTEM ━━━━━━━━━━━━━━━━━━━━

The SMP does NOT start automatically.

Only an admin can start it:

/eyesmp start

Permission: eyesmp.admin

Before /eyesmp start:

  • Players are normal.
  • No Eyes are assigned yet.
  • Abilities are disabled.
  • The SMP is considered inactive.

When /eyesmp start is executed:

PHASE 1 — PREPARATION

Show everyone:

"§5§lVOID SMP" "§dThe world is about to awaken..."

Then:

  • Everyone is lifted/floated into the sky.
  • Players remain frozen in the air.
  • Teleport them to safe starting locations.
  • Hunger does NOT decrease.
  • Players cannot take damage.
  • Abilities are disabled.

Make sure players cannot fall or die during preparation.

━━━━━━━━━━━━━━━━━━━━ 👁️ EYE AWAKENING ━━━━━━━━━━━━━━━━━━━━

Before the actual SMP starts:

  • Assign every player exactly ONE permanent Eye.
  • Use the configured rarity chances.
  • Save the Eye permanently.
  • Show a dramatic title for each player.

Example:

§5§lYOUR EYE HAS AWAKENED

§d⚫ DEATH EYE

Then play:

  • Eye-colored particles
  • Sound
  • Flash/burst effect
  • Animated rings around the player

Every Eye has its own color and visual theme.

━━━━━━━━━━━━━━━━━━━━ ⏳ FINAL COUNTDOWN ━━━━━━━━━━━━━━━━━━━━

After everyone receives their Eye:

Show a large center-screen countdown:

10 9 8 7 6 5 4 3 2 1

Each number should have:

  • Title animation
  • Sound
  • Particles

At "1":

Play a powerful activation effect.

Then display:

§5§lVOID SMP §dTHE SMP HAS BEGUN

━━━━━━━━━━━━━━━━━━━━ ☁️ SKY DROP / LAUNCH ━━━━━━━━━━━━━━━━━━━━

When the countdown reaches 0:

  • Everyone remains floating in the sky for exactly 10 seconds.
  • Players can look around and choose their direction.
  • Their movement is restricted during this 10-second preparation.
  • Hunger does not decrease.
  • Players cannot damage each other.

After 10 seconds:

EVERY PLAYER IS LAUNCHED IN THE EXACT DIRECTION THEY ARE LOOKING.

Use the player's looking direction as the launch vector.

Example:

Looking north → launched north.

Looking upward → launched upward safely.

Looking diagonally → launched diagonally.

Give the launch:

  • Strong velocity
  • Eye-colored particle trail
  • Wind/launch sound
  • Camera/visual effects if possible

Prevent players from being launched into completely unsafe situations.

━━━━━━━━━━━━━━━━━━━━ 🛡️ GRACE PERIOD ━━━━━━━━━━━━━━━━━━━━

After the launch:

Start a 10-minute grace period.

During grace:

  • PvP disabled.
  • Players cannot damage each other.
  • Players cannot use offensive Eye abilities against players.
  • Hunger does NOT decrease.
  • Players can explore, mine and prepare.
  • Death does not remove their Eye.

Show:

§a§lGRACE PERIOD §fPvP starts in §e10:00

Use action-bar countdowns.

DO NOT use a BossBar.

When grace reaches 0:

Play a warning sound.

Display:

§c§lGRACE PERIOD ENDED §fPvP IS NOW ENABLED

━━━━━━━━━━━━━━━━━━━━ 🌍 WORLD ━━━━━━━━━━━━━━━━━━━━

The playable world should be configurable.

Default world border:

Randomly choose a size between: 15,000 and 30,000 blocks.

Make this configurable:

world: min-border: 15000 max-border: 30000

The border should be centered around the SMP spawn.

Do not randomly teleport players outside the border.

━━━━━━━━━━━━━━━━━━━━ 👁️ EYE SYSTEM ━━━━━━━━━━━━━━━━━━━━

Eyes:

🔴 Blood Eye — 40% 🟢 Nature Eye — 25% 🟣 Void Eye — 15% 🟡 Golden Eye — 10% ⚫ Death Eye — 9.9% 🔵 Time Eye — 0.1%

Every player receives exactly one Eye.

Players cannot normally:

  • Drop it
  • Trade it
  • Transfer it

Commands:

/eye info /eye give <player> <eye> /eye reset <player> /eye reload

━━━━━━━━━━━━━━━━━━━━ ⚔️ ABILITY SYSTEM ━━━━━━━━━━━━━━━━━━━━

F = NORMAL ABILITY SHIFT + F = ULTIMATE

IMPORTANT:

Paper does not normally expose the physical F key.

Implement the most reliable compatible solution for Paper 1.21.11 and clearly explain if a client-side keybind/mod is required.

Normal abilities:

  • Short cooldown, generally 5–15 seconds.

Ultimate abilities:

  • Long cooldown, generally 45–120 seconds.

Cooldowns must be separate and configurable.

Do NOT make both abilities 10 seconds.

━━━━━━━━━━━━━━━━━━━━ 🔴 BLOOD EYE ━━━━━━━━━━━━━━━━━━━━

PASSIVE — BLOODLUST Lower HP = higher attack damage.

NORMAL — BLOOD RUSH

  • Dash toward the direction the player is looking.
  • Damage enemies hit.
  • Apply short bleed.
  • Gain temporary speed.
  • Red blood trail.

ULTIMATE — BLOOD REIGN

  • Create a large blood zone.
  • Enemies inside take damage over time.
  • Blood Eye gains resistance.
  • Damage dealt partially heals the caster.
  • Red particles spiral around the caster.
  • Finish with a large blood explosion.

━━━━━━━━━━━━━━━━━━━━ 🔵 TIME EYE ━━━━━━━━━━━━━━━━━━━━

PASSIVE — TIME SENSE Blue clock particles orbit the player.

NORMAL — TIME DASH

  • Rapid dash/teleport forward.
  • Leave a blue afterimage.
  • Enemies passed through are slowed.

ULTIMATE — TIME STOP

  • Freeze nearby enemies for 3 seconds.
  • They cannot move, attack or use abilities.
  • Blue clock rings surround frozen players.
  • When time resumes, release a shockwave and damage.

━━━━━━━━━━━━━━━━━━━━ 🟣 VOID EYE ━━━━━━━━━━━━━━━━━━━━

PASSIVE — VOID AURA Purple/black particles orbit the player.

NORMAL — VOID STEP

  • Teleport where the player is looking.
  • Create a purple trail between positions.

ULTIMATE — BLACK HOLE

  • Create a large temporary black hole.
  • Pull nearby enemies toward the center.
  • Damage enemies over time.
  • Slow players near the center.
  • End with a massive void explosion.

━━━━━━━━━━━━━━━━━━━━ 🟢 NATURE EYE ━━━━━━━━━━━━━━━━━━━━

PASSIVE — NATURE BLESSING Leaves/vines/green particles orbit the player.

NORMAL — NATURE ARMY

  • Summon MULTIPLE temporary grass/dirt blocks.
  • Blocks orbit the player.
  • Blocks can act as a temporary shield.
  • Blocks can launch toward enemies.
  • Blocks can create temporary platforms.
  • Blocks can rise from the ground.
  • Never permanently grief the world.

ULTIMATE — WRATH OF NATURE Create a large nature arena.

  • Grass spreads visually.
  • Vines grow.
  • Multiple blocks rise.
  • Roots attack nearby enemies.
  • Enemies are slowed by roots.
  • Floating blocks can launch at enemies.
  • Massive green nature explosion at the end.
  • Restore all temporary blocks afterward.

━━━━━━━━━━━━━━━━━━━━ 🟡 GOLDEN EYE ━━━━━━━━━━━━━━━━━━━━

PASSIVE — GOLDEN AURA Golden particles and rotating rings.

NORMAL — POWER BREAK

  • Target an enemy.
  • Disable their Eye temporarily.
  • Golden rings surround the target.

ULTIMATE — DIVINE BEAM

  • Charge a huge golden beam.
  • Rotating golden rings appear.
  • Powerful beam fires forward.
  • Heavy damage and knockback.
  • Shields cannot block it.
  • Massive golden impact.

━━━━━━━━━━━━━━━━━━━━ ⚫ DEATH EYE ━━━━━━━━━━━━━━━━━━━━

PASSIVE — DEATH AURA Dark purple/black soul particles.

NORMAL — DEATH MARK

  • Mark an enemy.
  • Increase damage against them.
  • Slightly slow them.
  • Dark particles follow them.
  • Killing the marked player restores health.

ULTIMATE — DEATH SENTENCE

  • Select one enemy.
  • Trap/freeze them.
  • Disable their Eye.
  • Dark ring surrounds them.
  • Death Eye gains increased damage.
  • End with a massive dark explosion.

━━━━━━━━━━━━━━━━━━━━ ✨ VISUAL SYSTEM ━━━━━━━━━━━━━━━━━━━━

Every Eye must look completely different.

Each player gets 3 animated rotating rings:

RING 1:

  • Feet
  • Clockwise

RING 2:

  • Waist
  • Counter-clockwise

RING 3:

  • Above head
  • Slow rotation

Use the Eye's color.

Add:

  • Orbiting particles
  • Rising particles
  • Pulsing aura
  • Ability activation bursts
  • Eye-specific sounds
  • Eye-specific particles
  • Ultimate animations

No boring white particles.

━━━━━━━━━━━━━━━━━━━━ 🎨 EYE COLORS ━━━━━━━━━━━━━━━━━━━━

Blood = Dark Red Time = Bright Blue Void = Purple/Black Nature = Green Golden = Gold Death = Dark Purple/Black

Use these colors for:

  • Names
  • Titles
  • Particles
  • Rings
  • Ability effects
  • Sounds/visual themes

━━━━━━━━━━━━━━━━━━━━ ⚙️ CONFIG ━━━━━━━━━━━━━━━━━━━━

Everything important should be configurable:

  • Eye chances
  • Normal cooldowns
  • Ultimate cooldowns
  • Damage
  • Range
  • Durations
  • Particle amounts
  • Ring size
  • Ring speed
  • Nature block count
  • Grace period
  • Sky-drop duration
  • World border size
  • PvP settings
  • Messages
  • Sounds
  • Ability enable/disable

━━━━━━━━━━━━━━━━━━━━ 🛡️ SAFETY / PERFORMANCE ━━━━━━━━━━━━━━━━━━━━

  • No permanent world griefing.
  • Nature blocks must restore.
  • No duplication.
  • No unsafe teleporting.
  • No self/spectator targeting.
  • Clean up temporary effects.
  • Handle disconnects/deaths/restarts.
  • Avoid memory leaks.
  • Optimize particle animations.
  • Do not spawn huge amounts of particles every tick.

━━━━━━━━━━━━━━━━━━━━ 📁 CODE ━━━━━━━━━━━━━━━━━━━━

Use clean modular Java classes:

EyeSMP ├── Core ├── Eye system ├── Ability system ├── Start/phase system ├── Countdown system ├── Grace system ├── World system ├── Effects/animations ├── Cooldowns ├── Commands ├── Listeners ├── Storage └── Utilities

Do NOT put everything in one class.

━━━━━━━━━━━━━━━━━━━━ 📦 OUTPUT ━━━━━━━━━━━━━━━━━━━━

Provide:

  • Complete source code
  • plugin.yml
  • config.yml
  • pom.xml/Gradle
  • Build instructions
  • Installation instructions
  • F/Shift+F input setup

FIRST explain the architecture and startup flow.

Then generate the complete production-ready plugin.

The final experience should feel like:

JOIN SERVER ↓ Wait for admin ↓ /eyesmp start ↓ Players rise into the sky ↓ Eye Awakening ↓ Unique Eye assigned ↓ Cinematic countdown 10 → 1 ↓ "VOID SMP HAS BEGUN" ↓ 10 seconds floating in sky ↓ Players choose direction ↓ EVERYONE LAUNCHES FORWARD ↓ 10 MINUTE GRACE PERIOD ↓ PvP ENABLES ↓ EYE POWERS + CINEMATIC COMBAT

Make it feel like a real custom SMP, not a collection of basic Bukkit abilities.

Kodari AI
KodariAug 16 at 1:08 pm 3
VoidSMP
A cinematic anime-style PvP SMP plugin for Paper 1.21.11. Features an admin-triggered start sequence with sky preparation, dramatic Eye Awakening assigning each player one of six unique Eyes (Blood, Nature, Void, Golden, Death, Time) with distinct visuals, abilities, and ultimates. Includes a 10-second sky-drop launch, 10-minute grace period, configurable world border, and a comprehensive GUI-based ability system. All abilities, cooldowns, visuals, and effects are fully configurable with no permanent world griefing.

Architecture and startup flow

  1. Core lifecycle: EyeSMP wires EyeManager, persistent storage, phase/start orchestration, cooldowns, passive visuals, commands, and listeners. The lifecycle is INACTIVE → PREPARATION → DROPPING → GRACE → ACTIVE.

  2. Permanent eyes: Eye assignments are stored in each player’s PersistentDataContainer, while lifecycle state and grace timing are stored in state.yml for restart recovery.

  3. Combat engine: AbilityManager owns cooldowns, disabled/frozen targets, marks, temporary nature blocks, targeting, and all six Eye ability kits. PlayerSwapHandItemsEvent is used for F; sneaking while pressing F is SHIFT+F.

  4. Cinematic sequence: /eyesmp start chooses and centers the border, safely teleports and floats players, awakens their Eyes, counts down from 10, gives them ten seconds to aim, launches them along their view vectors, then starts the configurable grace period.

The source below is modular and uses XSeries for cross-version material, sound, and particle resolution.

The initial source set is created. I’m tightening the lifecycle helpers before delivery so the generated code has no dangling method calls and scheduled cinematic effects clean themselves up correctly.

EyeSMP / VOID SMP

Created a modular Paper 1.21.11 plugin with:

  • INACTIVE → PREPARATION → DROPPING → GRACE → ACTIVE lifecycle

  • Admin-only /eyesmp start

  • Safe floating preparation phase

  • Permanent weighted Eye assignment using player PersistentDataContainer

  • Eye awakening titles, particles, sounds, and rotating colored rings

  • 10-second cinematic countdown

  • Direction-based sky launch

  • Configurable 10-minute PvP grace period

  • Action-bar grace timer without BossBars

  • Random configurable world border from 15,000–30,000 blocks

  • Six Eye types:

    • Blood

    • Nature

    • Void

    • Golden

    • Death

    • Time

  • Separate normal and ultimate cooldowns

  • Eye passives and ability effects

  • Temporary Nature blocks with restoration

  • Eye suppression, freezing, Death marks, Blood healing, and damage modifiers

  • Restart-aware lifecycle state storage

  • Drop and inventory-transfer protection

  • Hunger protection during preparation and grace

  • PvP protection before grace ends

  • Modular managers, commands, listeners, storage, effects, and ability systems

Commands

Plain Text
/eyesmp start
/eyesmp ability
/eyesmp ultimate

/eye info
/eye give <player> <eye>
/eye reset <player>
/eye reload

Admin permission:

Plain Text
eyesmp.admin

Input setup

Paper does not expose a native physical keyboard F-key event. The plugin uses the most reliable server-compatible input:

  • F key: swap items between main hand and offhand

  • SHIFT + F: swap items while sneaking

  • The swap is cancelled so the item does not actually move

  • /eyesmp ability and /eyesmp ultimate are also available as command fallbacks

Build

Install Java 21 and Gradle, then run:

Shell
gradle build

The resulting plugin is:

Plain Text
build/libs/EyeSMP-1.0.0.jar

Installation

  1. Build the plugin.

  2. Copy the JAR into the Paper server’s plugins directory.

  3. Start the server once to generate configuration and state files.

  4. Configure config.yml.

  5. Restart the server.

  6. Ensure players have joined.

  7. Run:

Plain Text
/eyesmp start

The generated project includes:

Plain Text
build.gradle
settings.gradle
src/main/resources/plugin.yml
src/main/resources/config.yml
src/main/java/com/eyesmp/...
Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
settings.gradle
Code
18 771
src/main/java/com/eyesmp/EyeSMP.java
package com.eyesmp;

import com.eyesmp.ability.AbilityManager;
import com.eyesmp.command.EyeCommand;
import com.eyesmp.command.EyeSMPCommand;
import com.eyesmp.core.StartManager;
import com.eyesmp.eye.EyeManager;
import com.eyesmp.listener.AbilityInputListener;
import com.eyesmp.listener.GameplayListener;
import com.eyesmp.storage.StateStorage;
import com.eyesmp.util.EffectUtil;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

public final class EyeSMP extends JavaPlugin {
    private StateStorage stateStorage;
    private EyeManager eyeManager;
    private StartManager startManager;
    private AbilityManager abilityManager;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        this.stateStorage = new StateStorage(this);
        this.eyeManager = new EyeManager(this);
        this.startManager = new StartManager(this, stateStorage, eyeManager);
        this.abilityManager = new AbilityManager(this, eyeManager, startManager);
        this.startManager.setAbilityManager(abilityManager);

        Bukkit.getPluginManager().registerEvents(new GameplayListener(this, startManager, abilityManager), this);
        Bukkit.getPluginManager().registerEvents(new AbilityInputListener(this, startManager, abilityManager), this);
        getCommand("eyesmp").setExecutor(new EyeSMPCommand(this, startManager, abilityManager));
        getCommand("eye").setExecutor(new EyeCommand(this, eyeManager));
        Bukkit.getScheduler().runTaskTimer(this, new EffectUtil.PassiveRunnable(this, eyeManager, startManager), 20L, getConfig().getLong("effects.passive-period-ticks", 5L));
        startManager.restoreIfNeeded();
    }

    @Override
    public void onDisable() {
        if (startManager != null) {
            startManager.shutdown();
        }
    }

    public StateStorage getStateStorage() { return stateStorage; }
    public EyeManager getEyeManager() { return eyeManager; }
    public StartManager getStartManager() { return startManager; }
    public AbilityManager getAbilityManager() { return abilityManager; }
}