兼容性与性能建议

目前，常见的混合端都无法保证任何 Mod 与插件的绝对兼容，Luminara 也是如此。

Luminara 同时加载 Forge 模组和 Bukkit/Spigot 插件，但不是完整 Paper 实现。插件是否可用取决于它使用的 API、对原版行为的假设，以及是否与模组修改冲突。遇到问题时先在只安装 Luminara 的最小环境复现。

只是简单一味的堆砌 过多的 优化 Mod 通常无法提升服务器性能，尤其是现在越来越多 AI Slop 的优化 Mod 出现，使我们越来越难以甄别哪些优化 Mod 是有帮助的。

若要最大限度地提升服务器性能，可以往下看 大型整合包的优化 部分。

已知兼容整合包

当 Luminara 准备发布正式版时，都会选择版本热门整合包进行简单的兼容性测试（开服与进服）。

当 Luminara 已发布正式版时，会随机挑选热门整合包部署到服务器上进行长期周目（大概 7 天 ~ 1 个月）测试。

以下是 Luminara 明确兼容的整合包：

All the Mods 10 (1.21.1 NeoForge)
Better MC [FABRIC] BMC3 (1.21.1 Fabric)
All the Mods 9 (1.20.1 Forge)
落幕曲 Closing Song (1.20.1 Forge)
GregTech Odyssey (1.20.1 Forge)
香草纪元：食旅纪行 VanillaEra: FaresChron (1.20.1 Forge)

如果你所游玩的整合包不在这个列表内，也没关系。因为这只是我们测试过的，你仍然可以尝试用 Luminara 开其他整合包的服务器，遇到了问题去发 Issue 或社区群求助就好。

ServerCore：其许多优化来自 Spigot 或 Paper，而 Luminara 已经在 Forge 服务端中提供 Bukkit/Spigot/Paper 兼容层，重复修改同一逻辑可能导致异常或崩溃。
Sinytra Connector：它用于连接 Forge 与 Fabric；Luminara 当前目标是 Forge + Bukkit/Spigot/Paper 兼容组合，不支持再叠加这一连接层。
C2ME Forge：当前闭源实现无法针对 Luminara 的变换链修复兼容问题。需要加速区块生成时可测试 FastChunkGen。

声称“自动优化服务器性能”的插件，例如 LaggRemover。此类插件经常与服务端自身调度冲突，收益也无法从名称推断。
反作弊插件，例如 GrimAC、Matrix、Vulcan。它们通常只按原版行为判断，可能误判模组物品、实体或交互。
强依赖 Paper API 的插件。Luminara 只实现一部分常用 Paper API，插件若调用未实现方法可能缺类、行为异常或崩溃。优先选择提供 Spigot API 版本的发行包。

这不是完整兼容清单。插件作者声称“支持 Paper”并不等于支持 Luminara；请先查看启动日志和插件依赖，再在备份服验证。

我们将模组数量 ≥300 的整合包定性为大型整合包.

对大型整合包，Luminara 只明确兼容以下几个优化 Mod：

跑图生成负载较高时，可尝试：

我们将模组数量 ≤299 的整合包定性为中型整合包；模组数量 ≤150 的定性为小型整合包。

如果目标是更激进的性能补丁，可尝试我们的下游项目 PRTS-SERVER（仅 1.20.1，此项目的 1.21.1 直接基于 Arclight 进行开发，不基于 Luminara）。它适合小型到中型整合包；大型整合包推荐留在 Luminara 。

如果你希望仍然使用 Luminara，你仍然可以复用 通用 / 大型整合包的优化 所提到的几个优化 Mod。

找出有问题的 Mod 或插件后，在单独的 Forge 服务端或 Paper 服务端进行测试。

若仍失败，则是 Mod 或插件本体出现问题；若能正常运行，则是 Luminara 的问题，这时请在 GitHub Issue 提交问题。

不要把“服务器能启动”当作标准，还要看看进服后是否正常。