✨ NeON ✨
The ultimate player join & leave experience for your Minecraft server
✨ What is NeON?
NeON turns every join and leave into an immersive event... say goodbye to ugly vanilla yellow messages!
With just a 'few' edits in the NeON\config.yml, you can:
- Elevate your chat with auto‑centered, MiniMessage & HEX‑coloured messages
- Surprise players with floating holograms (static, tracking or “breathing” animations) on join / leave
- Ignite the sky with custom fireworks (random bursts, hex colours, trails & flicker)
- Stylize join/leave events using particles for subtle ambiance or grand displays
- Get notified via event-correspondant sounds for join/leave (global or per-player)
- Command attention with titles, actionbars and bossbars (global or per‑player)
- Prompt joining players for resource pack usage
Born as the spiritual successor to my once popular ☄️ CometWelcome, now entirely rewritten on modern builds of Paper, ✨ NeON delivers everything CometWelcome could only dream of!
From an auto-updating configuration, plug‑and‑play Auto-Centering, HEX, and MiniMessage support, all the way to all‑new join/leave holograms, ✨ NeON is bound to be the ultimate welcome & farewell experience for your players!
📦 Feature Matrix
| 🚀 Feature |
Join |
Leave |
💬 Custom chat messages
(Proudly featuring AUTO‑CENTER) |
✅ |
✅ |
🏷️ Titles / Subtitles
(GLOBAL or PER‑PLAYER) |
✅ |
✅ |
📟 ActionBars
(GLOBAL or PER‑PLAYER) |
✅ |
✅ |
🚩 BossBars
(GLOBAL or PER‑PLAYER) |
✅ |
✅ |
🕹️ Holograms
(STATIC / TRACKING / BREATHING) |
✅ |
✅ |
🎶 Sounds
(GLOBAL or PER‑PLAYER) |
✅ |
✅ |
✨ Particles
(type, amount, radius, speed) |
✅ |
✅ |
🎆 Fireworks
(random bursts / customizable colors, trails, flicker, power) |
✅ |
– |
📦 Resource‑pack prompt
(custom URL prompt with accept/decline UI) |
✅ |
– |
FULL FEATURE LIST | Click here!
# NeON Configuration Key Reference
- NOTE: This is a minimized version of the fully-documented config generated by NeON.
---
## 📥 Join Events
### 💬 Chat Announcements (`join.global_message.*`)
**Scope:** Global only
- **`join.global_message.enabled`**
Toggle all custom global‐chat join messages on/off.
- **`join.global_message.value`**
The text (or list of lines) displayed in global chat. Supports MiniMessage, Legacy §‑codes & PlaceholderAPI.
- **`join.global_message.centered`**
Center‑align the join text in chat instead of left‑aligned.
#### 🎉 First‑Join Override (`join.global_message.first_join.*`)
- **`join.global_message.first_join.enabled`**
Enable a special message only on a player’s very first join.
- **`join.global_message.first_join.value`**
Custom text/lines shown exclusively on first join.
---
### 📬 Player MOTD (`join.player_motd.*`)
**Scope:** Per‑player only
- **`join.player_motd.enabled`**
Show a multi‑line “message of the day” to each player on login.
- **`join.player_motd.centered`**
Automatically center each line of the MOTD for better alignment.
- **`join.player_motd.value`**
List of MiniMessage strings representing the MOTD content.
---
### 🕹 Holograms (`join.hologram.*`)
**Scope:** Per‑player (with optional first‑join)
- **`join.hologram.enabled`**
Spawn floating text at eye level when a player joins.
- **`join.hologram.value`**
List of MiniMessage lines displayed as the hologram.
- **`join.hologram.duration`**
How long (in seconds) the hologram remains visible.
- **`join.hologram.distance`**
Distance (in blocks) in front of the player’s eyes.
#### 🔄 First‑Join Hologram (`join.hologram.first_join.*`)
- **`join.hologram.first_join.enabled`**
Only show hologram on a player’s first ever join.
- **`join.hologram.first_join.value`**
Custom lines for the first‑join hologram.
#### 🔭 Tracking & Bounce
- **`join.hologram.tracking.enabled`**
Make the hologram follow the player’s crosshair.
- **`join.hologram.bounce.enabled`**
Enable a “breathing” up‑and‑down animation (only if tracking is OFF).
#### 🎯 Pitch Lock (`join.hologram.pitch_lock.*`)
- **`join.hologram.pitch_lock.enabled`**
Prevent steep camera angles from making text unreadable.
- **`join.hologram.pitch_lock.value`**
Two‑float list `[maxPitch, minPitch]` (default `[25.0, -40.0]`).
---
### 🏷 Titles & ActionBars
#### ▶️ Player Title (`join.player_title.*`)
- **`join.player_title.enabled`**
Show a title & optional subtitle to the joining player.
- **`join.player_title.title`**
Main title text (MiniMessage/PAPI/§‑codes).
- **`join.player_title.subtitle`**
Subtitle text.
- **`join.player_title.time`**
Duration (in seconds) the title remains on screen.
#### 🌐 Global Title (`join.global_title.*`)
- **`join.global_title.enabled`**
Broadcast a title to all players when someone joins.
- **`join.global_title.title`**
Global title text (supports `%joined_player%`).
- **`join.global_title.subtitle`**
Global subtitle text.
- **`join.global_title.time`**
Display duration in seconds.
#### 📟 Player ActionBar (`join.player_actionbar.*`)
- **`join.player_actionbar.enabled`**
Show an actionbar to the joining player.
- **`join.player_actionbar.value`**
Actionbar text (MiniMessage/PAPI).
- **`join.player_actionbar.time`**
Duration in seconds.
#### 📰 Global ActionBar (`join.global_actionbar.*`)
- **`join.global_actionbar.enabled`**
Broadcast an actionbar to all players.
- **`join.global_actionbar.value`**
Text (supports `%joined_player%`).
- **`join.global_actionbar.time`**
Duration (seconds).
---
### 🚩 BossBars
#### 👤 Player BossBar (`join.player_bossbar.*`)
- **`join.player_bossbar.enabled`**
Display a bossbar to the joining player.
- **`join.player_bossbar.value`**
The MiniMessage/PAPI text shown on the bossbar.
- **`join.player_bossbar.color`**
Bar color. Valid values: `PINK`, `BLUE`, `RED`, `GREEN`, `YELLOW`, `PURPLE`, `WHITE`.
- **`join.player_bossbar.style`**
Segment style. Valid values: `SOLID`, `SEGMENTED_6`, `SEGMENTED_10`, `SEGMENTED_12`, `SEGMENTED_20`.
- **`join.player_bossbar.duration`**
How long (in seconds) the bossbar remains visible.
- **`join.player_bossbar.direction`**
Fill direction & easing curve. Valid values include:
- `LEFT_TO_RIGHT`
- `RIGHT_TO_LEFT`
- `LEFT_TO_RIGHT_CUBIC`
- `RIGHT_TO_LEFT_CUBIC`
- `SOLID`
#### 🌍 Global BossBar (`join.global_bossbar.*`)
- **`join.global_bossbar.enabled`**
Broadcast a bossbar to all players when someone joins.
- **`join.global_bossbar.value`**
Text shown on the global bossbar (supports `%joined_player%`).
- **`join.global_bossbar.color`**
Bar color. Valid values: `PINK`, `BLUE`, `RED`, `GREEN`, `YELLOW`, `PURPLE`, `WHITE`.
- **`join.global_bossbar.style`**
Segment style. Valid values: `SOLID`, `SEGMENTED_6`, `SEGMENTED_10`, `SEGMENTED_12`, `SEGMENTED_20`.
- **`join.global_bossbar.duration`**
How many seconds the bossbar remains visible.
- **`join.global_bossbar.direction`**
Fill direction & easing curve. Valid values include:
- `LEFT_TO_RIGHT`
- `RIGHT_TO_LEFT`
- `LEFT_TO_RIGHT_CUBIC`
- `RIGHT_TO_LEFT_CUBIC`
- `SOLID`
---
### 🎶 Audio (`join.sound.*`)
#### 🎧 Player Sound (`join.sound.player.*`)
- **`join.sound.player.enabled`**
Play a sound to the joining player.
- **`join.sound.player.value`**
Vanilla sound event key (e.g. `ENTITY_PLAYER_LEVELUP`).
- **`join.sound.player.pitch_volume`**
Two‑float list `[pitch, volume]`.
#### 🔊 Global Sound (`join.sound.global.*`)
- **`join.sound.global.enabled`**
Broadcast a sound to all players.
- **`join.sound.global.value`**
Sound event key.
- **`join.sound.global.pitch_volume`**
`[pitch, volume]`.
---
### 🎆 Fireworks (`join.fireworks.*`)
- **`join.fireworks.enabled`**
Launch fireworks when a player joins.
- (These fireworks can not do damage to the player.)
#### ✨ Randomized Firework
- **`join.fireworks.randomize`**
Randomize firework meta per spawn?
#### 🎨 Manual Settings (if `randomize: false`)
- **`join.fireworks.color`**
List of hex colors for explosion.
- **`join.fireworks.fade_color`**
Hex list for fade colors.
- **`join.fireworks.type`**
Shape (`BALL|BURST|…`).
- **`join.fireworks.flicker`**
Enable flicker.
- **`join.fireworks.trail`**
Enable trail effect.
- **`join.fireworks.power`**
Rocket flight power.
---
### ✨ Particles (`join.particle.*`)
- **`join.particle.enabled`**
Spawn particles on join.
- **`join.particle.type`**
Particle type name.
- **`join.particle.amount`**
Number of particles.
- **`join.particle.radius`**
Spread radius.
- **`join.particle.speed`**
Particle speed.
---
### 📦 Resource‑Pack Prompt (`join.resource_pack.*`)
- **`join.resource_pack.enabled`**
Prompt players to download a custom resource pack.
- **`join.resource_pack.url`**
URL to the pack.
---
## 📤 Leave Events
### 💬 Chat Announcements (`leave.global_message.*`)
- **`leave.global_message.enabled`**
Toggle farewell messages in chat.
- **`leave.global_message.value`**
List of lines for leave announcements.
- **`leave.global_message.centered`**
Center‑align the text.
---
### 🕹 Logout Hologram (`leave.hologram.*`)
- **`leave.hologram.enabled`**
Show floating text where the player logged out.
- **`leave.hologram.value`**
Lines displayed.
- **`leave.hologram.duration`**
Duration in seconds.
---
### 🏷 Leave Titles & ActionBars
#### 🌍 Global Leave Title (`leave.global_title.*`)
- **`leave.global_title.enabled`**
Broadcast a leave title to all players.
- **`leave.global_title.title`**
Main leave title (supports `%left_player%`).
- **`leave.global_title.subtitle`**
Subtitle text.
- **`leave.global_title.time`**
Display duration.
#### 📰 Global Leave ActionBar (`leave.global_actionbar.*`)
- **`leave.global_actionbar.enabled`**
Broadcast a leave actionbar.
- **`leave.global_actionbar.value`**
Text content.
- **`leave.global_actionbar.time`**
Duration in seconds.
---
### 🚩 Global Leave BossBar (`leave.global_bossbar.*`)
- **`leave.global_bossbar.enabled`**
Display a bossbar to all players when someone leaves.
- **`leave.global_bossbar.value`**
Text shown on the leave bossbar (supports `%left_player%`).
- **`leave.global_bossbar.color`**
Bar color. Valid values: `PINK`, `BLUE`, `RED`, `GREEN`, `YELLOW`, `PURPLE`, `WHITE`.
- **`leave.global_bossbar.style`**
Segment style. Valid values: `SOLID`, `SEGMENTED_6`, `SEGMENTED_10`, `SEGMENTED_12`, `SEGMENTED_20`.
- **`leave.global_bossbar.duration`**
Duration in seconds before the bossbar disappears.
- **`leave.global_bossbar.direction`**
Fill direction & easing curve. Valid values include:
- `LEFT_TO_RIGHT`
- `RIGHT_TO_LEFT`
- `LEFT_TO_RIGHT_CUBIC`
- `RIGHT_TO_LEFT_CUBIC`
- `SOLID`
---
### 🎶 Leave Sounds (`leave.sound.*`)
#### 🎧 Player‑Only (`leave.sound.player.*`)
- **`leave.sound.player.enabled`**
Play a sound to the departing player.
- **`leave.sound.player.value`**
Sound event key.
- **`leave.sound.player.pitch_volume`**
`[pitch, volume]`.
#### 🔊 Global (`leave.sound.global.*`)
- **`leave.sound.global.enabled`**
Broadcast a sound on leave.
- **`leave.sound.global.value`**
Sound key.
- **`leave.sound.global.pitch_volume`**
`[pitch, volume]`.
---
### ✨ Leave Particles (`leave.particle.*`)
- **`leave.particle.enabled`**
Spawn particles on leave.
- **`leave.particle.type`**
Particle type.
- **`leave.particle.amount`**
Number of particles.
- **`leave.particle.radius`**
Spread radius.
- **`leave.particle.speed`**
Particle speed.
🔧 Quick Start
- Drop NeON.jar and PlaceholderAPI into your
plugins/ folder.
- Start your server – NeON will create a fully‑documented
config.yml.
- If you don't already have these PlaceholderAPI Expansions installed run:
/papi ecloud download Player
/papi ecloud download Server
/papi ecloud download Essentials
/papi reload
- Start configuring!
-
You can use /neon reload to hot-reload your configuration file.
Tip: Mix legacy & colour codes, MiniMessage formatting, and PlaceholderAPI/NeON placeholders freely – NeON cleverly parses them all!
🤝 Integrations
- PlaceholderAPI – endless placeholders.
- MiniMessage – modern formatting tags (
<gradient>, <hover>, <click>…).
- Vanish Plugins – SuperVanish & VanishNoPacket are detected automatically.
- (Essentials Vanish not supported.)
❤️ Support & License
Released under CC BY‑NC‑SA 4.0.
Feel free to open issues or PRs on GitHub.
If NeON brightens your server, consider supporting it's development on ☕Ko‑fi.
Made with love by xHue
暂无评论，抢个沙发吧~