赛马娘DMM版本地化工具完全配置指南

准备阶段：环境与资源准备

环境兼容性检查

在开始配置本地化工具前，需要确保您的系统满足以下基本要求：

系统要求	最低配置	推荐配置
操作系统	Windows 7 64位	Windows 10/11 64位
磁盘空间	1GB 可用空间	2GB 可用空间
依赖环境	Visual C++ 2019 运行库	Visual Studio 2019+（用于构建）

新手提示：如果您不确定系统是否已安装必要的运行库，可以通过"控制面板→程序和功能"查看已安装的Microsoft Visual C++ Redistributable包。

获取项目资源

获取本地化工具的源代码是配置过程的第一步：

1. 打开命令提示符（Win+R输入cmd）
2. 导航到您希望存放项目的目录
3. 执行以下命令克隆项目资源库：

   git clone --depth 1 https://gitcode.com/gh_mirrors/um/umamusume-localify
   

📌 重点：--depth 1参数可以只获取最新版本代码，显著减少下载数据量。如果后续需要更新，可以使用git pull命令。

实施阶段：工具构建与集成

项目构建流程

项目采用Premake构建系统，需要先生成可编译的项目文件：

构建流程示意图（文字描述）：

[运行premake5] → [生成项目文件] → [编译源代码] → [输出核心文件]
     ↓                ↓               ↓               ↓
  执行脚本        VS解决方案       编译过程      version.dll生成

1. 进入项目根目录，找到并双击generate.bat文件
2. 等待脚本执行完成，会在项目中生成Visual Studio解决方案
3. 使用Visual Studio打开生成的解决方案文件（.sln）
4. 选择"发布"配置，点击"生成解决方案"（快捷键Ctrl+Shift+B）

💡 技巧：如果您没有安装Visual Studio，可以使用MSBuild命令行工具进行构建，在项目目录执行：

msbuild /p:Configuration=Release /p:Platform=x64 umamusume-localify.sln

文件集成步骤

构建完成后，需要将生成的文件正确放置到游戏目录：

文件名称	功能说明	集成位置	风险提示
version.dll	本地化核心模块	游戏主目录（与umamusume.exe同目录）	错误版本可能导致游戏无法启动
config.json	功能配置文件	游戏主目录	语法错误会导致配置失效
字典文件	翻译资源包	由config.json中的path字段指定	路径错误会导致无翻译效果

🔍 检查：集成完成后应确认文件是否存在于指定位置，特别是隐藏文件可能需要开启"显示隐藏文件"选项才能看到。

优化阶段：功能配置与性能调优

基础功能配置

通过修改config.json文件可以实现基本的本地化功能：

{
  "language": "zh-CN",
  "replaceFont": true,
  "fontPath": "fonts/NotoSansCJKsc-Regular.otf",
  "uiScale": 1.0,
  "autoFullscreen": false
}

配置项	默认值	推荐值	适用场景
replaceFont	false	true	解决游戏缺字问题
uiScale	1.0	1.2	高分辨率屏幕适配
autoFullscreen	false	true	宽屏显示器用户

新手提示：修改配置文件前建议先备份原始文件，以便出现问题时可以快速恢复。

性能增强设置

针对不同硬件配置优化游戏表现：

配置项	功能说明	低端配置	高端配置
maxFps	帧率限制	60	unlimited
unlockSize	分辨率解锁	false	true
textureQuality	纹理质量	low	high

💡 技巧：对于笔记本电脑用户，建议将maxFps设置为60以平衡性能和电池续航；台式机用户可设为unlimited获得更流畅体验。

进阶阶段：高级功能与问题排查

调试与日志功能

启用高级调试功能有助于排查问题：

{
  "enableConsole": true,
  "enableLogger": true,
  "logPath": "localify_logs/",
  "logLevel": "info"
}

适用场景：

• 当翻译不生效时，开启控制台查看错误信息
• 收集未翻译文本时，启用日志记录功能
• 解决兼容性问题时，设置logLevel为"debug"获取详细日志

自定义翻译管理

对于希望个性化翻译或参与翻译改进的用户：

1. 确保配置中启用enableLogger: true
2. 运行游戏并正常游玩，未翻译文本会记录到dump.txt
3. 编辑字典文件添加新的翻译条目
4. 使用以下命令验证翻译文件格式：

   lua utils/validate_translations.lua dict/zh-CN.json
   

📌 重点：翻译文件采用JSON格式，需注意保持语法正确，键名必须与游戏内文本完全一致。

常见问题解决方案

问题现象	可能原因	解决方法
游戏启动无反应	version.dll版本不匹配	重新构建或下载对应游戏版本的文件
部分文本未翻译	字典文件路径错误	检查config.json中的path配置
游戏闪退	配置参数设置不当	删除config.json使用默认配置
字体显示异常	字体文件缺失	确保fontPath指向正确的字体文件

💡 案例分享：某用户在4K显示器上遇到UI过小问题，通过将uiScale设置为1.5并启用unlockSize: true，成功解决了显示问题，同时保持了良好的性能表现。

通过以上四个阶段的配置，您已经完成了赛马娘本地化工具的完整设置。建议定期查看项目更新，以获取最新的功能改进和兼容性修复。享受本地化的游戏体验！