5分钟快速上手：赛马娘汉化补丁完整使用指南

umamusume-localify是一个专为《赛马娘：Pretty Derby》DMM客户端设计的游戏本地化工具，能够实现一键汉化、帧率优化和分辨率解锁等多项功能。本指南将带你从零开始，快速掌握这款汉化补丁的使用方法。

准备工作与文件获取

首先需要获取必要的文件资源。你可以通过以下方式获取完整项目：

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

项目下载完成后，在项目根目录下你会看到完整的源代码结构和配置文件。主要包含src源码目录、deps依赖库以及premake5.lua构建脚本。

一键安装详细步骤

安装汉化补丁非常简单，只需要三个步骤：

1. 定位游戏目录：找到你的《赛马娘》游戏安装位置，通常在DMM游戏库的安装路径下

2. 复制必要文件：将编译生成的version.dll文件、config.json配置文件以及字典文件一起复制到游戏主程序umamusume.exe所在的目录

3. 启动游戏验证：双击运行游戏，如果汉化成功，你将看到中文界面

核心功能配置详解

文本本地化设置

在config.json配置文件中，你可以调整以下关键参数：

• 启用控制台：设置enableConsole为true，可以实时查看调试信息
• 日志输出：开启enableLogger选项，所有未翻译的文本将自动保存到dump.txt文件
• 字典文件路径：在dicts数组中指定你的翻译字典文件位置

性能优化配置

• 帧率限制：通过maxFps参数控制游戏帧率，-1为默认、0为无限、大于0为锁定帧数
• 分辨率解锁：设置unlockSize为true，即可使用1080p以上的高分辨率
• UI缩放调整：使用uiScale参数自定义界面元素大小

显示效果增强

• 字体替换：开启replaceFont选项，解决游戏中可能出现的缺字问题
• 自动全屏：autoFullscreen功能可根据屏幕比例自动切换全屏模式

常见问题排查指南

汉化不生效怎么办？

如果游戏启动后仍然是日文界面，请检查以下几点：

• 确认version.dll文件已正确放置在游戏目录
• 验证config.json配置文件中的字典路径是否正确
• 确保字典文件格式符合规范要求

控制台无法显示

当设置了enableConsole为true但看不到控制台窗口时：

• 尝试重新启动游戏
• 检查系统权限设置
• 以管理员身份运行游戏

高分辨率设置失败

如果无法使用1080p以上的分辨率：

• 确认unlockSize选项已设置为true
• 更新显卡驱动程序到最新版本
• 在游戏设置中手动选择更高的分辨率选项

进阶使用技巧

自定义翻译字典

你可以创建自己的翻译字典来补充官方未覆盖的文本内容。只需按照JSON格式规范编写字典文件，并在config.json中引用即可。

性能监控与优化

通过控制台输出的调试信息，你可以实时监控游戏运行状态，及时发现并解决性能瓶颈问题。

通过以上完整的配置和使用指南，相信你能够轻松掌握umamusume-localify汉化补丁的使用方法，享受更好的游戏体验。