⭐ 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.

---

🖼️ Showcase

🎬 In-game GUI

The main hub — your head and the three effect tiers.

A paginated category menu with a live preview of your active effect.

---

✨ 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

🔵 Special

RGB Vortex · Double Helix · Soul Ring · Snow Flurry · Galaxy Spiral · Angel Wings · Flame Spiral · Frost Nova · Ender Aura · Love Halo

🔴 Administrative

Thunder Strike · Crown of Glory · Divine Beam · Dragon Aura · Inferno Spiral · Nebula · Meteor Shower · Sonic Boom · Totem Blessing · Big Bang

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 change cooldown
nstar.effect.<id>	false	Unlock a single effect
nstar.category.basic	false	Unlock the whole Basic tier
nstar.category.special	false	Unlock the whole Special tier
nstar.category.administrative	false	Unlock the whole Administrative tier

---

⚙️ Configuration

• config.yml — language (EN/PL), command aliases, storage (SQLite/MySQL), play delay, change cooldown, join-messages module, update checker.
• effects.yml — every effect with full documentation and examples for each type and shape.
• messages_en.yml / messages_pl.yml — all text and the entire GUI layout (titles, slots, lore, borders, custom heads).

---

🧩 PlaceholderAPI

Placeholder	Returns
%nstar_effect%	Selected effect id
%nstar_effect_name%	Coloured display name
%nstar_effect_permission%	Permission node of the selected effect
%nstar_has_effect%	Yes / No

---

📦 Requirements

• Server: Paper or Purpur 1.21.10
• Java: 21
• Optional: PlaceholderAPI

HikariCP and the SQLite / MySQL drivers are downloaded automatically by Paper at runtime — no shading, no manual installs.

---

💬 Support

Need help, found a bug or have a suggestion? Join the Discord: https://discord.gg/UGdPkamwfN

Made with care by NullaretH.