如何给MojoLauncher添加新渲染器:官方源码直写的7步扩展指南

原创2026-10-16 19:32:361,953 阅读

如何给MojoLauncher添加新渲染器:官方源码直写的7步扩展指南

MojoLauncher 是一款基于 PojavLauncher 的 Minecraft: Java Edition Android 启动器,内置 GL4ES、LTW、Zink、Mesa 等多个渲染器供不同 GPU 切换使用。想为它接入一个新渲染器吗?其实源码里就藏着一份官方亲写的 7 步指南——本文带你完整走通渲染器扩展流程,从 RenderSpec 实现到 UI 自动挂载,一步都不落。

先搞懂:MojoLauncher 渲染器架构

理解扩展流程前,先看一眼四大核心文件,它们各司其职:

文件 职责
RenderSpec.java 渲染器规范接口,定义设备兼容性、库文件、环境变量等契约
Renderers.java 各渲染器标签常量,如 opengles2、vulkan_zink
GameRenderer.java 渲染器总管:解析标签、设置环境、失败时回退
RendererCache.java 设备兼容性过滤,决定设置界面里显示哪些渲染器

具体实现类放在 impl/ 目录 下:GLESRenderSpec.java 承载 GL4ES 与 LTW,MesaRenderSpec.java 承载 Mesa、Zink、Freedreno 等 Vulkan 系渲染器。

MojoLauncher Minecraft 启动器渲染器扩展教程背景图

官方 7 步指南原文在哪找

在 GameRenderer.java 第 27-38 行 的类注释里,开发者直接写了一份 How to add an extra renderer 的指南,原文大致是:

  1. 为该渲染器创建一个 RenderSpec
  2. 添加所有需要的本地化字符串,并接进你的 RenderSpec
  3. 把渲染器标签加进 getKnownRenderer() 的映射
  4. (可选)把标签加进 Renderers 类的常量列表
  5. 把标签加进兼容检查列表(见 RendererCache)
  6. ???
  7. PROFIT(收益到手)

第 6 步的 "???" 是开发者留的玩笑,实际就是构建并真机测试。下面按顺序展开。

第 1 步:创建 RenderSpec 实现类

RenderSpec 接口要求你提供以下成员,这就是新渲染器的"身份档案":

方法 说明
compatibleDevice(Context) 判断当前设备能否用此渲染器(如检查 Vulkan 支持、库文件是否存在)
name() 内部名称,如 "GL4ES"
displayName() 设置界面显示的字符串资源 id
tag() 持久化到实例配置的渲染器标签
library() EGL 动态库文件名,如 libgl4es_114.so
setupEnvironment(...) 写入运行所需的环境变量
setupRenderer() 通过 MojoExec.prepareEgl(...) 完成加载

参考 GLESRenderSpec 中的 LTWRenderSpec(第 42-61 行) 最省事:继承 GLESRenderSpec 后只需补上 glesVersion() 一个抽象方法。若想接外部独立构建的库,可以模仿 ExtMesaRenderSpec,通过 LibraryPlugin 机制从插件目录发现库文件。

第 2 步:添加本地化字符串

在 strings.xml 第 66-72 行 可以看到现成的命名惯例,全部以 mcl_setting_renderer_ 为前缀:

<string name="mcl_setting_renderer_ltw">LTW (OpenGL ES 3) - 1.17+ only</string>
<string name="mcl_setting_renderer_vulkan_zink">Zink (Vulkan) - all versions</string>

为你的渲染器新增一条同风格条目(建议各语言目录同步更新),然后让 RenderSpec 的 displayName() 返回该资源 id。

第 3 步:注册到 getKnownRenderer()

这是标签字符串到 RenderSpec 实例的总映射。在 GameRenderer.getKnownRenderer()(第 61-77 行) 的 switch 中新增一个 case:

case YOUR_RENDERER: return new YourRenderSpec();

没匹配到的标签会打日志并返回 null,最终回退到默认的 opengles2(GL4ES)。

第 4 步(可选):在 Renderers 中定义常量

Renderers.java 里集中定义了现有标签:opengles2、opengles3_ltw、vulkan_zink、freedreno_kgsl、mesa_desktop 等。为新标签加一行常量能保持代码整洁,但并非必须——直接用字面量也能工作。

第 5 步:加入 RendererCache 兼容检查列表

RendererCache.getCompatibleRenderers()(第 38-57 行) 里的数组被开发者戏称为 "the list that controls em all"(控制一切的名单):

String[] renderers = {
        GL4ES_RENDERER, LTW_RENDERER, ZINK_RENDERER,
        FREEDRENO_RENDERER, MESA_RENDERER, MESA_RENDERER_EXT,
        LEGACYZINK_RENDERER
};

只有出现在这里的标签,才会经过 compatibleDevice() 检查后进入设置下拉框。漏掉这一步,前四步就都白做了。

第 6 步:???(构建 + 真机测试)

用 Gradle 构建应用(详见 README.md 的 Building 部分):

./gradlew :app_mojo:assembleDebug

真机验证要点:

第 7 步:PROFIT 🎉

到这里,新渲染器已经完整接入:标签可解析、兼容设备才展示、失败有回退、UI 零改动自动挂载。整套流程改动量很小——一个实现类、一条字符串、两个数组注册点,就是 MojoLauncher 渲染器扩展的全部成本。

小结

  • 扩展入口认准 RenderSpec 接口,官方指南写在 GameRenderer.java 注释里
  • 关键注册点只有两处:getKnownRenderer() 的 case 分支 + RendererCache 的标签数组
  • UI 与启动链路全自动,改完直接 ./gradlew :app_mojo:assembleDebug 真机验证即可
登录后查看全文
MojoLauncher