ShineX

✦ 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

<!-- SCREENSHOT: GUI menu kategorii z kilkoma efektami, widoczne gradienty i statusy -->

- Auto-equip toggle in main menu showing all active effects - Auto-equip toggle and hex colors throughout the entire UI - Auto-equip toggle — equipped ✔, available, locked ⛔ - Auto-equip toggle — click to equip, click again to unequip - Auto-equip toggle per category for quick unequip - Auto-equip toggle — remembers cosmetics across sessions

---

⚡ Performance

- Static mode particle computation — all math runs off the main thread - Static mode — balance smoothness vs. CPU usage - Static mode — 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

- Custom pairs — only one cosmetic at a time (any category) - Custom pairs — 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

- PlaceholderAPI (or forks like Purpur) - PlaceholderAPI - PlaceholderAPI *(optional)* — for placeholder support

---

*Made with ❤️ by Nullareth*