Heartbound
适用于 Minecraft 1.21.x 的 Paper 插件,在所有玩家间实现共享生命值池,并在死亡后自动重置世界。包含完整的速度运行计时器和计分板系统。
功能
- 共享生命值池:所有玩家共享一个单一的生命值池。任何玩家受到伤害时,都会影响全局生命值。
- 共享饥饿与饱和度:食物和饱和度在所有玩家间同步。饥饿消耗和进食效果对所有人平等生效。
- 共享治疗:治疗效果应用于共享池,并按玩家数量分配,以防止乘算漏洞利用。
- 自动世界重置:当共享生命值降至 0 时,世界会在可配置的延迟后自动重置。
- 速度运行计时器:实时计时器记录每次尝试的持续时间。
- 末影龙目标:主要目标是击败末影龙——当龙被杀死时计时器停止。
- 最佳时间记录:自动保存你击杀末影龙的最好时间。
- 尝试历史:记录你最近的 3 次尝试及其时间和结果。
- 侧边栏计分板:始终可见的侧边栏显示:
- 当前计时器(每秒实时更新)
- 尝试次数
- 最佳时间(如果击杀了末影龙)
- 最近 3 次尝试的时间及成功/失败指示符
- Limbo 世界:在重置期间,玩家会被安全传送至虚空世界。
- 出生点区块预加载:可配置围绕出生点的区块半径以进行预加载,从而获得更流畅的开始体验。
- 可配置:所有设置均可通过配置文件自定义。
命令
所有命令都需要 OP 权限。使用 /heartbound 或 /hb:
| 命令 |
描述 |
/hb trigger |
手动触发世界重置 |
/hb attempts |
显示当前尝试次数 |
/hb reset-counter |
将尝试计数器重置为 0(清除历史和最佳时间) |
/hb set-counter <value> |
将计数器设置为特定值 |
/hb health |
显示当前全局生命值 |
/hb sethealth <amount> |
设置全局生命值 |
/hb status |
显示完整状态(计时器、生命值、尝试次数、最佳时间、重置状态) |
/hb timer |
显示当前计时器状态 |
/hb timer-start |
手动开始/重启计时器 |
/hb timer-stop |
手动停止计时器 |
/hb best |
显示最佳末影龙击杀时间 |
/hb history |
显示最近 3 次尝试的时间 |
/hb reload |
重新加载配置 |
计分板显示
侧边栏计分板显示如下内容:
Speedrun
⏱ 12:34 <- 当前计时器(实时更新)
Attempt #5 <- 当前尝试次数
Best: 45:23.456 <- 最佳末影龙击杀时间
Last Attempts: <- 最近 3 次尝试的历史记录
✓ #4 45:23 <- 绿色对勾 = 击杀了末影龙
✗ #3 23:45 <- 红色叉号 = 失败的尝试
✗ #2 12:34
配置
配置文件位于 plugins/Heartbound/config.yml:
# 死亡后的重置延迟(毫秒)
reset-delay-ms: 3000
# 种子模式:"random"(随机)或 "fixed"(固定)
seed-mode: random
# 当 seed-mode 为 "fixed" 时使用的固定种子
fixed-seed: 12345
# 是否在重置期间启用 Limbo 世界
limbo-enabled: true
# 最大共享生命值
max-health: 20.0
# 需要重置维度
reset-overworld: true
reset-nether: true
reset-end: true
# 出生点区块预加载(仅限主世界)
# 围绕出生点预加载并保持加载的区块半径
# 半径为 3 = 7x7 = 49 个区块,半径为 5 = 11x11 = 121 个区块
spawn-preload-radius: 3
# 消息(支持 & 颜色代码)
messages:
prefix: "&c[Heartbound]&r "
death: "&4所有玩家都已倒下!将在 {delay} 秒后重置世界..."
reset-start: "&6世界正在重置中... 请稍候。"
reset-complete: "&a世界重置完成!第 #{attempt} 次尝试开始!"
limbo: "&7在世界重置期间,你处于 Limbo 状态..."
# 静默模式 - 禁用所有消息
silent-mode: false
# 在侧边栏显示速度运行计分板
show-attempts-sidebar: true
安装
- 安装 Paper 1.21.x 服务器
- 将插件 JAR 文件放入服务器的
plugins/ 文件夹
- 启动服务器
- (可选)编辑
plugins/Heartbound/config.yml 并重启
工作原理
- 计时器启动:计时器在服务器启动时或每次重置后开始。
- 独立游戏世界:插件创建独立的
game_world、game_nether 和 game_end 世界用于游戏。
- 伤害共享:所有玩家受到的伤害都通过共享生命值池路由。
- 饥饿共享:食物等级、饱和度和疲惫度在每个刻(tick)在所有玩家间同步。
- 治疗归一化:治疗效果按玩家数量除以,这样多名玩家同时回血不会导致效果乘算。
- 防止个人死亡:阻止个别玩家死亡;只有全局死亡才会触发重置。
- 末影龙检测:当在
game_end 中击杀末影龙时,计时器停止并判定成功。
- 重置序列:
- 停止计时器并记录本次尝试
- 玩家传送到 Limbo 世界(设置为旁观者模式)
- 卸载并删除游戏世界
- 使用新种子创建新世界
- 预加载出生点区块
- 将玩家返回到新出生点(设置为生存模式)
- 生命值和饥饿值重置为满
- 尝试计数器递增
- 为新尝试启动计时器
数据存储
尝试数据保存在 plugins/Heartbound/attempts.yml 中,包括:
- 总尝试次数
- 最近 3 次尝试记录(时间、成功/失败、时间戳)
- 最佳末影龙击杀时间
Heartbound
A Paper plugin for Minecraft 1.21.x that implements a shared health pool across all players with automatic world reset on death. Includes a full speedrun timer and scoreboard system.
Features
- Shared Health Pool: All players share a single health pool. When any player takes damage, it affects the global health.
- Shared Hunger & Saturation: Food and saturation are synced across all players. Hunger depletion and eating benefits apply to everyone equally.
- Shared Healing: Healing is applied to the shared pool and divided by player count to prevent multiplication exploits.
- Automatic World Reset: When the shared health reaches 0, the world automatically resets after a configurable delay.
- Speedrun Timer: Live timer tracks the duration of each attempt.
- Ender Dragon Goal: Main goal is defeating the Ender Dragon — timer stops when the dragon is killed.
- Best Time Tracking: Automatically saves your best dragon kill time.
- Attempt History: Keeps track of your last 3 attempts with times and outcomes.
- Sidebar Scoreboard: Always-visible sidebar showing:
- Current timer (updates live every second)
- Attempt number
- Best time (if dragon was killed)
- Last 3 attempt times with success/fail indicators
- Limbo World: Players are safely teleported to a void world during reset.
- Spawn Chunk Preloading: Configurable radius of chunks to preload around spawn for smoother starts.
- Configurable: All settings can be customized via config file.
Commands
All commands require OP. Use /heartbound or /hb:
| Command |
Description |
/hb trigger |
Manually trigger a world reset |
/hb attempts |
Show current attempt count |
/hb reset-counter |
Reset attempt counter to 0 (clears history and best time) |
/hb set-counter <value> |
Set counter to specific value |
/hb health |
Show current global health |
/hb sethealth <amount> |
Set global health |
/hb status |
Show full status (timer, health, attempts, best time, reset status) |
/hb timer |
Show current timer status |
/hb timer-start |
Manually start/restart the timer |
/hb timer-stop |
Manually stop the timer |
/hb best |
Show best dragon kill time |
/hb history |
Show last 3 attempt times |
/hb reload |
Reload configuration |
Scoreboard Display
The sidebar scoreboard displays:
Speedrun
⏱ 12:34 <- Current timer (updates live)
Attempt #5 <- Current attempt number
Best: 45:23.456 <- Best dragon kill time
Last Attempts: <- History of last 3 attempts
✓ #4 45:23 <- Green checkmark = dragon killed
✗ #3 23:45 <- Red X = failed attempt
✗ #2 12:34
Configuration
Config file is located at plugins/Heartbound/config.yml:
# Reset delay in milliseconds after death
reset-delay-ms: 3000
# Seed mode: "random" or "fixed"
seed-mode: random
# Fixed seed to use when seed-mode is "fixed"
fixed-seed: 12345
# Enable limbo world during reset
limbo-enabled: true
# Maximum shared health
max-health: 20.0
# Which dimensions to reset
reset-overworld: true
reset-nether: true
reset-end: true
# Spawn chunk preloading (overworld only)
# Radius in chunks around spawn to preload and keep loaded
# A radius of 3 = 7x7 = 49 chunks, radius of 5 = 11x11 = 121 chunks
spawn-preload-radius: 3
# Messages (supports & color codes)
messages:
prefix: "&c[Heartbound]&r "
death: "&4All players have fallen! Resetting world in {delay} seconds..."
reset-start: "&6World reset in progress... Please wait."
reset-complete: "&aWorld reset complete! Attempt #{attempt} begins!"
limbo: "&7You are in limbo while the world resets..."
# Silent mode - disable all messages
silent-mode: false
# Show speedrun scoreboard on sidebar
show-attempts-sidebar: true
Installation
- Install Paper 1.21.x server
- Place the plugin JAR in the server's
plugins/ folder
- Start the server
- (Optional) Edit
plugins/Heartbound/config.yml and restart
How It Works
- Timer Start: Timer begins when the server starts or after each reset.
- Separate Game Worlds: The plugin creates separate
game_world, game_nether, and game_end worlds for gameplay.
- Damage Sharing: All player damage is routed through a shared health pool.
- Hunger Sharing: Food level, saturation, and exhaustion are synced across all players every tick.
- Healing Normalization: Healing is divided by player count so multiple players regenerating health doesn't multiply the effect.
- Death Prevention: Individual player deaths are prevented; only global death triggers reset.
- Dragon Detection: When the Ender Dragon is killed in
game_end, the timer stops with success.
- Reset Sequence:
- Timer is stopped and attempt is recorded
- Players teleported to limbo world (set to spectator mode)
- Game worlds are unloaded and deleted
- New worlds are created with a new seed
- Spawn chunks are preloaded
- Players returned to new spawn (set to survival mode)
- Health and hunger reset to full
- Attempt counter incremented
- Timer starts for new attempt
Data Storage
Attempt data is saved to plugins/Heartbound/attempts.yml and includes:
- Total attempt count
- Last 3 attempt records (time, success/fail, timestamp)
- Best dragon kill time
评论 0
登录后参与评分
还没有评论,来抢沙发吧