Little Nebo

✨ Little Nebo

A lightweight, lovingly-built chat plugin for Paper servers - inspired by Little Nebo, the God of wisdom and communication. Little Nebo keeps your chat customisable and safe, with graceful support for MiniMessage, PlaceholderAPI, and legacy color codes.

Designed with 1.21 in mind, but backported to run cleanly on 1.19.1+. 🧵

---

🌷 Features

- 💬 Simple admin tools — create flexible chat layouts with color, hover text, gradients, and more. - 🧩 Simple admin tools — support for any registered placeholder (e.g. `%player_name%`, `%luckperms_prefix%`). - 🎨 Simple admin tools — allows player messages to use `&`-style Minecraft color codes (toggleable). - 🌈 Simple admin tools — includes backported `<pride:...>` tags for servers before 1.21. - 🔐 Simple admin tools — filters out dangerous tags like `<click>` or `<hover>` in player messages. - 🛠 Simple admin tools — reload config, toggle debug, or test formats live in-game.

---

📥 Installation

1. Drop `LittleNebo.jar` into your `/plugins/` folder. 2. *(Optional)* Add PlaceholderAPI for extended placeholder support. 3. Start your server once to generate the config. 4. Open `/plugins/LittleNebo/config.yml` to start customizing!

---

🧭 Commands

| Command | Permission | Description | |-------------------------------|---------------------|-----------------------------------------| | `/littlenebo reload` | `littlenebo.reload` | Reloads the plugin config. | | `/littlenebo debug` | `littlenebo.admin` | Toggles debug mode on/off. | | `/littlenebo debug config` | `littlenebo.admin` | Shows current configuration values. | | `/littlenebo debug test <msg>`| `littlenebo.admin` | Previews how `<msg>` will be formatted. |

---

🎀 Permissions

- `littlenebo.admin` - manage the plugin and test formats - `littlenebo.reload` - reload Little Nebo conf - `littlenebo.format.*` - use named chat formats like `admin`, `donator`, etc.

---

🧾 Configuration Example

Here's a simple default format using MiniMessage:

```yaml formats: default: format: "<gray>[<green>Chat</green>]</gray> <white>{display_name}</white><gray>: </gray><white>{message}</white>" ```

---

Notes:

- `{display_name}` and `{message}` are automatically replaced by the plugin. - You can include `%player_name%` or any PlaceholderAPI placeholder, if installed. - Set `settings.parse-player-colors` to `true` to allow `&` codes in player messages.

More examples and explanations are available in the generated config.yml.

---

📜 License

MIT License - use it, remix it, improve it. Just be kind.

---

This plugin was made with care and curiosity - thank you for your patience while I learn. 🫶