
Persistent Block Damage - Hytale-Style Mining
厌倦了每次停止挖矿时,方块破坏进度都会重置?
Persistent Block Damage 为 Minecraft 带来了一种受 Hytale 启发的挖矿系统。方块伤害效果会保持可见并持续一段可配置的时间,让你能够继续从刚才中断的地方开始挖矿。

? 功能介绍
当你挖掘一个方块时,即使你停止挖矿,其裂纹依然保持可见。如果你在配置的超时时间结束前返回,你可以从完全相同的进度继续挖掘。
打破一个方块所需的总击打次数不会改变。原版平衡性得到完全保留。
Vanilla: ████████████ (12次连续击打或进度重置)
PBD: ██████ pause ██████ = 12 hits ✨
✨ 特性
- 可配置的持久化方块伤害(1–300 秒)
- 停止挖矿后裂纹依然可见
- 可选的平滑衰减系统
- 提供即时重置模式
- 完全兼容多人游戏
- 服务器端权威同步
- 实时管理员命令
- 针对大型服务器进行了优化
- 无需额外依赖项
- 支持专用服务器
? 工作原理
- 开始挖掘一个方块
- 方块累积伤害并显示裂纹
- 停止挖掘
- 裂纹保持可见
- 在超时时间结束前返回
- 从相同的进度继续挖掘
- 如果超时时间结束,伤害将重置
⚙️ 配置
配置文件会自动生成于:
config/persistentblockdamage-server.toml
示例:
[general]
# 伤害开始衰减前的秒数
blockDamagePersistenceSeconds = 10
# true = 平滑衰减
# false = 即时重置
smoothDecay = true
# 衰减步骤之间的刻数
# 20 ticks = 1 秒
decayIntervalTicks = 20
# 最大追踪的受损方块数量
maxTrackedBlocks = 10000
# 最大裂纹渲染距离
renderDistance = 64
?️ 命令(仅限 OP)
| Command |
Description |
/pdb |
显示当前的持续时间 |
/pdb 30 |
将持续时间设置为 30 秒 |
/pdb 60 |
将持续时间设置为 1 分钟 |
/persistentblockdamage |
显示模组完整信息 |
/persistentblockdamage time <seconds> |
更改持续时间 |
/persistentblockdamage smooth |
切换平滑衰减 |
示例:
/pdb 5
裂纹将在 5 秒后消失
/pdb 120
裂纹将持续 2 分钟
/pdb 300
最大持续时间(5 分钟)
? 安装
- 为 Minecraft 1.21.1 安装 NeoForge 21.1.233 或更高版本
- 下载
PersistentBlockDamage-x.x.x.jar
- 将文件放入你的
mods 文件夹
- 启动游戏或服务器
模组使用默认设置即可立即生效。
? 专用服务器支持
Persistent Block Damage 由服务器完全同步。
如果一个玩家在一个方块上留下了 50% 的进度:
- 其他玩家将看到裂纹
- 其他玩家可以继续挖掘它
- 进度会自动共享和同步
非常适合多人生存服务器。
? 要求
- Minecraft 1.21.1
- NeoForge 21.1.233+
- 专用服务器或单人游戏
- 无需额外模组
❓ 常见问题
这会减少打破方块所需的击打次数吗?
不会。
击打次数与原版 Minecraft 完全相同。该模组仅保留挖矿会话之间的进度。
它适用于所有工具吗?
是的。
挖掘速度使用当前装备的工具正常计算。
它会影响性能吗?
不会。
该系统经过优化,可以以极小的开销处理数千个受损方块。
它与其他挖矿模组兼容吗?
通常兼容。
Persistent Block Damage 仅扩展了 Minecraft 现有的方块伤害系统,并不修改工具、方块或挖掘机制。

? Persistent Block Damage 1.0.1 — 更新日志
? 基于材质的撞击音效
- 每种方块材质都有独特的挖掘声音:石头、金属、木头、沙子、泥土、玻璃,以及额外的特定工具声音(斧头砍木头,铲子挖沙)。
- 可自定义矿物声音,支持覆盖(
block|#tag = sound)。
- 可配置的声音时机(
soundIntervalTicks,4 = 原版节奏)。
? 水效
- 在水下挖掘或在眼睛和方块之间有水流时,会有溅射效果 + 声音。
✨ 撞击粒子
?️ HUD 伤害条(新增)
?️ 配置 GUI
- 可从模组菜单访问原生配置界面(不再仅依赖命令),包含 EN/ES 翻译。
?️ 新命令
| 命令 |
权限 |
功能 |
/pdb hud |
任意玩家 |
切换你自己的伤害条 |
/pdb hud on|off |
任意玩家 |
启用/禁用你的伤害条 |
/pdb hud global [on|off] |
管理员 |
为整个服务器设置伤害条 |
⚙️ 新配置文件 (persistentblockdamage-server.toml)
[feedback]
soundEnabled = true
soundIntervalTicks = 4
impactSoundOverrides = []
impactParticles = true
waterSplashEffects = true
[hud]
hudIndicator = false # 全局伤害条,默认禁用
(renderDistance 现在也限制声音/HUD 的同步范围。)
? 灵感来源
本模组受 Hytale 中展示的持久化挖掘系统启发,在保留原版平衡性的同时,为 Minecraft 带来更具沉浸感和宽容度的挖掘体验。
由 DeLaRosaPlay 制作

Persistent Block Damage - Hytale-Style Mining
Tired of block breaking progress resetting every time you stop mining?
Persistent Block Damage brings a Hytale-inspired mining system to Minecraft. Block damage remains visible and persists for a configurable amount of time, allowing you to continue mining exactly where you left off.

? What Does It Do?
When you mine a block, its cracks remain visible even after you stop mining. If you return before the configured timeout expires, you continue from the exact same progress.
The total number of hits required to break a block never changes. Vanilla balance is fully preserved.
Vanilla: ████████████ (12 consecutive hits or progress resets)
PBD: ██████ pause ██████ = 12 hits ✨
✨ Features
- Configurable persistent block damage (1–300 seconds)
- Visible cracks remain after mining stops
- Optional smooth decay system
- Instant reset mode available
- Fully multiplayer compatible
- Server-authoritative synchronization
- Real-time admin commands
- Optimized for large servers
- No additional dependencies required
- Dedicated server support
? How It Works
- Start mining a block
- The block accumulates damage and displays cracks
- Stop mining
- The cracks remain visible
- Return before the timeout expires
- Continue mining from the same progress
- If the timeout expires, the damage resets
⚙️ Configuration
The configuration file is automatically generated at:
config/persistentblockdamage-server.toml
Example:
[general]
# Seconds before damage begins to decay
blockDamagePersistenceSeconds = 10
# true = smooth decay
# false = instant reset
smoothDecay = true
# Ticks between decay steps
# 20 ticks = 1 second
decayIntervalTicks = 20
# Maximum tracked damaged blocks
maxTrackedBlocks = 10000
# Maximum crack render distance
renderDistance = 64
?️ Commands (OP Only)
| Command |
Description |
/pdb |
Displays the current persistence time |
/pdb 30 |
Sets persistence to 30 seconds |
/pdb 60 |
Sets persistence to 1 minute |
/persistentblockdamage |
Displays full mod information |
/persistentblockdamage time <seconds> |
Changes persistence time |
/persistentblockdamage smooth |
Toggles smooth decay |
Examples:
/pdb 5
Cracks disappear after 5 seconds
/pdb 120
Cracks remain for 2 minutes
/pdb 300
Maximum persistence time (5 minutes)
? Installation
- Install NeoForge 21.1.233 or newer for Minecraft 1.21.1
- Download
PersistentBlockDamage-x.x.x.jar
- Place the file inside your
mods folder
- Launch the game or server
The mod works immediately with default settings.
? Dedicated Server Support
Persistent Block Damage is fully synchronized by the server.
If one player leaves a block at 50% progress:
- Other players will see the cracks
- Other players can continue mining it
- Progress is shared and synchronized automatically
Perfect for multiplayer survival servers.
? Requirements
- Minecraft 1.21.1
- NeoForge 21.1.233+
- Dedicated Server or Singleplayer
- No additional mods required
❓ Frequently Asked Questions
Does this reduce the number of hits required to break blocks?
No.
The number of hits remains exactly the same as vanilla Minecraft. The mod only preserves progress between mining sessions.
Does it work with all tools?
Yes.
Mining speed is calculated normally using the currently equipped tool.
Does it affect performance?
No.
The system is optimized to handle thousands of damaged blocks with minimal overhead.
Is it compatible with other mining mods?
Generally yes.
Persistent Block Damage only extends Minecraft's existing block damage system and does not modify tools, blocks, or mining mechanics.

? Persistent Block Damage 1.0.1 — What's New
? Material-Based Impact Sounds
- Each block material has a distinct mining sound: stone, metal, wood, sand, dirt, glass, plus an extra tool-specific sound (axe on wood, shovel on sand).
- Customizable mineral sounds with overrides (
block|#tag = sound).
- Configurable sound timing (
soundIntervalTicks, 4 = vanilla cadence).
? Water Effects
- Splash effect + sound when mining underwater or when water is between your eyes and the block.
✨ Impact Particles
- A burst of block particles occurs each time the crack stage advances.
?️ HUD Damage Bar (New)
?️ Configuration GUI
- Native config screen available from the Mods menu (no longer commands only), with EN/ES translations.
?️ New Commands
| Command |
Who |
Function |
/pdb hud |
Anyone |
Toggle your damage bar |
/pdb hud on|off |
Anyone |
Enable/disable your damage bar |
/pdb hud global [on|off] |
Admin |
Damage bar for the entire server |
⚙️ New Config (persistentblockdamage-server.toml)
[feedback]
soundEnabled = true
soundIntervalTicks = 4
impactSoundOverrides = []
impactParticles = true
waterSplashEffects = true
[hud]
hudIndicator = false # GLOBAL bar, disabled by default
(renderDistance now also limits sound/HUD synchronization.)
? Inspiration
This mod is inspired by the persistent mining system showcased in Hytale, bringing a more immersive and forgiving mining experience to Minecraft while preserving vanilla balance.
Created by DeLaRosaPlay
评论 0
登录后参与评分
还没有评论,来抢沙发吧