官方 MCT Discord 服务器 在此。
资源文件受 LICENSE_ASSETS 中的条款保护。
1.12.2 第三方声明
Resource Data Pack Loader
不仅仅是一个资源和数据包加载器,尽管它在这方面做得非常出色。现在,你可以掌控整个沙盒。
本应存在的 API。
Minecraft 直到变得有趣之前都是数据驱动的。数据包可以改变配方,但它无法添加方块、物品或流体,无法重塑世界,并且只能存在于单个世界的存档中。越过这条界线后,你需要编写模组,每个版本和每个加载器各一次。
这个模组将这条界线彻底推远。方块、物品、生物、维度、城市、规则、奖励以及完整的游戏模式都是 JSON 文件。一个文件夹适用于所有世界,无论是客户端还是专用服务器,并且只需编写一次即可在 Minecraft 1.12.2、1.20.1、1.21.1 和 26.x 上加载。你不再是在别人的游戏中添加内容:而是在设计你自己的游戏。
以下内容仅适用于某些版本的部分信息以这些版本开头。
无需 Java 的新矿石
rdploader/data/mypack/blocks/ore.json (1.20.1 / 1.21.1 / 26.x)
{
"type": "ore",
"material": "rock",
"harvestTool": "pickaxe",
"variants": {
"ruby_ore": { "hardness": 3.0 }
}
}
这将注册 mypack:ruby_ore。添加纹理和方块状态、模型、战利品表和标签,系统会自动为你生成。在 1.12.2 中,相同的方块是 rdploader/assets/mypack/blocks/ruby_ore.json。
为什么存在
- 内容是文件。 方块、物品、流体、实体变体和维度都在 JSON 中定义,而原版和加载器要求的是模组。
- 一个整合包,每个版本。 1.20.1、1.21.1 和 26.x 构建读取相同的整合包,为 1.12.2 编写的整合包可以在它们上面加载,反之亦然,首次加载时进行一次转换。
- 一个文件夹,每个世界。 数据包存在于单个世界的存档中,资源包由玩家选择启用。
rdploader 在所有地方都适用,无论是在单人模式还是专用服务器上,玩家无需进行任何启用操作。
1.12.2: 完全没有数据包。进度、战利品表和功能存在于每个世界的存档中,配方仅从模组 JAR 文件中加载。这个模组是该版本从未拥有过的数据包系统。
整合包能做什么
此处所有内容仅在服务器上运行,玩家可以使用纯原版客户端加入,除了标记为 RDPL 客户端 的内容:这需要每个玩家的客户端上都安装模组和整合包。参见 欢迎原版客户端。
自定义原版和你运行的任何模组
你的整合包优先级高于任何 JAR 文件。已安装的任何内容都不受限,且永远不会触碰任何 JAR 文件。
- 替换任何配方、战利品表、进度、功能或结构模板,原版的或任何模组的
- 1.12.2: 仅限合成炉和熔炉配方;模组的机器配方存在于其代码中,CraftTweaker 或 GroovyScript 是更好的选择
- 替换任何纹理、模型、语言文件或声音(RDPL 客户端)
- 属性覆盖:硬度、光照、挖掘工具和等级、堆叠数量、耐久度、食物值等对任何现有方块、物品或药水生效,使用
/rdpl reload 即可(RDPL 客户端)
- 方块掉落:在不替换其战利品表的情况下为任何方块添加掉落物和经验值
- 禁用的方块和物品:将任何方块或物品从游戏中移除,从标签页、JEI、战利品、交易和所有库存中消失
- 实体变体:基于任何模组的生物构建的新生物,保留其 AI 和你的皮肤、属性、掉落物和名称(RDPL 客户端)
- 生物等级:任何生物生成时的随机等级,具有自己的生命值、伤害、效果和战利品
- 语言门控:玩家可以选择的替代名称(RDPL 客户端)
- 注册表重命名:当模组重命名其方块时,旧世界仍能正常加载
- 选择其他模组添加的矿石、生物群系、结构、生成点和配方,并重塑其余部分
重制现有维度
主世界、下界、末地以及任何其他模组添加的维度都可以由你重新设计,不仅限于你自己创建的维度。参见 现有维度。
- 拥有你自己的太阳、月亮、行星和星星的新天空,或无尽的雨(RDPL 客户端)
- 在每个尚未探索的区块中生成新的地形和结构
- 传送门:锁定任意维度(包括下界和末地),直到玩家获得进度、制作或持有正确的物品、支付物品价格、击杀 Boss 或达到团队分数,支持按玩家、按团队或全服设置
- 每个维度(原版或模组添加)的游戏规则
- 固定于精确坐标的结构,以及逆向生成:为已探索的区块添加新的世界生成内容
- 防爆石膏集成:爆炸可以自我修复、掉落其破坏的方块或留下干净的弹坑,适用于任意维度和任意模组
添加内容
- 方块(所有常见形状)、矿石、箱子和容器(最多九行十二列)、钟以及传送门方块(RDPL 客户端)
- 物品、工具、盔甲、食物、流体、创造模式标签页和可穿戴物品(Baubles 或 Curios)(RDPL 客户端)
- 药水和村民职业(RDPL 客户端)
- 附魔(1.12.2 和 1.20.1 版本的 RDPL 客户端)
- 酿造配方和村民交易
- 生物群系、洞穴区域和完整的维度(1.12.2 版本的 RDPL 客户端)
生成世界
- 矿石、矿脉、晶洞、树木和你自己的结构模板,可根据高度、生物群系、维度以及与出生点的距离进行过滤
- 深层世界:延伸至原版地表以下数百格,抬高的天花板和漂浮的天空岛屿
- 虚空世界、自定义海平面和地形形状、重力以及堆叠维度
- 结构地图:突破原版 48 格模板限制,构建更远的结构
- 村庄和城市:随机生成的街道、广场、桥梁、铁路、地铁、下水道和路灯,由手绘城市地图绘制,或无限延伸的城市永不终止
- 世界创建时的预生成,确保游玩时无人等待区块加载
- 1.12.2: 扩展世界,突破 256 格高度限制,向上和向下延伸(RDPL 客户端)
控制沙盒
- 一个覆盖矿石、生物群系、结构、刷怪、配方、地形、村庄、实体、命令和服务端设置的控制层:针对每组设置,可选择由数据包决定、配置文件决定或直接关闭
- 随数据包提供的游戏规则、服务器属性、游戏模式和难度设置
- 世界模板:将整个世界设计封装为一个文件
塑造玩法
构建游戏模式
- 世界开场及进入时展示的故事页面(RDPL client)
- 队伍、计分回合及排名
- 由你自定义设计的袭击,包含你自己的波次、预兆和奖励
- 由命令、加入游戏、维度、生物群系、结构、进度、击杀、合成、时间和分数触发的事件卡牌 (Event cards)
- 驱动于选择与条件之上的分支式对话,用于你的生物
- 在游戏中可玩的骰子和牌组以及桌游
仍需模组支持的内容
任何需要独立方块实体、独立界面或逐刻机器逻辑的功能。目前无法实现完整的机器;但矿石、栅栏、食物、流体、箱子、袭击或整个游戏模式均不受此限。
HOWTO.md 对此进行了全面介绍。
欢迎原版客户端
其中大部分功能仅在服务器端运行。在专用服务器上安装该加载器,并开启 vanillaClients,玩家即可使用未修改的原版客户端加入:无需整合包,无需下载任何东西。详情参见 Server-side packs。
实际效果如下:
- 原版中的城市: 由原版方块构建的无尽城市,包含街道、广场、地铁、下水道和塔楼
- 原版中的团队对战: 阵营、计分回合和排名,结果会向所有玩家广播
- 原版中重构的经济体系: 新配方、移除配方、更丰富的战利品、新交易和重新设计的附魔
- 原版中的进度推进: 下界和末地保持关闭状态,直到玩家获得特定进度、合成关键物品或击败Boss
- 原版中的新世界: 虚空世界、自定义矿石矿脉、你自定义的结构,以及第一天即可使用的预生成地图
- 1.20.1 / 1.21.1 / 26.x: 新的生物群系和全新的维度,以及由你自定义设计的袭击
限制在于功能列表中标记为 RDPL client 的部分:即客户端必须知晓才能渲染的任何内容,例如新方块、物品、生物、声音、纹理和模型。vanillaClients 会跳过这些文件并在日志中列出每个文件名,因此一个多余的方块文件仅占用一行日志,而不会导致连接被拒绝。部分功能外观较为简陋:卡牌和对话以聊天形式呈现,服务器端配方可以合成但不会显示在配方书中。
开始使用
首次启动游戏。该加载器会在 mods 和 config 旁边创建 rdploader 文件夹,并在其中写入一份 readme.txt,涵盖基础操作说明。
文件需按照其在 jar 包内的相同路径放置。若要替换铁矿石纹理,请获取该文件在 Minecraft jar 包中的路径,并将你的版本放在 rdploader 下的相同路径中:
rdploader/assets/minecraft/textures/blocks/iron_ore.png (1.12.2)
rdploader/assets/minecraft/textures/block/iron_ore.png (1.20.1 / 1.21.1 / 26.x)
这就是全部规则。你还可以将文件分组为具有优先级顺序的命名 zip 包,并在名称后添加 .disabled 来禁用其中任何一个。rdploader 中的文件夹永远不是一个资源包,因此请打包资源包的内容,而不是包含它们的文件夹。
- 1.12.2: 所有内容都放在
assets/ 下,包括新内容的定义文件夹。
- 1.20.1 / 1.21.1 / 26.x:
data/ 对战利品表、配方、进度和标签的作用方式相同,新内容的定义文件夹也位于此处。
HOWTO.md 包含了完整的文件夹列表、所有方块和物品类型、所有世界生成形状、资源包优先级、资源包优先顺序以及命令。
须知
/rdpl reload 可在不重启的情况下应用资源包更改;在专用服务器上请使用 /rdplserver reload。/rdpl which 可显示提供任意文件的资源包,而 /rdpl unused 会列出未被任何内容请求的文件,这通常是路径拼写错误。
模组可以将 RDPL 内容内置在其自身的 jar 包中:位于 jar 根目录下的 rdploader 文件夹会被像其他资源包一样读取,因此模组无需单独下载。参见 Mod API。
1.12.2: 依赖 CoFH World 的模组在没有它时也能加载。
1.20.1 / 1.21.1 / 26.x: 游戏的遥测和聊天报告功能默认关闭;在配置文件中设置 privacy 可将其恢复。
模组自身的报告日志位于 logs/rdpl.log,而非主日志。
要求
MCT Blast Plaster 在所有版本中均为必需项。
- 1.12.2: Forge 和 MixinBooter。Baubles 为可选。
- 1.20.1: Forge。Curios 为可选。
- 1.21.1: NeoForge。Curios 为可选。
- 26.x: NeoForge。Curios 为可选。
缺少必需的模组将导致游戏无法启动。可选模组仅用于激活驱动它的资源包键位;若无此模组,这些键位无效。
报告问题
请附上 logs/latest.log 和 logs/rdpl.log,以及你的 Minecraft、模组和加载器版本。
帮助翻译模组
欢迎翻译本模组并提交拉取请求。
许可证
Resource Data Pack Loader © tgstyle, All Rights Reserved. 你可以在整合包中包含未修改的模组,并在视频、直播和评测中展示它。任何其他使用、复制、修改或再分发行为均需获得书面许可。请参阅 LICENSE、LICENSE_ASSETS.txt 和 LICENSE_THIRD_PARTY.txt。
Official MCT Discord Server here.
Assets are protected under the terms in the LICENSE_ASSETS
3rd Party Notice for 1.12.2
Resource Data Pack Loader
Not just another resource and data pack loader, though it does that very well. Now you can take control of the entire sandbox.
The API that should have been.
Minecraft is data driven right up to the point where it gets interesting. A data pack can change a recipe, but it cannot add a block, an item or a fluid, it cannot reshape the world, and it lives in one world's save. Past that line you write a mod, once per version and once per loader.
This mod moves the line all the way out. Blocks, items, creatures, dimensions, cities, rules, rewards and whole game modes are JSON files. One folder applies to every world, on clients and dedicated servers alike, and a pack written once loads on Minecraft 1.12.2, 1.20.1, 1.21.1 and 26.x. You are not adding to someone else's game anymore: you are designing your own.
- HOWTO.md, the full manual for each version (English, Deutsch, Русский, 简体中文, Español, Português (Brasil), Français, Čeština, Italiano, 日本語, 한국어, Português (Portugal), Українська, 繁體中文)
- CurseForge
- Modrinth
Anything below that applies to only some versions starts with those versions.
A new ore, no Java
rdploader/data/mypack/blocks/ore.json (1.20.1 / 1.21.1 / 26.x)
{
"type": "ore",
"material": "rock",
"harvestTool": "pickaxe",
"variants": {
"ruby_ore": { "hardness": 3.0 }
}
}
That registers mypack:ruby_ore. Add a texture and the blockstate, the models, the loot table and the tags are written for you. On 1.12.2 the same block is rdploader/assets/mypack/blocks/ruby_ore.json.
Why it exists
- Content is a file. Blocks, items, fluids, entity variants and dimensions are defined in JSON, where vanilla and the loaders ask for a mod.
- One pack, every version. The 1.20.1, 1.21.1 and 26.x builds read the same packs, and a pack written for 1.12.2 loads on them, or the other way around, converted once on first load.
- One folder, every world. A data pack lives in one world's save and a resource pack is the player's to switch on.
rdploader applies everywhere, in singleplayer and on dedicated servers, with nothing for players to enable.
1.12.2: there are no data packs at all. Advancements, loot tables and functions live inside each world's save, and recipes only load from mod jars. This mod is the data pack system that version never had.
What a pack can do
Everything here runs on the server alone, and players can join on a plain vanilla client, except what is marked RDPL client: that needs the mod and the pack on each player's client too. See Vanilla clients welcome.
Customize vanilla and every mod you run
Your pack outranks every jar. Nothing installed is off limits, and no jar is ever touched.
- Replace any recipe, loot table, advancement, function or structure template, vanilla's or any mod's
- 1.12.2: crafting and furnace recipes only; a mod's machine recipes live in its own code, where CraftTweaker or GroovyScript are the better fit
- Replace any texture, model, language file or sound (RDPL client)
- Property overrides: hardness, light, harvest tool and tier, stack size, durability, food values and more on any existing block, item or potion, live with
/rdpl reload (RDPL client)
- Block drops: add drops and experience to any block without replacing its loot table
- Disabled blocks and items: take any block or item out of the game, gone from tabs, JEI, loot, trades and every inventory
- Entity variants: new creatures built on any mod's mob, with its AI and your own skin, stats, drops and name (RDPL client)
- Mob ranks: a random rank for any mob when it spawns, with its own health, damage, effects and loot
- Language gates: alternative names players can choose between (RDPL client)
- Registry renames: old worlds keep loading when a mod renames its blocks
- Choose which ores, biomes, structures, spawns and recipes other mods add, and reshape the rest
Remake existing dimensions
The overworld, the Nether, the End and any dimension another mod adds are yours to rework, not just the ones you create. See Existing dimensions.
- A new sky with your own sun, moon, planets and stars, or endless rain (RDPL client)
- New terrain and structures in every chunk not yet explored
- Gates: lock any dimension, the Nether and the End included, until a player earns an advancement, crafts or holds the right item, pays an item price, slays a boss or reaches a team score, per player, per team or for the whole server
- Game rules per dimension, vanilla or modded
- Structures pinned to exact coordinates, and retrogen: new worldgen added to chunks already explored
- Blast Plaster integration: explosions that heal themselves, drop their blocks or leave a clean crater, in any dimension and from any mod
Add content
- Blocks in every common shape, ores, crates and containers up to nine rows by twelve, bells, and portal blocks (RDPL client)
- Items, tools, armor, food, fluids, creative tabs and wearable items (Baubles or Curios) (RDPL client)
- Potions and villager professions (RDPL client)
- Enchantments (RDPL client on 1.12.2 and 1.20.1)
- Brewing recipes and villager trades
- Biomes, cave regions and whole dimensions (RDPL client on 1.12.2)
Generate the world
- Ores, veins, geodes, trees and your own structure templates, filtered by height, biome, dimension and distance from spawn
- Deep worlds that reach hundreds of blocks below the vanilla floor, raised ceilings and floating sky islands
- Void worlds, your own sea level and terrain shape, gravity, and stacked dimensions
- Structure maps that build far past vanilla's 48 block template limit
- Villages and cities: streets, plazas, bridges, railways, subways, sewers and lamp posts, rolled at random, drawn by hand from a city map, or one endless city that never stops
- Pregeneration as a world is created, so nobody waits on chunks while playing
- 1.12.2: rubic worlds that reach far above and below the 256 block limit (RDPL client)
Control the sandbox
- One control layer over ores, biomes, structures, spawning, recipes, terrain, villages, entities, commands and server settings: for each group, let the pack decide, let the config decide, or switch it off
- Game rules, server properties, game mode and difficulty shipped with the pack
- A world template that carries an entire world design as one file
Shape how it plays
- Recipe locks that open crafting as players earn advancements
- Anvil recipes, affixes and socketed gems, and a reshaped enchanting table
- Vein mining, right-click harvest, picking up and carrying blocks and mobs, and loot dropped by players on death
- Rewards for a varied diet, extra hearts earned through play, and work orders
- Exposures: environmental hazards with their own death messages (RDPL client on 1.20.1, 1.21.1 and 26.x)
- Portways: a whole teleport system of named waypoints on their own networks, across dimensions if you allow it, with a price per trip in experience, items, health or hunger, and locked behind the same gates as a dimension (RDPL client)
- Tooltips on any item or enchantment (RDPL client)
Build game modes
- A world intro and story pages shown on entry (RDPL client)
- Teams, scoring rounds and standings
- Raids of your own design, with your own waves, omens and rewards
- Event cards triggered by commands, joins, dimensions, biomes, structures, advancements, kills, crafts, time and score
- Branching dialogs for your creatures, driven by choices and conditions
- Dice and card decks and board games played in the world
What still needs a mod
Anything needing a block entity of its own, a screen of its own or per-tick machine logic. A machine is currently out of reach; an ore, a fence, a food, a fluid, a crate, a raid or a whole game mode is not.
HOWTO.md covers each of these in full.
Vanilla clients welcome
Much of this runs on the server alone. Install the mod on a dedicated server, switch on vanillaClients, and players join with an untouched vanilla client: no modpack, nothing to download. Server-side packs has the details.
What that looks like:
- Cities in vanilla: an endless city of streets, plazas, subways, sewers and towers, built from vanilla blocks
- Team battles in vanilla: factions, scoring rounds and standings, with results announced to every player
- An overhauled economy in vanilla: new recipes, removed recipes, richer loot, new trades and reshaped enchanting
- Progression in vanilla: the Nether and the End stay shut until a player earns an advancement, crafts the key or slays a boss
- A new world in vanilla: void worlds, custom ore veins, your own structures and a pregenerated map ready on day one
- 1.20.1 / 1.21.1 / 26.x: new biomes and whole new dimensions, and raids of your own design
The limit is what the feature list marks RDPL client: anything the client has to know about to draw it, such as new blocks, items, creatures, sounds, textures and models. vanillaClients skips those files and names each one in the log, so a stray block file costs a log line, not a refused connection. A few things look plainer: cards and dialogs arrive as chat, and server recipes craft but do not show in the recipe book.
Getting started
Start the game once. The mod creates rdploader next to mods and config, and writes a readme.txt into it that covers the basics.
Files go in by the same path they have inside a jar. To replace the iron ore texture, take the file's path inside the Minecraft jar and put your version at the same path under rdploader:
rdploader/assets/minecraft/textures/blocks/iron_ore.png (1.12.2)
rdploader/assets/minecraft/textures/block/iron_ore.png (1.20.1 / 1.21.1 / 26.x)
That is the whole rule. You can also group files into named zips with a priority order, and turn any of them off by adding .disabled to the name. A folder in rdploader is never a pack, so zip the contents of a pack, not the folder holding them.
- 1.12.2: everything goes under
assets/, the definition folders for new content included.
- 1.20.1 / 1.21.1 / 26.x:
data/ works the same way for loot tables, recipes, advancements and tags, and the definition folders for new content live there.
HOWTO.md has the full folder list, every block and item type, every worldgen shape, pack priority, resource pack precedence and the commands.
Good to know
/rdpl reload applies pack changes without a restart; on a dedicated server, /rdplserver reload. /rdpl which names the pack serving any file, and /rdpl unused lists files nothing has asked for, which is usually a typo in a path.
A mod can ship RDPL content inside its own jar: a rdploader folder at the jar's root is read like any pack, so the mod needs no separate download. See the Mod API.
1.12.2: mods that require CoFH World load without it.
1.20.1 / 1.21.1 / 26.x: the game's telemetry and chat reporting are switched off by default; privacy in the config puts them back.
The mod's own report goes to logs/rdpl.log rather than the main log.
Requirements
MCT Blast Plaster is required on every version.
- 1.12.2: Forge and MixinBooter. Baubles is optional.
- 1.20.1: Forge. Curios is optional.
- 1.21.1: NeoForge. Curios is optional.
- 26.x: NeoForge. Curios is optional.
The game will not start without a required mod. An optional one only lights up the pack keys that drive it; without it they do nothing.
Reporting issues
Attach logs/latest.log and logs/rdpl.log, plus your Minecraft, mod and loader version.
Help translate the mod
Feel free to translate the mod and put it in a pull request.
License
Resource Data Pack Loader is © tgstyle, All Rights Reserved. You may include the unmodified mod in modpacks and show it in videos, streams and reviews. Any other use, copying, modification or redistribution needs written permission. See LICENSE, LICENSE_ASSETS.txt and LICENSE_THIRD_PARTY.txt.
评论 0
登录后参与评分
还没有评论,来抢沙发吧