注册表快照

📸 注册表快照

注册表快照是一款适用于 NeoForge 26.2 的轻量级开发者工具，可让你轻松查看 Minecraft 注册表在不同版本之间发生的具体变化。

保存注册表状态，对模组进行修改，然后将其与当前游戏状态进行比较，即可立即找出新增或移除的条目。

✨ 功能特性

• 📦 将确定性的注册表快照保存为 JSON 格式
• 🔍 将保存的快照与其他快照或当前运行时状态进行比较
• ➕ 清晰显示新增的注册表条目
• ➖ 清晰显示移除的注册表条目
• 🧠 自动为当前会话创建内存中的启动基线
• 🧩 支持 NeoForge 自定义注册表
• ⚙️ 通过配置包含或排除自定义注册表
• 📄 导出并检查已保存的快照信息
• 🗑️ 安全删除快照，包括损坏的文件
• 🛡️ 妥善处理损坏或不受支持的快照，不会导致游戏崩溃
• 📊 内置基准测试命令，用于测试捕获、序列化、解析和差异比较的性能
• 💾 不会自动生成快照 —— 持久化快照仅在你明确请求时才会创建
• 🔒 设计上为只读 —— 注册表快照绝不会修改你的注册表

🧪 非常适合模组开发

在以下场景中，注册表快照非常实用：

• 添加或移除方块、物品、流体、实体、菜单或其他已注册的内容
• 在不同版本之间重命名注册表 ID
• 调试缺失或意外的注册项
• 比较模组的两个版本
• 验证注册更改是否真正到达了运行时注册表
• 检查大型整合包，无需手动搜索成千上万的注册表条目

⌨️ 命令

/regsnap
显示当前注册表概览。

/regsnap save <name>
将当前注册表状态保存为确定性的 JSON 快照。

/regsnap list
列出所有已保存的快照。

/regsnap list open
在支持的本地系统上打开快照文件夹。

/regsnap diff <old> <new|current>
比较两个快照，或将保存的快照与当前注册表状态进行比较。

/regsnap diff startup current
将当前注册表状态与内存中的启动基线进行比较。

/regsnap export <name>
验证快照并显示其 JSON 位置和摘要。

/regsnap delete <name>
删除已保存的快照。

/regsnap benchmark
运行内存中的性能和确定性基准测试，不会写入任何文件。

📁 快照格式

快照使用带版本号的确定性 JSON 格式。注册表 ID 及其条目按稳定顺序存储，使快照适用于在不同版本之间进行可靠的比较。

差异比较示例：

注册表差异 • before_update → current

minecraft:item
+ examplemod:new_machine
+ examplemod:new_component
- examplemod:old_machine

minecraft:fluid
+ examplemod:coolant

摘要：+3 -1

⚡ 轻量级设计

注册表快照不会持续扫描注册表、修改游戏数据或在后台写入文件。

持久化快照仅通过显式命令创建，而会话启动基线则保留在内存中。

🔧 平台

• Minecraft 26.2
• NeoForge
• Java 25
• 客户端 + 服务端

注册表快照完全独立，不需要其他 Kiyoshibara 开发者工具。

💡 保存它。修改它。比较它。