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)
- Overworld Halo (
overworld)
* Color: Lime (#33FF33 / RGB: 51, 255, 51) * Potion Effects: Speed I, Regeneration I
- Ocean Halo (
ocean)
* Color: Deep Blue (#0066FF / RGB: 0, 102, 255) * Potion Effects: Water Breathing, Dolphins Grace
- Nether Halo (
nether)
* Color: Crimson Red (#FF0000 / RGB: 255, 0, 0) * Potion Effects: Fire Resistance, Resistance I
- End Halo (
end)
* Color: Pure White / Light Purple (#FFFFFF / RGB: 255, 255, 255) * Potion Effects: Slow Falling, Jump Boost II
- 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[1FB&lꜰ<F9&lʟMF8&lᴜDF6&lх�A4F4&l-�BBF2&lʜ�D2F1&lᴀ�E8EF&lʟ�FFED&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[1FB&lꜰ<F9&lʟMF8&lᴜDF6&lх�A4F4&l-�BBF2&lʜ�D2F1&lᴀ�E8EF&lʟ�FFED&lᴏ&8]"
settings: particle-tick-interval: 2 drop-on-death: true enable-crafting-multiverse: true
halos: overworld: display-name: "7FF55&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: "BFF&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"