F_Replace

F_Replace -（FGO Replace）

目录

• 快速开始
  • 汉化文件更新
  • 国服使用说明
• 配置文件说明 (frep.config)
• Mod 目录结构
• 资源替换指南
  • 资源格式与优先级速查
  • 各类型替换细节说明
• 工具与扩展功能
  • 剧情文本打包工具
  • 自定义加载图像与动画
  • 剧情文本语音接口
  • 超分图集自动下载
• 常见问题 (FAQ)
• 相关链接

快速开始

汉化文件更新

方法一：游戏启动自动更新（推荐）

直接打开游戏即可自动检查并更新 mapping 仓库。

• 开启方法：在 Mod/configs/frep.config 中配置 AutoMappingDownload=1（默认 0 为关闭）。
• 忽略文件配置：如需忽略某些文件或文件夹，请自行创建 Mod/.gitignore 并自行配置，语法与 git 仓库 .gitignore 完全一致。
• 首次启用说明：首次启用会下载覆盖一次全量包，如有特殊需求请在启动游戏前提前配置好 .gitignore。

方法二：App 内自动更新

启动 App 进入主界面，模块会自动连接 GitHub 下载并增量更新汉化文件。可在右上角文件列表中勾选需忽略更新的文件或文件夹。

方法三：手动更新

1. 下载 Jekyell/mappings 仓库（日服汉化文件）的完整内容。
2. 解压并放入对应路径： /sdcard/Android/data/com.aniplex.fategrandorder/files/Mod/
3. 将 Mod 目录及其所有子文件的权限设置为 777。

国服使用说明

国服无需翻译文件，所以无需下载mapping仓库的内容。只需要开启 TextReplace、MasterDataReplace、LocalizationReplace 与 ScriptReplace 即可进行简单的文本替换。

• 替换词下载：下载 替换词文件 后放入 Mod/F_Replace 目录。
• 注意事项：FontReplace（字体替换）在国服不可用，请保持关闭（0）。

{
  "global": {
    "全局通用替换词": "替换词"
  },
  "localization": {
    "兽": "Beast"
  },
  "masterdata": {
    "MasterData替换词": "替换词"
  },
  "script": {
    "剧情替换词": "替换词"
  },
  "textreplace": {
    "界面原文": "界面替换文本"
  }
}

配置文件说明 (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         # 本地化替换文本

资源替换指南

资源格式与优先级

各类型替换细节说明

1. 从者卡面、头像与立绘

   • 通用命名规范（适用于卡面/窄卡面/头像/状态立绘）：
     • 格式：[从者 ID]@[突破数]（突破数范围 1~4，部分灵衣从 11 开始，大部分以实际id为准，灵衣的从者id可能会变）。例如：[email protected]（奥尔加玛丽满破卡面）。
     • 若还是搞不清楚怎么命名的，开启autodownload，自动下载后去autodownload文件夹看看文件是什么命名
   • CharaFigure：
     • 文件名：以实际游戏文件名为主（不适用上述通用命名规范）。
     • 特定形态：特殊立绘存放在 Figure/CharaFigure/Form/[FormID]/ 子目录中。
     • 表情锁定：放入 Figure/CharaFigure/Lock/ 的立绘将被强制锁定为默认表情，且优先读取。

2. 御主头像与立绘

   • 全局替换（最高优先级）：Figure/Master/Lock/
   • 特定礼装替换：Figure/Master/[礼装 ID]/（例如 equip00441/）
   • 文件要求：头像使用 face.mp4 或 face.png（mp4 优先）格式；主立绘为 figure.png；蒙版遮罩为 figure_a.png。

3. 模型与宝具资源

   • 战斗模型：放入 Models/ 目录，加载战斗时自动替换贴图或模型。
   • 宝具动画：放入 Np/ 目录，自动替换对应宝具文件。

4. 指令卡文本图片替换

   • 图片放在 Mod/Figure/CommandCard/
   • 示例文件：https://t.me/fgomod/830

5. 指令卡宝具文本与人物贴图替换

   • 放置路径：把需要替换的图片放在 Mod/Figure/CommandCard/NpText/ 或 Mod/Figure/CommandCard/SvtImg/ 下。

   • 自动下载配置 (frep.config)：

     • AutoCommandCardNpCardTextDownload=0：自动下载中文的宝具卡文本图像到 CommandCard/NpText/AutoDownload/ 并替换游戏的贴图，国服玩家无需开启。
     • AutoCommandCardSvtImgDownload=0：自动下载指令卡上的从者图片到 CommandCard/SvtImg/AutoDownload/，除此之外没有任何作用，仅用于调试查看一些从者名称的变体。

   • 指令卡宝具文本替换命名规范：

     • A · 标准
       • 运行时贴图名：card_servant_np
       • 本地文件：NpText/<svtId>.png
     • B · 灵基覆写
       • 运行时贴图名：405910（纯数字）
       • 本地文件：NpText/<svtId>@405910.png
     • C · 变身
       • 运行时贴图名：card_servant_np_304802
       • 本地文件：NpText/<svtId>@304802.png
     • D · 序号
       • 运行时贴图名：card_servant_np4
       • 本地文件：NpText/<svtId>@4.png

   • 示例：

     • A · 标准：打开 atlasacademy 里的一个从者详情，切换到宝具页面，右键右边的宝具卡文本，可以选择新标签打开或者复制 url，得到如 https://static.atlasacademy.io/CN/Servants/Commands/4000100/card_servant_np.png 这样的链接，4000100/card_servant_np 就是上面的游戏贴图名（运行时），命名为 4000100.png。
     • B · 灵基覆写：像水摩根两个宝具文本，第二个宝具文本为 https://static.atlasacademy.io/CN/Servants/Commands/505300/505310.png，命名为 [email protected]。

   • 指令卡人物图像替换命名规范：

   • <id>@<灵基阶段>.png

   • 由于从者id变体非常多，部分从者如圣玛修，在从者详情和战斗中的id各不相同，所以不清楚的可以开启AutoCommandCardSvtImgDownload后，去AutoDownload看实际命名

工具与扩展功能

剧情文本打包工具 (FGSB Tool)

工具下载：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 资源样例

1. 创建 Mod/Figure/Load/ 目录。
2. 放入精灵图 animation.png 及配置文件 animation.json。
3. 在 frep.config 中开启 LoadingOverlay=1 并调整位置与帧率参数。

剧情文本语音接口 (ScriptVoice)

一、文件放置

创建 Mod/ScriptVoice/ 文件夹，按剧情ID建文件夹：

Mod/ScriptVoice/
└─ 9415901010            ← 剧情ID
   ├─ 1.mp3              ← 语音文件，文件名=编号
   ├─ 2.mp3
   ├─ 3.mp3
   └─ Mapping/mapping.json   ← 映射表（也可直接放 9415901010/mapping.json，二选一）

• 语音格式支持：mp3 / wav

二、mapping.json 写法

{
  "id": "9415901010",
  "1": [ { "jp": "日文原文", "cn": "中文翻译" } ],
  "2": [ { "jp": "……", "cn": "……" } ]
}

规则：

1. 最外层的 "1"、"2"、"3" 是语音编号，必须和语音文件名对应（1.mp3、2.mp3…）。
2. 数组条数随意，键名随便起（jp、cn、en 都行，只看值不看键名），不同语言的文本都指向同一个语音，换语言不用改音频。
3. 文本必须和游戏里那句台词一字不差（含标点）。剧情里的 [r]、[charaFace] 这类控制符不用管，匹配时自动忽略所有 [] 控制符，JSON 里写干净的纯文本。

• 示例配置下载：Telegram 示例配置

超分图集自动下载

开启后，游戏在加载对应从者资源时会自动按需拉取云端超分图集。开启后建议国内用户开启梯子否则下载速度不稳定

优先级与缓存说明

常见问题 (FAQ)

相关链接

• Telegram 频道
• 模型修改参考 (models.md)