在 Anbernic RG40XXH（原厂系统）上玩你自己的 Minecraft: Java Edition
PortMaster 有一个 Minecraft: Java Edition 移植版，可以在 Anbernic RG40XXH 这样的掌机上玩。在 muOS 等第三方系统上，稍作准备就能运行（我们的 muOS 指南）。但在 Anbernic 自己的系统，也就是掌机出厂自带的 “原厂系统”上，它根本无法启动：画面、操作和内存都需要先修复。
我们把这些修复做成了一个免费的小工具 PocketKode Port Bridge。它会在掌机上完成全部设置，并把 Minecraft 加入原厂系统的 PORTS 游戏列表。Minecraft 需要你自己提供；Port Bridge 从不下载它。
测试环境： Anbernic RG40XXH（1 GB 内存）· Anbernic 原厂系统 V1.1.0 · Minecraft: Java Edition 1.12.2 · Port Bridge 1.0.0。
实验性： 可以玩，但在 1 GB 内存的掌机上并不总是流畅。请看下文的“玩得更流畅”。
你需要
- 你自己的 Minecraft: Java Edition（在 Minecraft.net 购买）以及一台装有官方 Minecraft Launcher 的电脑（Windows、macOS 或 Linux）。
- 首次启动时掌机连接可以上网的 Wi-Fi：Port Bridge 会下载 PortMaster 的组件（约 190 MB）。
- 可用空间：系统分区约 1 GB（原厂系统空间充足），SD 卡 1 上约 200 MB 用于复制。
- 把文件复制到 SD 卡 1 的方法：Wi-Fi Transfer （见通过 Wi-Fi 往原厂系统传文件）、SFTP 或读卡器。
第 1 步：在电脑上准备 Minecraft 1.12.2
移植版运行的是 1.12.2（以及 1.7.10），不是现在的 Minecraft。
- 打开官方 Minecraft Launcher，用拥有 Java Edition 的账号登录。
- 进入 安装配置 → 新建安装，选择 正式版 1.12.2，点击 创建。
- 点击一次 开始游戏，等到出现主菜单。这样会下载 1.12.2 需要的库、声音和材质。然后退出 Minecraft。
第 2 步：下载 Port Bridge 并收集你的文件
下载 PortBridge-1.0.0-stock.zip（32 KB）并解压。其中的 PC 文件夹里有一个小脚本，只收集掌机需要的 1.12.2 文件（约 180 MB：游戏本体、30 个库、声音和材质）。它只复制 Minecraft Launcher 已经放在你电脑上的文件，不下载任何东西，也不登录。
| 电脑 | 运行方法 |
|---|---|
| Windows | 右键点击 collect-minecraft.ps1 → 使用 PowerShell 运行 |
| macOS、Linux | 在终端里进入 PC 文件夹：python3 collect-minecraft.py |
它会在脚本旁边生成 minecraft-1.12.2-files.zip。如果还没安装 1.12.2，它会告诉你该怎么做。
第 3 步：把两样东西复制到 SD 卡 1
- 把 Port Bridge 压缩包里的 Roms 文件夹复制到 SD 卡 1。其中的
Roms/PORTS和Roms/APPS会并入已有的文件夹。 - 把
minecraft-1.12.2-files.zip复制到 SD 卡 1 的Roms/APPS/PortBridge。
用 Wi-Fi Transfer 时，打开 SD card 1 标签页，进入 Roms/APPS/PortBridge，点 上传文件。用 SFTP 时，文件夹是
/mnt/mmc/Roms/APPS/PortBridge。
第 4 步：启动
- 打开 Wi-Fi，在游戏列表中打开 PORTS → Minecraft。如果还看不到 PORTS，请重启掌机一次。
- 第一次会显示 Port Bridge 设置 的进度：它从 PortMaster 的官方发布下载移植版和运行环境（会校验），应用原厂系统所需的修复，创建 512 MB 额外内存（交换文件，约一分钟），并安装你的文件。之后会删除压缩包。
- 显示 Minecraft 已就绪 后，按 A。启动 Minecraft 需要 1～2 分钟。
之后，PORTS → Minecraft 会直接启动游戏。
操作
| 按键 | 动作 |
|---|---|
| 左摇杆 | 移动 |
| 右摇杆 | 转动视角，菜单中为鼠标指针 |
| A | 跳跃 |
| B | 丢弃物品 |
| X / Y | 物品栏 |
| R2 | 挖掘 / 攻击（左键） |
| L2 | 放置 / 使用（右键） |
| L1 / R1 | 快捷栏 |
| START | 暂停菜单 |
| 按住 SELECT + START 2 秒 | 退出 Minecraft |
请用 SELECT + START 退出，不要直接关机。 Minecraft 运行时会大量写入 SD 卡（交换文件）。中途关机可能损坏卡上的文件。
玩得更流畅
RG40XXH 只有 1 GB 内存，Minecraft 几乎全部占用。如果你没有设置文件就开始，Port Bridge 会写入较轻的设置。如果你带来了电脑上的设置，请在 选项 → 视频设置 中调低：
| 设置 | 值 | 原因 |
|---|---|---|
| 渲染距离 | 4～6 | 对速度和内存影响最大 |
| 图像品质 | 流畅 | 树叶、水和阴影更简单 |
| 平滑光照 | 关 | 每个方块都省一些计算 |
| Mipmap 级别 | 关 | 材质占用更少内存 |
| 最大帧率 | 30 | 帧率稳定，不忽高忽低 |
| 云 | 关 | 少画一些东西 |
有农场和大量动物的大世界会更慢；在出生点附近的新世界里玩最流畅。
遇到问题时
- 设置提示未完成： 通常是 Wi-Fi 没有网络。打开 Wi-Fi 后再次打开 PORTS → Minecraft，它会从中断处继续。详情在
Roms/APPS/PortBridge/setup.log。 - “还差一步：你的 Minecraft 文件”： 设置没有找到
minecraft-1.12.2-files.zip。请确认它在Roms/APPS/PortBridge里（名字完全一致）。 - Minecraft 玩一会儿就关闭： 调低渲染距离（见上文）。日志：
/roms/pk-minecraft/ports/minecraftjava/app.log和log.txt（通过 SFTP）。 - 什么都启动不了，其他应用也不行： 可能是在写入时关机，导致系统分区变成只读。检查文件系统即可修复；请发邮件给我们，我们会帮忙。
卸载方法：从 SD 卡 1 删除 Roms/PORTS/Minecraft.sh、Roms/PORTS/Imgs/Minecraft.png 和 Roms/APPS/PortBridge，并通过
SFTP 删除 /roms/pk-minecraft（你的世界存档在 /roms/pk-minecraft/ports/minecraftjava/.minecraft/saves，想保留的话请先复制）。
Port Bridge 做了哪些改动（给好奇的人）
PortMaster 的移植版是为 muOS 这类系统做的。在原厂系统上，Port Bridge 会：
- 使用它自己版本的 PortMaster
control.txt（原厂系统的文件夹、按键和 640×480 屏幕）； - 让移植版运行所在的显示层 Westonpack 使用原厂系统的 Mali 显卡驱动（系统自带的是 Ubuntu 通用图形库，无法打开屏幕）；
- 用系统里较新的 SDL 启动按键助手，让按键能传到游戏；
- 添加 512 MB 交换文件（原厂系统没有）以及 SELECT + START 退出；
- 直接启动 1.12.2，不经过 PortMaster 的启动器菜单。
它的所有文件都是开放的（MIT 许可证），就在下载包里。
致谢
Port Bridge 只是让已有的成果在原厂系统上运行。感谢 PortMaster 及其社区，以及 Minecraft 移植版的作者：Dia（移植）、 Jeod（启动器）、BinaryCounter（Westonpack 和 Crusty）、gfififid（1.12.2）、HMCL（Hello Minecraft! Launcher）和 PortMaster 的测试者们。还要感谢 ptitSeb（gl4es）和 Azul（Zulu Java）。
在用 muOS？请看在 muOS 上玩 Minecraft Java：同一个电脑脚本可以把你的文件直接复制到 muOS 的卡上。
有问题？请发邮件到 feedback@pocketkode.com。
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.（这不是 Minecraft 官方产品，未经 Mojang 或 Microsoft 认可，也与它们无关。）Minecraft 是 Mojang Synergies AB 的商标。PocketKode 与 PortMaster、Anbernic 也没有关联。