赛马娘DMM版本地化工具配置全攻略

一、开发环境准备

1.1 源码获取与环境搭建

要开始使用赛马娘本地化工具，首先需要获取项目源代码并准备必要的开发环境。建议使用以下命令克隆项目仓库：

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

⚠️ 注意：确保您的系统已安装Git工具，若未安装，请先从官方渠道获取并安装适合您操作系统的Git版本。

1.2 编译环境要求

项目编译需要以下工具支持：

• C++编译器（推荐GCC 8.0+或MSVC 2019+）
• Premake5构建工具
• 支持C++17标准的开发环境

二、项目编译与构建

2.1 生成项目文件

项目采用Premake构建系统，通过以下步骤生成编译所需的项目文件：

1. 进入项目根目录
2. 执行以下命令生成项目文件：

   premake5 [action]
   

   其中[action]可根据您的开发环境选择，如vs2019、gmake等

💡 提示：若未指定action，Premake将默认生成适合当前系统的项目文件

2.2 编译核心组件

编译过程将生成项目的核心文件version.dll，这是实现本地化功能的关键组件：

1. 使用生成的项目文件打开工程
2. 选择"Release"配置
3. 执行构建命令（通常是F7或"Build Solution"）
4. 等待编译完成，成功后会在输出目录生成version.dll

三、本地化文件部署

3.1 文件部署清单

编译完成后，需要将以下文件部署到游戏目录：

文件名	功能描述	部署位置
version.dll	核心本地化模块	与游戏主程序umamusume.exe同目录
config.json	本地化配置文件	与游戏主程序同目录
字典文件	翻译文本资源	由config.json中的dictionaryPath指定

3.2 部署步骤详解

1. 定位游戏安装目录，找到umamusume.exe文件
2. 将编译生成的version.dll复制到该目录
3. 创建或获取config.json配置文件并放置在同一目录
4. 根据config.json中的配置，将字典文件放置到指定路径

⚠️ 重要：确保所有文件权限设置正确，特别是在Linux系统下需要检查执行权限

四、配置文件详解

4.1 基础配置项

config.json是控制本地化工具行为的核心配置文件，以下是关键配置项说明：

• enableLocalization (布尔值): 是否启用本地化功能，默认为true
• language (字符串): 指定目标语言，目前支持"zh-CN"(简体中文)和"zh-TW"(繁体中文)
• dictionaryPath (字符串): 翻译字典文件路径，可以是相对路径或绝对路径

4.2 显示优化配置

通过以下配置项优化游戏显示效果：

• replaceFont (布尔值): 是否替换游戏字体，解决中文显示问题
• fontPath (字符串): 自定义字体文件路径，仅在replaceFont为true时生效
• uiScale (数字): 界面缩放比例，取值范围0.8-1.5，默认1.0
• autoFullscreen (布尔值): 是否根据屏幕比例自动调整全屏模式

4.3 性能增强配置

提升游戏运行体验的高级配置：

• maxFps (数字): 帧率限制，0表示无限制，建议根据硬件配置设置为60或120
• unlockResolution (布尔值): 是否解锁分辨率限制
• targetResolution (对象): 自定义分辨率，格式为{"width": 1920, "height": 1080}

五、高级功能与优化

5.1 调试与日志功能

对于需要排查问题或进行高级配置的用户，可以启用调试功能：

• enableConsole (布尔值): 启用调试控制台，显示运行时信息
• enableLogging (布尔值): 启用日志记录功能
• logPath (字符串): 日志文件保存路径，默认为"./localify.log"

🛠️ 调试技巧：启用日志功能后，可以通过分析日志文件了解未翻译文本和潜在问题

5.2 自定义翻译管理

本地化工具支持用户自定义翻译内容：

1. 启用dumpUnlocalized配置项，游戏会将未翻译文本记录到dump.txt
2. 编辑dump.txt添加自定义翻译
3. 使用工具将自定义翻译合并到主字典文件
4. 更新config.json中的字典路径指向自定义字典

六、常见问题解决方案

6.1 启动问题排查

问题现象	可能原因	解决方法
游戏无响应	version.dll版本不兼容	重新编译或获取匹配游戏版本的DLL
配置文件错误	JSON格式错误	使用JSON验证工具检查配置文件
字典加载失败	文件路径错误	检查dictionaryPath配置是否正确

6.2 显示问题处理

遇到文本显示异常时，请按以下步骤排查：

1. 确认replaceFont已启用，且fontPath指向有效字体文件
2. 检查字典文件格式是否正确，编码是否为UTF-8
3. 尝试调整uiScale参数解决文字截断问题
4. 验证游戏版本与本地化工具版本是否匹配

🔍 提示：字体缺失是最常见的显示问题，建议使用包含完整中文字符集的字体，如微软雅黑、思源黑体等

6.3 性能优化建议

根据不同硬件配置，推荐以下优化设置：

• 低端配置：关闭unlockResolution，设置maxFps为30
• 中端配置：启用unlockResolution，设置maxFps为60
• 高端配置：启用所有增强功能，设置maxFps为120或更高

七、配置备份与更新

7.1 配置备份策略

为避免游戏更新导致配置丢失，建议定期备份：

1. 复制config.json到安全位置
2. 记录当前使用的字典文件版本
3. 备份自定义字体文件（如有）

7.2 版本更新注意事项

游戏版本更新后，建议按以下步骤操作：

1. 检查本地化工具是否有更新版本
2. 备份当前配置文件和字典
3. 重新编译或获取新版本version.dll
4. 恢复备份的配置文件，必要时调整以适应新游戏版本

通过本教程，您应该能够顺利配置和使用赛马娘DMM版本地化工具。建议定期查看项目更新，以获取最新功能和兼容性改进。如有任何问题，可以通过项目的issue系统寻求帮助。