# ✦ 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 -->  - **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*