如何轻松实现赛马娘DMM版本地化？umamusume-localify完整使用指南

umamusume-localify是一款专为《赛马娘: Pretty Derby》DMM客户端打造的本地化补丁工具，能够帮助玩家将游戏内容转换为中文，并提供帧率限制解除、分辨率解锁等实用功能，让你的游戏体验更流畅、更符合习惯。

📋 项目基础信息概览

核心功能亮点

• 中文本地化：自动替换游戏内文本为中文显示
• 性能优化：支持帧率上限调整与分辨率解锁
• 轻量架构：纯本地运行，无需联网即可使用
• 安全可靠：开源项目，无恶意代码注入风险

技术架构组成

项目采用C++作为核心开发语言，主要模块包括：

• src/local/：本地化文本处理核心模块
• src/il2cpp/：游戏引擎交互接口
• src/logger/：运行日志记录系统
• deps/：第三方依赖库（含minhook、rapidjson等）

🔧 快速上手安装教程

一键部署步骤

1. 克隆项目仓库到本地

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

2. 运行生成脚本

   # Windows系统
   generate.bat
   

3. 将编译产物复制到游戏根目录
   • 复制src/dllproxy/生成的version.dll
   • 复制配置文件模板到游戏目录并重命名为config.json

基础配置说明

首次运行前需修改config.json基础设置：

{
  "language": "zh-CN",
  "unlockFps": true,
  "maxFps": 120,
  "unlockSize": true
}

🛠️ 常见问题解决方案

🔍 本地化文本不生效

问题表现：游戏启动后仍显示日文文本
解决流程：

1. 检查local/local.cpp是否正确编译
2. 确认配置文件中language字段设置为zh-CN
3. 验证游戏目录下是否存在完整的local/文件夹

🖥️ 分辨率解锁失败

问题表现：设置高于1080p分辨率无效果
解决步骤：

1. 确保config.json中unlockSize参数为true
2. 更新显卡驱动至最新版本
3. 检查src/hook.cpp中的窗口尺寸钩子是否正常加载

📊 帧率不稳定

优化方案：

• 在配置文件中设置合理的maxFps值（建议60-144）
• 关闭后台占用资源的程序
• 检查src/console.cpp中的性能监控输出

⚙️ 高级功能设置

自定义分辨率配置

通过修改配置文件实现2K/4K分辨率支持：

"resolution": {
  "width": 2560,
  "height": 1440,
  "windowed": false
}

日志系统使用

启用详细日志记录（默认保存在logs/目录）：

"logLevel": "verbose",
"logToFile": true

📝 使用注意事项

兼容性说明

• 支持游戏版本：v1.8.0及以上
• 操作系统要求：Windows 10/11 64位系统
• .NET运行时：需安装.NET Framework 4.8或更高版本

安全提示

• 请勿同时使用其他游戏修改工具
• 定期从官方仓库更新程序文件
• 修改配置文件前建议备份原始数据

通过本指南，你可以轻松掌握umamusume-localify的安装配置与故障排除方法，让《赛马娘》游戏体验更加本地化、个性化。如有其他问题，可查阅项目中的readme.md获取更多技术细节。