FTB Quests Translator

🌐 FTB Quest Translator

这是一款与 FTB Quests 深度集成的客户端附属模组，可将高质量的实时任务翻译直接带入游戏。告别外部翻译工具，轻松畅玩母语版整合包！

⚠️ 作者重要通知 这款模组由一位开发者利用业余时间开发和维护。虽然我会尽力为大家带来最佳体验，但更新可能需要一些时间。

如果你遇到任何漏洞、有功能建议，或者只是想聊聊这款模组，我都很乐意听取！欢迎加入官方 

 

Discord 服务器 (discord.gg/XsZ5czhpJ8) 来反馈问题或分享意见。

 

✨ 主要功能：

• 一键翻译 — 任务界面中内置了一个无缝集成的切换按钮，无需打开繁杂的外部菜单。
• 批量翻译 — FTB Quests 侧边栏新增两个按钮，可在后台翻译整本任务书。采用智能限流队列（延迟 1.5 秒），避免 API 封禁。进度会自动保存 — 随时关闭游戏，之后再继续翻译。
• 术语表（翻译记忆） — 通过 config/tfq_glossary.json 设置不翻译的词语。非常适合让“Redstone”、“Create”或“Mekanism”等模组名称保持原样。
• 文字转语音朗读 — 翻译按钮旁的扬声器图标可使用 Google TTS 朗读任务文本。系统会根据当前视图，动态朗读原文或译文。
• 高级翻译服务 — 支持 DeepL （强烈推荐，能够保留上下文和格式）和 Google Translate。
• 原生界面配置 — 无需再手动编辑配置文件。通过 FTB Library 提供的精美界面，直接在游戏中配置 API 密钥、翻译服务和动画效果。
• 智能语言检测 — 自动检测 Minecraft 的语言设置，并据此翻译任务。
• 语言支持指示器 — 在 Minecraft 的语言选项界面中找到醒目的绿色 [T] ，即可快速确认你的语言是否受支持！
• 实时连接诊断 — 翻译按钮周围的沉浸式动态效果会在翻译服务器无法连接或 API 密钥无效时发出提示。
• 内存缓存 — 智能缓存让翻译即时显示，避免重复调用 API，节省网络流量和 API 用量。
• 仅限客户端 — 无需进行任何服务器端设置。在任何多人游戏服务器上游玩时都可以放心使用！

🎮 使用方法：

1. 打开 FTB Quests 任务书中的任意任务。
2. 点击翻译按钮，即可立即翻译该任务。
3. 再次点击即可切换回原文。
4. 使用侧边栏中的批量翻译按钮，一次性翻译整本任务书。

⚙️ 配置：

打开 FTB Quests 任务书，点击右上角的设置齿轮，即可进入游戏内配置菜单：

• 覆盖目标语言
• DeepL API 密钥
• 网络连接和切换动画
• 缓存管理和清除
• 术语表管理（config/tfq_glossary.json）

🌍 目标语言

目标语言设置使用标准 ISO 语言代码。

• `auto` 是此设置的默认值，因此大多数情况下无需手动更改。模组会自动适配你当前的 Minecraft 语言。
• 如果想强制使用特定的翻译语言，请使用手动语言代码。
• 完整的 ISO 语言代码列表可在维基百科的 ISO 639-1 页面中找到。
• 请注意，并非所有现有语言代码都受 Minecraft 或所选翻译服务提供商支持。

📋 前置要求：

• FTB Quests(NeoForge/Forge/Fabric) （必需）
• FTB Library(NeoForge/Forge/Fabric) （必需）