FeatherUtils
一个 Paper/Spigot/Folia 插件,可将你的 Minecraft 服务器与 Feather 客户端集成。它为 Discord Rich Presence 添加了实时在线玩家计数、为 Feather 用户提供了自定义服务器列表背景,并在 Feather 玩家加入时显示可配置的加入消息。
功能
- Discord Rich Presence — 在你的玩家的 Discord 状态中显示你的服务器,并带有自动更新的
online/max 玩家计数。
- 自定义服务器列表背景 — 当玩家在 Feather 客户端浏览你的服务器时,显示 PNG 背景图片。
- Feather 加入消息 — 当使用 Feather 的玩家加入时,广播一条可配置的消息,可选择性地受权限限制。
- 实时更新 — 状态每 5 秒刷新一次,并在玩家加入/离开时立即更新。
要求
- Paper、Spigot 或 Folia 1.21+(该插件使用 Folia 的区域调度器并声明了
folia-supported,因此可以在三者上原生运行)
- Feather Server API
安装
- 将
FeatherUtils.jar 放入服务器的 plugins/ 文件夹中。
- 将 Feather Server API jar 包也添加到
plugins/ 中(FeatherUtils 依赖于此)。
- 启动或重启服务器以生成默认配置文件。
- 编辑
plugins/FeatherUtils/config.yml,然后运行 /featherutils reload。
配置
所有选项均位于 plugins/FeatherUtils/config.yml 中:
| 键 |
描述 |
background |
放置在 plugins/FeatherUtils/backgrounds/ 中的 PNG 文件名。 |
discord-activity.enabled |
开启/关闭 Discord Rich Presence。 |
discord-activity.image |
活动中显示的图像的直接链接。 |
discord-activity.image-text |
图像的悬停文本。 |
discord-activity.state |
第一行;支持 %player_count% 和 %max_players%。 |
discord-activity.details |
第二行;支持相同的占位符。 |
join-message.enabled |
开启/关闭 Feather 加入广播。 |
join-message.message |
消息文本;支持 %player% 和 & 颜色代码。 |
join-message.permission |
如果设置,只有拥有此权限的玩家才能看到该消息。 |
prefix |
命令输出中使用的前缀。 |
将背景图片放置在 plugins/FeatherUtils/backgrounds/<background> 处(仅限 PNG)。
命令
| 命令 |
描述 |
/featherutils reload |
重新加载配置并重新应用背景。 |
/featherutils help |
显示帮助菜单。 |
权限
| 权限 |
描述 |
默认值 |
featherutils.commands.use |
使用 FeatherUtils 命令。 |
op |
featherutils.receivemessages |
接收 Feather 加入消息。 |
true |
作者
Veqtora
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/max player 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.jar into your server's plugins/ 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧