Server News

📢 Server News

Server News is a simple, lightweight Minecraft server plugin for sharing announcements with your players - without spamming chat or forcing popups.

Players are gently reminded when new server news is available, can read it at any time using /news, and the plugin tracks who has already read it. Optionally, you can reward players the first time they read the news.

Built for modern Paper/Spigot servers with performance and simplicity in mind.

---

✨ Features

• 📜 Display server announcements via /news
• 👀 Track which players have already read the news (UUID-based)
• 🔔 Automatic join reminders (with configurable delays)
• 🧪 Test announcements before publishing (testnews.yml)
• 💾 Reader data persists across restarts
• 🎁 Optional reward command for first-time readers
• 🔊 Optional reward sound effect
• ♻️ Reloadable without restarting the server
• 🛡️ Permission-based admin controls

---

🧑‍💻 Commands

Player Commands

• /news
  Reads the current server news and marks the player as having read it.

Admin Commands

• /news test
  Preview testnews.yml without tracking reads
  Permission: shantekmc.servernews.test

• /news reset
  Clears the reader list (use when publishing new announcements)
  Permission: shantekmc.servernews.reset

• /news list
  Shows how many players have read the news and their names
  Permission: shantekmc.servernews.list

• /news reload
  Reloads config.yml, news.yml, and testnews.yml
  Permission: shantekmc.servernews.reload

---

⚙️ Configuration (config.yml)

reward:
  enabled: true
  # Console command to run when a player reads the news for the first time
  # %player% is replaced with the player name
  command: "eco give %player% 25"
  delay-seconds: 5

sound:
  enabled: true
  name: "ENTITY_PLAYER_LEVELUP"
  volume: 0.6
  pitch: 1.2

messages:
  rewarded: "&aPay-day for keeping informed. Good work!"

Notes

• The reward command is fully customizable - economy, items, permissions, crate keys, or any console command.
• Rewards only fire once per news cycle.
• All configuration values can be changed and reloaded live using /news reload.

---

📰 News Files

news.yml

lines:
  - "&6Welcome to Block Horizon!"
  - "&7Check out the new shopping district."
  - "&eHave fun and play fair!"

testnews.yml

Used for previewing announcements before publishing them live.

lines:
  - "&d[Test] &7This is what the next announcement will look like."
  - "&7Make sure colors and formatting look right."

---

🚀 How It Works

1. Admin updates news.yml
2. Admin runs /news reload and /news reset
3. Players are reminded on join if they haven’t read it
4. Players run /news
5. News is shown and the player is marked as read
6. Optional reward is given on first read

No spam. No forced UI. Just clean communication.