

如果您有任何建议或修改意见,请在 Discord 上联系我。

- DonutScoreboard 打造了一个与著名服务器 "DonutSMP" 完全相同的计分板。
- 一个 Jar 包搞定所有。 同一个文件适用于 Bukkit、Spigot、Paper、Purpur、Folia、Leaf 和 Canvas,以及 Velocity、Velocity-CTD、BungeeCord 和 Waterfall。无需分别下载后端或代理插件。

- 相同的设计: 计分板完美还原了原版 DonutSMP 的布局——图标、颜色和渐变标题均保持一致。
- 全面自定义:
config.yml 中的每一行均可编辑。支持使用 MiniMessage 标签、十六进制颜色代码、渐变效果,或者用占位符替换任意值。
- 条件计分板: 您可以在
scoreboards 下定义任意多个计分板。系统会自上而下检查条件,匹配到第一个符合条件的即生效——非常适合按权限组或世界设置不同的计分板。
- 无需 Groups 文件的分组计分板: 分组计分板本质上就是一个条件,例如
permission:group.staff。将其放在 default 之上即可生效。
- 动画效果: 在
animations.yml 中定义动画文本,然后在任意行插入 %animation:name%,并可自定义帧间隔。
- 零闪烁: 仅当内容实际发生变化时才会更新行。玩家永远不会看到闪烁或刷新卡顿。
- 兼容 Folia: Folia 使用原生的数据包渲染器,因此该计分板可以在不使用 Bukkit 计分板 API 的情况下正常工作。
- 代理同步: 玩家在
/sb 中的选择会跟随其跨越整个网络——代理端和所有后端保持同步。
- Keyall 倒计时: 全服范围的倒计时功能,会自动重置;到达零点时可触发可选命令并提供反馈。
- 玩家开关: 玩家可以使用
/sb enable 或 /sb disable 自行显示或隐藏自己的计分板,并支持配置聊天栏、动作栏、标题和声音反馈。该设置会在重启后保存。
- 世界控制: 可以按世界禁用计分板,或使用通配符模式(如
event_*)。在不同世界之间切换时会自动处理。
- 自动配置迁移: 旧版配置文件会在启动时自动升级到
config-version: 2.0,原始版本会保留在 backups/ 目录中。
- PlaceholderAPI & Vault: 行内支持任何
%placeholder% 占位符,当安装 Vault 时也支持经济相关的占位符。
- 安全备份:
/dsb export create 会将所有数据文件连同元数据一起打包为 ZIP 文件,而 /dsb import 则可通过一条命令恢复这些数据。

命令
| 命令 |
权限 |
描述 |
/donutscoreboard |
所有人 |
显示插件信息及可用命令 |
/donutscoreboard reload |
donutscoreboard.admin |
重新加载配置文件 |
/donutscoreboard reset |
donutscoreboard.admin |
将配置重置为默认值并重建所有计分板 |
| /donutscoreboard interval <秒> | donutscoreboard.admin | 设置记分板刷新间隔(1-60秒) |
| /donutscoreboard title edit [文本] | donutscoreboard.admin | 修改记分板标题 |
| /donutscoreboard title reset | donutscoreboard.admin | 将标题重置为默认值 |
/donutscoreboard line add [text] |
donutscoreboard.admin |
向计分板添加新行 |
/donutscoreboard line edit <number> [text] |
donutscoreboard.admin |
编辑指定行 |
/donutscoreboard line delete <number> |
donutscoreboard.admin |
从计分板删除一行 |
/donutscoreboard line empty <number> |
donutscoreboard.admin |
清空某一行(使其变为空白) |
/donutscoreboard line reset [number] |
donutscoreboard.admin |
将某一行(或所有行)重置为默认值 |
/donutscoreboard line swap <n> with <n> |
donutscoreboard.admin |
交换两行的位置 |
| /donutscoreboard keyall time set <时间> | donutscoreboard.admin | 设置关键倒计时(示例:30m、1h、2d) |
| /donutscoreboard keyall time reset | donutscoreboard.admin | 将 keyall 倒计时重置为最大持续时间 |
| /donutscoreboard keyall duration <time> | donutscoreboard.admin | 设置 keyall 的最大持续时间(示例:2h、3d) |
| /donutscoreboard keyall trigger | donutscoreboard.admin | 立即触发 keyall 事件 |
| /donutscoreboard world list | donutscoreboard.admin | 列出所有世界及其状态 |
| /donutscoreboard world disable <world> | donutscoreboard.admin | 在指定世界中禁用计分板 |
| /donutscoreboard world enable <world> | donutscoreboard.admin | 在指定世界中启用计分板 |
| /donutscoreboard auto-world list | donutscoreboard.admin | 列出自动禁用的模式 |
| /donutscoreboard auto-world add <pattern> | donutscoreboard.admin | 添加一个自动禁用模式(支持 * 通配符) |
| /donutscoreboard auto-world remove <pattern> | donutscoreboard.admin | 移除一个自动禁用模式 |
| /donutscoreboard animation preview <name> | donutscoreboard.admin | 预览动画的当前帧 |
| /donutscoreboard animation interval <name> <ticks> | donutscoreboard.admin | 更改动画的帧间隔 |
| /donutscoreboard animation delete <name> | donutscoreboard.admin | 删除一个动画 |
| /donutscoreboard style <new\|old> | donutscoreboard.admin | 在预设的计分板布局之间切换 |
| /donutscoreboard scoreboard-numbers <enable|disable> | donutscoreboard.admin | 切换计分板侧边数字显示(Paper 1.20.5+) |
| /donutscoreboard board list | donutscoreboard.admin | 列出所有已配置的计分板及其条件 |
| /donutscoreboard condition test <expression> | donutscoreboard.admin | 在使用前对当前玩家测试某个条件 |
| /donutscoreboard debug | donutscoreboard.admin | 显示配置版本、渲染器、活跃计分板和钩子信息 |
| /donutscoreboard export create | donutscoreboard.admin | 创建完整的配置备份 ZIP 文件 |
| /donutscoreboard export list | donutscoreboard.admin | 列出所有可用的备份导出文件 |
| /donutscoreboard import <filename> | donutscoreboard.admin | 导入一个配置备份 ZIP 文件 |
| /donutscoreboard toggle <player> | donutscoreboard.admin | 切换其他玩家的计分板可见性 |
| /sb | donutscoreboard.toggle | 开启或关闭你自己的计分板 |
| /sb enable | donutscoreboard.toggle | 显示你的计分板 |
| /sb disable | donutscoreboard.toggle | 隐藏你的计分板 |
权限
| 权限 |
默认值 |
描述 |
donutscoreboard.admin |
OP |
完全访问所有管理员命令(授予以下所有子权限) |
donutscoreboard.view |
Everyone |
必须拥有此权限才能查看计分板 |
donutscoreboard.toggle |
Everyone |
可访问 /sb 切换命令 |
donutscoreboard.toggle.others |
OP |
可访问 /dsb toggle <player> 以切换其他玩家的状态 |
donutscoreboard.reload |
OP |
/dsb reload |
donutscoreboard.reset |
OP |
/dsb reset |
donutscoreboard.interval |
OP |
/dsb interval |
donutscoreboard.title |
OP |
/dsb title |
donutscoreboard.line |
OP |
/dsb line |
donutscoreboard.keyall |
OP |
/dsb keyall |
donutscoreboard.world |
OP |
/dsb world |
donutscoreboard.auto-world |
OP |
/dsb auto-world |
donutscoreboard.animation |
OP |
/dsb animation |
donutscoreboard.style |
OP |
/dsb style |
donutscoreboard.board |
OP |
/dsb board |
donutscoreboard.scoreboard-numbers |
OP |
/dsb scoreboard-numbers |
donutscoreboard.export |
OP |
/dsb export |
donutscoreboard.import |
OP |
/dsb import |

- 系统会自动在您的
plugins 文件夹中创建一个名为 DonutScoreboard 的文件夹。在其中您将看到一个干净的 config.yml 文件。
Config.yml
# DonutScoreboard 配置版本。请勿编辑:旧文件会在启动和 /dsb reload 时自动迁移,并在 backups/ 目录下生成备份。
config-version: 2.0
# 在启动时打印带有版本号、作者、平台和下载链接的 DSB 横幅。
startup-banner: true
# 在启动时检查 Modrinth 是否有新版本发布。离线时无静默处理;绝不会阻塞启动过程。
update-checker: true
enabled: true
update-interval: 1
join-delay: 2
keyall-duration: 3600
date-format: "yyyy-MM-dd"
disabled-worlds: []
auto-disable-worlds: []
占位符:
"1": "%player_name%"
"money": "%vault_eco_balance_formatted%"
# 计分板从上到下进行检查。第一个匹配的条件胜出。
# 没有单独的组-计分板系统。在此处放置组条件,例如:
# staff:
# condition: "permission:group.staff || %vault_group% == staff"
# title: "<gradient:#FFD700:#FFA500><bold>Staff</bold></gradient>"
# lines:
# - "<white>Rank <gold>%group%"
# 在 `default` 上方放置一个条件计分板,因为 `default` 的条件为空且始终匹配。
scoreboards:
default:
condition: ""
title: "<gradient:#007DFC:#00E8FC><bold>DonutSMP</bold></gradient>"
numbers-visible: false
lines:
- " "
- "<#00FF00><bold>$</bold> <white>Money <#00FF00>%money%"
- "<#A503FC>★ <white>Shards <#A503FC>0"
- "<#FF0000>? <white>Kills <#FF0000>%kills%"
- "<#FC7703>☠ <white>Deaths <#FC7703>%deaths%"
- "<#00A6FF>⌛ <white>Keyall <#00A6FF>%keyall%"
- "<#FFE600>⌚ <white>Playtime <#FFE600>%playtime%"
- "<#00A6FF>? <white>Team <#00A6FF>%group%"
- " "
- "<gray>NA East <gray>(<#00A6FF>%ping%ms<gray>)"
toggle:
command: "sb"
command-enabled: true
permission: "donutscoreboard.toggle"
default-on: true
args:
enable: "enable"
disable: "disable"
enable:
chat-enabled: true
chat-message: "<green>You have enabled scoreboard."
actionbar-enabled: true
actionbar-message: "<green>You have enabled scoreboard."
title-enabled: false
title-message: "<green>Scoreboard"
subtitle-message: "<gray>has been enabled"
title-fade-in: 10
title-stay: 40
title-fade-out: 10
sound-enabled: true
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
disable:
chat-enabled: true
chat-message: "<red>You have disabled scoreboard."
actionbar-enabled: true
actionbar-message: "<red>You have disabled scoreboard."
title-enabled: false
title-message: "<red>Scoreboard"
subtitle-message: "<gray>has been disabled"
title-fade-in: 10
title-stay: 40
title-fade-out: 10
sound-enabled: true
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
toggle-placeholder:
format-on: "<green><bold>ON"
format-off: "<red><bold>OFF"
adaptive-refresh:
enabled: true
minimum-interval-ticks: 1
scoreboard-conflict-auto-reapply: true
placeholder-intervals:
"%animation:gradient_title%": 15
"%ping%": 20
keyall-execute:
enabled: false
commands:
- "crates key give @a example"
- "broadcast <gold><bold>Keyall keys have been distributed!"
notify:
actionbar-enabled: false
actionbar-message: "<#00A6FF><bold>Keyall</bold> <gray>keys have been given to everyone!"
title-enabled: false
title-message: "<#00A6FF><bold>KEYALL"
subtitle-message: "<gray>Keys have been distributed!"
title-fade-in: 10
title-stay: 60
title-fade-out: 10
sound-enabled: false
sound: "ENTITY_PLAYER_LEVELUP"

- Download the latest version of DonutScoreboard.
- Drop the
.jar file into your server's plugins folder.
- Restart your server.
- Done! No additional setup required.
Running a network? Put the same .jar in your proxy's plugins folder as well. The proxy keeps every player's toggle in sync with your backend servers — nothing else to configure.

© All Rights Reversed. Created by SirSnaryo.


Please contact me on Discord if you have any suggestions or edits.

- DonutScoreboard makes a Scoreboard exactly like the famous Server "DonutSMP"
- One jar for everything. The same file works on Bukkit, Spigot, Paper, Purpur, Folia, Leaf and Canvas, and on Velocity, Velocity-CTD, BungeeCord and Waterfall. No separate backend or proxy download.

- Same Design: The scoreboard matches the original DonutSMP layout exactly — same icons, same colors, same gradient title.
- Full Customization: Every single line is editable in config.yml. Use MiniMessage tags, hex codes, gradients, or swap any value with a placeholder.
- Conditional Scoreboards: List as many scoreboards as you want under
scoreboards. They are checked top to bottom and the first matching condition wins — perfect for per-rank or per-world boards.
- Group Boards Without a Groups File: A group board is just a condition, like
permission:group.staff. Put it above default and you are done.
- Animations: Define animated text in
animations.yml and drop %animation:name% into any line, with its own frame interval.
- Zero Flicker: Lines only update when the content actually changes. Players never see a flash or refresh stutter.
- Folia Ready: Folia uses a native packet renderer, so the board works there without the Bukkit scoreboard API.
- Proxy Sync: A player's
/sb choice follows them across your whole network — the proxy and every backend stay in sync.
- Keyall Countdown: A server-wide countdown that resets automatically, with optional commands and feedback when it hits zero.
- Player Toggle: Players show or hide their own board with
/sb enable or /sb disable, with configurable chat, actionbar, title and sound feedback. The choice saves across restarts.
- World Control: Disable the scoreboard per world, or use wildcard patterns like
event_*. Moving between worlds is handled automatically.
- Automatic Config Migration: Older configs are moved forward to
config-version: 2.0 on startup, and the original is kept in backups/.
- PlaceholderAPI & Vault: Any
%placeholder% works inside lines, and Vault economy placeholders are supported when Vault is installed.
- Safe Backups:
/dsb export create zips every data file with metadata, and /dsb import restores it in one command.

Commands
| Command |
Permission |
Description |
/donutscoreboard |
Everyone |
Shows plugin info and available commands |
/donutscoreboard reload |
donutscoreboard.admin |
Reloads the configuration file |
/donutscoreboard reset |
donutscoreboard.admin |
Resets config to defaults and rebuilds all scoreboards |
/donutscoreboard interval <seconds> |
donutscoreboard.admin |
Sets the scoreboard refresh rate (1-60 seconds) |
/donutscoreboard title edit [text] |
donutscoreboard.admin |
Changes the scoreboard title |
/donutscoreboard title reset |
donutscoreboard.admin |
Resets the title to default |
/donutscoreboard line add [text] |
donutscoreboard.admin |
Adds a new line to the scoreboard |
/donutscoreboard line edit <number> [text] |
donutscoreboard.admin |
Edits a specific line |
/donutscoreboard line delete <number> |
donutscoreboard.admin |
Removes a line from the scoreboard |
/donutscoreboard line empty <number> |
donutscoreboard.admin |
Clears a line (makes it blank) |
/donutscoreboard line reset [number] |
donutscoreboard.admin |
Resets a line (or all lines) to default |
/donutscoreboard line swap <n> with <n> |
donutscoreboard.admin |
Swaps two lines |
/donutscoreboard keyall time set <time> |
donutscoreboard.admin |
Sets the keyall countdown (example: 30m, 1h, 2d) |
/donutscoreboard keyall time reset |
donutscoreboard.admin |
Resets keyall countdown to max duration |
/donutscoreboard keyall duration <time> |
donutscoreboard.admin |
Sets the max keyall duration (example: 2h, 3d) |
/donutscoreboard keyall trigger |
donutscoreboard.admin |
Fires the keyall event immediately |
/donutscoreboard world list |
donutscoreboard.admin |
Lists all worlds and their status |
/donutscoreboard world disable <world> |
donutscoreboard.admin |
Disables the scoreboard in a world |
/donutscoreboard world enable <world> |
donutscoreboard.admin |
Enables the scoreboard in a world |
/donutscoreboard auto-world list |
donutscoreboard.admin |
Lists auto-disable patterns |
/donutscoreboard auto-world add <pattern> |
donutscoreboard.admin |
Adds an auto-disable pattern (supports * wildcard) |
/donutscoreboard auto-world remove <pattern> |
donutscoreboard.admin |
Removes an auto-disable pattern |
/donutscoreboard animation preview <name> |
donutscoreboard.admin |
Previews the current frame of an animation |
/donutscoreboard animation interval <name> <ticks> |
donutscoreboard.admin |
Changes an animation's frame interval |
/donutscoreboard animation delete <name> |
donutscoreboard.admin |
Deletes an animation |
/donutscoreboard style <new|old> |
donutscoreboard.admin |
Switches between preset scoreboard layouts |
/donutscoreboard scoreboard-numbers <enable|disable> |
donutscoreboard.admin |
Toggles the side numbers on the scoreboard (Paper 1.20.5+) |
/donutscoreboard board list |
donutscoreboard.admin |
Lists every configured scoreboard and its condition |
/donutscoreboard condition test <expression> |
donutscoreboard.admin |
Tests a condition against yourself before you use it |
/donutscoreboard debug |
donutscoreboard.admin |
Shows config version, renderer, active boards and hooks |
/donutscoreboard export create |
donutscoreboard.admin |
Creates a full config backup zip |
/donutscoreboard export list |
donutscoreboard.admin |
Lists all available backup exports |
/donutscoreboard import <filename> |
donutscoreboard.admin |
Imports a config backup zip |
/donutscoreboard toggle <player> |
donutscoreboard.admin |
Toggles another player's scoreboard visibility |
/sb |
donutscoreboard.toggle |
Toggles your scoreboard on or off |
/sb enable |
donutscoreboard.toggle |
Shows your scoreboard |
/sb disable |
donutscoreboard.toggle |
Hides your scoreboard |
Permissions
| Permission |
Default |
Description |
donutscoreboard.admin |
OP |
Full access to all admin commands (grants every child permission below) |
donutscoreboard.view |
Everyone |
Required to see the scoreboard at all |
donutscoreboard.toggle |
Everyone |
Access to the /sb toggle command |
donutscoreboard.toggle.others |
OP |
Access to /dsb toggle <player> to toggle other players |
donutscoreboard.reload |
OP |
/dsb reload |
donutscoreboard.reset |
OP |
/dsb reset |
donutscoreboard.interval |
OP |
/dsb interval |
donutscoreboard.title |
OP |
/dsb title |
donutscoreboard.line |
OP |
/dsb line |
donutscoreboard.keyall |
OP |
/dsb keyall |
donutscoreboard.world |
OP |
/dsb world |
donutscoreboard.auto-world |
OP |
/dsb auto-world |
donutscoreboard.animation |
OP |
/dsb animation |
donutscoreboard.style |
OP |
/dsb style |
donutscoreboard.board |
OP |
/dsb board |
donutscoreboard.scoreboard-numbers |
OP |
/dsb scoreboard-numbers |
donutscoreboard.export |
OP |
/dsb export |
donutscoreboard.import |
OP |
/dsb import |

- A folder named
DonutScoreboard is created in your plugins folder automatically. Inside you will find a clean config.yml file.
Config.yml
# DonutScoreboard configuration version. Do not edit: older files are migrated
# forward automatically on startup and /dsb reload, with a backup in backups/.
config-version: 2.0
# Print the DSB banner with version, author, platform and download link on startup.
startup-banner: true
# Check Modrinth for a newer release on startup. Silent when offline; never blocks startup.
update-checker: true
enabled: true
update-interval: 1
join-delay: 2
keyall-duration: 3600
date-format: "yyyy-MM-dd"
disabled-worlds: []
auto-disable-worlds: []
placeholders:
"1": "%player_name%"
"money": "%vault_eco_balance_formatted%"
# Scoreboards are checked from top to bottom. The first matching condition wins.
# There is no separate group-scoreboard system. Put group conditions here, for example:
# staff:
# condition: "permission:group.staff || %vault_group% == staff"
# title: "<gradient:#FFD700:#FFA500><bold>Staff</bold></gradient>"
# lines:
# - "<white>Rank <gold>%group%"
# Place a conditional board above `default`, because `default` has an empty condition and always matches.
scoreboards:
default:
condition: ""
title: "<gradient:#007DFC:#00E8FC><bold>DonutSMP</bold></gradient>"
numbers-visible: false
lines:
- " "
- "<#00FF00><bold>$</bold> <white>Money <#00FF00>%money%"
- "<#A503FC>★ <white>Shards <#A503FC>0"
- "<#FF0000>? <white>Kills <#FF0000>%kills%"
- "<#FC7703>☠ <white>Deaths <#FC7703>%deaths%"
- "<#00A6FF>⌛ <white>Keyall <#00A6FF>%keyall%"
- "<#FFE600>⌚ <white>Playtime <#FFE600>%playtime%"
- "<#00A6FF>? <white>Team <#00A6FF>%group%"
- " "
- "<gray>NA East <gray>(<#00A6FF>%ping%ms<gray>)"
toggle:
command: "sb"
command-enabled: true
permission: "donutscoreboard.toggle"
default-on: true
args:
enable: "enable"
disable: "disable"
enable:
chat-enabled: true
chat-message: "<green>You have enabled scoreboard."
actionbar-enabled: true
actionbar-message: "<green>You have enabled scoreboard."
title-enabled: false
title-message: "<green>Scoreboard"
subtitle-message: "<gray>has been enabled"
title-fade-in: 10
title-stay: 40
title-fade-out: 10
sound-enabled: true
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
disable:
chat-enabled: true
chat-message: "<red>You have disabled scoreboard."
actionbar-enabled: true
actionbar-message: "<red>You have disabled scoreboard."
title-enabled: false
title-message: "<red>Scoreboard"
subtitle-message: "<gray>has been disabled"
title-fade-in: 10
title-stay: 40
title-fade-out: 10
sound-enabled: true
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
toggle-placeholder:
format-on: "<green><bold>ON"
format-off: "<red><bold>OFF"
adaptive-refresh:
enabled: true
minimum-interval-ticks: 1
scoreboard-conflict-auto-reapply: true
placeholder-intervals:
"%animation:gradient_title%": 15
"%ping%": 20
keyall-execute:
enabled: false
commands:
- "crates key give @a example"
- "broadcast <gold><bold>Keyall keys have been distributed!"
notify:
actionbar-enabled: false
actionbar-message: "<#00A6FF><bold>Keyall</bold> <gray>keys have been given to everyone!"
title-enabled: false
title-message: "<#00A6FF><bold>KEYALL"
subtitle-message: "<gray>Keys have been distributed!"
title-fade-in: 10
title-stay: 60
title-fade-out: 10
sound-enabled: false
sound: "ENTITY_PLAYER_LEVELUP"

- Download the latest version of DonutScoreboard.
- Drop the
.jar file into your server's plugins folder.
- Restart your server.
- Done! No additional setup required.
Running a network? Put the same .jar in your proxy's plugins folder as well. The proxy keeps every player's toggle in sync with your backend servers — nothing else to configure.

© All Rights Reversed. Created by SirSnaryo.
评论 0
登录后参与评分
还没有评论,来抢沙发吧