C2ME OpenCL Acceleration Module

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

  1. 安装 Fabric
  2. 安装模组
  3. 完成

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。