Registry Dumper 3000

Registry Dumper 3000

Registry Dumper 3000 是一款面向整合包制作者、数据包创作者和模组开发者的开发/调试工具模组。

它会以结构化格式将 Minecraft 注册表、标签、配方和资源文件夹导出到磁盘，让你准确查看游戏/服务器中实际加载的内容。

以下情况尤其适用：

• 整合包调试
• 数据包故障排查
• 调查标签/配方冲突
• 检查不同模组中的注册表
• 逆向分析数据驱动内容
• 检查资源包合并后实际加载的资源

---

导出内容

内置注册表

导出 所有内置注册表（不只是方块/物品/流体），来源为 BuiltInRegistries.REGISTRY。

• 输出格式：TXT 或 JSON（可配置）
• 可选显示条目的类名（非常适合模组调试）

运行时注册表

从服务器的 RegistryAccess 导出 所有运行时注册表。

其中包括模组添加或运行时加载的注册表，可呈现服务器所见的最终状态。

原始标签 JSON

直接从资源管理器导出原始标签 JSON 文件（data/*/tags/...）。

• 根据推断出的注册表类型对文件进行归类
• 支持模组自定义标签类型
• 可保留原始 JSON 格式，或进行美化排版（可配置）

展开后的运行时标签

从 Registry#getTags() 导出 合并后的最终标签内容。

这样你就能查看应用所有模组、数据包和资源层后，标签实际解析出的内容。

• 输出格式：TXT 或 JSON（可配置）

原始配方 JSON

从 data/*/recipes/... 导出原始配方 JSON 文件。

• 按解析出的配方 type 对配方分组
• 安全处理未知配方类型和无效 JSON
• 可选美化排版

通用数据包资源文件夹（基于规则）

可通过配置将任意数据包文件夹导出为原始副本，并内置了大量默认规则。

默认涵盖的示例：

• loot_tables
• predicates
• item_modifiers
• advancements
• functions
• worldgen/*（生物群系、特征、结构、模板池、处理器、噪声、密度函数、预设等）
• dimension
• dimension_type
• damage_type
• chat_type
• trim_material
• trim_pattern
• painting_variant
• instrument
• jukebox_song
• Forge / NeoForge 的额外内容，例如战利品修改器/生物群系修改器/结构修改器

未知顶层文件夹兜底导出（可选）

还可以导出那些未被已配置规则明确涵盖的顶层数据文件夹。

这有助于发现你可能遗漏的隐藏资源目录或模组添加的资源目录。

客户端资源文件夹（可选）

可选在客户端启动时导出客户端资源（默认禁用，因为导出内容可能非常庞大）。

示例：

• lang
• models
• blockstates
• textures
• sounds
• font
• shaders
• post_effect
• particles
• atlases

---

这款模组的用途

调试模组化 Minecraft 时，难点通常不在于“应该加载什么”，而在于“一切合并完成后，实际加载了什么？”

Registry Dumper 3000 可通过导出以下内容帮你找到答案：

• 最终注册表
• 最终展开后的标签
• 原始源 JSON 文件
• 原始资源文件夹
• 包含计数信息的结构化摘要

它专为检查和故障排查而设计，不提供游戏玩法功能。

---

输出位置

默认情况下，转储文件会写入：

• <game folder>/dump/

文件夹结构可在模组配置中调整。

生成的根目录示例（默认名称）：

• dump/registry_builtin
• dump/registry_runtime
• dump/tags
• dump/registry_tags_expanded
• dump/recipes
• dump/data_raw
• dump/assets_raw

模组还会为主要转储部分生成摘要文件（_summary.txt）。

---

配置

系统会自动在以下位置创建详细的 JSON 配置文件：

• <game folder>/config/registry_dumper_3000.json

你可以通过配置控制：

• 启用哪些转储部分
• 受支持的转储使用 TXT 还是 JSON 格式
• 原始 JSON 副本是否采用美化格式
• 是否每个会话仅运行一次
• 客户端/服务器端触发条件
• 基于规则转储资源文件夹
• 对未知文件夹的兜底处理
• 是否转储可选资源
• 是否生成摘要/报告
• 是否转储可选资源栈（高级）

---

性能/大小说明

根据整合包和配置不同，此模组可能会生成大量文件。

请注意：

• 启用资源转储可能会生成非常多的文件
• 启用未知文件夹兜底处理会大幅增加输出文件大小
• 美化 JSON 格式会增加 CPU 开销和文件大小
• 启用可选资源栈转储可能会使文件数量成倍增加

如果你只需要特定数据，请关闭不需要的部分。

---

适用人群

此模组非常适合：

• 整合包开发者
• 数据包开发者
• 模组开发者
• 服务器整合包维护者
• 调试数据驱动内容的技术型玩家

如果你只是想体验游戏内容，这个模组可能不适合你。

---

兼容性说明

• 使用类似 Architectury 的生命周期钩子构建
• 部分功能使用反射以确保兼容性（平台信息/客户端资源管理器/可选资源栈 API）
• 此模组定位为实用工具和调试工具，输出量可能因加载器/版本/整合包内容而异

---

快速开始

1. 安装模组并启动游戏/服务器。
2. 等待系统生成配置文件。
3. 编辑 config/registry_dumper_3000.json，启用或禁用所需功能。
4. 重启后查看 dump/ 文件夹。
5. 通过生成的 _summary.txt 文件快速查看已导出的内容。

---

整合包作者须知

此模组非常适合用于诊断以下问题：

• 标签内容与预期不符
• 配方覆盖未生效
• 数据包资源路径错误
• 出现意料之外的模组注册表条目
• 数据驱动功能生成问题（世界生成文件夹）

它还可以帮助你编写自动化脚本，检查转储结果以进行整合包质量保证。