资源数据包加载器

官方 MCT Discord 服务器请点击此处。

资源受代码仓库中 LICENSE_ASSETS.txt 条款的保护。

MCT 资源数据包加载器

一个全局文件夹，可覆盖 Minecraft 与模组提供的内容，通过 JSON 定义新内容，并控制世界生成——适用于每个世界、客户端和服务器。

Minecraft 1.12.2 没有数据包系统，而资源加载器仅覆盖客户端资源。进度、战利品表、配方和函数无法在不重新打包模组 JAR 或将文件复制到每个存档的情况下进行覆盖。添加一种矿石或一种生物群系就需要编写模组。此模组通过一个文件夹即可涵盖所有功能。

使用方法

将散装文件或压缩包放入与 mods 和 config 同级的 rdploader 文件夹中。

rdploader/assets/<命名空间>/...
rdploader/<包名>.zip

覆盖路径与模组 JAR 内的布局一致，因此文件可以直接复制。内容通过在对应文件夹中添加 JSON 文件来定义——路径即标识，因此 assets/mypack/blocks/ruby_ore.json 会注册 mypack:ruby_ore。

请参阅 HOWTO.md 获取完整文件夹列表、所有方块和物品类型、所有世界生成形状、包优先级、资源包优先级以及命令。

覆盖已有内容

• 模组 assets 文件夹中的纹理、模型、方块状态、语言文件、音效及其他一切内容
• 进度和战利品表，适用于专用服务器和单人游戏
• 配方，可替换或添加，并可按名称、命名空间或输出删除配方
• 战利品注入，即向现有表格添加一个池，而非替换整个表格
• 结构模板（.nbt）
• 函数（.mcfunction），原版仅按世界读取这些文件
• 注册表重命名，确保模组重命名方块或物品之前保存的世界能够保留这些内容
• 矿物词典名称、熔炉配方、燃料燃烧时间、创造模式标签页和声音事件

定义新内容

支持各种常见形状的方块——基础、矿石、下落、台阶、楼梯、栅栏、墙、窗格、门、梯子、火把、原木、树叶、树苗、作物、花、甘蔗、藤蔓和传送门。物品包括基础、食物、饮品、工具、盔甲、种子、药水和药水瓶。此外还有流体、工具和盔甲材料、药水效果、药水类型、酿造配方、带交易的村民职业、游戏规则、生物群系、村庄布局、实体变种和完整维度。

树苗可长成由你自己的原木和树叶构成的树木，或长成你的结构模板之一。树叶可着色并掉落你的树苗。传送门方块可连接两个维度，记住建造者，并在爆炸中幸存。维度可自定义天空、雾和云的颜色，或完全关闭天空、云或天气。

实体变种是一种基于已有实体（原版或模组）构建的新实体——拥有自己的注册名、名称、刷怪蛋、战利品表和皮肤，并具有独立的生命值、伤害、速度、跳跃、尺寸、效果、装备和性情。一只攻击时膨胀的兔子、一个会交易的僵尸、一头无视火焰的牛：这一切都只需一个文件，而其所基于的实体则保持原样。

注册以最低优先级进行，因此真正的模组始终优先。任何需要方块实体、GUI、物品栏或逐刻逻辑的功能仍需真正的模组支持。

世界生成

世界生成由形状和分布组成。形状涵盖矿石团簇、长条蜿蜒矿脉、扁平矿层、中空晶洞、碗状结构、锥形尖塔、粗糙结核、狭窄喷口、地表装饰、整棵树木、藤蔓、跨越多个区块的带状矿区，以及你自己的 .nbt 模板。分布方式可均匀放置、偏向某一高度、分形蔓延、沿地形起伏、生成于洞穴地面和顶部，或水下。

每个条目均可按高度、尝试次数、目标方块、维度、生物群系、温度、降雨量和距出生点的距离进行过滤，并可生成到已经存在的区块中。

控制生成内容

• 按模组或矿石类型阻止矿物生成，两种方向均可
• 按模组或名称阻止生物群系，两种方向均可，并在生成的生物群系地图上替换不需要的群系，以便也能到达海洋、恶地和丘陵变种
• 完全阻止其他模组的世界生成器，或按生成内容（矿石、结构、植物、湖泊或地形）进行阻止——这是模组添加 Forge 事件无法捕捉内容的方式
• 抑制原版结构，或设置其生成间距、允许的群系、距出生点的最小距离、生成的生物以及刷怪笼中的生物
• 按生物群系设置生物生成率和上限
• 从已存在的区块中替换方块，以便清理泄漏到世界中的矿石
• 按模组阻止合成和熔炉配方，同时 CraftTweaker 和 GroovyScript 的添加内容始终有效
• 压平基岩层，按维度或群系，适用于新区块或已存在区块
• 塑造主世界本身——海平面、熔岩海洋和地形噪声——在世界创建时生效，因此已存在的世界不受影响
• 将主世界生成带有平台的虚空，如果所有生物群系都被阻止，也会自动发生

世界模板可将这些设置汇总到一个文件中，使整合包一次定义整个世界的形状。每个分组都响应一个配置开关，可将其留给整合包决定、强制使用配置自身的值，或完全关闭该分组，使任何整合包都无法启用。

CoFH World

需要 CoFH World 的模组可在其缺失时正常加载。它们的生成文件可直接从其 JAR 中读取，并通过此模组进行生成，涵盖所有可产出任何内容的 CoFH 生成器和分布方式。此功能默认关闭，并在安装了真正的 CoFH World 时退出，届时后者会正常生成——将这些文件转换到整合包中是推荐方式，也是改变其生成内容的唯一途径。

注意事项

名称以 RDPLO 开头的整合包始终覆盖玩家选择的资源包；以 RDPLN 开头的则从不覆盖；其他所有情况遵循 overrideResourcePacks 配置。

/rdpl unused 列出整合包中未被请求的文件，这通常是路径拼写错误。/rdpl biome 和 /rdpl oregen 报告生成内容以及被阻止的内容。

模组自身的报告输出到 logs/rdpl.log 而非主日志。

报告问题

报告错误时，请附上 logs/latest.log 和 logs/rdpl.log，以及你的模组和 Forge 版本。

帮助翻译模组

欢迎翻译模组并通过拉取请求提交。

关于整合包与许可

资源数据包加载器根据 GNU 通用公共许可证第三版（GPLv3）授权。只要遵守条款，你可以在整合包、评测或其他任何形式中使用它。