死亡回归

死亡回归

当你死亡时,整个世界会回滚到你上一个检查点。你的玩家数据是否保留取决于你的设置。

杂项

死亡回溯会在你死亡时回滚你的世界。

它不会让你重生,而是将整个世界退回到你上一个检查点:地形、方块、箱子、生物——一切都恢复到创建检查点时的确切状态。你会以满生命值重新出现在检查点位置。

这是一次完整的存档回滚,而不是对重生机制的微调。
仅限单人游戏。


!! 警告 !!

此模组在回滚期间会替换你的世界存档文件夹。
你在检查点之后建造或更改的任何内容都将丢失。
首次使用前请备份你的世界。


!! 仅限单人游戏 !!

此模组专为单人游戏设计。

不支持多人游戏(局域网世界和专用服务器)。
回滚依赖于游戏停止其内部服务器,而这仅在单人游戏中
会自动发生。


===== 存档工作原理 =====

检查点何时创建?

三种自动触发方式:

  • 睡觉(SLEEP)
      当你在床上睡觉时触发。

  • 游戏天数(DAYS)
      每 N 个游戏日按概率触发。
      默认:每 10 个游戏日,50% 概率。
      换句话说,并非每 10 天都会创建检查点——而是像抛硬币一样。

  • 首次加入(INITIAL)
      当你首次进入一个尚无检查点的世界时,会立即创建一个,因此你始终有可回滚的目标。

通过以下命令选择启用哪些触发方式:

  /regression config saveMode SLEEP|DAYS|MIXED

  SLEEP   仅睡觉
  DAYS    仅游戏天数
  MIXED   两者(默认)

还存在两种手动方式:

  /regression save                                 立即创建检查点
  /regression config manualSaveItem <物品 ID>      手持该物品时右键点击


可以多频繁地保存?(冷却)

自动检查点有最小间隔,以免堆积。

  默认:100 分钟(现实时间)。

冷却期间,睡觉或达到天数间隔不会发生任何事;你会收到一条“冷却中,剩余 X”的提示。

通过以下命令更改:

  /regression config saveCooldownMinutes 1~1440


保留多少个检查点?

默认:每个世界 3 个。

  saves/regression_backups/<world>/backup_0
  saves/regression_backups/<world>/backup_1
  saves/regression_backups/<world>/backup_2

所有槽位用完后,下一个检查点会覆盖最旧的检查点,从 backup_0 开始循环。可以将其视为一个始终保存最近 N 个检查点的环形缓冲区。

通过以下命令更改:

  /regression config maxBackups 1~20

重要:回滚使用时间戳最新的检查点,而不是槽位编号最大的那个。


其他限制

  • 需要满生命值(requireFullHealth,默认开启)
      玩家必须处于满生命值才能触发自动检查点。受伤时睡觉不会创建检查点。

  • 维度黑名单(blacklistedDimensions,默认为空)
      此处列出的维度不会创建检查点,在其中死亡也不会触发回滚。例如,添加 minecraft:the_nether 会使下界不受影响。

  • 世界标识
      每个检查点会记录它所属的世界。如果你删除一个世界并创建同名的新世界,旧检查点会被自动清理,而不会被误用。


检查点中存储了什么?

世界文件夹的完整副本:

  region/.mca      地形和方块
  entities/
.mca    生物和掉落物
  playerdata/       玩家数据
  level.dat         世界元数据
  DIM-1/ DIM1/      下界和末地

因此回滚会倒回整个世界,而不仅仅是你的位置。


创建检查点时会发生什么

  1. 服务器完全保存世界
  2. 等待区块写入稳定(避免复制写了一半的文件)
  3. 整个世界文件夹被复制到备份目录
  4. 验证区块文件,如不完整则重新复制
  5. 删除超出限制的检查点


回滚时会发生什么

  1. 你死亡,回滚开始
  2. 服务器停止并断开你的连接
  3. 世界文件夹被替换为最新的检查点
  4. 根据你的设置合并玩家数据
  5. 客户端自动重新连接

无需手动操作,但你会在几秒内被踢出并重新加入。


===== 玩家数据(默认关闭) =====

默认情况下,模组只回滚世界,不保留任何玩家数据:

  你死亡 -> 世界回到检查点 -> 你随之返回
  你的物品栏变为检查点时的状态
  你在检查点之后拾取、合成或购买的任何东西都会消失

这与手动加载存档完全相同,是默认行为。


开启它

  /regression config keepPlayerData true

现在行为会改变:

  世界仍会回滚到检查点
  但你的物品栏和玩家数据会保留你死亡那一刻的状态
  你在检查点之后获得的物品会在回滚后保留

注意区别:它保留的是你死亡时的状态,而不是检查点时的状态。
你死亡时物品栏里有五颗钻石,回滚后就有五颗钻石。
你死亡时物品栏是空的,回滚后就是空的。


选择保留哪些类别

在主开关开启的情况下,每个类别可以单独切换(默认全部开启):

  inventory(物品栏)
  armor(头盔、胸甲、护腿、靴子 + 副手)
  ender chest(末影箱)
  XP(等级、进度、总量、附魔种子)
  hunger(饥饿值)
  potion effects(药水效果,包括负面效果)
  absorption(金苹果生命值)
  air(水下剩余呼吸值)
  scoreboard score(计分板分数)
  respawn point(床 / 重生锚)
  mod data(饰品、技能树等)

示例:

  仅末影箱  -> 只保留 keepEnderChest
  仅物品栏    -> 只保留 keepInventory
  仅饰品      -> 只保留 keepModData
  全部        -> 只需启用主开关


始终取自检查点(不可配置)

  position(位置)
  health(生命值)
  fire ticks(着火时间)
  fall distance(下落距离)
  death state(死亡状态)


游戏内菜单

  /regression config playerdata

打开一个可点击的列表,每一项都有 [开启] / [关闭] 按钮。
点击切换;无需命令。


===== 命令 =====

查看

  /regression config                     显示此世界的所有设置
  /regression config playerdata          可点击菜单
  /regression config <option>            显示单个选项,例如 keepInventory

更改

  /regression config <option> true|false
    例如 /regression config keepEnderChest true

玩家数据选项

  keepPlayerData     主开关
  keepInventory      物品栏(36 格)
  keepArmor          护甲 + 副手
  keepEnderChest     末影箱
  keepXp             经验
  keepHunger         饥饿值
  keepEffects        药水效果
  keepAbsorption     吸收
  keepAir            空气
  keepScore          计分板分数
  keepSpawnPoint     重生点
  keepModData        模组数据

保存

  /regression save                                    立即创建检查点
  /regression config backups                          列出已有检查点
  /regression config saveMode SLEEP|DAYS|MIXED        保存触发方式
  /regression config saveCooldownMinutes 11440       冷却时间(分钟)
  /regression config daysInterval 1365               天数间隔
  /regression config daysProbability 0.01.0          天数保存的概率
  /regression config maxBackups 120                  保留的检查点数
  /regression config manualSaveItem <物品 ID|none>    用于创建检查点的物品
  /regression config blacklistedDimensions add <dim>      添加到黑名单
  /regression config blacklistedDimensions remove <dim>   从黑名单移除
  /regression config blacklistedDimensions clear          清空黑名单

其他

  /regression stats                                   统计信息
  /regression reload                                  重新加载配置
  /regression config deathRegression true|false       模组主开关
  /regression config requireFullHealth true|false     保存需要满生命值
  /regression config easterEgg true|false             聊天彩蛋


===== 配置 =====

每项设置按世界存储:

  saves/<world>/serverconfig/regressionmod-server.toml

在一个世界中更改设置不会影响另一个。所有选项均可在游戏内更改并立即生效。


===== 默认值 =====

  死亡回溯主开关   开启
  保留玩家数据                 关闭
  inventory / armor / ender chest / XP   开启
  hunger / effects / absorption / air / score   开启
  重生点                    关闭
  模组数据                         关闭
  保存模式                    MIXED
  保存冷却                    100 分钟
  天数间隔 / 概率            10 个游戏日 / 50%
  需要满生命值              是
  最大检查点数                  3
  聊天彩蛋                    开启

注意:类别开关默认为开启,但主开关为关闭,因此开箱即用时不会保留任何东西——与加载存档完全相同。


===== 权限 =====

所有 /regression 命令需要权限等级 2(管理员)。
在单人游戏中,创建世界时启用作弊。


===== 已知问题 =====

  • 创建新世界时,首个备份可能有一些区块文件无法通过完整性检查。受影响区域在回滚后可能显示为未生成。玩家数据不受影响。
    - 仅限单人游戏。不支持多人游戏。
    - 需要 Minecraft 1.20.1 和 Forge。


===== 许可证 =====

MIT