模组说明
Block Change Tracker 是一款适用于 Minecraft 1.20.1 的 Forge 模组。它帮助你在指定的立方体区域内追踪方块破坏或放置事件,并将统计数据实时记录到原版计分板中。无论是玩家手动挖掘、TNT 爆炸、火焰燃烧还是其他实体引起的方块变化,均可被准确追踪(支持可配置的方块白名单过滤)。区域配置保存在世界存档中,因此重新加载游戏后无需重新配置。
主要功能
区域追踪:通过命令定义一个立方体区域,并选择追踪方块破坏或放置事件。
多种破坏来源覆盖:实时检测玩家破坏/放置方块的行为,并通过定期扫描捕获由爆炸、火焰、凋灵以及其他非玩家直接操作引起的方块变化。
计分板集成:统计数据将记录在虚拟玩家 #blockchange 下的指定原版计分板中。
白名单过滤:配置排除追踪的方块(默认忽略火焰和灵魂之火,以防止因自然熄灭导致的误统计)。
暂停/恢复:暂停或恢复所有区域或特定区域的追踪,便于分阶段观察。
区域命名:创建区域时可分配自定义名称,以便后续管理(暂停/恢复特定区域)。
持久化:区域、暂停状态和计分板名称均保存至世界存档,并在重启后自动恢复。
多维支持:每个维度(主世界、下界、末地)都维护自己独立的追踪区域列表。
如需自定义白名单,请编辑配置文件 config/blockchangetracker-common.toml(首次启动后生成)。
命令教程
所有命令均以 /blockchange 为前缀,且需要足够的权限(默认为管理员权限;单人模式下可直接使用)。
- 创建追踪区域
基本语法(不含区域名称):
/blockchange <scoreboardName> <x1> <y1> <z1> <x2> <y2> <z2> <break|place> [regionName]
参数说明:
<scoreboardName>:用于记录统计数据的计分板。如果不存在则会自动创建(类型为 dummy)。
<x1> <y1> <z1> & <x2> <y2> <z2>:定义立方体区域的两个角坐标。顺序无关紧要;模组会自动计算最小/最大坐标。
<break|place>:追踪模式。break 统计方块破坏事件,place 统计方块放置事件。
[regionName](可选):为区域分配唯一名称,以便后续进行暂停/恢复操作。如果省略,该区域没有名称,但仍可通过计分板名称进行管理。
示例:
/blockchange myboard 10 60 10 20 70 20 break
/blockchange myboard 10 60 10 20 70 20 place spawn_area
注意:
如果你使用已存在的区域名称创建一个新区域,同名旧区域将被移除,新区域生效。
如果省略区域名称但你使用已存在的计分板名称创建区域,绑定到该计分板名称的旧区域将被替换(以避免重复计数)。
可以创建多个区域;即使它们共享同一个计分板,分数也会累加。
Mod Description
Block Change Tracker is a Forge mod for Minecraft 1.20.1. It helps you track block break or place events within a specified cuboid area and records statistics to the vanilla scoreboard in real time. Whether blocks are broken by players mining manually, TNT explosions, fire burning, or other entity-caused block changes, all can be accurately tracked (configurable block whitelist filtering is supported). Region configurations are saved within the world save, so no reconfiguration is needed after reloading the game.
Key Features
Region Tracking: Define a cuboid region via commands and choose to track either block break or place events.
Multiple Destruction Source Coverage: Real-time detection of player block breaking/placing, plus periodic scanning to capture block changes caused by explosions, fire, the Wither, and other non-player direct actions.
Scoreboard Integration: Statistics are recorded to a designated vanilla scoreboard under the virtual player #blockchange.
Whitelist Filtering: Configure blocks to exclude from tracking (flame and soul fire are ignored by default to prevent miscounting from natural extinguishing).
Pause / Resume: Pause or resume tracking for all regions or a specific region, convenient for stage-by-stage observation.
Region Naming: Assign a custom name when creating a region for easier subsequent management (pausing/resuming a specific region).
Persistence: Regions, pause states, and scoreboard names are saved to the world save and automatically restored after restart.
Multi-dimension Support: Each dimension (Overworld, Nether, End) maintains its own independent tracking region list.
To customize the whitelist, edit the configuration file config/blockchangetracker-common.toml (generated after the first launch).
Command Tutorial
All commands use the /blockchange prefix and require sufficient permissions (admin permissions by default; directly usable in single-player mode).
- Create a Tracking Region
Basic syntax (without region name):
/blockchange <scoreboardName> <x1> <y1> <z1> <x2> <y2> <z2> <break|place> [regionName]
Parameter description:
<scoreboardName>: The scoreboard used to record statistics. It will be created automatically if it does not exist (type: dummy).
<x1> <y1> <z1> & <x2> <y2> <z2>: Two corner coordinates defining the cuboid region. Order does not matter; the mod automatically calculates the minimum/maximum coordinates.
<break|place>: Tracking mode. break counts block destruction events, place counts block placement events.
[regionName] (optional): Assign a unique name to the region for subsequent pause/resume operations. If omitted, the region has no name but can still be managed via the scoreboard name.
Examples:
/blockchange myboard 10 60 10 20 70 20 break
/blockchange myboard 10 60 10 20 70 20 place spawn_area
Notes:
If you create a region with an existing region name, the old region with the same name will be removed and the new one takes effect.
If the region name is omitted but you create a region with an existing scoreboard name, the old region bound to that scoreboard name will be replaced (to avoid duplicate counting).
Multiple regions can be created; even if they share the same scoreboard, scores will be accumulated.
评论 0
登录后参与评分
还没有评论,来抢沙发吧