✦ ShineX - Premium Particle Cosmetics ✦

32 unique particle effects across 4 categories. Lightweight, async, fully configurable.

---

✨ What is ShineX?

ShineX is a premium cosmetic plugin that adds stunning particle effects to your server. Every effect is rendered asynchronously for maximum performance — zero lag, pure aesthetics.

---

🎭 5 Categories, 40 Effects

🔥 Auras (8 effects)

Particle auras that surround the player's body.

Effect	Description
Quantum Singularity	A swirling vortex that bends space
Celestial Sphere	Armillary rings of pure starlight
Fractal Illusion	Endless shifting geometric patterns
Time Dilation	Clocks and time warps spiral around you
Crystalline Matrix	Crystals of light form a geometric cage
Vortex of Souls	Tormented spirits in a dark vortex
Abyssal Runes	Ancient glyphs of forbidden knowledge
Phoenix Rebirth	Rise from the ashes in a blaze of glory

🪽 Wings (8 effects)

Majestic particle wings rendered behind the player.

Effect	Description
Archangel's Fury	Radiant golden wings, fold when sneaking
Cybernetic Glitch	Digital wings with corrupted data streams
Valkyrie Blades	Sharp metallic norse warrior wings
Dragon's Breath	Molten wings dripping with dragonfire
Bioluminescent Web	Glowing organic silk thread wings
Prismatic Butterfly	Iridescent wings shimmering with every hue
Shadow Fiend	Tattered dark wings that devour light
Starlight Nebula	Wings woven from stardust and nebula

👣 Trails (8 effects)

Effects that follow your footsteps — only active while moving.

Effect	Description
Tectonic Rupture	Ground cracks with molten energy
Bifrost Path	✨ crystal bridge under your feet
Echoes of the Past	Ghostly afterimages linger behind you
Floral Spore	Flowers bloom in your footsteps
Geometric Collapse	Reality fractures into geometric shards
Scorched Earth	Ground burns and chars beneath you
Bloody Footprints	Crimson footprints mark your path
Frostwalker's Illusion	Ice forms and shatters in your wake

👑 Head Effects (8 effects)

Floating effects above the player's head.

Effect	Description
Eye of Providence	Burning all-seeing eye that tracks threats
Sword of Damocles	Spectral blade hanging above your head
Floating Pantheon	Miniature solar system orbiting your crown
Holographic AI	Digital hologram pulsing with data
Brainstorm	Lightning arcs between thoughts
Demonic Halo	Dark halo dripping corrupted essence
Crown of Thorns	Bleeding thorns wrapped as a crown
Elemental Lotus	Lotus cycling fire, water, wind, earth

---

🖥️ Premium GUI

• Player head in main menu showing all active effects
• Gradient text and hex colors throughout the entire UI
• Smart status indicators — equipped ✔, available, locked ⛔
• One-click toggle — click to equip, click again to unequip
• Remove button per category for quick unequip
• Auto-equip toggle — remembers cosmetics across sessions

---

⚡ Performance

• Fully async particle computation — all math runs off the main thread
• Configurable tick rate — balance smoothness vs. CPU usage
• Render distance — only send particles to nearby players
• Static mode — effects only appear when standing still (configurable delay)

---

🛠️ Features

Configuration

• config.yml — locale, render distance, tick rate, auto-equip, static mode
• cosmetics.yml — enable/disable any effect, custom names, icons, permissions, lore
• gui.yml — full layout customization, combination modes, slot positions
• Multi-language — English & Polish built-in, easy to add more

Commands

Command	Description	Permission
/shinex	Open cosmetics GUI	shinex.use
/shinex <category> <effect>	Equip (toggle) a cosmetic	shinex.use
/shinex remove <category>	Remove active cosmetic	shinex.use
/shinex <category> <effect> <player>	Equip on another player	shinex.admin
/shinex remove <category> <player>	Remove from another player	shinex.admin
/shinex reload	Reload all configs	shinex.admin
/shinex help	Show help	shinex.use

Permissions

Permission	Description	Default
shinex.use	Access to command & GUI	Everyone
shinex.admin	Admin commands (reload, manage others)	OP
shinex.aura.*	All aura effects	OP
shinex.wings.*	All wing effects	OP
shinex.trail.*	All trail effects	OP
shinex.head.*	All head effects	OP
shinex.aura.phoenix_rebirth	Specific effect	OP

Combination Modes

• SINGLE — only one cosmetic at a time (any category)
• PER-CATEGORY — one per category, all categories simultaneously
• Custom pairs — define exactly which categories can coexist (e.g. AURA+TRAIL)

PlaceholderAPI Support

Placeholder	Returns
%shinex_active_aura%	Active aura name or None
%shinex_active_wings%	Active wings name or None
%shinex_active_trail%	Active trail name or None
%shinex_active_head%	Active head effect name or None
%shinex_active_id_aura%	Active aura ID or none
%shinex_has_aura%	true / false
%shinex_has_any%	true / false
%shinex_count_aura%	Number of available auras for player
%shinex_total_active%	Total active cosmetics count
%shinex_total_available%	Total available cosmetics for player
%shinex_active_list%	Comma-separated list of active names
%shinex_auto_equip%	true / false

---

📋 Requirements

• Paper 1.21.4+ (or forks like Purpur)
• Java 21+
• PlaceholderAPI (optional) — for placeholder support

---

Made with ❤️ by Nullareth