📄
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**.
Create the Gradle/Paper project metadata and configurable resource files.
Add the blade item, modes, abilities, persistent player state, and energy/cooldown management.
Implement the ability engine with combat, targeting, temporary-world safety, charging, rifts, prisons, and cinematic effects.
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, andreset.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.
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); }
}