NuLLStar

# ⭐ NuLLStar — Join Effects **Give every player a spectacular entrance.** NuLLStar is a lightweight, fully configurable join-effects plugin for **Paper / Purpur 1.21.10**. Players pick a particle, firework or combo effect from a clean two-level GUI, and it plays the moment they join your server. Every effect has its own permission, so it's perfect for ranks, crates, store perks and donor tiers. > Built for performance, packed with **30 ready-to-use effects**, and with **zero hard-coded text** — translate or restyle absolutely everything. <!-- Optional: footer banner / logo. --> !(https://cdn.modrinth.com/data/cached_images/ab900bca48155fd03069fe26ebabe6a71bcb9a3d.jpeg) --- ## 🖼️ Showcase <!-- A short looping GIF of effects firing on join works best as the first image. --> !(https://cdn.modrinth.com/data/cached_images/bafde20dbf1edbb6c39cc07c05b489043cd0dc5e_0.webp) !(https://cdn.modrinth.com/data/cached_images/59ab5c1c6a64a6800dee4c867308c80a89202858_0.webp) !(https://cdn.modrinth.com/data/cached_images/8bb0e77f4ba958f2f8e046cf1e1660db8e219416_0.webp) --- ## 🎬 In-game GUI <!-- The main hub: player head + the three category heads. --> *The main hub — your head and the three effect tiers.* !(https://cdn.modrinth.com/data/cached_images/c0a720bceda123c9527d8488a0232a34b33b85f3.png) <!-- A category list with the live preview head at the top. --> *A paginated category menu with a live preview of your active effect.* !(https://cdn.modrinth.com/data/cached_images/92d3482e284d0bcb7ac9743829829ab557a6d2c0_0.webp) --- ## ✨ Features - **30 built-in effects** across 3 tiers (10 each): **Basic**, **Special**, **Administrative**. - **A real effect engine**, not just `spawnParticle`. 16 animated shapes: `HELIX` · `DOUBLE_HELIX` · `CIRCLE` · `EXPANDING_RING` · `FOUNTAIN` · `VORTEX` · `PILLAR` · `AURA` · `GALAXY` · `TORNADO` · `SPHERE` · `HEART_SHAPE` · `CROWN` · `BEAM` · `METEOR` · `WINGS` - **6 effect types** — `PARTICLE`, `FIREWORK`, `LIGHTNING`, `FALLING_BLOCK` (falling meteors), `TNT_SCATTER` (harmless TNT) and `COMBO` (stack several effects into one). - **Beautiful two-level GUI** with optional custom base64 skull textures and a live preview head. - **Per-effect permissions** — `nstar.effect.<id>`, or grant a whole tier at once with `nstar.category.<basic|special|administrative>`. - **Persistent selections** — **SQLite** (zero setup) or **MySQL** (great for networks), via HikariCP. - **Admin force-grant** — play an effect on join even without the permission. - **Anti-spam cooldown** between changes (bypass with `nstar.delaybypass`). - **Custom join-messages module** with per-effect overrides. - **Full RGB / hex / gradient** support via MiniMessage *and* legacy `&` codes. - **PlaceholderAPI** support out of the box. - **Built-in Modrinth update checker.** - **Bilingual** (English + Polish) with **every string editable**. - **Custom sounds** per effect. --- ## 🎆 The 30 effects ### 🟢 Basic Flame Helix · Heart Fountain · Arcane Halo · Aqua Splash · Emerald Glimmer · Note Twirl · Smoke Pillar · Rainbow Firework · Star Burst · Creeper Boom <!-- Optional: a grid/collage screenshot of the Basic tier. --> !(https://cdn.modrinth.com/data/cached_images/f018bcf3f1171a7b0b4a9f764dcaa1114338f19b.png) ### 🔵 Special RGB Vortex · Double Helix · Soul Ring · Snow Flurry · Galaxy Spiral · Angel Wings · Flame Spiral · Frost Nova · Ender Aura · Love Halo <!-- Optional: a grid/collage screenshot of the Special tier. --> !(https://cdn.modrinth.com/data/cached_images/ab7b07eedd5aa2c8809a5c9d3dd2dec749937a0a.png) ### 🔴 Administrative Thunder Strike · Crown of Glory · Divine Beam · Dragon Aura · Inferno Spiral · Nebula · Meteor Shower · Sonic Boom · Totem Blessing · Big Bang <!-- Optional: a grid/collage screenshot of the Administrative tier. --> !(https://cdn.modrinth.com/data/cached_images/21aac09e63c5eac2ce1d94d8acfca67c45e21b1e.png) > Every effect is fully editable — icon, name, lore, colours, particle, shape, sound and join message. --- ## 🕹️ Commands | Command | Description | Permission | |---|---|---| | `/nstar` | Open the effects menu | `nstar.use` | | `/nstar off` | Disable your join effect | `nstar.use` | | `/nstar discord` | Discord invite | — | | `/nstar version` | Plugin version | — | | `/nstar help` | Command list | — | | `/nstar reload` | Reload config, messages & effects | `nstar.admin` | | `/nstar admin on <player> <effect>` | Force-grant an effect | `nstar.admin` | | `/nstar admin off <player>` | Clear a player's effect | `nstar.admin` | > The main command is always `/nstar`. Add extra aliases (e.g. `/joineffects`, `/je`) in `config.yml`. --- ## 🔑 Permissions | Node | Default | What it does | |---|---|---| | `nstar.use` | everyone | Open the menu and pick effects | | `nstar.admin` | op | Reload & admin commands | | `nstar.delaybypass` | op | Skip the