joiplay 中文文档 下载 App

字体显示为方块或乱码怎么办

乱码的本质

手机上的 JoiPlay 游戏出现字体方块（□□□）或乱码，本质是游戏使用的字体在 JoiPlay 的渲染环境中不存在。常见场景：

RPG Maker 游戏字体问题

快速检查

在 PC 上能不能正常玩这个游戏？PC 上如果正常，说明游戏用的是 Windows 自带字体（比如 MS Gothic、Meiryo、SimSun 等），而手机上没有这些字体。

解决方法

  1. 确认游戏用了什么字体：在 PC 上打开游戏目录 → 有没有 Fonts/ 文件夹？如果有，里面的字体文件就是游戏指定的字体，复制出来
  2. 把字体文件传到手机：用 USB 或局域网传输，拷贝到 JoiPlay 能访问的目录
  3. 在 JoiPlay 中替换字体（取决于版本）：

常用替代字体

场景推荐字体
日文字体缺失Meiryo（明了体）、Yu Gothic（游ゴシック）、Noto Sans JP
中文字体缺失Noto Sans SC、思源黑体、微软雅黑
简繁混用Noto Sans CJK SC

这些字体可以从 adobe-fonts/source-han-sans GitHub 仓库或 Google Fonts 免费下载。

Ren'Py 游戏字体问题

Ren'Py 游戏通常在 game/ 目录下直接包含字体文件（.ttf 或 .otf），这部分 JoiPlay 会自动加载。但如果字体文件缺失或损坏，就会用默认字体显示成方块。

排查

  1. 看 game/ 目录里有没有 fonts/ 文件夹或 .ttf 文件
  2. 如果有，直接复制出来用 PC 打开验证字体文件本身没坏
  3. 如果没有，说明游戏依赖系统默认字体 → 按 RPG Maker 那套方式给手机装对应字体

全局字体重启

某些旧版本的 JoiPlay 在替换字体后需要重启 JoiPlay 进程才能生效（不是只是退出游戏重新进）。操作：

  1. 退出游戏 → 回到手机桌面
  2. 手机设置 → 应用 → JoiPlay → 强制停止
  3. 重新打开 JoiPlay → 启动游戏

不要使用字体注入工具

社区流传一些"给 JoiPlay 注入字体"的 Xposed/Frida 模块——不推荐使用：