自动本地化

自动本地化

让所有模组界面都以您喜欢的语言显示!

杂项

🌍 AutoLocalization Engine

让所有模组界面以您偏好的语言显示!

✨ 本模组能为您做什么

  • 🎯 母语体验 – 将所有模组界面转换为您的首选语言
  • 🔄 自动检测 – 智能发现所有需要翻译的文本内容
  • 📝 轻松翻译 – 简单文本编辑即可完成语言转换
  • 流畅性能 – 针对大量模组优化,不影响游戏体验
  • 🌐 多语言支持 – 支持您偏好的任何语言

🎯 工作原理

步骤 1:自动扫描 该模组会自动扫描所有已安装模组,找出需要翻译的文本内容。

步骤 2:生成翻译文件 系统会创建两个文件:

  • 📄 collected_items.yaml – 包含所有需要翻译的原始文本
  • 📄 translations.yaml – 在此文件中添加您的语言翻译

步骤 3:享受母语阅读 只需填写翻译内容并重启游戏,即可享受母语阅读体验!

📥 安装指南

  1. 下载 模组文件
  2. 解压 至游戏的 BepInEx/plugins 文件夹
  3. 启动 游戏
  4. 开始享受 自动本地化服务!

⚠️ 重要提示: 为获得最佳效果,请将此模组作为您的第一个插件加载。

🛠️ 使用方法

首次设置

  1. 启动游戏 – 模组会自动开始工作
  2. BepInEx/config/Autolocalization 路径下找到生成的文件
  3. 打开 translations.yaml 文件
  4. 使用格式 原始文本:翻译 添加您的翻译
  5. 保存文件并重启游戏

翻译示例

系统支持两种 YAML 文件格式,您可以使用其中任意一种:

平坦格式(简单,向后兼容)

# English to Chinese
Graphics Settings: 图形设置
Master Volume: 主音量
Enable Shadows: 启用阴影
# English to Japanese
Graphics Settings: グラフィック設定
Master Volume: マスターボリューム
Enable Shadows: シャドウを有効にする
# English to Korean
Graphics Settings: 그래픽 설정
Master Volume: 마스터 볼륨
Enable Shadows: 그림자 활성화
# English to French
Graphics Settings: Paramètres graphiques
Master Volume: Volume principal
Enable Shadows: Activer les ombres
# English to Spanish
Graphics Settings: Configuración de gráficos
Master Volume: Volumen principal
Enable Shadows: Habilitar sombras
# English to German
Graphics Settings: Grafik-Einstellungen
Master Volume: Hauptlautstärke
Enable Shadows: Schatten aktivieren
# English to Russian
Graphics Settings: Настройки графики
Master Volume: Основная громкость
Enable Shadows: Включить тени

嵌套格式(按模组 GUID 分组,推荐用于大型项目)

# Grouped by mod GUID for better organization
com.example.mod1:
  "Graphics Settings": "图形设置"
  "Master Volume": "主音量"
  "Enable Shadows": "启用阴影"
com.example.mod2:
  "Graphics Settings": "グラフィック設定"
  "Master Volume": "マスターボリューム"
  "Enable Shadows": "シャドウを有効にする"
com.example.mod3:
  "Graphics Settings": "그래픽 설정"
  "Master Volume": "마스터 볼륨"
  "Enable Shadows": "그림자 활성화"
com.example.mod4:
  "Graphics Settings": "Paramètres graphiques"
  "Master Volume": "Volume principal"
  "Enable Shadows": "Activer les ombres"
com.example.mod5:
  "Graphics Settings": "Configuración de gráficos"
  "Master Volume": "Volumen principal"
  "Enable Shadows": "Habilitar sombras"
com.example.mod6:
  "Graphics Settings": "Grafik-Einstellungen"
  "Master Volume": "Hauptlautstärke"
  "Enable Shadows": "Schatten aktivieren"
com.example.mod7:
  "Graphics Settings": "Настройки графики"
  "Master Volume": "Основная громкость"
  "Enable Shadows": "Включить тени"

💡 提示: 系统会自动检测并加载这两种格式。在管理多个模组的翻译时,使用嵌套格式可以获得更好的组织效果。

安装新模组时

  1. 新模组的文本会自动添加到收集文件中
  2. 只需在翻译文件中为新内容添加翻译
  3. 保存并重启游戏以应用更改

⚙️ 配置

您可以通过编辑 BepInEx/config/ 目录下的 .com.HsgtLgt.autolocalization.cfg 文件来配置模组行为:

收集功能开关

[Collection]
# Enable or disable the collection feature
# true = Enable collection (collects untranslated content)
# false = Disable collection (only applies existing translations, improves startup speed)
EnableCollection = true

何时禁用收集功能:

  • ✅ 所有翻译已完成
  • ✅ 希望加快游戏启动速度
  • ✅ 仅需应用现有翻译

何时启用收集功能:

  • ✅ 仍在添加新翻译
  • ✅ 想要发现模组中未翻译的新内容
  • ✅ 正在积极进行翻译工作

💡 提示: 完成翻译后,将 EnableCollection 设置为 false 可以提高游戏启动性能。

❓ 常见问题解答

问:翻译不显示,该怎么办?

  1. 确保翻译文件中的原始文本完全匹配
  2. 检查模组加载顺序
  3. 重启游戏以使翻译生效
  4. 确认文件已保存到正确的位置

问:如何确认模组正常运行? 请查看游戏日志文件,搜索与 "Autolocalization" 相关的信息以了解运行状态。

🎉 立即开始享受母语阅读!

立即安装,让所有模组以您最舒适的语言与您沟通!

“终于可以用母语浏览菜单了!” —— 满意用户

📞 需要帮助?

让语言不再成为您游戏体验的障碍!

🔧 面向模组开发者

您的模组将自动获得支持!此引擎兼容标准 BepInEx 配置系统,模组作者无需进行额外设置。

尽情享受您的个性化游戏体验吧! 🎮