
C2ME OpenCL Acceleration Module
通过OpenCL提供硬件加速世界生成的C2ME附加组件
C2ME OpenCL 加速模块
实验性 C2ME 附加组件,通过 OpenCL 提供硬件加速的世界生成。需要基础 C2ME 模组。 强烈建议安装 ScalableLux,因为光照计算很容易成为瓶颈。
注意
本模组需要 Java 25 才能正常运行,即使在 26.1 之前的版本上也是如此。
在原版世界生成中,世界生成应具有完整的原版一致性,但有一个例外: 在极少数情况下,生物群系边界可能会偏移一两个方块,这是因为原版实现依赖于执行顺序。(换句话说,此模组与原版一致性程度与 Noisium 及其分支(如 NoisiumForked)相同,后者尽管声称具有完整的原版一致性,但也存在同样的问题。)
适用常规的世界生成非确定性。
目前仅实现了噪声阶段和生物群系阶段。 在 CPU 受限的情况下,原版主世界的预期性能提升为 80% 以上。性能取决于种子、数据包等因素。
此外,世界生成现在包含 GPU 驱动程序错误。在现有世界上使用此模组前,请备份您的世界。 已知某些世界生成模组会彻底失败。详情请参阅模组兼容性部分。
平台兼容性矩阵
支持:已知在一般情况下完全正常工作部分:已知在存在一些重大限制的情况下工作不支持:已知完全无法工作N/A:不适用,因为该组合不存在。
| 厂商 | 代际 | 驱动 | Windows | Linux | MacOS |
|---|---|---|---|---|---|
| NVIDIA | Maxwell 及更新 | 专有和开源 | 支持 | 部分¹ | 未知 |
| NVIDIA | Kepler | 专有 | 未知 | 支持 | 未知 |
| NVIDIA | 更旧的显卡 | 任何 | 未知 | 未知 | 未知 |
| NVIDIA | nouveau 支持的 GPU | nouveau 上的 Rusticl | N/A | 未知 | N/A |
| Intel | Gen9, Gen9.5⁵ | 官方² | 部分³ | 部分⁴ | 未知 |
| Intel | Gen11, Gen12, Gen12.5⁶ | 官方² | 不支持¹² | 不支持¹² | 未知 |
| Intel | Gen12.7, Xe2, Xe3 及更新⁷ | 官方² | 部分³ | 部分⁴ | 未知 |
| Intel | 更旧的显卡 | 官方² | 未知 | 未知 | 未知 |
| Intel | iris 支持的 GPU | iris 上的 Rusticl | N/A | 未知 | N/A |
| AMD | RDNA1 及更新¹⁴ | 官方⁸ | 支持⁹ | 支持 | 未知 |
| AMD | GCN | 官方¹⁰ | 不支持¹³ | 不支持¹³ | 未知 |
| AMD | radeonsi 支持的 GPU | radeonsi 上的 Rusticl | N/A | 部分¹¹ | N/A |
| Qualcomm | 任何 | 官方 | 不支持¹² | 不支持¹² | N/A |
| Apple | 任何 | MacOS 驱动 | N/A | N/A | 不支持¹² |
| Apple | 任何 | asahi 上的 Rusticl | N/A | 未知 | N/A |
- ¹ 该驱动程序已知在一段时间后会挂起。535 LTS 驱动分支似乎工作正常。
- ² Windows 上的官方驱动包。Gen9 和 Gen9.5 需要最新驱动程序: Gen9: https://www.intel.com/content/www/us/en/download/762755/intel-6th-gen-processor-graphics-windows.html Gen9.5: https://www.intel.com/content/www/us/en/download/776137/intel-7th-10th-gen-processor-graphics-windows.html Linux: https://github.com/intel/compute-runtime
- ³ GPU 已知在几乎所有非原版世界生成中崩溃。您的体验可能有所不同。
- ⁴ GPU 已知在某些复杂的 worldgen 数据包(如 Terralith)中崩溃。您的体验可能有所不同。
- ⁵ Gen9 和 Gen9.5 是第 6-9 代酷睿处理器以及第 10 代非 G 系列酷睿处理器的集成显卡
- ⁶ 这里的 Gen11、Gen12、Gen12.5 是第 10 代 G 系列酷睿处理器、第 11-14 代酷睿处理器以及 Arc DG1、Arc A 系列的集成显卡
- ⁷ Gen12.7 指 Meteor Lake 和 Arrow Lake 集成显卡。 此时,它是 Core Ultra 100 系列及以上处理器的集成显卡,以及 Battlemage 及以上独立显卡。
- ⁸ Windows 上的官方驱动包。Linux 上的 ROCm 运行时。
- ⁹ 26.5.1 版驱动程序已知总是崩溃。升级到 26.6.1+ 的现有安装也可能崩溃。 如果您在 26.6.1+ 上遇到崩溃,建议使用 DDU 然后进行全新安装。
- ¹⁰ Windows 上的官方驱动包。Linux 上的 AMDGPU-Pro 运行时。
- ¹¹ Mesa 26.1.x 分支已知可在 RDNA3/4 上工作。任何硬件组合都可能发生任何事情,包括损坏的世界生成。您的体验可能有所不同。
- ¹² 缺少 FP64 支持
- ¹³ 驱动程序崩溃
- ¹⁴ 不包括 Ryzen 7000 系列和 9000 系列的集成显卡。它们对于此任务来说太慢了。
此处未列出的任何硬件均处于“未知”状态。欢迎测试满足以下最低要求的其他硬件配置。
最低硬件要求
- 一个正常工作的 OpenCL 1.2+ 驱动程序
cl_khr_fp64支持(fp64 支持)
锦上添花的功能
- 一个正常工作的 OpenCL 3.0 驱动程序
- 用于稳定设备匹配的
cl_khr_device_uuid - 用于最佳性能的
CL_QUEUE_OUT_OF_ORDER_EXEC_MODE_ENABLE。AMD GPU 上不存在。 - 用于队列优先级的
cl_khr_priority_hints和cl_khr_throttle_hints。已知仅存在于 Intel GPU 上。 - 非均匀工作组,Nvidia GPU 和一些 AMD GPU 上不存在。
使用 Chunky 的性能预期
针对原版主世界 1200+ cps 目标:
CPU:现代中端台式机(9700X,9800X3D,245K) GPU:
- Nvidia GTX 1060 或更高
- AMD Radeon RX 6500 XT 或更高
- Intel Arc B570 或更高(Intel 没有更弱的 GPU,所以就是这样)
针对原版主世界 2500+ cps 目标:
CPU:现代旗舰台式机(9950X,9950X3D,285K,270K+) GPU:
- Nvidia GTX 1080 Ti 或更高,RTX 4060 Ti 或更高
- AMD Radeon RX 7600 XT 或更高
- Intel Arc B570 或更高(Intel 仍然没有更弱的 GPU)
使用说明
Windows
- 安装 Fabric
- 安装模组
- 完成
Linux
由于大多数 Linux 发行版没有预装 OpenCL,您需要手动安装。
在 Flatpak 中运行是不支持的配置
Flatpak 目前仅支持 Rusticl(可能还有 NVIDIA)作为 OpenCL 运行时,这在 Linux 上非常粗糙。请参阅上面的兼容性矩阵。
对于 Nvidia 用户
通常,您的发行版提供的 nvidia 驱动包包含 OpenCL 驱动。您应该可以直接使用。如果没有,请参阅以下特定于发行版的设置。
基于 Debian 的发行版(如 Ubuntu)
所有厂商:安装 ocl-icd-opencl-dev
Nvidia:安装 nvidia-driver-full 包
AMD:安装 rocm-opencl-icd 包
Intel:安装 intel-opencl-icd(适用于 Gen12 及以上)或 intel-opencl-icd-legacy(适用于较旧的集成显卡)(不过在 Debian 13 上不可用,您需要手动编译)
Arch Linux
https://wiki.archlinux.org/title/General-purpose_computing_on_graphics_processing_units#OpenCL
所有厂商:安装 ocl-icd
Nvidia:安装 opencl-nvidia
AMD:安装 rocm-opencl-runtime
Intel:安装 intel-compute-runtime(适用于 Gen12 及以上)或从 AUR 安装 intel-compute-runtime-legacy(适用于较旧的集成显卡)
基于 Fedora 的发行版
注意:如果您使用带有 AMD GPU 的 Bazzite,您需要切换到 Bazzite-DX,而不是执行以下步骤。
所有厂商:安装 ocl-icd-devel
Nvidia:https://docs.nvidia.com/datacenter/tesla/driver-installation-guide/fedora.html
AMD:安装 rocm-opencl
Intel:安装 intel-opencl(适用于 Xe)
使用 Rusticl(非常实验性)
这需要 Mesa 26.1 及以上版本,并启用 rusticl+fp64。
兼容性
数据包兼容性
此功能保证与原生可以加载的数据包兼容。例如:
- Stardust Labs 数据包(Terralith, Incedium, …)
- Tectonic
- CliffTree
- … 更多
模组兼容性
大多数非世界生成模组应该可以工作。
对于世界生成模组:
- 重新打包数据包的模组(即,如果重命名为 .zip 仍然可以作为数据包工作),请参阅数据包兼容性。
- Tectonic 3.0.20+ 作为模组可以工作
- 使用自定义密度函数的模组目前不工作。(例如 Enderscape, The Bumblezone)
- 推出全新世界生成器的模组不工作,并且如果没有大量工作可能永远无法工作。(例如 Big Globe)
- 其他特殊情况:
- Biomes O' Plenty:导致生物群系放置完全失败
- TerraBlender:也导致生物群系放置完全失败
已知问题
- 着色器编译已知需要一段时间,具体取决于使用的数据包。
- 堆外的额外内存使用是着色器编译所预期的。
- 使用 CPU 后端的 PoCL 几乎肯定会崩溃,即使 pocl 在配置中被列入黑名单。解决方案是完全删除它。
- 直接引用
minecraft:beardifier密度函数的数据包可能会导致地形形状出现轻微错误。没有计划修复此问题,因为原版不受影响,修复它将使 GPU 吞吐量减半。
调优建议,适用于只想让世界生成更快的人
感谢 Discord 上的 skillnoob_。
模组:
- ScalableLux(光照引擎优化,高性能区块生成中的瓶颈)
- Lithium(通用优化模组,用于各种方面)
- FerriteCore(内存使用改进)
- Structure Layout Optimizer(使结构生成更快)
- zFastNoise(加速世界生成中的噪声和表面构建器)
Java/JVM 参数:
-XX:+UseCompactObjectHeaders -Dchunky.maxWorkingCount=768(-Dchunky.maxWorkingCount=768参数仅在使用 chunky 时相关)。- 如果您分配超过 16GB 内存,请使用
-XX:+UseZGC,否则使用-XX:+UseG1GC -XX:G1HeapRegionSize=16M或-XX:+UseShenandoahGC -XX:ShenandoahGCMode=generational。
然后,在配置文件目录下的 c2me.toml 中,您可以将 globalExecutorParallelism = "default" 选项更改为您的线程数或略低于此值。
例如,如果您有一个 16 线程的 CPU,您需要将其更改为 globalExecutorParallelism = 16。
注意:如果您需要 FPS 和 TPS 稳定性,您需要为系统的其余部分预留一些线程。
您还可以在配置中启用 gcFreeChunkSerializer = true,这可以提高区块生成性能。
常见问题解答
这会使用多 GPU 吗?
默认情况下,它会在它能找到的所有 OpenCL 设备上进行最小负载调度。 然而,通常是您的 CPU 成为瓶颈。请参见下文。 所以除非您只有一堆 GT1030,否则不要期望多 GPU 带来任何改进。
我的 GPU 几乎未被使用,而 CPU 满载。发生了什么?
使用合理的 CPU 和 GPU 组合,您将受限于 CPU。这主要是因为只实现了噪声阶段和生物群系阶段。 其他阶段可能会在未来实现。
如何选择 GPU?
您可以在配置文件中指定白名单和黑名单。设备 UUID 可以在日志中找到。
AMD GPU 名称在日志中是 gfx something,而不是它们的营销名称。
voxy 与此兼容吗?
是的。
简而言之,要为 voxy 生成渲染距离,请安装 Chunky,运行 /voxy import current,然后启动 chunky 任务。建议加入他们的 Discord 服务器以获取更多信息。
Distant Horizons 与此兼容吗?
简短回答:不推荐。请使用 Voxy 代替。
详细回答:DH 太慢,无法看到此模组带来的好处。
如果您仍打算使用 DH,请在 DH 中使用 Internal Server / Full - Save Chunks 模式以启用加速。
即便如此,您可能看不到改进,因为 LoD 生成已经是链中最慢的部分。
我遇到了 OpenCL error [-1001]。这是什么意思?
OpenCL ICD 加载程序无法找到任何 OpenCL 驱动程序。请检查您的驱动程序安装。
建议使用 clinfo 工具快速检查。
这能在专用服务器上工作吗?
只要驱动程序到位,就可以在专用服务器和单人游戏上工作。 仅提供 linux x86_64、linux arm64 和 windows x86_64 的服务器端二进制文件。
如果初始化失败,我可以让它回退到常规世界生成吗?
默认情况下不可以。这可以通过配置文件中的 openclAccel.allowIncompatibilityFallback 设置。
我听说 Vulkan 是优秀的图形 API。为什么选择 OpenCL?
- 我熟悉它
- 我需要在 Vulkan 中使用无类型指针,这在 Vulkan 中直到最近才存在 并且这实际上要求 Vulkan 1.4,极大地缩小了硬件兼容性
- Vulkan 没有明确指定 FP64 精度,仅要求“至少与 FP32 相同”。
- 正确舍入的浮点除法和平方根仍然在 Vulkan 规范中缺失
为什么不是 CUDA?或 Rocm?或 Level0?或 Metal?
不使用任何厂商锁定的 API。
我使用的是 AMD RDNA GPU,在世界生成开始之前就看到崩溃。为什么?
26.5.1 版驱动程序已知总是崩溃。升级到 26.6.1 的现有安装也可能崩溃。 如果您在 26.6.1 上遇到崩溃,建议使用 DDU 然后进行全新驱动程序安装。
请参见平台兼容性矩阵中的脚注 9。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。