Uzii on fire
📎 1 file 14,424 chars
📄
pasted-code-1788167214422.txt
txt 760 lines
▶
# 🌌 DIMENSION BLADE — ILLEGAL EDITION

Create a highly advanced and cinematic Minecraft Java Edition plugin called **Dimension Blade – Illegal Edition**.

The plugin must add one extremely rare legendary custom sword called **Dimension Blade**. This sword has 3 different dimensional modes, each with completely different powers, visuals, particles, sounds, combat effects, and abilities.

The sword should feel **extremely powerful, forbidden, unique, and impossible compared to normal Minecraft items**. It is designed specifically for SMP and YouTube content, so every ability should look cinematic and create impressive moments.

Target Minecraft version: **1.21.x**

---

# ⚔️ DIMENSION BLADE CORE SYSTEM

Item name:

**§5✦ Dimension Blade ✦**

The sword has 3 modes:

**🌍 OVERWORLD MODE**
**🔥 NETHER MODE**
**🌌 END MODE**

Right-click switches between modes:

**Overworld → Nether → End → Overworld**

Show the current mode in the action bar.

Example:

`🌍 Dimension Blade: OVERWORLD MODE`

Each mode must have:

* Different sword texture/model
* Different particles
* Different sounds
* Different attack effects
* Different abilities
* Different visual aura

Support custom model data/resource-pack integration.

---

# 🎮 CONTROLS

Make the controls simple and consistent.

### Left Click

Normal sword attack.

### Right Click

Switch Dimension Blade mode.

Add approximately 1-second mode-switch cooldown.

### Sneak + Right Click

Open the **Dimension Blade Ability Menu**.

The GUI should display all abilities available for the current mode.

### Sneak + Left Click

Activate the currently selected ability.

---

# 🎯 TARGET SYSTEM

For abilities requiring a player target:

* Player must look at the target.
* Use configurable maximum range.
* Highlight the target with subtle particles before activation.
* If no valid target exists, show:

`§cNo valid target found.`

For AOE abilities:

* Display a temporary particle circle showing the affected radius.
* Respect configured protected worlds/regions.

---

# 🌍 OVERWORLD MODE — NATURE POWERS

The Overworld form should use green, white, and earth/nature effects.

## 1. Nature Dash

Activation:

**Select Nature Dash → Sneak + Left Click**

Effects:

* Dash up to 15 blocks forward.
* Create leaves/grass particles.
* Create wind particles.
* Play a custom dash sound.
* Damage enemies hit during the dash.
* Apply configurable knockback.

---

## 2. Root Trap

Activation:

**Select Root Trap → Aim at player → Sneak + Left Click**

Effects:

* Roots grow around the target.
* Target movement is heavily reduced or locked.
* Duration: approximately 4 seconds.
* Nature particles surround the target.
* Small configurable damage over time.

---

## 3. Earth Split

Activation:

**Select Earth Split → Sneak + Left Click while looking at ground**

Effects:

* Create a visual 15-block-long earth crack.
* Use block/crack particles.
* Create a shockwave.
* Damage nearby enemies.
* Knock enemies backward.
* Do NOT permanently destroy terrain.

---

# ☠️ ILLEGAL OVERWORLD ABILITY — WORLD REWRITE

Activation:

1. Select **World Rewrite**.
2. Aim at the ground.
3. Sneak + Left Click.
4. Show:

`§c⚠ WORLD REWRITE ⚠`
`§7Sneak + Left Click again to confirm.`

5. Sneak + Left Click again within 3 seconds.

Effects:

* Temporarily transform a configurable area.
* Stone can become Diamond.
* Grass can become Emerald.
* Water can become Lava.
* Allow configurable block transformations.
* Save the original block states.
* Restore every affected block after approximately 10 seconds.
* Never permanently grief player builds.
* Restore blocks even after ability cancellation where possible.
* Prevent use in protected regions/worlds.

This ability should look like the player is literally **rewriting Minecraft's world**.

---

# 🔥 NETHER MODE — FIRE POWERS

The Nether form should use red, orange, black, lava, smoke, and flame effects.

## 1. Flame Dash

Activation:

**Select Flame Dash → Sneak + Left Click**

Effects:

* Dash up to 20 blocks.
* Leave a fire particle trail.
* Damage enemies touched by the dash.
* Knock enemies backward.
* Play a powerful Nether sound.

---

## 2. Hell Chain

Activation:

**Select Hell Chain → Aim at enemies → Sneak + Left Click**

Effects:

* Target up to 3 nearby players.
* Create visual fire chains connecting them.
* Pull enemies toward the caster.
* Apply short fire/burning effect.
* Create chain particles and sounds.

---

## 3. Lava Burst

Activation:

**Select Lava Burst → Aim at target → Sneak + Left Click**

Effects:

* Create a temporary lava-style explosion around the target.
* Launch nearby enemies.
* Use lava/fire particles.
* Create an explosive sound.
* Temporary lava must automatically disappear.
* Never permanently grief the world.

---

# ☠️ ILLEGAL NETHER ABILITY — NETHER OVERLOAD

Activation:

1. Select **Nether Overload**.
2. Sneak + Left Click to begin charging.
3. Hold Sneak for approximately 2 seconds.
4. Release Sneak to activate.

Show boss-bar charging:

`NETHER OVERLOAD ███████░░░ 70%`

Effects:

* Dark atmospheric effect.
* Massive Nether particles.
* Fire particles across the area.
* Temporary lava eruptions.
* Random lightning/fire effects.
* Launch nearby enemies.
* Create a cinematic Nether catastrophe.
* Duration approximately 8 seconds.
* Automatically restore temporary environmental changes.

The ability should look like the player has **overloaded the Nether itself**.

---

# 🌌 END MODE — VOID POWERS

The End form should use purple, black, dark-blue, portal, and void effects.

## 1. Void Step

Activation:

**Select Void Step → Aim at target → Sneak + Left Click**

Effects:

* Teleport behind the target.
* Maximum range approximately 15 blocks.
* Create End particles.
* Play teleport sound.
* Deal configurable bonus damage.
* Create a short void trail.

---

## 2. End Rift

Activation:

**Select End Rift → Sneak + Left Click twice**

First activation:

* Create Rift A.

Second activation:

* Create Rift B.

Players entering one rift teleport to the other.

Effects:

* Purple/black particles.
* End sounds.
* Temporary portals.
* Configurable duration.

---

## 3. Gravity Collapse

Activation:

**Select Gravity Collapse → Aim at location → Sneak + Left Click**

Effects:

* Create a gravity field.
* Pull nearby enemies toward the center.
* Apply configurable force.
* Create floating/void particles.
* Optional temporary low-gravity effect.

---

# ☠️ ILLEGAL END ABILITY — VOID EXECUTION

Activation:

1. Select **Void Execution**.
2. Aim at a player.
3. Sneak + Left Click.
4. Lock target.
5. Start a short cinematic charge.

Effects:

* Create a huge black/purple void sphere around the target.
* Temporarily freeze the target.
* Set target health to a configurable amount, default 1 HP.
* Teleport caster near the target.
* Create a massive void explosion.
* Release the target afterward.

Do not automatically permanently kill the target unless configured by the server administrator.

---

# 🩸 FORBIDDEN SWAP

Add another hidden illegal ability.

Activation:

1. Select **Forbidden Swap**.
2. Aim at a player.
3. Sneak + Left Click.

The caster and target swap:

* Position
* Health
* Potion effects
* Velocity

Do NOT swap:

* Inventory
* Armor
* Ender Chest
* XP

Example:

Caster = 2 hearts
Target = 20 hearts

After activation:

Caster = 20 hearts
Target = 2 hearts

Add a powerful dimensional swap animation.

---

# 👁️ SECRET ULTIMATE — DIMENSION BREAK

This must be one of the hardest and most impressive abilities.

The player must perform the exact mode sequence:

**OVERWORLD → NETHER → END → OVERWORLD**

Each switch must happen within a configurable time limit, such as 5 seconds.

If the wrong sequence is performed, reset the combo.

After completing the sequence:

Display:

`§c⚠ DIMENSION BREAK READY ⚠`

Play a unique sound.

Then activate using:

**Sneak + Left Click**

Effects:

* Massive dimensional glitch effect.
* Mix Overworld, Nether, and End particles.
* Temporary gravity changes.
* Fake dimensional rifts.
* Randomly teleport nearby enemies within a safe configurable radius.
* Create temporary visual block distortions.
* Darken the atmosphere.
* Play a boss-level sound sequence.
* Create a giant dimensional crack/rift.
* After approximately 5 seconds, restore the area.

Everything must return safely to its original state.

---

# 💀 FINAL SECRET ABILITY — DIMENSION DELETE

Activation:

1. Select **Dimension Delete**.
2. Aim at a player.
3. Sneak + Left Click.
4. Lock target.
5. Start:

`3...`
`2...`
`1...`

Then open a dimensional rift.

The target is temporarily transported into a special isolated void arena.

Arena:

* Floating platform.
* Void surrounding the platform.
* Dark cosmic sky.
* Purple/black particles.
* Custom dimensional effects.
* No normal escape route.

After a configurable duration, approximately 5 seconds:

* Return the player to their original safe location.
* Restore all temporary effects.
* Do not delete inventory.
* Do not permanently delete world data.
* If the player disconnects, safely handle their return when they reconnect.
* If the server restarts, safely recover affected players.

This should feel like the sword has **deleted a player from the current dimension** without actually destroying their data.

---

# 🔋 DIMENSION ENERGY SYSTEM

Add an Ultimate Energy system.

Players gain energy from:

* Hitting players
* Dealing damage
* Taking damage
* Killing mobs
* Killing players

Display energy with a boss bar:

`DIMENSION ENERGY ███████░░░ 75%`

At 100%:

`§d⚠ ULTIMATE READY ⚠`

Dimension Break and Dimension Delete can require 100% energy.

Make energy gain configurable.

---

# 📋 DIMENSION BLADE GUI

Sneak + Right Click opens the ability menu.

The GUI should show:

### OVERWORLD

🌿 Nature Dash
🌱 Root Trap
⛰ Earth Split
☠ World Rewrite

### NETHER

🔥 Flame Dash
⛓ Hell Chain
🌋 Lava Burst
☠ Nether Overload

### END

🌌 Void Step
🌀 End Rift
🪐 Gravity Collapse
☠ Void Execution

### SECRET

🩸 Forbidden Swap
⚠ Dimension Break
💀 Dimension Delete

For each ability display:

* Name
* Description
* Current cooldown
* Energy requirement
* Activation method
* Locked/unlocked status

Clicking an ability selects it and closes the menu.

Show:

`Selected Ability: Void Step`

---

# ⏳ COOLDOWN SYSTEM

Every ability must have its own cooldown.

Example:

`Void Step — 8.4s`

When unavailable:

`§cAbility on cooldown: 5.2s`

Display cooldown through:

* Action bar
* GUI
* Optional boss bar

All cooldowns configurable.

---

# 🎨 MODE VISUALS

## OVERWORLD

Sword:

* Green/diamond/nature appearance

Particles:

* Leaves
* Grass
* Emerald
* Wind
* Earth

Aura:

* Green/white

## NETHER

Sword:

* Black/red flaming appearance

Particles:

* Flame
* Lava
* Smoke
* Soul particles

Aura:

* Red/orange

## END

Sword:

* Black/purple cosmic appearance

Particles:

* Portal
* End rod
* Purple particles
* Void effects

Aura:

* Purple/black

## DIMENSION BREAK FORM

When Dimension Break is ready:

* Sword combines all 3 dimensional energies.
* Green + red + purple energy.
* Glitch particles.
* Pulsing aura.
* Unique legendary sword model if supported by resource pack.

---

# ⚔️ NORMAL COMBAT

Make normal sword attacks visually powerful.

Add:

* Custom hit particles.
* Critical hit effects.
* Custom sounds.
* Small knockback effects.
* Configurable damage.
* Different hit effects based on current dimension.
* No excessive particles that cause lag.

---

# 🛡️ SAFETY & ANTI-GRIEF

The plugin must be optimized for multiplayer SMP servers.

Temporary abilities must NEVER permanently destroy builds.

Add:

* Protected world support.
* Protected region support.
* Permission system.
* Configurable PvP rules.
* Ally/friendly-fire option.
* Mob targeting option.
* Safe teleport checks.
* Void protection.
* Combat logging protection.
* Server restart recovery for temporary abilities.
* Player disconnect recovery.
* Maximum ability range.
* Maximum affected players.
* Maximum affected blocks.
* Configurable particle limits.

Use efficient event handling and avoid unnecessary repeating tasks.

---

# ⚙️ CONFIG.YML

Everything should be configurable:

* Damage
* Range
* Cooldowns
* Duration
* Knockback
* Particle amounts
* Sounds
* Energy gain
* Energy requirements
* Mode switch cooldown
* Target limits
* Block transformation list
* Restoration time
* Protected worlds
* Protected regions
* PvP settings
* Mob settings
* Ability enable/disable
* Illegal ability enable/disable
* GUI settings
* Messages
* Titles
* Action bars
* Boss bars

---

# 🛠️ ADMIN COMMANDS

Add:

`/dimensionblade give `

Give the Dimension Blade.

`/dimensionblade remove `

Remove the Dimension Blade.

`/dimensionblade menu`

Open the ability menu.

`/dimensionblade reload`

Reload configuration.

`/dimensionblade admin`

Open admin configuration GUI.

`/dimensionblade energy  `

Set player's Dimension Energy.

`/dimensionblade reset `

Reset player's cooldowns and ability state.

Add appropriate permissions for every admin command.

---

# 🎬 CINEMATIC EXPERIENCE

Every illegal ability should feel like a major Minecraft event.

Use:

* Titles
* Subtitles
* Action bars
* Boss bars
* Custom sounds
* Particles
* Screen effects where possible
* Camera-friendly animations
* Charging animations
* Warning messages
* Impact effects
* Unique activation sequences

The final result should feel like a **forbidden legendary artifact from another dimension**, not a normal custom sword.

The plugin must be polished, optimized, multiplayer-safe, highly configurable, and specifically designed for **Minecraft SMP and YouTube content**.
Kodari AI
KodariAug 31 at 9:20 am 4
DimensionBlade
A cinematic Minecraft plugin introducing the legendary Dimension Blade, a forbidden sword with three dimensional modes (Overworld, Nether, End). Players switch modes via right-click, open an ability GUI with sneak-right-click, and activate selected abilities with sneak-left-click. Each mode features unique particles, sounds, combat effects, and three standard abilities plus one illegal ability. Includes a Dimension Energy system with boss bar display, cooldown tracking, Forbidden Swap and Dimension Break secret ultimates, and Dimension Delete void arena. Features configurable damage, ranges, cooldowns, protected worlds/regions, anti-grief restoration, admin commands, and full config.yml customization for SMP and YouTube content.
  1. Create the Gradle/Paper project metadata and configurable resource files.

  2. Add the blade item, modes, abilities, persistent player state, and energy/cooldown management.

  3. Implement the ability engine with combat, targeting, temporary-world safety, charging, rifts, prisons, and cinematic effects.

  4. Add GUI, event listeners, commands, and plugin registration for the complete control flow.

Implemented the Dimension Blade plugin from scratch for Paper 1.21.x.

  • Added configurable Gradle project with XSeries and Lombok.

  • Added the custom Dimension Blade with PDC mode tracking and custom model data.

  • Implemented Overworld, Nether, End, and secret abilities.

  • Added energy, boss bars, cooldowns, mode switching, combo tracking, and ultimate abilities.

  • Added temporary block rewriting with automatic restoration.

  • Added rifts, dashes, traps, gravity effects, executions, swaps, and Dimension Delete recovery.

  • Added cinematic particles, sounds, action bars, titles, and visual auras.

  • Added ability GUI and admin GUI.

  • Added /dimensionblade give, remove, menu, reload, admin, energy, and reset.

  • Added player state persistence, energy persistence, and prison-location recovery.

  • Added configurable permissions, PvP rules, protected worlds, affected-block limits, ranges, damage, cooldowns, and ability settings.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
settings.gradle
Code
16 1,363
src/main/java/com/kodari/dimensionblade/DimensionBladePlugin.java
package com.kodari.dimensionblade;

import com.kodari.dimensionblade.command.DimensionBladeCommand;
import com.kodari.dimensionblade.gui.AbilityMenu;
import com.kodari.dimensionblade.gui.AdminMenu;
import com.kodari.dimensionblade.listener.BladeListener;
import org.bukkit.Bukkit;
import org.bukkit.NamespacedKey;
import org.bukkit.plugin.java.JavaPlugin;

public class DimensionBladePlugin extends JavaPlugin {
    private NamespacedKey bladeKey;
    private NamespacedKey modeKey;
    private StateManager states;
    private AbilityEngine engine;
    private AbilityMenu abilityMenu;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        bladeKey = new NamespacedKey(this, "dimension_blade");
        modeKey = new NamespacedKey(this, "dimension_mode");
        states = new StateManager(this);
        engine = new AbilityEngine(this);
        abilityMenu = new AbilityMenu(this);
        Bukkit.getPluginManager().registerEvents(new BladeListener(this), this);
        DimensionBladeCommand command = new DimensionBladeCommand(this);
        getCommand("dimensionblade").setExecutor(command);
        getCommand("dimensionblade").setTabCompleter(command);
        Bukkit.getScheduler().runTaskTimer(this, () -> {
            for (org.bukkit.entity.Player player : Bukkit.getOnlinePlayers()) Effects.modeAura(player, states.get(player).getMode());
        }, 20L, 20L);
    }

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

    public NamespacedKey bladeKey() { return bladeKey; }
    public NamespacedKey modeKey() { return modeKey; }
    public StateManager states() { return states; }
    public AbilityEngine engine() { return engine; }
    public AbilityMenu abilityMenu() { return abilityMenu; }
    public AdminMenu adminMenu() { return new AdminMenu(this); }
}