Updates

Updates

A modern Minecraft Paper (1.21.8+) plugin for managing, displaying, and tracking server updates for your players. Easily post news, patch notes, or changelogs and ensure every player stays informed! Features

/updates — View updates, newest first, with click-to-navigate pagination. /update <message> — Admins can post new updates. Supports %nl% or n for line breaks. /updates clear — Admins can clear all updates. /updates help — Shows all commands. Players see only player commands; admins see all. /updates toggle — Players can toggle unread update join notifications. Unread update tracking: Players are notified on join if they haven't seen new updates. All messages configurable: Supports both MiniMessage and legacy & color codes. Configurable command hooks: Run one or more server commands automatically when an update is posted (great for Discord integrations). Player data (seen updates, toggle state) stored per-UUID in a separate file. Updates stored in their own YAML file. Clean, and modular plugin, feel free to fork and expand as you like!

Commands & Permissions Command Permission Description /updates updates.use View updates (pagination, clickable nav) /updates help updates.use View help panel /updates toggle updates.use Toggle unread join notification /update <message> updates.admin Post a new update /updates clear updates.admin Clear all updates

Permission updates.admin is required for admin commands. Players by default can use /updates, /updates help, and /updates toggle.

Configuration

``` config.yml

updates-per-page: 5

messages: no-permission: "&cYou do not have permission." cleared: "&aAll updates cleared." update-posted: "&aUpdate posted." update-usage: "&eUsage: /update <message>" join-unread: "<yellow>You have <green>{amount}</green> unread update(s)! Do <white>/updates</white>." updates-header: "<gold>--- Updates (<white>{page}</white> of <white>{total}</white>) ---" update-format: "<gray>#<white>{number}</white> <gray>by <green>{author}</green>:<reset>n<white>{message}</white>" toggle-on: "&aYou will no longer see unread join messages." toggle-off: "&cYou will now see unread join messages." no-updates: "&7No updates to show." player-only: "&cThis command can only be used by players." unknown-subcommand: "&cInvalid subcommand or page number. Do /updates help" help-header: "<gold>--- Updates Help ---" help-player: "&e/updates &7- Show updatesn&e/updates help &7- Show this paneln&e/updates toggle &7- Toggle unread join msg" help-admin: "&c/update <msg> &7- Post an updaten&c/updates clear &7- Clear all updates"

on-update-commands: - "yourcommand {message}" - "yourcommand {author}"

on-update-commands

Add one or more commands to run (from console) every time an update is posted. Supports {message} and {author} placeholders.

Example:

on-update-commands: - "say [Update] {author} posted: {message}" - "discordsrv broadcast Update: {message} (by {author})" ```

Usage

Posting an update: /update The server will restart soon%nl%Please finish your activities!

Line breaks: Use %nl% or n in your message.

Clearing updates: /updates clear

Viewing updates: /updates — includes clickable navigation for multiple pages.

Toggling join notifications: /updates toggle

Player Join Experience

If a player has not seen the latest updates, they receive a join message telling them how many updates are unread and to use /updates. Once they view the updates, they will not receive the join message again until new updates are posted. Players can toggle this join notification with /updates toggle.