概要

该模组为百科制作的游戏内数据导出模组。可用于可视化导出游戏内物品，实体的图片（PNG）或动图（GIF，仅支持单点导出，v2.3.0+）；一键式导出物品，实体，药水效果，附魔，生物群系信息，维度信息以及包括但不限于原版配方的配方表。和配方渲染好像关系不大

使用前须知

• 本模组只允许在本地单人游戏运行，否则可能会发生错误甚至崩溃。

协议

• 该模组使用 GPL v3 进行开源；

• 强调其传染性：该协议意味着您可以借鉴该 Mod 的代码，但是您的项目必须使用同样的协议（GPL v3）进行开源。

• 因为资产版权问题导致的与第三方冲突纠纷，与本模组和作者无关；

• 使用则代表用户已经阅读并已同意以上协议。

关于下载及版本

• 为了数据导入的方便，百科的下载页面中只会提供最新版本的 Mod 文件，若有特殊需要，请转到 GitHub 下载自动构建的产物或自行构建。如果运行的版本低于最新版本，将会无法导出，使用 /reciperenderer ignoreOutdated（不可缩写）可忽略更新。

• NeoForge 和 Fabric 是同一个 Jar 包

导出前须知

《数据导出，从入门到入坟》

• 一键导出：/rr export [modid] 或 /reciperenderer export [modid] 导出某个命名空间（如“minecraft”为原版命名空间）。

• 单点导出：当有些物品/实体贴图无法被正常导出时，请使用下面的指令进行导出。动图在此页面导出。输入指令后，请在对应窗口调整。左键拖动可以旋转模型，右键拖动可以平移模型位置，滚动滚轮可以调节模型缩放，单击滚轮可以重置更改。修改完成后点击旁边的导出按钮即可。

• /rr test hand

• /rr test item [item_id]{nbt}

• /rr test entity [target]/[uuid]

• /rr test entity_type [entity_type] {nbt}

• 注意：{nbt} 都是可选项，[item_id] 与 {nbt} 间没有空格，[entity_type] 与 {nbt} 间有空格。

• 示例：

• 导出玩家的皮肤（仅支持在线玩家）：
  

/rr test entity Bread_NiceCat

导出作者(


• 使用默认情况导出一个含 NBT 的实体：

/rr test entity candycraftce:gingerbread_man {"job":"traveller"}

• 导出一个已存在的实体（有些生物默认情况下不是正常状态，如鱼等，这时候需要从世界获取正常的实体导出）。

• 对准实体，然后从指令提示中即可获取该实体的 UUID：

/rr test entity 039bf7ad-12f0-4f4a-805c-4603ff7817a9

/rr test entity candycraftce:cranfish/rr test entity 039bf7ad-12f0-4f4a-805c-4603ff7817a9




• 导出手上的物品（实时同步）：
  

/rr hand

• 导出草方块物品的模型： 

/rr test item minecraft:grass_block

• 导出位置：游戏根目录下 rr_export/[modid] 文件夹内。还可以使用 /rr open 打开 rr_export 目录，/rr open [modid] 打开对应的目录。导出内容储存于 output.zip。
  

导出后须知

•  本 Mod 导出时会在 ZIP 包的注释区添加导出信息，含导出的 Mod 的数据，MC 数据，模组加载器数据等，非必要请勿修改导出的 ZIP 包，以免数据丢失。

• 附加的单点导出可以另存到一个压缩包内，与 output.zip 一同上传。

Bug 反馈及建议

• 按照使用优先顺序排序：

1. GitHub Issues。

2. 该模组的评论区。

• 注：Gitee 在国内只做镜像，并不会去维护，若提交到 Gitee 或许需要更长时间才能被注意。

Q&A

• Q：能够支持更高（更低）的 MC 版本吗？

• A：如果我（作者）有空闲的时间会优先向上更新，如果有向下的需求会考虑向下移植。

• Q：为什么不支持 All 导出？

• A：因为 All 导出会消耗大量资源去导出无用的模组（例如 Minecraft 原版还有 Fabric API 全家桶）。

• Q：启动时为什么会有一个弹窗闪过？

• A：因为 MC 的内存分配和 CPU 时间片分配机制问题，如果在需要单点导出的时候再打开该窗口，会消耗更多的时间。故选在谷期预初始化该窗口。

• Q：为什么导出一半客户端连接中止/连接超时？

• A：此问题不影响导出，且 v2 新架构版本实现渲染和 IO 等操作分离，几乎不会出现此问题。因为该模组受限只能采用单线程渲染别问为什么，多线程协作的方式去导出。由于导出会使客户端线程阻塞，会导致内置服务器与客户端长时间无法同步从而选择断开连接。

• 这个问题在 v1 的版本中曾尝试修复过，但是修复后发现导出速率明显大幅下降（因为每一帧不仅渲染了图片，还要去重绘整个 MC 窗口），而且还会带来不可控的线程安全问题。

• Q：为什么要取名配方渲染？

• A：因为做这个模组的初衷是导出非原版的配方，后来发现框架写好了，不把其他的加进来太可惜了，然后就一路狂飙，把能做的都做进去了。

鸣谢（排名不分先后）

• 感谢 [IconR]图标渲染 (IconRenderer) 提供的物品渲染思路；

• 感谢 [AnR]动图记录 (AnimationRecorder) 提供的实体渲染的部分思路；

• 感谢 北葵的 《在你导出一个模组Json的时候，还可以顺便导出这些！》；

• 感谢 重生是希望 一直辛苦的手动导入 Json；

• 感谢 一直为 MC百科 默默奉献的大大们。