Auto Translate

自动翻译 AutoTranslate

1. 声明（重要）

1. 本 mod 为 EtG 提供对一些线上翻译 api 的支持，可以翻译游戏内文字为翻译 api 支持的语言。
2. 本 mod 的作者不收取任何费用，但是使用网络翻译 api 可能产生费用，由相应 api 的服务商收取。不是所有的翻译请求都会产生费用，多数翻译 api 有免费额度，如每月 100 万字符到 500 万字符不等，请查阅使用的 api 的定价标准。如过量使用网络翻译 api 从而产生账单，本 mod 作者不承担任何责任。
3. 使用本 mod 需要向翻译 api 服务商申请服务获得密钥，具体请查阅翻译 api 服务商的文档。
4. 本 mod 的网络请求只与相关网络翻译 api 进行，不会收集、发送或公开用户的任何信息，包括个人的翻译 api 密钥等。
5. 请从正规途径获取本 mod。请自行辨别传播的版本。
6. 本 mod 仅供学习使用。
7. 请保护好个人信息，不要将个人的网络翻译 api 密钥等信息通过手动截图、使用 mod 管理器的共享配置文件等方式进行共享，以免造成不必要的损失。
8. 使用本 mod 代表信任本 mod 并同意以上声明。

1. Declaration (Important)

1. This mod provides support for some online translation APIs in EtG, allowing in-game text to be translated into languages supported by these APIs.
2. The author of this mod does not charge any fees, but using online translation APIs may incur costs, which will be charged by the respective API service providers. Not all translation requests will incur fees; most translation APIs offer a free quota, ranging from 1 million to 5 million characters per month for example. Please refer to the pricing standards of the API you are using. If excessive use of the translation APIs results in charges, the author of this mod is not responsible.
3. To use this mod, you need to apply for a service and obtain a key from the translation API provider. Please refer to the provider's documentation for details.
4. The mod's network requests are only made to the relevant translation APIs and will not collect, transmit, or disclose any user information, including personal translation API keys.
5. Please obtain this mod through legitimate channels. Be cautious of distributed versions.
6. This mod is for learning use only.
7. Please protect your personal information and avoid sharing your translation API key through manual screenshots, shared configuration files using mod managers, etc., to prevent unnecessary losses.
8. By using this mod, you trust it and agree to the above declaration.

2. AutoTranslate 使用方式

1. 从 mod 管理器安装 AutoTranslate。
2. 第一次安装时，开启该 mod 启动一次游戏并关闭游戏。
3. 在 mod 管理器的配置中找到 AutoTranslate。
4. 在 General 选项卡中选择使用的翻译服务 api。
5. 在 General 选项卡中，设置 RegexForFullTextNeedToTranslate、RegexForEachLineNeedToTranslate 和 RegexForIgnoredSubstringWithinText。默认为中文设置，如果目标语言是中文不用修改。其他语言自行修改。
6. 在 General 选项卡中，如果你的目标语言不是中文，把 PresetTranslations 置为空，或者用你自定义的 PresetTranslations.json。
7. 在 Font 选项卡中 OverridedFont 选择需要覆盖的字体。若目标语言是为中文，设为 Chinese。其他语言自行设置。
8. 进入选择的 api 选项卡，输入该 api 需要的密钥和其他细节如源语言、目标语言等。翻译 api 需要的必选项和可选项请查阅服务商官方说明。
9. 启动游戏。

2. How to Use AutoTranslate

1. Install AutoTranslate from the mod manager.
2. When installing for the first time, launch the game with this mod enabled, then close the game.
3. In the mod manager, find AutoTranslate in the configuration settings.
4. In the General tab, select the translation service API you want to use.
5. In the General tab, Set RegexForFullTextNeedToTranslation, RegexForEachLineNedToTranslate and RegexForIgnoreDubstringWithinText. The default setting is for Chinese. If the target language is Chinese, there is no need to modify it. For other languages, please set on your own.
6. In the General tab, If your target language is not Chinese, set PresetTranslations to empty or use your custom PresetTranslations.json.
7. In the Font tab, Select the font you want to override in the OverridedFont below. If the target language is Chinese, set it as Chinese. For other languages, please modify on your own.
8. Go to the tab for the selected API, and enter the required key and other details like source language, target language, etc. For required and optional parameters for the translation API, please refer to the official documentation of the API provider.
9. Launch the game.

3. 节约翻译额度的方法

包括设置 RegexForFullTextNeedToTranslate、RegexForEachLineNeedToTranslate 和 PresetTranslations 都可以显著减少不必要的翻译。见详细说明。

3. Ways to Save Translation Quotas

Setting RegexForFullTextNeedToTranslate, RegexForEachLineNeedToTranslate, and PresetTranslations can significantly reduce unnecessary translations. Please refer to detailed description.

4. AutoTranslate 功能详细说明

命令 Command

• autotranslate save_cache \[cache_json_name\]

将翻译缓存保存为\[cache_json_name\]，默认为 CachedTranslations.json。

• autotranslate load_cache \[cache_json_name\]

加载翻译缓存自\[cache_json_name\]，默认为 CachedTranslations.json。

总体 General

1. TranslationAPI

选择使用的翻译 API。支持腾讯翻译 api、百度翻译 api 和 Microsoft Azure 翻译 api。截止 2025.1.29，三者的免费额度为 Tencent 500万字符/月、Baidu 100万字符/月、Azure 200万字符/月。详见官方说明。

1. ToggleTranslationKeyBinding

启用或关闭翻译的按键。

1. FilterForFullTextNeedToTranslate

对整个文本生效。用来筛选待翻译的文本以节省翻译额度。

1. RegexForFullTextNeedToTranslate

正则表达式，一个多行文本若匹配为真，则这个多行文本保留以待翻译。只在 FilterForFullTextNeedToTranslate 为 CustomRegex 时生效。样例 RegexForFullTextNeedToTranslate 正则表达式： ^(?!Enter the Gungeon).*$

1. FilterForEachLineNeedToTranslate

对文本的每一行生效。用来筛选待翻译的文本以节省翻译额度。

1. RegexForEachLineNeedToTranslate

正则表达式，多行文本若存在一行匹配，整个多行文本保留以待翻译。只在 FilterForEachLineNeedToTranslate 为 CustomRegex 时生效。样例 RegexForEachLineNeedToTranslate 正则表达式（适配中文）： ^(?![@#])(?=\S)(?!^[\d\p{P}]+$)(?!.*[\u4e00-\u9fa5\u3000-\u303F\uFF00-\uFFEF]).*$

1. FilterForIgnoredSubstringWithinText

用来过滤文本中需要忽略的子文本。这通常包括一些要特殊处理的贴图和转义符。

1. RegexForIgnoredSubstringWithinText

正则表达式，匹配文本中需要忽略的子文本。请使用非捕获组。只在 FilterForIgnoredSubstringWithinText 为 CustomRegex 时生效。样例 RegexForIgnoredSubstringWithinText 正则表达式（适配中文）： `(?:\[color\s+[^\]]+\])|(?:\[sprite\s+[^\]]+\])|(?:\[/color\])|(?:\{[^}]*\})|(?:\^[\w\d]{9})|(?:[\u4e00-\u9fa5\u3000-\u303F\uFF00-\uFFEF]+)|(?:]+>)|(?:)|(?:^\s*[\d\p{P}]+\s*$)|(?:[<>\[\]])|(?:@[a-fA-F0-9]{