⭐ 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.
!Banner
🖼️ Showcase
!Sonic Boom !Flame Spiral !Arcane Halo
🎬 In-game GUI
The main hub — your head and the three effect tiers. !Main Menu
A paginated category menu with a live preview of your active effect. !Category Visualization
✨ 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) andCOMBO(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 withnstar.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 · ✨ Firework · Star Burst · Creeper Boom
!Basic Category
🔵 Special
RGB Vortex · Double Helix · Soul Ring · Snow Flurry · Galaxy Spiral · Angel Wings · Flame Spiral · Frost Nova · Ender Aura · Love Halo
!Special Category
🔴 Administrative
Thunder Strike · Crown of Glory · Divine Beam · Dragon Aura · Inferno Spiral · Nebula · Meteor Shower · Sonic Boom · Totem Blessing · Big Bang
!Administrative Category
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) inconfig.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).
!Configuration
🧩 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.