MinecraftForge 1.21.4版本中语言文件在服务端加载问题的分析与解决方案

问题背景

在MinecraftForge 1.21.4版本中，开发者报告了一个关于语言文件(lang文件)在专用服务器上无法正确加载的问题。该问题表现为当尝试在专用服务器上加载mod的语言字符串时，系统无法找到对应的语言资源。

问题本质

这个问题的根源在于Minecraft 1.21.4版本对服务器资源管理器的修改。在新的版本中，Minecraft决定将服务器资源限制为仅能访问数据包(data packs)，而不再允许访问客户端资源(client resources)。这一变更导致了Forge原有的语言文件加载机制失效。

技术分析

在Forge的代码实现中，原本通过LanguageHook类尝试加载语言文件。然而，由于服务器资源管理器的范围限制，这些尝试无法成功获取到位于客户端资源包中的语言文件。

这种设计变更可能是出于性能和安全考虑，因为服务器通常不需要访问客户端专有的资源。然而，这也带来了与Forge原有机制的兼容性问题。

解决方案

针对这一问题，Forge开发团队提出了一个解决方案，通过重新实现资源管理器来绕过这一限制。核心思路是：

1. 获取服务器资源管理器实例
2. 收集所有可用的资源包
3. 递归处理资源包的子包
4. 按命名空间组织资源包
5. 为每个命名空间尝试加载对应的语言文件

具体实现代码如下(已做适当简化)：

private static void loadLanguage(String langName, MinecraftServer server) {
    var langFile = String.format(Locale.ROOT, "lang/%s.json", langName);
    var resourceManager = server.getServerResources().resourceManager();
    var byNamespace = new HashMap<String, List<PackResources>>();

    // 收集所有资源包
    var packs = new ArrayList<>(resourceManager.listPacks().toList());
    var seen = new HashSet<>(packs);

    // 递归处理资源包及其子包
    while (!packs.isEmpty()) {
        var pack = packs.removeFirst();
        if (pack.getChildren() != null) {
            for (var child : pack.getChildren()) {
                if (seen.add(child))
                    packs.add(child);
            }
        }

        // 按命名空间组织客户端资源
        for (var namespace : pack.getNamespaces(PackType.CLIENT_RESOURCES)) {
            byNamespace.computeIfAbsent(namespace, k -> new ArrayList<>()).add(pack);
        }
    }

    // 尝试加载每个命名空间的语言文件
    for (var entry : byNamespace.entrySet()) {
        var languages = new ArrayList<IoSupplier<InputStream>>();
        var path = ResourceLocation.fromNamespaceAndPath(entry.getKey(), langFile);
        
        for (var pack : entry.getValue()) {
            var io = pack.getResource(PackType.CLIENT_RESOURCES, path);
            if (io != null)
                languages.add(io);
        }

        // 加载找到的语言文件
        while (!languages.isEmpty()) {
            try (var stream = languages.removeLast().get()) {
                loadLocaleData(stream);
            } catch (Exception exception) {
                LOGGER.warn("Skipped language file: {}:{}", entry.getKey(), langFile, exception);
            }
        }
    }
}

开发者应对策略

对于使用Forge 1.21.4版本的mod开发者，可以采取以下策略：

1. 等待Forge官方发布包含此修复的版本更新
2. 如果急需解决，可以临时实现类似的资源管理器重写逻辑
3. 考虑将必要的语言字符串放入数据包而非客户端资源中

总结

MinecraftForge 1.21.4版本中出现的语言文件加载问题反映了Minecraft核心代码变更对mod生态的影响。Forge团队通过重新实现资源管理器的部分功能，巧妙地解决了这一兼容性问题。这提醒我们作为mod开发者，需要密切关注Minecraft核心机制的变更，并做好相应的适配工作。

该解决方案不仅解决了当前的语言文件加载问题，也为未来处理类似的资源访问限制提供了参考模式。通过递归收集资源包、按命名空间组织资源、以及灵活的资源加载机制，开发者可以更可靠地访问所需的游戏资源。