赛马娘DMM版本地化工具使用指南

一、准备工作：环境与工具就绪 🛠️

获取项目资源

请确保您的系统已安装Git工具，然后通过以下命令获取项目源代码：

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

编译环境准备

项目采用Premake构建系统，编译前需确认您的开发环境满足以下要求：

• 支持C++17的编译器（如Visual Studio 2019+、GCC 8+或Clang 7+）
• Premake5构建工具
• Windows SDK（如使用Windows系统）

二、实施步骤：从编译到部署 🚀

生成项目文件

1. 进入项目根目录
2. 运行Premake5构建脚本：

   premake5 gmake  # 或根据您的IDE选择其他生成器，如vs2019
   

   该命令会根据premake5.lua配置文件生成相应的项目文件

编译核心组件

1. 使用生成的项目文件打开工程
2. 选择"Release"配置
3. 执行编译操作，完成后将在输出目录生成以下关键文件：
   • version.dll：实现本地化功能的核心动态链接库
   • 相关配置文件和资源

文件部署流程

将编译生成的文件部署到游戏目录：

组件类型	功能说明	部署位置
核心库文件	提供本地化支持的主程序	与游戏主程序umamusume.exe同目录
配置文件	存储用户偏好设置	与游戏主程序同目录
翻译资源	包含文本翻译数据的字典文件	按配置文件中指定路径存放

三、优化配置：打造个性化体验 ⚙️

显示效果定制

通过修改配置文件实现个性化显示效果：

• 字体优化：启用replaceFont选项并指定系统中已安装的中文字体，解决可能出现的文字显示异常
• 界面缩放：调整uiScale参数值（建议范围0.8-1.2），适配不同屏幕尺寸
• 显示模式：设置autoFullscreen参数为true，让游戏根据屏幕比例自动调整显示模式

性能参数调整

针对不同硬件配置优化游戏性能：

• 帧率控制：通过maxFps参数设置帧率上限，可选择"unlimited"（无限制）或具体数值（如60、120）
• 分辨率设置：启用unlockSize选项，解除游戏原始分辨率限制，支持更高清晰度显示
• 资源加载：调整loadPriority参数优化资源加载顺序，提升游戏启动速度

调试功能配置

如需开发或问题排查，可启用以下调试功能：

• 控制台输出：设置enableConsole为true，启动游戏时将显示调试信息控制台
• 日志记录：开启enableLogger选项，系统会自动记录未翻译文本到日志文件
• 性能监控：启用showFpsCounter显示实时帧率，帮助评估性能优化效果

四、拓展应用：高级技巧与问题解决 🔍

翻译内容管理

对于希望自定义翻译或参与翻译改进的用户：

1. 启用文本记录功能，游戏运行时会将未翻译文本保存到dump.txt
2. 使用文本编辑器打开该文件，添加或修改翻译内容
3. 将更新后的文件保存为新的字典文件，并在配置中指定路径

常见问题诊断

遇到游戏启动或显示问题时，请按以下流程排查：

启动异常处理：

• 检查version.dll文件版本是否与游戏版本匹配
• 使用JSON验证工具检查config.json文件格式是否正确
• 确认所有字典文件路径配置正确且文件可访问

显示问题解决：

• 缺字问题：启用字体替换功能并尝试不同中文字体
• 乱码现象：检查字典文件编码格式是否为UTF-8
• 界面错位：调整UI缩放比例或恢复默认配置参数

配置备份与迁移

为避免因游戏更新导致配置丢失，建议：

• 定期备份config.json文件到安全位置
• 使用云存储同步配置文件，便于多设备使用
• 游戏版本更新前导出当前配置，更新后重新应用

通过以上步骤，您可以快速完成赛马娘DMM版的本地化配置，并根据个人需求优化游戏体验。建议定期查看项目更新，获取最新功能和兼容性改进。如有疑问，可参考项目中的文档或寻求社区支持。