FeatherUtils
A Paper/Spigot/Folia plugin that integrates your Minecraft server with the Feather client. It adds Discord Rich Presence with a live player count, a custom server-list background for Feather users, and a configurable join message when a Feather player connects.
Features
- Discord Rich Presence — shows your server in a player's Discord status, with a
live
online/maxplayer count that updates automatically. - Custom server-list background — display a PNG background for players browsing your server in the Feather client.
- Feather join message — broadcast a configurable message when a player joins using Feather, optionally gated behind a permission.
- Live updates — presence refreshes on a 5-second timer and immediately on player join/leave.
Requirements
- Paper, Spigot, or Folia 1.21+ (the plugin uses Folia's region
schedulers and declares
folia-supported, so it runs natively on all three) - Feather Server API
Installation
- Drop
FeatherUtils.jarinto your server'splugins/folder. - Add the Feather Server API jar to
plugins/as well (FeatherUtils depends on it). - Start or restart the server to generate the default config.
- Edit
plugins/FeatherUtils/config.yml, then run/featherutils reload.
Configuration
All options live in plugins/FeatherUtils/config.yml:
| Key | Description |
|---|---|
background |
File name of the PNG placed in plugins/FeatherUtils/backgrounds/. |
discord-activity.enabled |
Toggle Discord Rich Presence on/off. |
discord-activity.image |
Direct link to the image shown in the activity. |
discord-activity.image-text |
Hover text for the image. |
discord-activity.state |
Top line; supports %player_count% and %max_players%. |
discord-activity.details |
Second line; supports the same placeholders. |
join-message.enabled |
Toggle the Feather join broadcast. |
join-message.message |
Message text; supports %player% and & color codes. |
join-message.permission |
If set, only players with this permission see the message. |
prefix |
Prefix used in command output. |
Place your background image at plugins/FeatherUtils/backgrounds/<background> (PNG only).
Commands
| Command | Description |
|---|---|
/featherutils reload |
Reloads the config and re-applies the background. |
/featherutils help |
Shows the help menu. |
Permissions
| Permission | Description | Default |
|---|---|---|
featherutils.commands.use |
Use FeatherUtils commands. | op |
featherutils.receivemessages |
Receive Feather join messages. | true |
Author
Veqtora
