SimpleServerUtility

Lightweight, fully-configurable utilities for Spigot/Paper 1.20+ (Java 17+). Toggle every feature via config.yml.

✨ Features

• Custom server list MOTD (multi-line)
• First-join DM + broadcast
• Custom join/quit messages
• Tablist header/footer with %nl% line breaks
• Periodic auto-broadcasts
• Join title + sound
• /rules command
• /broadcast command (colors + placeholders)
• Chat format (global)
• Maintenance mode (+ bypass + toggle command)
• Chat slowmode (+ bypass + toggle/set command)
• /clearchat command

---

✅ Requirements

• Server: Spigot or Paper 1.20+
• Java: 17+ (Java 21 also fine)

---

⌨️ Commands & Permissions

Command	Description	Permission	Default
/ssu reload	Reload config.yml	ssu.reload	OP
/rules	Show the configured rules list	(none)	Everyone
/broadcast <message>	Broadcasts a message (supports & + hex colors, %nl%, %online%, %max%, %ip%)	ssu.broadcast	OP
/maintenance <on,off,status>	Toggle or view maintenance mode	ssu.maintenance	OP
(join during maintenance)	Bypass maintenance kick	ssu.maintenance.bypass	OP
/slowmode <on,off,status,set <seconds>>	Toggle/set global chat slowmode	ssu.slowmode	OP
(slowmode bypass)	Ignore slowmode delay	ssu.slowmode.bypass	OP
/clearchat	Clears public chat	ssu.clearchat	OP

---

🧩 Placeholders

• %player% — player name
• %online% — online player count
• %max% — max players
• %ip% — server IP
• %nl% / %n% — newline

Hex colors &#RRGGBB supported on MC 1.16+.

---

🛠 Installation

1. Put the jar in plugins/.
2. Start server to generate plugins/SimpleServerUtility/config.yml.
3. Edit config and run /ssu reload to apply.

---

⚙️ Config (snippet)

motd:
  enabled: true
  lines:
    - "&aWelcome to &lMyServer&r"
    - "&7Have fun, %player%!"
tablist:
  enabled: true
  header: "&6&lMyServer%nl%&7Online: %online%/%max%"
  footer: "&7IP: &fplay.example.com"
broadcasts:
  enabled: true
  interval-seconds: 300
  messages:
    - "&aJoin our Discord: &bdiscord.gg/example"

Full, documented config is shipped with the plugin jar.

---

🧪 Tested On

• Paper 1.20.x, Spigot 1.20.x (Java 17, 21)

---

📄 License

MIT.