F_Replace -（FGO Replace）
目录
快速开始
汉化文件更新
方法一：游戏启动自动更新（推荐）
直接打开游戏即可自动检查并更新 mapping 仓库。
- 开启方法：在
Mod/configs/frep.config 中配置 AutoMappingDownload=1（默认 0 为关闭）。
- 忽略文件配置：如需忽略某些文件或文件夹，请自行创建
Mod/.gitignore 并自行配置，语法与 git 仓库 .gitignore 完全一致。
- 首次启用说明：首次启用会下载覆盖一次全量包，如有特殊需求请在启动游戏前提前配置好
.gitignore。
方法二：App 内自动更新
启动 App 进入主界面，模块会自动连接 GitHub 下载并增量更新汉化文件。可在右上角文件列表中勾选需忽略更新的文件或文件夹。
方法三：手动更新
- 下载 Jekyell/mappings 仓库（日服汉化文件）的完整内容。
- 解压并放入对应路径：
/sdcard/Android/data/com.aniplex.fategrandorder/files/Mod/
- 将
Mod 目录及其所有子文件的权限设置为 777。
国服使用说明
国服无需翻译文件，所以无需下载mapping仓库的内容。只需要开启 TextReplace、MasterDataReplace、LocalizationReplace 与 ScriptReplace 即可进行简单的文本替换。
- 替换词下载：下载 替换词文件 后放入
Mod/F_Replace 目录。
- 注意事项：
FontReplace（字体替换）在国服不可用，请保持关闭（0）。
💡 自定义替换词文件 anti_harmony.json 结构说明
{
"global": {
"全局通用替换词": "替换词"
},
"localization": {
"兽": "Beast"
},
"masterdata": {
"MasterData替换词": "替换词"
},
"script": {
"剧情替换词": "替换词"
},
"textreplace": {
"界面原文": "界面替换文本"
}
}
提示：textreplace覆盖面最广，会捕获当前界面上的所有文本，若不确定所属分类，直接写入 global 块即可。
配置文件说明 (frep.config)
首次启动游戏或初始化模块时，会在 Mod/configs/ 目录下生成 frep.config 配置文件（1 为开启，0 为关闭）。
# 核心功能开关 (1=开启, 0=关闭)
FadeOptimize=1 # 淡入淡出动画渲染优化
TextReplace=1 # 通用文本替换
FaceReplace=1 # 从者头像替换
FontReplace=1 # 字体替换 (国服需设为 0)
MasterDataReplace=1 # MasterData 替换
ImageReplace=1 # 从者卡面/立绘/贴图图像替换
LocalizationReplace=1 # 本地化多语言文本替换 (Mod/LocalizationJpn.txt)
ScriptReplace=1 # 剧情文本替换
ScriptVoice=1 # 剧情文本语音播放
LoadingOverlay=1 # 自定义加载动画显示
MasterImageReplace=1 # 御主头像与立绘替换
UnlockFPS=0 # 解锁游戏帧率
# 映射仓库与超分图集按需自动下载开关 (1=开启, 0=关闭，默认 0)
AutoMappingDownload=0 # 游戏启动时自动更新 mapping 汉化仓库 (仅日服)
AutoCharaFigureDownload=0 # 从者立绘超分图集自动下载 (CharaFigure)
AutoCharaGraphDownload=0 # 从者卡面超分图集自动下载 (CharaGraph)
AutoNarrowFigureDownload=0 # 窄条头像超分图集自动下载 (NarrowFigure)
AutoFaceDownload=0 # 头像超分图集自动下载 (Face)
AutoStatusDownload=0 # 状态图超分图集自动下载 (Status)
AutoCommandCardNpCardTextDownload=0 # 自动下载中文宝具卡文本图像 (国服无需开启)
AutoCommandCardSvtImgDownload=0 # 自动下载指令卡从者贴图 (仅调试)
# 参数配置 (单位: DP, 边距可为负数)
MARGIN_RIGHT=45 # 加载图右边距
MARGIN_BOTTOM=14 # 加载图下边距
IMAGE_SIZE=150 # 加载图显示尺寸
LoadingFPS=24 # 加载图动画播放帧率
FPS=60 # 目标帧率 (UnlockFPS=1 时生效)
Mod 目录结构
各服务器与渠道服的 Mod 存放根路径：
- 日服：
/sdcard/Android/data/com.aniplex.fategrandorder/files/Mod/
- B 服：
/sdcard/Android/data/com.bilibili.fatego/files/Mod/
- 4399 渠道服：
/sdcard/Android/data/com.bilibili.fgo.m4399/files/Mod/
- 小米：
/sdcard/Android/data/com.bilibili.fgo.mi/files/Mod/
- 九游：
/sdcard/Android/data/com.bilibili.fgo.uc/files/Mod/
- 华为：
/sdcard/Android/data/com.bilibili.fgo.huawei/files/Mod/
Mod/
├── .gitignore # 自定义忽略更新文件规则 (语法与 git 一致，可选)
├── configs/
│ └── frep.config # 模块核心配置文件
├── Figure/
│ ├── CharaFigure/ # 从者立绘 (Form/ 特殊形态, Lock/ 表情锁定)
│ │ └── AutoDownload/ # 自动下载超分图集缓存
│ ├── CharaGraph/ # 从者卡面
│ │ └── AutoDownload/ # 自动下载超分图集缓存
│ ├── Faces/ # 从者头像
│ │ └── AutoDownload/ # 自动下载超分图集缓存
│ ├── NarrowFigure/ # 窄版卡面
│ │ └── AutoDownload/ # 自动下载超分图集缓存
│ ├── Status/ # 状态详情立绘
│ │ └── AutoDownload/ # 自动下载超分图集缓存
│ ├── CommandCard/ # 指令卡通用文本图片
│ │ ├── NpText/ # 宝具卡文本图片替换
│ │ │ └── AutoDownload/ # 自动下载中文宝具卡文本缓存
│ │ └── SvtImg/ # 指令卡人物贴图替换
│ │ └── AutoDownload/ # 自动下载指令卡从者贴图缓存 (仅调试)
│ ├── Load/ # 自定义加载图像与动画
│ └── Master/ # 御主头像与立绘 (Lock/ 全局锁定, equipXXXXX/ 按礼装)
├── Models/ # 从者战斗模型与贴图
├── Np/ # 从者宝具资源
├── Script/ # 单 .txt 剧情文本文件
├── ScriptBundle/ # .fgsb 剧情打包文件
├── ScriptVoice/ # 剧情文本自定义语音
└── LocalizationJpn.txt # 本地化替换文本
资源替换指南
卡面与动态卡面 (MP4/WebP) 会增加显存和内存开销。建议静态图保持原图 2 倍超分，动态卡面控制在 60 帧以内，避免引发内存溢出或闪退。
动图首次加载会在后台生成缓存，此时系统会卡顿，属于正常现象，等一段时间生成完成后会就恢复了
资源格式与优先级
| 资源类型 |
对应目录 |
支持格式 |
格式读取优先级 |
备注 |
从者卡面 (CharaGraph) |
Figure/CharaGraph/ |
.mp4, .webp, .png |
mp4 → webp → png |
- |
窄卡面 (NarrowFigure) |
Figure/NarrowFigure/ |
.mp4, .webp, .png |
mp4 → webp → png |
四角切角 |
头像 (Face) |
Figure/Faces/ |
.mp4, .webp, .png |
mp4 → webp → png |
左上+右上切角 |
状态立绘 (Status) |
Figure/Status/ |
.png, .astc, .astc.zstd |
png → astc → astc.zstd |
不支持动图 |
立绘 (CharaFigure) |
Figure/CharaFigure/ |
.png, .astc, .astc.zstd |
png → astc → astc.zstd |
不支持动图 |
各类型替换细节说明
-
从者卡面、头像与立绘
- 通用命名规范（适用于卡面/窄卡面/头像/状态立绘）：
- 格式：
[从者 ID]@[突破数]（突破数范围 1~4，部分灵衣从 11 开始，大部分以实际id为准，灵衣的从者id可能会变）。例如：[email protected]（奥尔加玛丽满破卡面）。
- 若还是搞不清楚怎么命名的，开启autodownload，自动下载后去autodownload文件夹看看文件是什么命名
- CharaFigure：
- 文件名：以实际游戏文件名为主（不适用上述通用命名规范）。
- 特定形态：特殊立绘存放在
Figure/CharaFigure/Form/[FormID]/ 子目录中。
- 表情锁定：放入
Figure/CharaFigure/Lock/ 的立绘将被强制锁定为默认表情，且优先读取。
-
御主头像与立绘
- 全局替换（最高优先级）：
Figure/Master/Lock/
- 特定礼装替换：
Figure/Master/[礼装 ID]/（例如 equip00441/）
- 文件要求：头像使用
face.mp4 或 face.png（mp4 优先）格式；主立绘为 figure.png；蒙版遮罩为 figure_a.png。
-
模型与宝具资源
- 战斗模型：放入
Models/ 目录，加载战斗时自动替换贴图或模型。
- 宝具动画：放入
Np/ 目录，自动替换对应宝具文件。
-
指令卡文本图片替换
-
指令卡宝具文本与人物贴图替换
工具与扩展功能
工具下载：FGSB Tool Releases
- 封包（目录打包为
.fgsb）：./fgsb_tool.exe pack ./剧情文件夹 20250209.fgsb
- 解包（
.fgsb 解压为目录）：./fgsb_tool.exe unpack 20250209.fgsb ./剧情文件夹
- 读取逻辑：打包文件存放在
Mod/ScriptBundle/。模块会优先读取 Mod/Script/ 下的 .txt 解压文件。推荐直接使用 App 自动拉取，非必要情况下无需使用fgsb文件。
自定义加载图像与动画
样例参考与下载：Load 资源样例
- 创建
Mod/Figure/Load/ 目录。
- 放入精灵图
animation.png 及配置文件 animation.json。
- 在
frep.config 中开启 LoadingOverlay=1 并调整位置与帧率参数。
剧情文本语音接口 (ScriptVoice)
一、文件放置
创建 Mod/ScriptVoice/ 文件夹，按剧情ID建文件夹：
Mod/ScriptVoice/
└─ 9415901010 ← 剧情ID
├─ 1.mp3 ← 语音文件，文件名=编号
├─ 2.mp3
├─ 3.mp3
└─ Mapping/mapping.json ← 映射表（也可直接放 9415901010/mapping.json，二选一）
二、mapping.json 写法
{
"id": "9415901010",
"1": [ { "jp": "日文原文", "cn": "中文翻译" } ],
"2": [ { "jp": "……", "cn": "……" } ]
}
规则：
- 最外层的
"1"、"2"、"3" 是语音编号，必须和语音文件名对应（1.mp3、2.mp3…）。
- 数组条数随意，键名随便起（
jp、cn、en 都行，只看值不看键名），不同语言的文本都指向同一个语音，换语言不用改音频。
- 文本必须和游戏里那句台词一字不差（含标点）。剧情里的
[r]、[charaFace] 这类控制符不用管，匹配时自动忽略所有 [] 控制符，JSON 里写干净的纯文本。
超分图集自动下载
开启后，游戏在加载对应从者资源时会自动按需拉取云端超分图集。开启后建议国内用户开启梯子否则下载速度不稳定
优先级与缓存说明
- 本地 MOD 优先：若本地对应目录已存在手动放置的自定义 MOD（例如
Figure/CharaGraph/[email protected]），将始终优先读取本地 MOD，不会触发该资源的自动下载，也不会被覆盖。
- 目录：自动下载的超分图集统一保存在各子目录的
AutoDownload/ 文件夹中（例如 Figure/CharaGraph/AutoDownload/），支持增量更新与网络异常自动重试。
常见问题 (FAQ)
Q: MuMu 模拟器国际版启动游戏卡死 / 闪退怎么办？
Q: AutoDownload 功能下载很慢或者下载失败怎么办？
相关链接
评论