Shards
minecraftFreev1.0.0
Description
You are working on ShardsSystem, a competitive 26-shard Minecraft PvP plugin for Paper 1.21.1 (Java). Shards are Nether Star items stored in the offhand that grant passive effects, activated abilities (right-click), and aura-gated ultimates (sneak + right-click at 100% BossBar aura). The plugin uses XSeries for cross-version compatibility, Lombok, and Bukkit/Paper APIs.
Architecture
com.shardsystem/
├── ShardsPlugin.java — Main plugin, @Getter managers, onEnable/onDisable
├── shard/
│ ├── Shard.java — Abstract base (getId, applyPassive, removePassive, onAbility, onUltimate, getRecipe, createItem via PDC "shard_id")
│ ├── ShardTier.java — Enum T1-T6 with displayName, ritualDurationTicks, category
│ ├── ShardManager.java — Registry (shardById, shardByRecipeKey), getOffhandShard, silence system, normalizeId
│ └── impl/ — 26 shard classes (see full list below)
├── combat/
│ ├── CombatListener.java — Right-click ability trigger, sneak+right-click ultimate trigger, damage routing (onPlayerDealDamage/onPlayerReceiveDamage), death handler (remove passive + broadcast shard drop), EntityTargetEvent (prevents summoned mobs targeting caster)
│ └── AuraManager.java — BossBar aura system per player, fills over time via combat/proximity
├── ritual/
│ ├── Ritual.java — Data class (ownerUUID, shard, anchorLocation, savedIngredients, tasks, completed/failed flags)
│ ├── RitualManager.java — startRitual (spawn ArmorStand anchor, particle helix, countdown with grace zone, 30-block contest radius, completion/failure handling, broadcast updates)
│ └── RitualListener.java — onCraft (intercepts shard recipes → cancel → consume ingredients → closeInventory → startRitual), onItemDrop (T6 Origin Forge: Dragon Egg + 5 T5 Shards dropped at 0,0 on Crying Obsidian → 3s delayed check → consume + ritual)
├── inventory/
│ ├── gui/GUIManager.java — Custom GUI framework
│ ├── gui/GUIListener.java — Click routing
│ ├── ShardBookGUI.java — /shards and /shard-recipes viewer (reads getRecipe() dynamically)
│ └── RecipeViewGUI.java — Individual recipe display
├── command/
│ ├── ShardsCommand.java — /shards → opens ShardBookGUI
│ └── AShardCommand.java — /ashard give/remove/list (op-only)
└── util/
├── AbilityUtils.java — sendActionBar (Spigot ChatMessageType), teleportForward (safe block collision), applyTrueDamage, getNearbyLivingEntities, getTargetEntity (ray trace), getNearestPlayer, applyStandardDash
└── CooldownManager.java — Per-player ability cooldown tracking
Tier System
Tier Category Ritual Duration Shard Count
T1 Basic Utility 6s (120 ticks) 5
T2 Crowd Control 15s (300 ticks) 5
T3 Tactical Advantage 30s (600 ticks) 5
T4 High Skill 60s (1200 ticks) 5
T5 Endgame Power 120s (2400 ticks) 5
T6 The Origin 240s (4800 ticks) 1
All 26 Shards — Complete Reference
TIER 1
1. Vessel Shard (vessel, CMD 1001)
Passive: +2 Max Hearts (AttributeModifier on GENERIC_MAX_HEALTH)
Ability: Heal 4 HP instantly
Ultimate: Full heal + Absorption IV for 10s
Recipe: NGN/GTG/NGN (N=Netherite Scrap, G=Gold Block, T=Totem of Undying)
2. Shinobi Shard (shinobi, CMD 1002)
Passive: Speed I
Ability: Grapple Hook — rayTrace 30 blocks, pull velocity toward hit block
Ultimate: Shadow Clone — spawn 2 ArmorStand decoys with player's skull + armor for 5s
Recipe: SHS/HNH/SHS (S=Slime Block, H=Honey Block, N=Netherite Ingot)
3. Hunter Shard (hunter, CMD 1003)
Passive: Night Vision
Ability: Tracking — action bar arrow points to nearest player with distance for 5s
Ultimate: Eagle Eye — Glowing on all players in 50 blocks for 5s
Recipe: ECE/CNC/ECE (E=Echo Shard, C=Compass, N=Nether Star)
4. Titan Shard (titan, CMD 1004)
Passive: Resistance I
Ability: Ground Slam — 5-block AOE knockback + explosion particles
Ultimate: Fortify — Resistance V + Slowness 255 for 3s (immobile tank), restores Resistance I after
Recipe: OIO/INI/OIO (O=Crying Obsidian, I=Iron Block, N=Netherite Ingot)
5. Swordsman Shard (swordsman, CMD 1005)
Passive: +Attack Speed (AttributeModifier on GENERIC_ATTACK_SPEED)
Ability: Parry — next incoming hit blocked for 0.5s window
Ultimate: Blade Dance — 3 rapid dashes with sweep attacks
Recipe: WAW/ANA/WAW (W=Wither Skeleton Skull, A=Anvil, N=Netherite Ingot)
TIER 2
6. Ice Shard (ice, CMD 1006)
Passive: Frost Walker — repeating task freezes nearby water blocks and reverts them
Ability: Ice Path — creates temporary ice bridge in look direction
Ultimate: Deep Freeze — Slowness + Mining Fatigue on all nearby
Recipe: PSP/SHS/PSP (P=Packed Ice, S=Sponge, H=Heart of the Sea)
7. Sun Shard (sun, CMD 1007)
Passive: Fire Resistance
Ability: Solar Flare — Blindness 2s on all entities within 5 blocks
Ultimate: Supernova — Ignites entities in 15 blocks for 10s + 5 true damage
Recipe: MGM/GNG/MGM (M=Magma Block, G=Glowstone, N=Nether Star)
8. Shadow Shard (shadow, CMD 1008)
Passive: Invisibility while sneaking
Ability: Shadow Step — teleport 5 blocks forward (safe teleport via AbilityUtils)
Ultimate: Abyss — Blindness 5s on ALL online players (except caster)
Recipe: EWE/WSW/EWE (E=Echo Shard, W=Wither Rose, S=Sculk Sensor)
9. Gravity Shard (gravity, CMD 1009)
Passive: No Fall Damage
Ability: Repel — push all entities away (7-block radius, 3.0 velocity)
Ultimate: Singularity — pull all entities to caster location (20-block radius)
Recipe: OTO/TNT/OTO (O=Crying Obsidian, T=Target Block, N=Nether Star)
10. Vortex Shard (vortex, CMD 1010)
Passive: Water Breathing
Ability: Whirlpool — Slowness II for 3s on all in 5 blocks
Ultimate: Tidal Wave — push enemies back with water particles
Recipe: PTP/THT/PTP (P=Prismarine Bricks, T=Trident, H=Heart of the Sea)
TIER 3
11. Blood Shard (blood, CMD 1011)
Passive: 25% Lifesteal on melee hits (heals attacker for 25% of damage dealt)
Ability: Blood Draw — costs 2 HP, grants Speed II for 5s
Ultimate: Blood Ritual — steals 20% max HP from target, gives to self
Recipe: WRW/RNR/WRW (W=Wither Rose, R=Redstone Block, N=Netherite Block)
12. Reaper Shard (reaper, CMD 1012)
Passive: +Strength at nighttime (repeating task checks time)
Ability: Mark of Death — marks target for 2x damage for 5s
Ultimate: Death Sentence — executes target below 30% HP
Recipe: SWS/WNW/SWS (S=Soul Sand, W=Wither Skeleton Skull, N=Nether Star)
13. Flash Shard (flash, CMD 1013)
Passive: Speed III
Ability: Dash — teleport 8 blocks forward (safe teleport)
Ultimate: Time Warp — Slowness 255 on all other players for 3s
Recipe: RER/ENE/RER (R=Rabbit Foot, E=Echo Shard, N=Netherite Block)
14. Room Shard (room, CMD 1014)
Passive: +5% Crit Chance
Ability: Shambles — swap locations with target entity
Ultimate: Tact — teleport target 20 blocks into the air
Recipe: PCP/CNC/PCP (P=Sticky Piston, C=Crying Obsidian, N=Nether Star)
15. Eraser Shard (eraser, CMD 1015)
Passive: Shows target HP in action bar (repeating task, rayTrace 30 blocks)
Ability: Silence — target player cannot use Shard abilities for 3s
Ultimate: Nullify — removes ALL potion effects from target
Recipe: GTG/TNT/GTG (G=Ghast Tear, T=Totem of Undying, N=Netherite Block)
TIER 4
16. Six Eyes Shard (six_eyes, CMD 1016)
Passive: 30% cooldown reduction on all abilities (checked in ShardManager.hasCooldownReduction)
Ability: Red/Blue — sneak to push, stand to pull target (20 blocks)
Ultimate: Hollow Purple — 10 True Damage + destroys 5 random blocks near target
Recipe: EBE/BNB/EBE (E=Emerald Block, B=Beacon, N=Netherite Block)
17. Curse Shard (curse, CMD 1017)
Passive: 1.0 true damage (half-heart) per tick to nearby enemies (repeating task)
Ability: Hex — DOT effect on target for 5s
Ultimate: Domain — visual box of redstone dust particles, teleports target back if they leave
Recipe: WEW/EBE/WEW (W=Wither Skeleton Skull, E=Echo Shard, B=Beacon)
18. Gate Shard (gate, CMD 1018)
Passive: Luck II
Ability: Save/Recall toggle — first right-click saves location, second recalls to it
Ultimate: Arrow Storm — spawns 60 homing arrows that track target constantly for 10s
Recipe: GEG/EBE/GEG (G=Gold Block, E=Echo Shard, B=Beacon)
19. Anti-Magic Shard (anti_magic, CMD 1019)
Passive: Immune to Slowness and Blindness
Ability: Deflect — reflects incoming projectiles for 3s
Ultimate: Demon Form — +50% DMG + flight for 10s (onPlayerDealDamage multiplier)
Recipe: OTO/TBT/OTO (O=Crying Obsidian, T=Totem of Undying, B=Beacon)
20. Stand Shard (stand, CMD 1020)
Passive: +2 Block Reach Distance
Ability: Barrage — 5 rapid 1-damage true hits on target
Ultimate: The World — global 5s time freeze (Slowness 255 + no-jump on all players)
Recipe: NTN/TBT/NTN (N=Netherite Block, T=Totem of Undying, B=Beacon)
TIER 5
21. Almighty Shard (almighty, CMD 1021)
Passive: Jump Boost V
Ability: Almighty Push — 20-block AOE knockback
Ultimate: Chibaku Tensei — launches all enemies into the sky
Recipe: NEN/EBE/NEN (N=Netherite Block, E=End Crystal, B=Beacon)
22. False God Shard (false_god, CMD 1022)
Passive: Permanent Absorption II
Ability: Smite — lightning strike on target
Ultimate: Judgment — halves target's current HP
Recipe: GTG/TET/GTG (G=Gold Block, T=Totem of Undying, E=End Crystal)
23. Rumbling Shard (rumbling, CMD 1023)
Passive: Strength II
Ability: Stomp — 10-block AOE Earthquake knockback + explosion effect
Ultimate: The Wall — summon 3 Giants that crush enemies (6 damage/s) for 10s, don't attack caster
Recipe: OWO/WEW/OWO (O=Obsidian, W=Wither Rose, E=End Crystal)
24. Eclipse Shard (eclipse, CMD 1024)
Passive: +4 Max Hearts (AttributeModifier)
Ability: Eclipse Drain — steals target's health
Ultimate: Total Eclipse — Wither + Blindness on all nearby entities
Recipe: OEO/ENE/OEO (O=Crying Obsidian, E=End Crystal, N=Netherite Block)
25. Zenith Shard (zenith, CMD 1025)
Passive: Regeneration I + Speed II
Ability: Zenith Blast — ranged energy projectile
Ultimate: Zenith Ascension — invulnerability + flight for 10s
Recipe: NEN/EBE/NEN (N=Netherite Block, E=End Crystal, B=Beacon)
TIER 6
26. The Origin (the_origin, CMD 1026)
Passive: ALL positive potion effects at level II (Speed, Strength, Resistance, Regen, Jump, Fire Res, Water Breathing, Night Vision, Absorption, Luck)
Ability: Universal Pull — teleport any player to 0,0
Ultimate: Big Bang — reset all nearby players to 1 HP
Crafting: NOT crafted. Obtained via Origin Forge — drop Dragon Egg + 5 T5 Shards at X:0, Z:0 on Crying Obsidian. Only 1 can exist. 4-minute ritual.
Recipe: none (getRecipe returns null)
Ritual System
Recipes are intercepted on CraftItemEvent → cancelled → ingredients consumed → crafting table closed → Ritual starts
Ritual spawns an invisible ArmorStand anchor with "★ RITUAL ★" floating name
30-block contest radius with 60-particle flame helix animation
Action bar shows progress % and countdown
Server-wide broadcasts on start, every 30s, and completion/failure
If player leaves 30-block zone: 5s grace period with warning sounds, then ritual fails and drops ingredients
Aura System
BossBar fills during combat/proximity
At 100% aura, the player can use Ultimate (sneak + right-click)
Death Mechanics
On death: passive removed, server-wide broadcast with death coords and shard name
YOUR TASK
This plugin currently works but needs a premium visual and audio polish pass for Paper 1.21.1. Implement the following:
1. Upgrade to Paper 1.21.1
Update
build.gradle
to target io.papermc.paper:paper-api:1.21.1-R0.1-SNAPSHOT instead of spigot-api 1.20.4
Use Paper's native Adventure API (Component, MiniMessage) instead of legacy ChatColor.translateAlternateColorCodes
Use Paper's native player.sendActionBar(Component) instead of the Spigot ChatMessageType workaround
Set Java source/target to 21
Do NOT break any existing ability logic
2. SFX Pass — Every Shard Action Must Have Sound
For EVERY shard's
applyPassive
,
onAbility
, and
onUltimate
, ensure there is a fitting XSound call:
Passive activation: soft ambient sound (e.g., BLOCK_BEACON_ACTIVATE, ENTITY_EXPERIENCE_ORB_PICKUP)
Ability use: impactful mid-tier sound matching the shard's theme
Ultimate activation: dramatic, powerful sound (e.g., ENTITY_WITHER_SPAWN, ENTITY_ENDER_DRAGON_GROWL, UI_TOAST_CHALLENGE_COMPLETE)
Cooldown message: ENTITY_VILLAGER_NO or similar denial sound
Ability hit: impact sound on the target's location
3. VFX Pass — Particle Effects for Every Action
For EVERY shard's
onAbility
and
onUltimate
, add themed particle effects:
Use Paper/Bukkit's
Particle
enum directly (not XParticle strings)
Passive: Subtle ambient particles around the player (optional repeating task)
Ability cast: Burst of particles at cast location
Ability impact: Particles at target location
Ultimate: Large-scale dramatic particle effects (spirals, pillars, explosions)
Use Particle.DustOptions for colored particles where appropriate
Examples: Ice = SNOWFLAKE + BLOCK_CRACK(ICE), Fire = FLAME + LAVA, Shadow = SMOKE_LARGE + SQUID_INK, Blood = REDSTONE(DustOptions red), etc.
4. Visual Enhancements
Shard Item Glow: All shard items should have enchantment glint (addEnchant(UNBREAKING, 1, true) + addItemFlags(HIDE_ENCHANTS))
Title Messages: Major events (ultimate activation, ritual start/complete) should use player.sendTitle() with fade-in/stay/fade-out
Action Bar Feedback: All ability activations show action bar messages with Unicode symbols
BossBar Aura: Ensure the aura BossBar changes color based on fill % (RED < 33%, YELLOW < 66%, GREEN < 100%, PURPLE = full)
5. Ritual Visual Overhaul
Replace the basic flame helix with a multi-layered particle system: outer ring (soul fire), inner ring (enchantment), center beam (end rod going up)
Add block-change effects around the anchor (temporary crying obsidian ring)
Final completion should have a dramatic lightning strike + firework burst
Failure should have explosion particles + wither sound
6. Code Quality
Remove all dead code and unused imports
Ensure all BukkitRunnable tasks have proper cancellation (no memory leaks)
All potion amplifiers must be correct: amplifier 0 = Level I, 1 = Level II, etc (0-indexed)
Ensure thread safety: async particle tasks should not modify entities
Build must compile with 0 errors. Do NOT remove or alter any ability/passive/ultimate logic — only ADD sound and visual effects.
Architecture
com.shardsystem/
├── ShardsPlugin.java — Main plugin, @Getter managers, onEnable/onDisable
├── shard/
│ ├── Shard.java — Abstract base (getId, applyPassive, removePassive, onAbility, onUltimate, getRecipe, createItem via PDC "shard_id")
│ ├── ShardTier.java — Enum T1-T6 with displayName, ritualDurationTicks, category
│ ├── ShardManager.java — Registry (shardById, shardByRecipeKey), getOffhandShard, silence system, normalizeId
│ └── impl/ — 26 shard classes (see full list below)
├── combat/
│ ├── CombatListener.java — Right-click ability trigger, sneak+right-click ultimate trigger, damage routing (onPlayerDealDamage/onPlayerReceiveDamage), death handler (remove passive + broadcast shard drop), EntityTargetEvent (prevents summoned mobs targeting caster)
│ └── AuraManager.java — BossBar aura system per player, fills over time via combat/proximity
├── ritual/
│ ├── Ritual.java — Data class (ownerUUID, shard, anchorLocation, savedIngredients, tasks, completed/failed flags)
│ ├── RitualManager.java — startRitual (spawn ArmorStand anchor, particle helix, countdown with grace zone, 30-block contest radius, completion/failure handling, broadcast updates)
│ └── RitualListener.java — onCraft (intercepts shard recipes → cancel → consume ingredients → closeInventory → startRitual), onItemDrop (T6 Origin Forge: Dragon Egg + 5 T5 Shards dropped at 0,0 on Crying Obsidian → 3s delayed check → consume + ritual)
├── inventory/
│ ├── gui/GUIManager.java — Custom GUI framework
│ ├── gui/GUIListener.java — Click routing
│ ├── ShardBookGUI.java — /shards and /shard-recipes viewer (reads getRecipe() dynamically)
│ └── RecipeViewGUI.java — Individual recipe display
├── command/
│ ├── ShardsCommand.java — /shards → opens ShardBookGUI
│ └── AShardCommand.java — /ashard give/remove/list (op-only)
└── util/
├── AbilityUtils.java — sendActionBar (Spigot ChatMessageType), teleportForward (safe block collision), applyTrueDamage, getNearbyLivingEntities, getTargetEntity (ray trace), getNearestPlayer, applyStandardDash
└── CooldownManager.java — Per-player ability cooldown tracking
Tier System
Tier Category Ritual Duration Shard Count
T1 Basic Utility 6s (120 ticks) 5
T2 Crowd Control 15s (300 ticks) 5
T3 Tactical Advantage 30s (600 ticks) 5
T4 High Skill 60s (1200 ticks) 5
T5 Endgame Power 120s (2400 ticks) 5
T6 The Origin 240s (4800 ticks) 1
All 26 Shards — Complete Reference
TIER 1
1. Vessel Shard (vessel, CMD 1001)
Passive: +2 Max Hearts (AttributeModifier on GENERIC_MAX_HEALTH)
Ability: Heal 4 HP instantly
Ultimate: Full heal + Absorption IV for 10s
Recipe: NGN/GTG/NGN (N=Netherite Scrap, G=Gold Block, T=Totem of Undying)
2. Shinobi Shard (shinobi, CMD 1002)
Passive: Speed I
Ability: Grapple Hook — rayTrace 30 blocks, pull velocity toward hit block
Ultimate: Shadow Clone — spawn 2 ArmorStand decoys with player's skull + armor for 5s
Recipe: SHS/HNH/SHS (S=Slime Block, H=Honey Block, N=Netherite Ingot)
3. Hunter Shard (hunter, CMD 1003)
Passive: Night Vision
Ability: Tracking — action bar arrow points to nearest player with distance for 5s
Ultimate: Eagle Eye — Glowing on all players in 50 blocks for 5s
Recipe: ECE/CNC/ECE (E=Echo Shard, C=Compass, N=Nether Star)
4. Titan Shard (titan, CMD 1004)
Passive: Resistance I
Ability: Ground Slam — 5-block AOE knockback + explosion particles
Ultimate: Fortify — Resistance V + Slowness 255 for 3s (immobile tank), restores Resistance I after
Recipe: OIO/INI/OIO (O=Crying Obsidian, I=Iron Block, N=Netherite Ingot)
5. Swordsman Shard (swordsman, CMD 1005)
Passive: +Attack Speed (AttributeModifier on GENERIC_ATTACK_SPEED)
Ability: Parry — next incoming hit blocked for 0.5s window
Ultimate: Blade Dance — 3 rapid dashes with sweep attacks
Recipe: WAW/ANA/WAW (W=Wither Skeleton Skull, A=Anvil, N=Netherite Ingot)
TIER 2
6. Ice Shard (ice, CMD 1006)
Passive: Frost Walker — repeating task freezes nearby water blocks and reverts them
Ability: Ice Path — creates temporary ice bridge in look direction
Ultimate: Deep Freeze — Slowness + Mining Fatigue on all nearby
Recipe: PSP/SHS/PSP (P=Packed Ice, S=Sponge, H=Heart of the Sea)
7. Sun Shard (sun, CMD 1007)
Passive: Fire Resistance
Ability: Solar Flare — Blindness 2s on all entities within 5 blocks
Ultimate: Supernova — Ignites entities in 15 blocks for 10s + 5 true damage
Recipe: MGM/GNG/MGM (M=Magma Block, G=Glowstone, N=Nether Star)
8. Shadow Shard (shadow, CMD 1008)
Passive: Invisibility while sneaking
Ability: Shadow Step — teleport 5 blocks forward (safe teleport via AbilityUtils)
Ultimate: Abyss — Blindness 5s on ALL online players (except caster)
Recipe: EWE/WSW/EWE (E=Echo Shard, W=Wither Rose, S=Sculk Sensor)
9. Gravity Shard (gravity, CMD 1009)
Passive: No Fall Damage
Ability: Repel — push all entities away (7-block radius, 3.0 velocity)
Ultimate: Singularity — pull all entities to caster location (20-block radius)
Recipe: OTO/TNT/OTO (O=Crying Obsidian, T=Target Block, N=Nether Star)
10. Vortex Shard (vortex, CMD 1010)
Passive: Water Breathing
Ability: Whirlpool — Slowness II for 3s on all in 5 blocks
Ultimate: Tidal Wave — push enemies back with water particles
Recipe: PTP/THT/PTP (P=Prismarine Bricks, T=Trident, H=Heart of the Sea)
TIER 3
11. Blood Shard (blood, CMD 1011)
Passive: 25% Lifesteal on melee hits (heals attacker for 25% of damage dealt)
Ability: Blood Draw — costs 2 HP, grants Speed II for 5s
Ultimate: Blood Ritual — steals 20% max HP from target, gives to self
Recipe: WRW/RNR/WRW (W=Wither Rose, R=Redstone Block, N=Netherite Block)
12. Reaper Shard (reaper, CMD 1012)
Passive: +Strength at nighttime (repeating task checks time)
Ability: Mark of Death — marks target for 2x damage for 5s
Ultimate: Death Sentence — executes target below 30% HP
Recipe: SWS/WNW/SWS (S=Soul Sand, W=Wither Skeleton Skull, N=Nether Star)
13. Flash Shard (flash, CMD 1013)
Passive: Speed III
Ability: Dash — teleport 8 blocks forward (safe teleport)
Ultimate: Time Warp — Slowness 255 on all other players for 3s
Recipe: RER/ENE/RER (R=Rabbit Foot, E=Echo Shard, N=Netherite Block)
14. Room Shard (room, CMD 1014)
Passive: +5% Crit Chance
Ability: Shambles — swap locations with target entity
Ultimate: Tact — teleport target 20 blocks into the air
Recipe: PCP/CNC/PCP (P=Sticky Piston, C=Crying Obsidian, N=Nether Star)
15. Eraser Shard (eraser, CMD 1015)
Passive: Shows target HP in action bar (repeating task, rayTrace 30 blocks)
Ability: Silence — target player cannot use Shard abilities for 3s
Ultimate: Nullify — removes ALL potion effects from target
Recipe: GTG/TNT/GTG (G=Ghast Tear, T=Totem of Undying, N=Netherite Block)
TIER 4
16. Six Eyes Shard (six_eyes, CMD 1016)
Passive: 30% cooldown reduction on all abilities (checked in ShardManager.hasCooldownReduction)
Ability: Red/Blue — sneak to push, stand to pull target (20 blocks)
Ultimate: Hollow Purple — 10 True Damage + destroys 5 random blocks near target
Recipe: EBE/BNB/EBE (E=Emerald Block, B=Beacon, N=Netherite Block)
17. Curse Shard (curse, CMD 1017)
Passive: 1.0 true damage (half-heart) per tick to nearby enemies (repeating task)
Ability: Hex — DOT effect on target for 5s
Ultimate: Domain — visual box of redstone dust particles, teleports target back if they leave
Recipe: WEW/EBE/WEW (W=Wither Skeleton Skull, E=Echo Shard, B=Beacon)
18. Gate Shard (gate, CMD 1018)
Passive: Luck II
Ability: Save/Recall toggle — first right-click saves location, second recalls to it
Ultimate: Arrow Storm — spawns 60 homing arrows that track target constantly for 10s
Recipe: GEG/EBE/GEG (G=Gold Block, E=Echo Shard, B=Beacon)
19. Anti-Magic Shard (anti_magic, CMD 1019)
Passive: Immune to Slowness and Blindness
Ability: Deflect — reflects incoming projectiles for 3s
Ultimate: Demon Form — +50% DMG + flight for 10s (onPlayerDealDamage multiplier)
Recipe: OTO/TBT/OTO (O=Crying Obsidian, T=Totem of Undying, B=Beacon)
20. Stand Shard (stand, CMD 1020)
Passive: +2 Block Reach Distance
Ability: Barrage — 5 rapid 1-damage true hits on target
Ultimate: The World — global 5s time freeze (Slowness 255 + no-jump on all players)
Recipe: NTN/TBT/NTN (N=Netherite Block, T=Totem of Undying, B=Beacon)
TIER 5
21. Almighty Shard (almighty, CMD 1021)
Passive: Jump Boost V
Ability: Almighty Push — 20-block AOE knockback
Ultimate: Chibaku Tensei — launches all enemies into the sky
Recipe: NEN/EBE/NEN (N=Netherite Block, E=End Crystal, B=Beacon)
22. False God Shard (false_god, CMD 1022)
Passive: Permanent Absorption II
Ability: Smite — lightning strike on target
Ultimate: Judgment — halves target's current HP
Recipe: GTG/TET/GTG (G=Gold Block, T=Totem of Undying, E=End Crystal)
23. Rumbling Shard (rumbling, CMD 1023)
Passive: Strength II
Ability: Stomp — 10-block AOE Earthquake knockback + explosion effect
Ultimate: The Wall — summon 3 Giants that crush enemies (6 damage/s) for 10s, don't attack caster
Recipe: OWO/WEW/OWO (O=Obsidian, W=Wither Rose, E=End Crystal)
24. Eclipse Shard (eclipse, CMD 1024)
Passive: +4 Max Hearts (AttributeModifier)
Ability: Eclipse Drain — steals target's health
Ultimate: Total Eclipse — Wither + Blindness on all nearby entities
Recipe: OEO/ENE/OEO (O=Crying Obsidian, E=End Crystal, N=Netherite Block)
25. Zenith Shard (zenith, CMD 1025)
Passive: Regeneration I + Speed II
Ability: Zenith Blast — ranged energy projectile
Ultimate: Zenith Ascension — invulnerability + flight for 10s
Recipe: NEN/EBE/NEN (N=Netherite Block, E=End Crystal, B=Beacon)
TIER 6
26. The Origin (the_origin, CMD 1026)
Passive: ALL positive potion effects at level II (Speed, Strength, Resistance, Regen, Jump, Fire Res, Water Breathing, Night Vision, Absorption, Luck)
Ability: Universal Pull — teleport any player to 0,0
Ultimate: Big Bang — reset all nearby players to 1 HP
Crafting: NOT crafted. Obtained via Origin Forge — drop Dragon Egg + 5 T5 Shards at X:0, Z:0 on Crying Obsidian. Only 1 can exist. 4-minute ritual.
Recipe: none (getRecipe returns null)
Ritual System
Recipes are intercepted on CraftItemEvent → cancelled → ingredients consumed → crafting table closed → Ritual starts
Ritual spawns an invisible ArmorStand anchor with "★ RITUAL ★" floating name
30-block contest radius with 60-particle flame helix animation
Action bar shows progress % and countdown
Server-wide broadcasts on start, every 30s, and completion/failure
If player leaves 30-block zone: 5s grace period with warning sounds, then ritual fails and drops ingredients
Aura System
BossBar fills during combat/proximity
At 100% aura, the player can use Ultimate (sneak + right-click)
Death Mechanics
On death: passive removed, server-wide broadcast with death coords and shard name
YOUR TASK
This plugin currently works but needs a premium visual and audio polish pass for Paper 1.21.1. Implement the following:
1. Upgrade to Paper 1.21.1
Update
build.gradle
to target io.papermc.paper:paper-api:1.21.1-R0.1-SNAPSHOT instead of spigot-api 1.20.4
Use Paper's native Adventure API (Component, MiniMessage) instead of legacy ChatColor.translateAlternateColorCodes
Use Paper's native player.sendActionBar(Component) instead of the Spigot ChatMessageType workaround
Set Java source/target to 21
Do NOT break any existing ability logic
2. SFX Pass — Every Shard Action Must Have Sound
For EVERY shard's
applyPassive
,
onAbility
, and
onUltimate
, ensure there is a fitting XSound call:
Passive activation: soft ambient sound (e.g., BLOCK_BEACON_ACTIVATE, ENTITY_EXPERIENCE_ORB_PICKUP)
Ability use: impactful mid-tier sound matching the shard's theme
Ultimate activation: dramatic, powerful sound (e.g., ENTITY_WITHER_SPAWN, ENTITY_ENDER_DRAGON_GROWL, UI_TOAST_CHALLENGE_COMPLETE)
Cooldown message: ENTITY_VILLAGER_NO or similar denial sound
Ability hit: impact sound on the target's location
3. VFX Pass — Particle Effects for Every Action
For EVERY shard's
onAbility
and
onUltimate
, add themed particle effects:
Use Paper/Bukkit's
Particle
enum directly (not XParticle strings)
Passive: Subtle ambient particles around the player (optional repeating task)
Ability cast: Burst of particles at cast location
Ability impact: Particles at target location
Ultimate: Large-scale dramatic particle effects (spirals, pillars, explosions)
Use Particle.DustOptions for colored particles where appropriate
Examples: Ice = SNOWFLAKE + BLOCK_CRACK(ICE), Fire = FLAME + LAVA, Shadow = SMOKE_LARGE + SQUID_INK, Blood = REDSTONE(DustOptions red), etc.
4. Visual Enhancements
Shard Item Glow: All shard items should have enchantment glint (addEnchant(UNBREAKING, 1, true) + addItemFlags(HIDE_ENCHANTS))
Title Messages: Major events (ultimate activation, ritual start/complete) should use player.sendTitle() with fade-in/stay/fade-out
Action Bar Feedback: All ability activations show action bar messages with Unicode symbols
BossBar Aura: Ensure the aura BossBar changes color based on fill % (RED < 33%, YELLOW < 66%, GREEN < 100%, PURPLE = full)
5. Ritual Visual Overhaul
Replace the basic flame helix with a multi-layered particle system: outer ring (soul fire), inner ring (enchantment), center beam (end rod going up)
Add block-change effects around the anchor (temporary crying obsidian ring)
Final completion should have a dramatic lightning strike + firework burst
Failure should have explosion particles + wither sound
6. Code Quality
Remove all dead code and unused imports
Ensure all BukkitRunnable tasks have proper cancellation (no memory leaks)
All potion amplifiers must be correct: amplifier 0 = Level I, 1 = Level II, etc (0-indexed)
Ensure thread safety: async particle tasks should not modify entities
Build must compile with 0 errors. Do NOT remove or alter any ability/passive/ultimate logic — only ADD sound and visual effects.
Reviews (0)
No reviews yet
Be the first to leave a review!
Seller
Mohid Khan
0
downloads
Versionv1.0.0
Platformminecraft
Typespigot
Minecraft VersionMC 1.20
CategoryMinecraft Plugins > Gameplay
Published on11/03/2026
Last update21/04/2026
Free