TidyMOTD
完全掌控你的服务器列表条目 —— 轮换 MOTD、渐变、居中、悬停文本、图标、维护模式。
每当有人刷新服务器列表时,TidyMOTD 会选取下一个(或按权重随机)MOTD —— 支持实时占位符、可选的自定义悬停提示框、每个条目的独立图标等。
功能
- 轮换 MOTD — 随机(支持每条设置
weight: 权重)或顺序播放。
- 两种格式,自动检测每行内容 — 经典
& 代码 或 MiniMessage (<gradient:#ffaa00:#ff5500>、<#55ff55> 十六进制颜色,…)。
<center> — 在行首使用此标签,TidyMOTD 会在服务器列表中像素级居中该行,即使 {online} 在线人数变化导致宽度改变也能保持居中。
- 实时占位符 —
{online} {max} {time} {date} {day} {tps} {random-player} {unique-players}。
- 悬停文本 — 用你自己的多行文本替换玩家数量上的玩家名称提示框(可全局设置或针对每个条目单独设置)。
- 玩家数量控制 — 隐藏计数(显示
???)或显示一个虚假的最大值。
- 版本文本 — 在原本显示“服务器版本过旧”的位置自定义文本。
- 图标 — 将 64×64 的
.png 文件放入 plugins/TidyMOTD/icons/;可随机轮换或为每个 MOTD 条目固定指定图标。
- 定时条目 — 支持
between: "2026-12-01 / 2026-12-31" 日期范围以及 daily: "18:00 - 23:00" 每日时间段(支持跨午夜循环)。
- 维护模式 — 执行
/tidymotd maintenance on 切换至专用的 MOTD/图标/版本文本,重启后依然生效。
配置
order: random # 或:sequential
motds:
- lines:
- "<center>&6&lMy Server &7- &fSurvival"
- "<center>&7Now with &b{online}&7/&b{max}&7 players!"
- lines:
- "<center><gradient:#55ff55:#00aa00>My Server</gradient>"
- "<center>&aCome build with us!"
weight: 2 # 随机顺序下出现的概率是其他条目的两倍
icon: summer.png # 来自 plugins/TidyMOTD/icons/
hover:
- "&6Welcome!"
- "&evote.myserver.net"
between: "2026-06-01 / 2026-08-31" # 仅在此日期范围内显示
daily: "18:00 - 23:00" # 仅在此每日时间段内显示
默认的 config.yml 对每个部分都有详细文档说明(包括悬停文本、玩家数量、版本文本、图标、维护模式、格式等)。旧的 1.0.x 配置文件会自动迁移(备份保留为 config.yml.bak)。
关于版本文本的说明: Minecraft 仅在客户端协议不匹配时才渲染自定义版本文本,因此 always-show: true 会强制制造协议不匹配状态 —— 此时客户端会显示一个带斜杠的延迟图标,但玩家仍可正常加入服务器。
安装
将 jar 包放入 plugins/ 目录,重启服务器,编辑 plugins/TidyMOTD/config.yml,然后运行 /tidymotd reload。
需要 Paper 1.21.x / 26.x(对应的 jar 包)。
命令与权限
| 命令 |
作用 |
权限 |
/tidymotd reload |
重载配置 |
tidymotd.reload (OP) |
/tidymotd list |
列出已配置的 MOTD |
tidymotd.admin (OP) |
/tidymotd preview |
在聊天中预览所有 MOTD |
tidymotd.admin |
/tidymotd maintenance on|off |
切换维护模式 |
tidymotd.admin |
/tidymotd add <text> |
添加 MOTD(|| 用于分隔两行) |
tidymotd.admin |
/tidymotd remove <#> |
移除某个 MOTD |
tidymotd.admin |
tidymotd.admin 权限包含 tidymotd.reload。
安全设计
仅接管一项内容:服务器列表显示的内容。如果 MOTD 列表为空,它会退让,显示服务器的默认 MOTD。线程安全由设计保证 —— 由于 ping 请求来自主线程之外,实时数据(如 {tps}、{random-player})来源于定期的主线程快照,而 ping 处理器读取的所有数据都是不可变的。唯一的网络活动:一次启动时的更新检查(Modrinth 公共 API)+ 匿名 bStats 统计数据。
TidyMOTD
Full control over your server-list entry — rotating MOTDs, gradients, centering, hover text, icons, maintenance mode.
Every time someone refreshes their server list, TidyMOTD picks the next (or a weighted-random) MOTD — with live placeholders, an optional custom hover tooltip, per-entry icons and more.
Features
- Rotating MOTDs — random (with per-entry
weight:) or sequential.
- Two formats, auto-detected per line — classic
&-codes or MiniMessage (<gradient:#ffaa00:#ff5500>, <#55ff55> hex, …).
<center> — start a line with it and TidyMOTD pixel-centers it in the server list, even as {online} changes width.
- Live placeholders —
{online} {max} {time} {date} {day} {tps} {random-player} {unique-players}.
- Hover text — replace the player-name tooltip on the player count with your own lines (globally or per entry).
- Player count control — hide the count (
???) or show a fake max.
- Version text — custom text where "outdated server" normally appears.
- Icons — put 64×64
.png files in plugins/TidyMOTD/icons/; rotate randomly or pin one per MOTD entry.
- Scheduled entries —
between: "2026-12-01 / 2026-12-31" date ranges and daily: "18:00 - 23:00" windows (wraps past midnight).
- Maintenance mode —
/tidymotd maintenance on switches to a dedicated MOTD/icon/version text, persists across restarts.
Config
order: random # or: sequential
motds:
- lines:
- "<center>&6&lMy Server &7- &fSurvival"
- "<center>&7Now with &b{online}&7/&b{max}&7 players!"
- lines:
- "<center><gradient:#55ff55:#00aa00>My Server</gradient>"
- "<center>&aCome build with us!"
weight: 2 # shown twice as often (random order)
icon: summer.png # from plugins/TidyMOTD/icons/
hover:
- "&6Welcome!"
- "&evote.myserver.net"
between: "2026-06-01 / 2026-08-31" # only in this date range
daily: "18:00 - 23:00" # only in this daily window
The default config.yml documents every section (hover, player-count, version-text, icons, maintenance, formats). Old 1.0.x configs are migrated automatically (a backup is kept as config.yml.bak).
Note on version text: Minecraft only renders custom version text when the client's protocol doesn't match, so always-show: true forces a mismatch — the client then shows a crossed-out ping icon, but players can still join normally.
Install
Drop the jar in plugins/, restart, edit plugins/TidyMOTD/config.yml, run /tidymotd reload.
Requires Paper 1.21.x / 26.x (matching jar).
Commands & permissions
| Command |
What it does |
Permission |
/tidymotd reload |
Reload the config |
tidymotd.reload (OP) |
/tidymotd list |
List configured MOTDs |
tidymotd.admin (OP) |
/tidymotd preview |
Render all MOTDs in chat |
tidymotd.admin |
/tidymotd maintenance on|off |
Toggle maintenance mode |
tidymotd.admin |
/tidymotd add <text> |
Add an MOTD (|| splits two lines) |
tidymotd.admin |
/tidymotd remove <#> |
Remove an MOTD |
tidymotd.admin |
tidymotd.admin includes tidymotd.reload.
Safe by design
Owns exactly one thing: what the server list shows. If your MOTD list is empty it steps aside and the server default shows. Thread-safe by construction — pings arrive off the main thread, so live data ({tps}, {random-player}) comes from a periodic main-thread snapshot and everything the ping handler reads is immutable. Only network activity: one startup update check (Modrinth public API) + anonymous bStats stats.
评论 0
登录后参与评分
还没有评论,来抢沙发吧