BlameRun – 硬核速通
适用于 Paper 和 Purpur 26.3 的合作硬核速通,在这里每个人都知道该怪谁。
如果有任何人死亡,世界将重置并开始新的尝试,罪魁祸首的脸会显示在每个人的屏幕上。BlameRun 在每个玩家的皮肤头像旁记录其死亡次数,使用分段计时(splits)记录每次尝试的时间,并在尝试之间保留记录,包括“耻辱榜”(最短运行记录)。
仅一个 jar 文件,无依赖项,无需资源包。包含英文和西班牙语的提示信息。
功能
- 自动世界重置。每次尝试都会生成全新的主世界、下界和末地,使用相同的种子并链接传送门。旧世界会从磁盘中删除。
- 按玩家统计的死亡计数器与皮肤头像。显示在操作栏、标签页列表和侧边栏中,并且在每次重置后依然存在。
- Boss 栏中的速通计时器。从第一步开始计时,或采用倒计时模式,所有人被冻结直到出现 GO 指令。
- 分段计时(Splits):铁 → 下界 → 堡垒 → 烈焰棒 → 末影珍珠 → 要塞 → 末地。每个分段时间都会与你的最佳时间进行比较,领先时显示为绿色,落后时显示为红色。
- 记录:最佳时间、胜利次数、最佳分段以及耻辱榜(历史上最短的一次尝试)。
- 死亡时刻:闪电特效、所有人的屏幕上显示罪魁祸首的脸、随机嘲讽台词,以及本次尝试的总结。
- 胜利:龙被击杀后会有烟花和标题提示。
/catchup:用于中途加入的玩家。将他们传送到你身边,并提供与你等级相同或服务器平均水平的装备,加上食物和经验值。当有人在中途加入时,管理员会收到一个可点击的按钮。
- 两种结束条件:首次死亡(经典模式)或 全员死亡(只要还有人活着,尝试就会继续)。
- 固定种子模式:用于练习特定种子。
- 可翻译:所有消息均可编辑,添加语言只需复制单个文件即可。
玩家头像使用 Minecraft 1.21.9 中添加的文本 "object" 组件绘制,因此客户端需要 1.21.9 或更高版本。Paper 26.3 已经要求使用该版本。
要求
- Paper 或 Purpur 26.3(不支持 Folia 和 Spigot)
- Java 25
安装
- 将
BlameRun-<version>.jar 放入 plugins/ 目录。
- 建议在
server.properties 中设置:hardcore=true,以便客户端显示硬核模式的红心。
- 保持下界(
allow-nether=true)和末地(bukkit.yml 中的 settings.allow-end: true)启用,否则传送门将无法工作。
- 启动服务器。插件会创建第一次尝试的世界并将所有人传送到那里。
服务器的主要世界仅作为等待区,因为 Paper 无法在运行时卸载它。从外部加入的玩家会被移动到当前的尝试中,作为新参与者加入。
一次尝试的流程
- 等待阶段:每个人都看到 ATTEMPT #N。计时器从第一步开始,或通过
/run start 启动。
- 进行中:当你到达各个分段点时会收到提示。
- 有人死亡:尝试结束,显示总结,几秒后生成下一次尝试的世界。所有人以生存模式被传送到新世界,背包清空,无经验值和无进度成就。
- 击杀龙:尝试成功,更新记录。通过
/run reset 开始下一次尝试,或启用 reset-after-win 自动重置。
命令
| 命令 |
权限 |
描述 |
/deaths [player] |
everyone |
查看死亡次数和排名。 |
/deaths top |
everyone |
显示前 10 名及其头像。 |
/deaths hud <faces|text|off> |
everyone |
设置操作栏显示的内容。 |
/run · /run stats |
everyone |
当前尝试状态、分段时间和记录。别名:/speedrun。 |
/run seed |
尝试结束后所有人;尝试期间需 blamerun.seed |
显示当前尝试的种子。 |
/run start |
blamerun.run.control |
倒计时后开始计时。 |
/run reset [seed] |
blamerun.run.control |
立即进入下一次尝试,可选择指定种子。 |
/run cancel |
blamerun.run.control |
取消待处理的自动重置。 |
/run new |
blamerun.run.control |
在同一世界中开始新的尝试(计时器归零)。 |
/catchup <player> [admin|average] |
blamerun.catchup |
将玩家传送到你身边并提供可比拟的装备。 |
/deaths set <player> <n> |
blamerun.deaths.edit |
修正某人的死亡次数。 |
/deaths reset confirm |
blamerun.deaths.edit |
将所有人的死亡次数重置为 0。 |
/br reload · /br version |
blamerun.reload |
重新加载配置和语言文件。 |
blamerun.admin 授予所有管理员权限,默认分配给 OP。拥有 blamerun.notify 权限的用户会在有人中途加入时收到可点击的 [Catch up] 按钮。
撤销廉价死亡
如果有人刚出生就死了,而你不想计入死亡次数:
/run cancel 停止自动重置。
/run new 在同一世界中开启新的尝试。
/gamemode survival <player> 复活该玩家。
/deaths set <player> <n> 恢复其之前的死亡次数。
配置
plugins/BlameRun/config.yml 包含完整注释。最有用的选项如下:
| 选项 |
功能说明 |
language |
en 或 es。消息文件位于 lang/<language>.yml。 |
run.ends-when |
first-death(首次死亡)或 all-dead(全部死亡)。 |
run.auto-start |
在玩家首次移动时启动计时器,还是仅通过 /run start 命令启动。 |
world-reset.seed |
留空则每次尝试使用随机种子;设置具体值则始终使用同一种子进行游戏。 |
world-reset.automatic |
false = 仅通过 /run reset 命令重置。 |
world-reset.delay-seconds |
在新世界生成前,显示总结信息的时间(秒)。 |
world-reset.reset-after-win |
获胜后自动进入下一次尝试。 |
world-reset.difficulty / hardcore |
运行世界的难度与硬核模式设置。 |
world-reset.clear-players.* |
新尝试开始时玩家失去的内容:物品栏、末影箱、经验值、状态效果、进度。 |
world-reset.enabled |
设为 false 可让其他插件负责重置世界;此时 BlameRun 仅检测新世界并继续计分。 |
ignored-worlds |
插件不会操作的地图(如大厅等)。 |
hud.* |
开启或关闭屏幕上的各个 HUD 元素。 |
catchup.* |
默认模式、附魔复制、最低食物值、额外物品以及新手提示。 |
当更新插件时,新的配置选项会自动添加到你的 config.yml 中,缺失的消息键将回退到 JAR 包内自带的默认值。
翻译
- 将
plugins/BlameRun/lang/en.yml 复制为 xx.yml。
- 翻译文本内容。保留
<tags>,因为它们是占位符。
- 设置
language: xx 并执行 /br reload。
消息使用 MiniMessage 格式,因此颜色和排版完全可自定义。
数据文件
| 文件 |
内容 |
deaths.yml |
每位玩家的死亡记录及 HUD 偏好设置。 |
run.yml |
当前尝试次数、其种子与世界名称,以及历史最高纪录。 |
这两个文件均存放在插件文件夹中,而非任何世界目录内,因此它们会在世界重置后得以保留。
从源码构建
./gradlew build
需要 JDK 25。生成的 JAR 文件会输出到 build/libs/ 目录。
BlameRun – Hardcore Speedrun
Co-op hardcore speedruns for Paper and Purpur 26.3, where everyone knows who to blame.
If anyone dies, the world resets and a new attempt begins, and the culprit's face shows up on everyone's screen. BlameRun keeps every player's death count next to their skin face, times each attempt with splits, and keeps records between attempts, including the hall of shame for the shortest run ever.
One jar, no dependencies, and no resource pack. English and Spanish messages are included.
Features
- Automatic world reset. Every attempt gets a fresh overworld, Nether and End with the same seed and linked portals. Old worlds are deleted from disk.
- Per-player death counter with skin faces. It is shown in the action bar, the tab list and the sidebar, and it survives every reset.
- Speedrun timer in the boss bar. It starts on the first step, or with a countdown that freezes everyone until GO.
- Splits: Iron → Nether → Fortress → Blaze rod → Ender pearl → Stronghold → The End. Each split is compared to your best time, in green when you're ahead and in red when you're behind.
- Records: best time, wins, best splits, and the hall of shame (the shortest attempt ever).
- Death moments: lightning, the culprit's face on everyone's screen, a random roast line, and a summary of the attempt.
- Victory: fireworks and a title when the dragon dies.
/catchup for late joiners. It teleports them to you and gives them gear of the same tier as yours, or as the server average, plus food and XP. Admins get a clickable button when someone joins mid-attempt.
- Two end conditions: first death (classic) or all dead (the attempt continues while anyone is alive).
- Fixed-seed mode to practise a specific seed.
- Translatable: every message is editable, and adding a language means copying a single file.
Player faces are drawn with the text "object" components added in Minecraft 1.21.9, so clients need 1.21.9 or newer. Paper 26.3 already requires that.
Requirements
- Paper or Purpur 26.3 (Folia and Spigot are not supported)
- Java 25
Installation
- Drop
BlameRun-<version>.jar into plugins/.
- Recommended in
server.properties: hardcore=true, so clients show hardcore hearts.
- Keep the Nether (
allow-nether=true) and the End (settings.allow-end: true in bukkit.yml) enabled, or portals won't work.
- Start the server. The plugin creates the first attempt's worlds and sends everyone there.
The server's main world is only a waiting room, because Paper can't unload it at runtime. Players who join from outside the run are moved into the current attempt as fresh arrivals.
How an attempt works
- Waiting: everyone sees ATTEMPT #N. The timer starts with the first step, or with
/run start.
- Running: splits are announced as you reach them.
- Someone dies: the attempt ends, a summary is shown, and after a few seconds the next attempt's worlds are generated. Everyone is moved there in survival with an empty inventory, no XP and no advancements.
- Dragon killed: the attempt is won and records are updated. Start the next attempt with
/run reset, or enable reset-after-win.
Commands
| Command |
Permission |
Description |
/deaths [player] |
everyone |
Death count and rank. |
/deaths top |
everyone |
Top 10 with faces. |
/deaths hud <faces|text|off> |
everyone |
What your action bar shows. |
/run · /run stats |
everyone |
Current attempt, splits and records. Alias: /speedrun. |
/run seed |
everyone after the attempt; blamerun.seed during it |
Shows the attempt's seed. |
/run start |
blamerun.run.control |
Countdown, then start the timer. |
/run reset [seed] |
blamerun.run.control |
Jump to the next attempt now, optionally with a specific seed. |
/run cancel |
blamerun.run.control |
Cancel a pending automatic reset. |
/run new |
blamerun.run.control |
New attempt in the same world (timer back to 0). |
/catchup <player> [admin|average] |
blamerun.catchup |
Teleport a player to you and give them comparable gear. |
/deaths set <player> <n> |
blamerun.deaths.edit |
Fix a death count. |
/deaths reset confirm |
blamerun.deaths.edit |
Reset everyone's deaths to 0. |
/br reload · /br version |
blamerun.reload |
Reload config and language. |
blamerun.admin grants every admin permission and is given to OPs by default. With blamerun.notify you receive the clickable [Catch up] button when someone joins mid-attempt.
Undoing a cheap death
If someone dies right after spawning and you don't want it to count:
/run cancel stops the automatic reset.
/run new opens a fresh attempt in the same world.
/gamemode survival <player> revives them.
/deaths set <player> <n> restores their previous death count.
Configuration
plugins/BlameRun/config.yml is fully commented. The most useful options:
| Option |
What it does |
language |
en or es. Messages live in lang/<language>.yml. |
run.ends-when |
first-death or all-dead. |
run.auto-start |
Start the timer on first movement, or only with /run start. |
world-reset.seed |
Empty for a random seed every attempt, or set one to always play the same seed. |
world-reset.automatic |
false = reset only with /run reset. |
world-reset.delay-seconds |
Time to read the summary before the new world. |
world-reset.reset-after-win |
Go to the next attempt automatically after a win. |
world-reset.difficulty / hardcore |
Difficulty and hardcore mode of the run worlds. |
world-reset.clear-players.* |
What players lose on a new attempt: inventory, ender chest, XP, effects, advancements. |
world-reset.enabled |
Set to false to let another plugin reset the world; BlameRun then only detects the new world and keeps score. |
ignored-worlds |
Worlds (lobbies, etc.) the plugin never touches. |
hud.* |
Turn each on-screen element on or off. |
catchup.* |
Default mode, enchantment copying, minimum food, extra items and newcomer notices. |
When you update the plugin, new options are added to your config.yml automatically, and missing message keys fall back to the ones bundled in the jar.
Translating
- Copy
plugins/BlameRun/lang/en.yml to xx.yml.
- Translate the text. Keep the
<tags>, because they are placeholders.
- Set
language: xx and run /br reload.
Messages use MiniMessage, so colours and formatting are fully customisable.
Data files
| File |
Contents |
deaths.yml |
Deaths and HUD preference per player. |
run.yml |
Current attempt, its seed and world, and all-time records. |
Both live in the plugin folder, not in any world, so they survive resets.
Building from source
./gradlew build
Requires JDK 25. The jar is written to build/libs/.
评论 0
登录后参与评分
还没有评论,来抢沙发吧