✦ 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 | Rainbow 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