# umamusume-localify

**Repository Path**: ManakaAo/umamusume-localify

## Basic Information

- **Project Name**: umamusume-localify
- **Description**: 赛马娘解锁帧&汉化
- **Primary Language**: Unknown
- **License**: WTFPL
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 13
- **Created**: 2022-01-08
- **Last Updated**: 2023-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 注意
- 此库复刻自github：https://github.com/GEEKiDoS/umamusume-localify
- 原作者@GEEKiDoS
- 由于长时间没有更新，现由@Minami_Chiwa自行判断接手

-  **_!由于本插件涉及到更改游戏文件，可能会有封号风险，本项目及其贡献者均与cygames无关并且不对使用该项目造成账号被ban负责，如果账号因使用此项目被ban请发issue!_** 

# 中文
## 赛马娘 (DMM版) 本地化补丁

### 使用方法:
1. 下载发行版`DMMUPD-Schinese`压缩包，将压缩包内的文件解压至游戏根目录`X:\Pretty Derby\Umamusume`
2. 启动游戏

或者

1. 将 `version.dll`（仓库version文件夹内） 和 `config.json`（仓库resources文件夹内） 以及 `config.json` 中引用的字典（仓库resources文件夹内的任意 **localized_data 文件夹**  <目前仅schinese处于更新状态>）放置于游戏根目录 `X:\Pretty Derby\Umamusume` 
2. 启动游戏

### 设置选项:
- `enableConsole` 启用用来输出调试信息的控制台 (true/false)
- `enableLogger` 将未覆盖的文本输出到 `dump.txt` (true/false)
- `dumpStaticEntries` 需要上一条启用, 在游戏启动时将游戏内硬编码的文本条目输出到 `dump.txt`
- `maxFps` 帧率限制 (-1 = 游戏原版/0 = 无限/>0 = 锁定到特定帧数)
    - 注: 垂直同步已开启
- `unlockSize` 允许游戏使用`1080p`以上的分辨率 (true/false)
- `uiScale` 自定义UI缩放
- `replaceFont` 将所有字体替换为默认字体, 解决缺字问题 (true/false)
- `autoFullscreen` 在屏幕比例对应时自动设置为全屏 (true/false)
    - 如屏幕是16:9 并且横屏，将会在横屏播放剧情/live时全屏
    - 如屏幕是9:16，将会在绝大多数情况下全屏
- `dicts` 将会读取的字典列表 (相对/绝对路径)

### 已知问题
- ~~有时候加载 yaml 时会卡住，原因不明~~ 换成了rapidjson, 再见了您内
- maxFPS设为0时可能会在LIVE中出现眼球锁死的BUG
- maxFPS过大时，部分画面会出现强烈抖动（应该是原本的镜头抖动在高帧率下被加强了）
- 剧情文本跳字时可能会出现混乱
- 观看剧情时若启用了`AUTO`（自动播放）会导致剧情快速跳过

### 如何贡献
 - 文本条目: 
    - 如要添加新条目，请先将`config.json` 内的 `enableLogger` 设置为 `true` 之后启动游戏
        - 随后未覆盖的文本会出现在 `dump.txt`
    - 部分原文本位于 `resources/original_data` 内
    - 请在汉化完条目之后将其移动到`localized_data`内并提交 Pull Reqeust
    
 - 代码
    - 想必各位都是老司机了

### `static.json`更新工具
- 目前已知游戏在更新时有可能导致`static.json`文本序号改变，需要使用以下地址的软件进行更新
- github（原作者）：https://github.com/AirJerryWhite/i18upgrade
- gitee（搬运）：https://gitee.com/Minami_Chiwa/i18upgrade


# English
## Uma Musume: Pretty Derby localify patch

##Disclaimer: 
- **_This project(and its contributors) is not related with Cygames and will not take any responsbility of possible account bans because of using this project. USE IT AT YOUR RISK._** 
- **_If your account is banned because of using this project, please open an issue about that._** 

### Usage:
1. Put `version.dll`, `config.json` and the `dicts` referenced by `config.json` near the `umamusume.exe`.
2. Launch the game

### Config:
- `enableConsole` Enable the console for printing debug infomations (true/false)
- `enableLogger` Output uncovered text entries into `dump.txt` (true/false)
- `dumpStaticEntries` Requires ^, Dump hardcoded text entries into `dump.txt`
- `maxFps` Max fps limit (-1 = Unmodified/0 = Unlimited/>0 = Lock to #fps)
    - Note: VSync is enabled
- `unlockSize` Allow game to use resolutions that bigger than `1080p` (true/false)
- `uiScale` Custom UI scale
- `replaceFont` Replace all font to default font, solves missing word issue (true/false)
- `autoFullscreen` The game will be fullscreen if screen aspect ratio is correct (true/false)
    - If screen aspect ratio is 16:9, the game will be fullscreen when playing story/live with landscape.
    - If screen aspect ratio is 9:16, the game will be fullscreen in most case.
- `dicts` A list of dicts that read by this (Path)

### Known issue
- None

# Resources
- `static.json` upgrade tool 
- github（original）：https://github.com/AirJerryWhite/i18upgrade
- gitee：https://gitee.com/Minami_Chiwa/i18upgrade

# Credits
## Translation
### Original
#### schinese
- @AirJerryWhite
- @Yaklo
- @july20026
- @RikkaTakanaishi
- @羲羲
#### tchinese
- @yotv2000tw

### Now
#### schinese
- @MinamiChiwa