P

PLUGIN SPECIFICATION: Flux-Halo (Minecraft Paper 1.21.1 - 26.3)

You are tasked with developing a lightweight, highly optimized Minecraft Paper/Spigot plugin named Flux-Halo compatible with Minecraft Java versions 1.21.1 up to 26.3. Follow all the technical specifications, mechanics, commands, permissions, and configuration structures detailed below.

---

1. Compatibility & Target Version

* Target Version Support: Minecraft 1.21.1 through 26.3 (using modern Paper API standards, Paperweight / Mojang mappings, and PDC for custom items). * Java Version: Java 21+

---

2. Core Plugin Mechanics

Halos & Visuals

* Halos render as a revolving or static ring of glowing particle effects positioned directly above the player's head (approx. 0.3–0.5 blocks above the player's collision box). * Particles must use bright, visible particle types (e.g., DUST with custom RGB colors, END_ROD, or GLOW) to achieve a distinct glowing aesthetic. * Particle Spawn Rate: Every 1–2 ticks (configurable) relative to player movement.

Halo Types & Effects (2 Effects Per Base Halo)

  1. Overworld Halo (overworld)

* Color: Lime (#33FF33 / RGB: 51, 255, 51) * Potion Effects: Speed I, Regeneration I

  1. Ocean Halo (ocean)

* Color: Deep Blue (#0066FF / RGB: 0, 102, 255) * Potion Effects: Water Breathing, Dolphins Grace

  1. Nether Halo (nether)

* Color: Crimson Red (#FF0000 / RGB: 255, 0, 0) * Potion Effects: Fire Resistance, Resistance I

  1. End Halo (end)

* Color: Pure White / Light Purple (#FFFFFF / RGB: 255, 255, 255) * Potion Effects: Slow Falling, Jump Boost II

  1. Multiverse Halo (multiverse)

* Color: Golden (#FFD700 / RGB: 255, 215, 0) * Visual: Alternating particle ring incorporating elements/colors from all 4 base halos. * Potion Effects: ALL 8 effects from the 4 base halos + Strength II (INCREASE_DAMAGE:2).

---

3. Item & Gameplay Mechanics

* Physical Item Representation: Halos exist as physical custom items (e.g., custom player head, nether star, or custom item model using Persistent Data Container key fluxhalo:halo_type). * Equipping via Item: Right-clicking the physical halo item consumes/equips it onto the player. * Unequipping via Command: Any player can execute /fluxhalo unequip <haloname> at any time without special permissions. Unequipping places the physical halo item back into their inventory (or drops it at their location if full). * Death Drop Rule: If a player holding or equipping any Halo dies, the equipped Halo drops on the ground at their death location as a physical item. * Crafting Recipe (Multiverse Halo): * Shapeless crafting grid recipe requiring:

Overworld Halo + Ocean Halo + Nether Halo + End Halo = Multiverse Halo.

---

4. Font & Prefix Requirements

* Small Caps Font Requirement: All default display names, lore, and system messages in messages.yml and config.yml MUST use Small Caps unicode text (e.g., ꜰʟᴜх-ʜᴀʟᴏ, ᴏᴠᴇʀᴡᴏʀʟᴅ ʜᴀʟᴏ). * Plugin Prefix: &8[&#0049FB&lꜰ&#0060F9&lʟ&#0077F8&lᴜ&#008DF6&lх&#00A4F4&l-&#00BBF2&lʜ&#00D2F1&lᴀ&#00E8EF&lʟ&#00FFED&lᴏ&8]

---

5. Commands & Aliases

* Base Command: /fluxhalo * Aliases: /halo, /fhalo

Command Tree & Permissions

| Command | Permission | Description | | :--- | :--- | :--- | | /fluxhalo unequip <haloname> | None (Default: Everyone) | Unequips an active halo and returns the physical item to the player. | | /fluxhalo equip <player> <haloname> | fluxhalo.admin | Force-equips a halo on a player. | | /fluxhalo remove <player> <haloname> | fluxhalo.admin | Removes an equipped halo from a player (without dropping item). | | /fluxhalo reload | fluxhalo.admin | Reloads config.yml and messages.yml. |

---

6. File Configurations

config.yml

```yaml

=======================================================

FLUX-HALO CONFIGURATION

=======================================================

prefix: "&8[&#0049FB&lꜰ&#0060F9&lʟ&#0077F8&lᴜ&#008DF6&lх&#00A4F4&l-&#00BBF2&lʜ&#00D2F1&lᴀ&#00E8EF&lʟ&#00FFED&lᴏ&8]"

settings: particle-tick-interval: 2 drop-on-death: true enable-crafting-multiverse: true

halos: overworld: display-name: "&#55FF55&lᴏᴠᴇʀᴡᴏʀʟᴅ ʜᴀʟᴏ" material: "PLAYER_HEAD" custom-model-data: 1001 color-rgb: "51,255,51" lore: - "&7ᴀɴ ᴀɴᴄɪᴇɴᴛ ʜᴀʟᴏ ɪᴍʙᴜᴇᴅ ᴡɪᴛʜ" - "&7ᴛʜᴇ ᴘᴏᴡᴇʀ ᴏғ ᴛʜᴇ ᴏᴠᴇʀᴡᴏʀʟᴅ." - "" - "&e&lʀɪɢʜᴛ-ᴄʟɪᴄᴋ &7ᴛᴏ ᴇǫᴜɪᴘ" effects: - "SPEED:1" - "REGENERATION:1"

ocean: display-name: "&#0066FF&lᴏᴄᴇᴀɴ ʜᴀʟᴏ" material: "PLAYER_HEAD" custom-model-data: 1002 color-rgb: "0,102,255" lore: - "&7ᴀɴ ᴀɴᴄɪᴇɴᴛ ʜᴀʟᴏ ɪᴍʙᴜᴇᴅ ᴡɪᴛʜ" - "&7ᴛʜᴇ ᴅᴇᴘᴛʜs ᴏғ ᴛʜᴇ ᴏᴄᴇᴀɴ." - "" - "&e&lʀɪɢʜᴛ-ᴄʟɪᴄᴋ &7ᴛᴏ ᴇǫᴜɪᴘ" effects: - "WATER_BREATHING:1" - "DOLPHINS_GRACE:1"

nether: display-name: "&#FF0000&lɴᴇᴛʜᴇʀ ʜᴀʟᴏ" material: "PLAYER_HEAD" custom-model-data: 1003 color-rgb: "255,0,0" lore: - "&7ᴀɴ ᴀɴᴄɪᴇɴᴛ ʜᴀʟᴏ ɪᴍʙᴜᴇᴅ ᴡɪᴛʜ" - "&7ᴛʜᴇ ғɪᴇʀʏ ɴᴇᴛʜᴇʀ." - "" - "&e&lʀɪɢʜᴛ-ᴄʟɪᴄᴋ &7ᴛᴏ ᴇǫᴜɪᴘ" effects: - "FIRE_RESISTANCE:1" - "RESISTANCE:1"

end: display-name: "&#FFFFFF&lᴇɴᴅ ʜᴀʟᴏ" material: "PLAYER_HEAD" custom-model-data: 1004 color-rgb: "255,255,255" lore: - "&7ᴀɴ ᴀɴᴄɪᴇɴᴛ ʜᴀʟᴏ ɪᴍʙᴜᴇᴅ ᴡɪᴛʜ" - "&7ᴛʜᴇ ᴍʏsᴛɪᴄᴀʟ ᴇɴᴅ." - "" - "&e&lʀɪɢʜᴛ-ᴄʟɪᴄᴋ &7ᴛᴏ ᴇǫᴜɪᴘ" effects: - "SLOW_FALLING:1" - "JUMP_BOOST:2"

multiverse: display-name: "&#FFD700&lᴍᴜʟᴛɪᴠᴇrsᴇ ʜᴀʟᴏ" material: "NETHER_STAR" custom-model-data: 1005 color-rgb: "255,215,0" lore: - "&7ᴛʜᴇ ᴜʟᴛɪᴍᴀᴛᴇ ʜᴀʟᴏ ᴄᴏᴍʙɪɴɪɴɢ" - "&7ᴀʟʟ ᴇʟᴇᴍᴇɴᴛᴀʟ ᴘᴏᴡᴇʀs." - "" - "&e&lʀɪɢʜᴛ-ᴄʟɪᴄᴋ &7ᴛᴏ ᴇǫᴜɪᴘ" effects: - "SPEED:1" - "REGENERATION:1" - "WATER_BREATHING:1" - "DOLPHINS_GRACE:1" - "FIRE_RESISTANCE:1" - "RESISTANCE:1" - "SLOW_FALLING:1" - "JUMP_BOOST:2" - "INCREASE_DAMAGE:2"

Kodari AI
KodariOct 7 at 9:24 am 2
FluxHalo
FluxHalo is a lightweight Paper plugin that adds equippable particle halos with unique visual effects and potion buffs. Players can obtain five distinct halos (Overworld, Ocean, Nether, End, and Multiverse) as physical items, each rendering a glowing particle ring above the player's head. Right-clicking equips a halo, applying its associated potion effects, while the /fluxhalo unequip command returns the item. Admin commands allow force-equipping, removing, and reloading configs. The Multiverse Halo is crafted by combining all four base halos in a shapeless recipe, granting combined effects plus Strength II. Halos drop on death and feature customizable colors, particle intervals, and Small Caps styled messages.
  1. Create the Paper plugin scaffold and small-caps configuration/messages.

  2. Implement persistent halo items, equipping, effects, rotating particles, crafting, and death drops.

  3. Add the player/admin commands and event wiring.

Created Flux-Halo with persistent custom halo items, right-click equipping, rotating colored particle rings, configurable potion effects, the Multiverse crafting recipe, death drops, and the requested player/admin commands. Added the Paper 1.21.1 / Java 21 project scaffold and small-caps configuration and messages.

P

Instead Of Players Heads Add These For The Following 1.Overworld - Grass Block (enchanted it should not show any enchatments) 2.Ocean - Heart Of The Sea (enchanted it should not show any enchatments) 3.Nether - Blaze Powder (enchanted it should not show any enchatments) 4.End - End Stone (enchanted it should not show any enchatments) 5.Multiverse - Heavy Core (enchanted it should not show any enchatments also make sure that player do not craft mace with this)

And Add Abilites For Each Halo When a Player Eqips Any Sword With The Halo and Crouches Then Right Clicks The Get to dash(5blocks) For 3 Times After 3 Time they get a 45 second cooldown and in multivers 5 dash and cooldown 30 seconds and Emprove The Server Performance Add Some Tweaks Make The Plugin More Smooth And Lag Free

Kodari AI
KodariOct 7 at 10:00 am 2
  1. Update halo item materials and hide enchantment glint; prevent Heavy Core halos from being used to craft a mace.

  2. Add crouch + right-click sword dashes with the requested charges and cooldowns.

  3. Apply focused performance improvements to halo effects and particle updates.

  • Replaced the halo items with Grass Block, Heart of the Sea, Blaze Powder, End Stone, and Heavy Core. They have an enchantment glint without displaying enchantments; tagged Multiverse Halos are blocked from mace crafting.

  • Added the crouch + right-click sword dash while a halo is equipped: 3 dashes with a 45-second cooldown, or 5 dashes and a 30-second cooldown for Multiverse.

  • Reduced recurring work by caching particle options and potion effects, refreshing potion effects every 40 ticks instead of every particle tick, and precomputing ring geometry.

P

Make The Partcile Effects Of Each Ring a Little Better And I told You To Make The Multiverse Halo iN Golden Colour

Kodari AI
KodariOct 7 at 10:07 am 1

The generation was stopped before any content could be produced.

P

Make The Partcile Effects Of Each Ring a Little Better And I told You To Make The Multiverse Halo in Golden Colour and also add sound effects on the abilities based on the halo effects

Kodari AI
KodariOct 7 at 10:10 am 1
  1. Improve ring visuals and make Multiverse unmistakably gold.

  2. Add halo-themed sound effects to successful dash abilities.

Updated Flux-Halo’s visuals: each ring now has a brighter outer ring, a smaller inner ring, and subtle End Rod accents. The Multiverse ring now uses its configured gold throughout instead of alternating between the base-halo colors.

Successful dashes now play halo-themed sounds: Overworld level-up, Ocean dolphin splash, Nether blaze shot, End enderman teleport, and Multiverse firework blast.

P

The Dash Isnt Of 5 Blocks Its Like a 0.5 Blocks Make It 5 Blocks Dash Full and fix bugs and put end of eye in the end halo item

Kodari AI
KodariOct 7 at 10:20 am 1
  1. Fix the dash to travel a full 5 blocks.

  2. Change the End halo icon to an Eye of Ender and check the related changes for bugs.

Fixed the dash to travel 5 blocks in 10 smooth half-block steps, stopping if it hits a solid block. Changed the End halo item to an Eye of Ender.

P

Add More Particle Effects ON The Halo Of Every U Dont Need To Use Only 1 Add More To Make IT Look Good Make The Halo Particle More Enhanced

Kodari AI
KodariOct 7 at 10:22 am 1

I’ll give each halo a distinct themed accent particle and make every ring denser with a complete inner loop, while keeping particle types/options cached and the current tick interval unchanged.

Enhanced all halo rings with a fuller inner loop and rotating themed accents: green sparkles for Overworld, bubbles for Ocean, flames for Nether, portal particles for End, and End Rod accents over Multiverse’s gold dust. Particle types remain cached, and the existing tick interval is unchanged.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
settings.gradle
Code
10 903
src/main/java/com/kodari/fluxhalo/FluxHaloPlugin.java
package com.kodari.fluxhalo;

import org.bukkit.command.CommandSender;
import org.bukkit.command.PluginCommand;
import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.plugin.java.JavaPlugin;

import java.io.File;

public final class FluxHaloPlugin extends JavaPlugin {
    private YamlConfiguration messages;
    private HaloManager haloManager;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        if (!new File(getDataFolder(), "messages.yml").exists()) {
            saveResource("messages.yml", false);
        }
        reloadMessages();

        haloManager = new HaloManager(this);
        HaloCommand haloCommand = new HaloCommand(this, haloManager);
        PluginCommand command = getCommand("fluxhalo");
        command.setExecutor(haloCommand);
        command.setTabCompleter(haloCommand);
        getServer().getPluginManager().registerEvents(new HaloListener(this, haloManager), this);
    }

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

    public void reloadMessages() {
        messages = YamlConfiguration.loadConfiguration(new File(getDataFolder(), "messages.yml"));
    }

    public void sendMessage(CommandSender recipient, String key, String... replacements) {
        String message = messages.getString("messages." + key, "&cᴜɴᴋɴᴏᴡɴ ᴍᴇssᴀɢᴇ.");
        for (int index = 0; index + 1 < replacements.length; index += 2) {
            message = message.replace(replacements[index], replacements[index + 1]);
        }
        String prefix = getConfig().getString("prefix", "");
        recipient.sendMessage(TextUtil.colorize(prefix + " " + message));
    }

    public void reloadPluginSettings() {
        reloadConfig();
        reloadMessages();
        haloManager.reload();
    }
}