EclipseFX

# EclipseFX **A cinematic RPG aura & visual effects engine for Minecraft.** _by ArcalithStudios_ EclipseFX is not "just a particle plugin." It's a layered, in-game **aura identity engine** built for MMORPG, anime, fantasy, cultivation, dungeon, class-based, magic and progression servers. Players equip magical auras, anime power effects, cultivation rings, spell circles, combat trails, wings, orbitals, halos, ground runes and awakening bursts — each built from stacked, trigger-driven visual layers that server owners can create, edit, preview, import and export **entirely in-game**, no coding required. --- ## ✨ Features - **Layered aura engine** — every aura is a stack of independent layers (ground rune + orbitals + idle flare + awakening pulse) instead of a single canned effect. - **20 original preset auras** — Void Monarch, Heavenly Ascension, Demon King Pressure, Dragon Soul, Thunder Breathing, Celestial Wings, Time Fracture and more. - **30 shape primitives** — rings, spirals, helixes, halos, orbitals, wings, ground runes, spheres, domes, blade orbits, dragon coils, soul chains, constellations, floating glyphs… - **12 animations & 6 colour modes** — rotate, pulse, rise, orbit, expand, spiral, gradient, rainbow, transition and more. - **Trigger system** — layers react to idle, walking, sprinting, sneaking, jumping, damage, kills, mining, low health and other states. - **Anime awakening cinematics** — title, layered sounds, an inward particle build-up and an expanding shockwave, then the aura equips. Never damaging by default. - **In-game aura editor** — tweak every layer value (shape, particle, colour, motion, trigger, performance) with click-to-edit controls. - **RPG class aura groups** — resolve a player's class via permission, PlaceholderAPI or manual assignment, and show class-specific auras. - **Live previews, favorites & per-player visibility toggles.** - **Performance-first** — per-player and global particle budgets, TPS-aware density scaling, per-world disabling, and a live performance dashboard. --- ## 🎮 Commands **Players — `/aura`** | Command | Description | |---|---| | `/aura` | Open the aura menu | | `/aura equip <aura>` | Equip an aura | | `/aura preview <aura>` | Preview an aura | | `/aura toggle` | Toggle your aura's visibility | | `/aura favorites` | Open your favorites | | `/aura awaken <aura>` | Play an awakening cinematic | **Admins — `/eclipsefx`** — dashboard, reload, performance, create/clone/delete/import/export auras, give/take unlocks, awaken players, manage classes, and the in-game editor. Full tab-completion on every command. --- ## 🔐 Permissions - `eclipsefx.menu` — open the aura menu (default: everyone) - `eclipsefx.admin` — full access - `eclipsefx.aura.<id>` / `eclipsefx.category.<category>` / `eclipsefx.rarity.<rarity>` — unlock auras by id, category or rarity - Granular nodes for editor, create, delete, give/take, awaken, preview and class management. --- ## 🧩 Integrations - **PlaceholderAPI** (optional) — `%eclipsefx_equipped_aura%`, `%eclipsefx_aura_rarity%`, `%eclipsefx_auras_unlocked%`, `%eclipsefx_player_class%`, `%eclipsefx_performance_mode%` and more. - **Developer API** — `EclipseFXAPI` plus 6 Bukkit events. Fire aura reactions from your own RPG/skill/quest plugins via `triggerAuraEffect(player, trigger)`. --- ## 📦 Requirements | | | |---|---| | Server | **Paper 1.21.3+** (Paper/Purpur) | | Java | **21** | | Optional | PlaceholderAPI | SQLite is bundled — **no database setup required**. No other dependencies. ## 🚀 Installation 1. Drop `EclipseFX.jar` into your `plugins/` folder. 2. Start the server — configs and the 20 preset auras generate automatically. 3. (Optional) Install PlaceholderAPI for placeholders. 4. Edit the configs and run `/eclipsefx reload`. --- ## ⚙️ Configuration Fully configurable via `config.yml`, `messages.yml` (MiniMessage), `themes.yml`, `performance.yml`, `classes.yml`, `storage.yml`, `permissions.yml` and per-aura files in `auras/`. ## 💬 Support Found a bug or have a suggestion? Open a ticket on the ArcalithStudios support channel. _Free to use on any server. Made with care by ArcalithStudios._