Chunky¶

Chunky是一个离线路径追踪渲染器，常用于给Minecraft世界制作高质量宣传图。它不是基岩版渲染器，也不能直接验证基岩版资源包的实际显示效果；在基岩版项目里，它更适合放在“最后做展示图”的阶段。除了成图本身，Chunky也提供插件扩展能力，可以为Java版渲染流程补充新方块支持、后处理器甚至其他渲染扩展，但这条路线并不能把它变成基岩版实机渲染测试工具。

快速导航¶

深入学习（推荐新用户先读这些）： - 路径追踪原理：理解Chunky如何工作，为什么某些场景需要更长的渲染时间 - 采样与噪点：判断什么时候该继续渲染，什么时候该缩小画布或调整场景 - 光源估计优化：理解太阳采样、ESS和Emitter Grid对噪点与速度的影响 - 材质属性详解：学习如何通过调整自发光、镜面反射等属性实现逼真效果 - 降噪技术：使用AI降噪器加快渲染，可减少50-80%的时间 - 无头渲染：在没有GUI的情况下继续渲染场景

快速开始（本页内容）： - 什么时候使用 - 安装与配置 - 完成第一次渲染

基岩版世界不能直接读取

Chunky文档明确说明当前不支持基岩版世界。若要渲染基岩版地图，需要先用Chunker等工具把世界转换为Java版格式。转换后可能丢失或改变一部分方块、实体、方块状态和数据，渲染结果不能代表基岩版实机画面。

什么时候使用¶

Chunky适合处理下列任务：

给已经完成的地图、世界模板或服务器大厅制作宣传图。
在可接受转换损耗的前提下，渲染由基岩版世界转换得到的Java版副本。
使用路径追踪、天空贴图、雾、水体和后期参数制作比游戏内截图更“摄影化”的静态画面。
在无人值守环境中继续渲染已经配置好的场景。

Chunky不适合处理下列任务：

直接打开基岩版存档。
检查基岩版PBR、延迟渲染、RTX或其他实机渲染效果。
验证附加包自定义方块、实体、动画和脚本是否正确。
作为Chunky预生成插件的替代品。二者只是重名项目，Chunky预生成插件用于服务器区块预生成。

安装要求¶

官方安装文档推荐使用Chunky Launcher，并安装Java17和OpenJFX。最低配置只代表可以启动；正式渲染更依赖可用内存、CPU速度、场景规模和画布尺寸。复杂场景可能长时间占用CPU，并在场景目录中产生较大的保存文件。

兼容性方面，Chunky首页仍把它描述为支持Java版1.2.1及以上世界，并提到快照里的新方块通常会在数日内补上；但它依旧不支持基岩版世界，很多Java版实体和特殊方块的表现也不能视为完全无缺。正式渲染前，仍应先用转换后的副本核对关键结构、材质和取景位置。

Windows上的基本流程是：

安装64位Java17。
下载ChunkyLauncher.jar并保存到固定位置。
双击启动，或在命令行中运行：

java -jar "C:\path\to\ChunkyLauncher.jar" --launcher

如果JAR文件没有正确关联到Java17，可以显式使用Java路径：

"C:\path\to\Java17\bin\java.exe" -jar "C:\path\to\ChunkyLauncher.jar" --launcher

首次启动时，选择推荐设置目录即可。进入启动器后，先点击检查更新，再启动Chunky。若启动器无法自动安装或检测OpenJFX，需要按文档把OpenJFX的lib目录加入启动命令或启动器的Java选项。

配置启动器¶

启动器里最常用的配置是：

Minecraft directory：Java版.minecraft目录。目录不正确时，Chunky可能找不到世界或纹理。
Memory limit：内存限制。文档举例说明，16GiB系统内存可以考虑分配到12GiB左右，但仍要给系统和其他应用留余量。
Release Channel：发布通道。稳定版适合日常使用；快照版可能支持更新的Java版世界，但也更容易遇到变化。
Java options：高级Java参数。只有在排查JavaFX、显示或自定义设置目录等问题时再修改。

不要一开始就改高级设置。只有更新站点错误、JavaFX无法加载、窗口空白或需要特殊启动参数时，再进入高级设置排查。

如果你打算长期使用插件或无头渲染，也要记住设置目录的位置。插件管理器会从该目录下的plugins文件夹发现JAR插件，场景文件和chunky-launcher.json也都保存在这里。

渲染前准备世界¶

基岩版项目需要先完成这一步：

在基岩版中备份世界。
导出世界副本。
使用Chunker转换为Java版世界。
打开转换后的世界，检查大范围结构、关键方块、容器、实体和材质是否仍然可接受。
再让Chunky读取转换后的Java版存档。

如果项目大量使用基岩版独有方块、实体、方块状态、附加包内容或脚本生成内容，转换结果可能不适合渲染。此时更建议使用游戏内截图、视频录制或其他面向基岩版的拍摄方案。

完成第一次渲染¶

在游戏中找到想渲染的位置，记录坐标、偏航角和俯仰角。
在Chunky中点击Change World加载世界。
在地图视图中选择只会被相机看到的区块。区块越多，加载和渲染越慢；没有被选择的区块会在成图中完全缺失。
右键地图并选择New scene from selection，或在Scene页点击Load selected chunks，生成场景。
在Scene页设置画布尺寸。预览阶段可以先用960×540之类的小尺寸，确认构图后再改为正式分辨率。
在Camera页设置相机。要从玩家视角复现画面时，建议在加载区块前关闭玩家实体，或在加载后从Entities页删除挡住相机的玩家实体。

如果要把Minecraft调试屏幕坐标换成Chunky相机，文档给出的换算关系是：

Chunky Camera X = Minecraft X
Chunky Camera Y = Minecraft Y + 1.62
Chunky Camera Z = Minecraft Z

Chunky Camera Yaw = 90 - Minecraft Yaw
Camera Pitch = Minecraft Pitch - 90

Minecraft默认视场角与Chunky默认FoV都为70°时，在相同画布比例下通常更容易复现相似构图。如果游戏开启了动态视场角，飞行、疾跑等状态会影响对照，应在截图取景时注意关闭或记录这一差异。

调整光照和质量¶

Chunky使用CPU路径追踪。路径追踪会不断累积样本，样本越多噪点越少，但收益会递减；通常需要把当前SPP翻倍，噪点才会约减半。因此，不要只凭前几十个SPP判断最终质量。

常见调节思路如下：

日间、没有大量发光体的场景，可以先用较低SPP预览。
火把、岩浆、发光方块等小而亮的光源会显著增加噪点，也可能产生随机亮点。
室内或夜间场景通常需要更高SPP。
画布尺寸按面积影响耗时；1920×1080约等于960×540四倍像素。
雾、HDR天空贴图、复杂水面和很大的选区都会增加场景复杂度。
Render threads通常比CPU utilization更适合控制实际CPU占用。
Ray depth越高，间接光和反射越准确，但耗时也会增加。普通室外场景可从较低值试起，室内场景再按效果提高。

渲染前建议先保存场景，并开启自动保存或设置合适的保存间隔。需要暂停时，先点击Pause，等待CPU占用下降，再保存并关闭，避免丢失进度。

资源包、天空和水体¶

Chunky可以加载Java版资源包、.jar版本文件或包含pack.mcmeta的资源包。资源包列表越靠上，优先级越高。对基岩版项目而言，这只适用于转换后仍能映射到Java版资源系统的内容，不能还原基岩版资源包的所有表现。

了解更多关于材质属性的详情。

天空与环境参数常用于决定宣传图的气氛：

Sky mode可以使用模拟天空、纯色、渐变、天空贴图或天空盒。
等距矩形天空贴图需要正确设置垂直分辨率，否则天空可能被拉伸或镜像错误。
Fog density为0时禁用雾；雾会增加噪点和耗时。
Water页可以调节静止水、透明度、水下可视距离、自定义水色和无限水面。

这些设置只影响Chunky渲染场景，不会改变世界文件，也不代表基岩版客户端的画面。

导出成品¶

渲染过程中可以使用Save current frame保存当前帧。达到目标SPP后，结果通常会出现在场景目录的snapshots文件夹中，也可以在Chunky的Scene页点击Open Scene Directory打开场景目录。

如果需要较早出图，可以先导出低SPP结果并进行降噪，但降噪可能造成块面变形、纹理模糊或油画感。正式展示图仍应尽量保留足够SPP，并在最终发布前检查细节。

无头渲染¶

Chunky可以在没有GUI的情况下继续渲染已经配置好的场景，适合服务器、远程主机或夜间批量渲染。大致流程是先在GUI中完成场景、相机、资源包和目标SPP设置，再把场景放在设置目录的scenes文件夹中使用命令渲染：

java -jar "C:\path\to\ChunkyLauncher.jar" --update
java -jar "C:\path\to\ChunkyLauncher.jar" -list-scenes
java -jar "C:\path\to\ChunkyLauncher.jar" -render SceneName

命令行渲染会持续到场景文件中设置的目标SPP。提前中断时，最近一次自动保存之后的进度可能丢失。需要把当前进度输出为图片时，可以使用snapshot相关命令或回到GUI中保存当前帧。

如果你准备长期挂机、远程渲染或给多个项目分开管理场景，建议继续阅读Chunky无头渲染。

常见问题¶

现象	可能原因	处理方式
启动器窗口空白	JavaFX在Windows上的硬件渲染问题	在启动命令和启动器Java选项中加入`-Dprism.order=sw`。
双击`ChunkyLauncher.jar`没有反应	JAR文件没有关联到Java17	用命令行启动，或重新安装Java17并修复JAR关联。
报错缺少`javafx`类	OpenJFX未安装、未检测到或架构不匹配	安装匹配系统架构的OpenJFX，或手动加入`--module-path`和`--add-modules`参数。
内存限制不能超过2GiB	使用了32位JRE	改用64位Java17。
地图视图出现红叉或海洋	世界版本不被当前Chunky版本支持	尝试更新Chunky或切换到快照通道，并确认该Java版世界版本受支持。
方块纹理错误、黑色或红叉	没有正确加载Java版`version.jar`或资源包	检查Java版`.minecraft`目录，或手动添加版本文件和资源包。
新场景为空	没有选中区块，或Y裁剪范围排除了所有方块	重新选择区块，并检查Scene页的最小/最大Y层级。
生物和部分实体没有显示	Chunky对实体支持有限	以官方兼容性页为准；必要时使用游戏内截图补充。
渲染时间过长	场景复杂度高或光源众多	考虑使用降噪技术来加速。

最后再次提醒：Chunky结果是宣传渲染图，不是基岩版渲染兼容性测试。