ВЕРСИИ (42)

FTB Quests Translator 1.5.0 (2026-10-14) ADDED • New Quest Translation menu: Everything about batch translation now lives in one window that uses your quest book's FTB Quests theme (custom quest pack themes apply too). – Show translated quests: one switch at the top turns translated quests on or off. – Translate tab: pick a language and a chapter (or All chapters), press Translate. Live progress with Pause, Resume, Stop and Retry failed. – Saved tab: all saved chapter translations with search and a language filter. Tick a chapter to read it translated, untick it for the original, delete with confirmation. – Settings tab: the most used options as simple ON/OFF rows, plus a shortcut to all TFQ settings. • Translations per world: batch translations, progress and the chapter selection are stored separately for every world, server and quest pack, so different packs never mix. • Show translation when finished: newly translated chapters can switch the quest book to the translation automatically. • Auto-pause on service errors: if the translation service keeps failing (no internet, rate limit), the batch waits longer between attempts and then pauses instead of marking the rest of the queue as failed. Resume continues where it stopped. • Read aloud follows what you see: the voice reads the translation that is currently shown (batch or single quest) in its language. CHANGED • Batch translation is several times faster: small quests are packed into one request (up to 10 quests), chapter titles share that request, quests without text are skipped instantly and identical lines are sent once. The 1.5 s pause between requests is unchanged, so the translation service receives fewer requests than before. Example: 8 short quests now take about 3 s instead of 15–20 s. • DeepL: a whole quest (up to 50 lines) is sent in one request instead of one request per line. • Quest view buttons: Translate and Read aloud now sit next to FTB's pin and close buttons in the title bar. A slim extra row is used only when the quest title is very long. The quest icon is no longer hidden. • Read aloud starts playing while the audio is still loading and stops reliably when you switch quests. • Missing or outdated FTB Quests / FTB Library: Fabric shows its standard incompatible-mods screen instead of crashing. Forge and NeoForge show a window with the installed and required versions and update instructions. FIXED • Translations turned into "????" after restarting the game (Minecraft 1.20.1 and 1.20.4 on Windows): saved translations and the glossary were written in the system code page, which loses Cyrillic, Chinese, Japanese and most other scripts. All files are now saved as UTF-8, and translations that were already damaged are removed automatically so they get translated again. • "Invalid formatting! Can't nest multiple substitutes!" after translating: translators sometimes damage the mod's internal text markers (a lost brace, a Cyrillic letter, extra spaces). Markers are now repaired, and leftover braces can no longer break a quest line. • DeepL errors saved as translations: when the quota was used up, the key was wrong or DeepL was busy, the original text was stored as a finished translation and never retried. These are now reported as failures. • Unreadable Google responses saved as translations: such a response is now retried through the next connection route instead of being stored. • Batch results lost on a crash: during a long batch the cache was only written to disk after the batch ended. It is now saved at least every 5 seconds, and a crash in the middle of saving can no longer leave a broken file. • Wrong quest translated: when switching quests quickly, a late result could appear on another quest. • Corrupted config files no longer crash the game; default settings are used instead. • DeepL language codes for Chinese (Simplified and Traditional) and Norwegian. REMOVED • Old 1.4.0 batch files (ftbqt-batch-cache.json, ftbqt-batch-metadata.json, tfq_batch_progress.json, tfq_batch_selection.json) are no longer loaded because they had no world or pack identity. They stay on disk, and the Saved tab points them out. Please translate your chapters again once. • Unused code and textures from earlier versions, which makes the mod file smaller. REQUIREMENTS • 1.20.1 Fabric: FTB Quests 2001.4.2+, FTB Library 2001.2.1+ • 1.20.1 Forge: FTB Quests 2001.4.0+, FTB Library 2001.2.0+ • 1.20.4 Fabric: FTB Quests 2004.2.0+, FTB Library 2004.2.0+ • 1.20.4 NeoForge: FTB Quests 2004.2.0+, FTB Library 2004.2.1+ • 1.21.1 Fabric / NeoForge: FTB Quests 2101.1.0+, FTB Library 2101.1.1+

FTB Quests Translator 1.5.0 (2026-10-14) ADDED • New Quest Translation menu: Everything about batch translation now lives in one window that uses your quest book's FTB Quests theme (custom quest pack themes apply too). – Show translated quests: one switch at the top turns translated quests on or off. – Translate tab: pick a language and a chapter (or All chapters), press Translate. Live progress with Pause, Resume, Stop and Retry failed. – Saved tab: all saved chapter translations with search and a language filter. Tick a chapter to read it translated, untick it for the original, delete with confirmation. – Settings tab: the most used options as simple ON/OFF rows, plus a shortcut to all TFQ settings. • Translations per world: batch translations, progress and the chapter selection are stored separately for every world, server and quest pack, so different packs never mix. • Show translation when finished: newly translated chapters can switch the quest book to the translation automatically. • Auto-pause on service errors: if the translation service keeps failing (no internet, rate limit), the batch waits longer between attempts and then pauses instead of marking the rest of the queue as failed. Resume continues where it stopped. • Read aloud follows what you see: the voice reads the translation that is currently shown (batch or single quest) in its language. CHANGED • Batch translation is several times faster: small quests are packed into one request (up to 10 quests), chapter titles share that request, quests without text are skipped instantly and identical lines are sent once. The 1.5 s pause between requests is unchanged, so the translation service receives fewer requests than before. Example: 8 short quests now take about 3 s instead of 15–20 s. • DeepL: a whole quest (up to 50 lines) is sent in one request instead of one request per line. • Quest view buttons: Translate and Read aloud now sit next to FTB's pin and close buttons in the title bar. A slim extra row is used only when the quest title is very long. The quest icon is no longer hidden. • Read aloud starts playing while the audio is still loading and stops reliably when you switch quests. • Missing or outdated FTB Quests / FTB Library: Fabric shows its standard incompatible-mods screen instead of crashing. Forge and NeoForge show a window with the installed and required versions and update instructions. FIXED • Translations turned into "????" after restarting the game (Minecraft 1.20.1 and 1.20.4 on Windows): saved translations and the glossary were written in the system code page, which loses Cyrillic, Chinese, Japanese and most other scripts. All files are now saved as UTF-8, and translations that were already damaged are removed automatically so they get translated again. • "Invalid formatting! Can't nest multiple substitutes!" after translating: translators sometimes damage the mod's internal text markers (a lost brace, a Cyrillic letter, extra spaces). Markers are now repaired, and leftover braces can no longer break a quest line. • DeepL errors saved as translations: when the quota was used up, the key was wrong or DeepL was busy, the original text was stored as a finished translation and never retried. These are now reported as failures. • Unreadable Google responses saved as translations: such a response is now retried through the next connection route instead of being stored. • Batch results lost on a crash: during a long batch the cache was only written to disk after the batch ended. It is now saved at least every 5 seconds, and a crash in the middle of saving can no longer leave a broken file. • Wrong quest translated: when switching quests quickly, a late result could appear on another quest. • Corrupted config files no longer crash the game; default settings are used instead. • DeepL language codes for Chinese (Simplified and Traditional) and Norwegian. REMOVED • Old 1.4.0 batch files (ftbqt-batch-cache.json, ftbqt-batch-metadata.json, tfq_batch_progress.json, tfq_batch_selection.json) are no longer loaded because they had no world or pack identity. They stay on disk, and the Saved tab points them out. Please translate your chapters again once. • Unused code and textures from earlier versions, which makes the mod file smaller. REQUIREMENTS • 1.20.1 Fabric: FTB Quests 2001.4.2+, FTB Library 2001.2.1+ • 1.20.1 Forge: FTB Quests 2001.4.0+, FTB Library 2001.2.0+ • 1.20.4 Fabric: FTB Quests 2004.2.0+, FTB Library 2004.2.0+ • 1.20.4 NeoForge: FTB Quests 2004.2.0+, FTB Library 2004.2.1+ • 1.21.1 Fabric / NeoForge: FTB Quests 2101.1.0+, FTB Library 2101.1.1+

FTB Quests Translator 1.5.0 (2026-10-14) ADDED • New Quest Translation menu: Everything about batch translation now lives in one window that uses your quest book's FTB Quests theme (custom quest pack themes apply too). – Show translated quests: one switch at the top turns translated quests on or off. – Translate tab: pick a language and a chapter (or All chapters), press Translate. Live progress with Pause, Resume, Stop and Retry failed. – Saved tab: all saved chapter translations with search and a language filter. Tick a chapter to read it translated, untick it for the original, delete with confirmation. – Settings tab: the most used options as simple ON/OFF rows, plus a shortcut to all TFQ settings. • Translations per world: batch translations, progress and the chapter selection are stored separately for every world, server and quest pack, so different packs never mix. • Show translation when finished: newly translated chapters can switch the quest book to the translation automatically. • Auto-pause on service errors: if the translation service keeps failing (no internet, rate limit), the batch waits longer between attempts and then pauses instead of marking the rest of the queue as failed. Resume continues where it stopped. • Read aloud follows what you see: the voice reads the translation that is currently shown (batch or single quest) in its language. CHANGED • Batch translation is several times faster: small quests are packed into one request (up to 10 quests), chapter titles share that request, quests without text are skipped instantly and identical lines are sent once. The 1.5 s pause between requests is unchanged, so the translation service receives fewer requests than before. Example: 8 short quests now take about 3 s instead of 15–20 s. • DeepL: a whole quest (up to 50 lines) is sent in one request instead of one request per line. • Quest view buttons: Translate and Read aloud now sit next to FTB's pin and close buttons in the title bar. A slim extra row is used only when the quest title is very long. The quest icon is no longer hidden. • Read aloud starts playing while the audio is still loading and stops reliably when you switch quests. • Missing or outdated FTB Quests / FTB Library: Fabric shows its standard incompatible-mods screen instead of crashing. Forge and NeoForge show a window with the installed and required versions and update instructions. FIXED • Translations turned into "????" after restarting the game (Minecraft 1.20.1 and 1.20.4 on Windows): saved translations and the glossary were written in the system code page, which loses Cyrillic, Chinese, Japanese and most other scripts. All files are now saved as UTF-8, and translations that were already damaged are removed automatically so they get translated again. • "Invalid formatting! Can't nest multiple substitutes!" after translating: translators sometimes damage the mod's internal text markers (a lost brace, a Cyrillic letter, extra spaces). Markers are now repaired, and leftover braces can no longer break a quest line. • DeepL errors saved as translations: when the quota was used up, the key was wrong or DeepL was busy, the original text was stored as a finished translation and never retried. These are now reported as failures. • Unreadable Google responses saved as translations: such a response is now retried through the next connection route instead of being stored. • Batch results lost on a crash: during a long batch the cache was only written to disk after the batch ended. It is now saved at least every 5 seconds, and a crash in the middle of saving can no longer leave a broken file. • Wrong quest translated: when switching quests quickly, a late result could appear on another quest. • Corrupted config files no longer crash the game; default settings are used instead. • DeepL language codes for Chinese (Simplified and Traditional) and Norwegian. REMOVED • Old 1.4.0 batch files (ftbqt-batch-cache.json, ftbqt-batch-metadata.json, tfq_batch_progress.json, tfq_batch_selection.json) are no longer loaded because they had no world or pack identity. They stay on disk, and the Saved tab points them out. Please translate your chapters again once. • Unused code and textures from earlier versions, which makes the mod file smaller. REQUIREMENTS • 1.20.1 Fabric: FTB Quests 2001.4.2+, FTB Library 2001.2.1+ • 1.20.1 Forge: FTB Quests 2001.4.0+, FTB Library 2001.2.0+ • 1.20.4 Fabric: FTB Quests 2004.2.0+, FTB Library 2004.2.0+ • 1.20.4 NeoForge: FTB Quests 2004.2.0+, FTB Library 2004.2.1+ • 1.21.1 Fabric / NeoForge: FTB Quests 2101.1.0+, FTB Library 2101.1.1+

FTB Quests Translator 1.5.0 (2026-10-14) ADDED • New Quest Translation menu: Everything about batch translation now lives in one window that uses your quest book's FTB Quests theme (custom quest pack themes apply too). – Show translated quests: one switch at the top turns translated quests on or off. – Translate tab: pick a language and a chapter (or All chapters), press Translate. Live progress with Pause, Resume, Stop and Retry failed. – Saved tab: all saved chapter translations with search and a language filter. Tick a chapter to read it translated, untick it for the original, delete with confirmation. – Settings tab: the most used options as simple ON/OFF rows, plus a shortcut to all TFQ settings. • Translations per world: batch translations, progress and the chapter selection are stored separately for every world, server and quest pack, so different packs never mix. • Show translation when finished: newly translated chapters can switch the quest book to the translation automatically. • Auto-pause on service errors: if the translation service keeps failing (no internet, rate limit), the batch waits longer between attempts and then pauses instead of marking the rest of the queue as failed. Resume continues where it stopped. • Read aloud follows what you see: the voice reads the translation that is currently shown (batch or single quest) in its language. CHANGED • Batch translation is several times faster: small quests are packed into one request (up to 10 quests), chapter titles share that request, quests without text are skipped instantly and identical lines are sent once. The 1.5 s pause between requests is unchanged, so the translation service receives fewer requests than before. Example: 8 short quests now take about 3 s instead of 15–20 s. • DeepL: a whole quest (up to 50 lines) is sent in one request instead of one request per line. • Quest view buttons: Translate and Read aloud now sit next to FTB's pin and close buttons in the title bar. A slim extra row is used only when the quest title is very long. The quest icon is no longer hidden. • Read aloud starts playing while the audio is still loading and stops reliably when you switch quests. • Missing or outdated FTB Quests / FTB Library: Fabric shows its standard incompatible-mods screen instead of crashing. Forge and NeoForge show a window with the installed and required versions and update instructions. FIXED • Translations turned into "????" after restarting the game (Minecraft 1.20.1 and 1.20.4 on Windows): saved translations and the glossary were written in the system code page, which loses Cyrillic, Chinese, Japanese and most other scripts. All files are now saved as UTF-8, and translations that were already damaged are removed automatically so they get translated again. • "Invalid formatting! Can't nest multiple substitutes!" after translating: translators sometimes damage the mod's internal text markers (a lost brace, a Cyrillic letter, extra spaces). Markers are now repaired, and leftover braces can no longer break a quest line. • DeepL errors saved as translations: when the quota was used up, the key was wrong or DeepL was busy, the original text was stored as a finished translation and never retried. These are now reported as failures. • Unreadable Google responses saved as translations: such a response is now retried through the next connection route instead of being stored. • Batch results lost on a crash: during a long batch the cache was only written to disk after the batch ended. It is now saved at least every 5 seconds, and a crash in the middle of saving can no longer leave a broken file. • Wrong quest translated: when switching quests quickly, a late result could appear on another quest. • Corrupted config files no longer crash the game; default settings are used instead. • DeepL language codes for Chinese (Simplified and Traditional) and Norwegian. REMOVED • Old 1.4.0 batch files (ftbqt-batch-cache.json, ftbqt-batch-metadata.json, tfq_batch_progress.json, tfq_batch_selection.json) are no longer loaded because they had no world or pack identity. They stay on disk, and the Saved tab points them out. Please translate your chapters again once. • Unused code and textures from earlier versions, which makes the mod file smaller. REQUIREMENTS • 1.20.1 Fabric: FTB Quests 2001.4.2+, FTB Library 2001.2.1+ • 1.20.1 Forge: FTB Quests 2001.4.0+, FTB Library 2001.2.0+ • 1.20.4 Fabric: FTB Quests 2004.2.0+, FTB Library 2004.2.0+ • 1.20.4 NeoForge: FTB Quests 2004.2.0+, FTB Library 2004.2.1+ • 1.21.1 Fabric / NeoForge: FTB Quests 2101.1.0+, FTB Library 2101.1.1+

FTB Quests Translator 1.5.0 (2026-10-14) ADDED • New Quest Translation menu: Everything about batch translation now lives in one window that uses your quest book's FTB Quests theme (custom quest pack themes apply too). – Show translated quests: one switch at the top turns translated quests on or off. – Translate tab: pick a language and a chapter (or All chapters), press Translate. Live progress with Pause, Resume, Stop and Retry failed. – Saved tab: all saved chapter translations with search and a language filter. Tick a chapter to read it translated, untick it for the original, delete with confirmation. – Settings tab: the most used options as simple ON/OFF rows, plus a shortcut to all TFQ settings. • Translations per world: batch translations, progress and the chapter selection are stored separately for every world, server and quest pack, so different packs never mix. • Show translation when finished: newly translated chapters can switch the quest book to the translation automatically. • Auto-pause on service errors: if the translation service keeps failing (no internet, rate limit), the batch waits longer between attempts and then pauses instead of marking the rest of the queue as failed. Resume continues where it stopped. • Read aloud follows what you see: the voice reads the translation that is currently shown (batch or single quest) in its language. CHANGED • Batch translation is several times faster: small quests are packed into one request (up to 10 quests), chapter titles share that request, quests without text are skipped instantly and identical lines are sent once. The 1.5 s pause between requests is unchanged, so the translation service receives fewer requests than before. Example: 8 short quests now take about 3 s instead of 15–20 s. • DeepL: a whole quest (up to 50 lines) is sent in one request instead of one request per line. • Quest view buttons: Translate and Read aloud now sit next to FTB's pin and close buttons in the title bar. A slim extra row is used only when the quest title is very long. The quest icon is no longer hidden. • Read aloud starts playing while the audio is still loading and stops reliably when you switch quests. • Missing or outdated FTB Quests / FTB Library: Fabric shows its standard incompatible-mods screen instead of crashing. Forge and NeoForge show a window with the installed and required versions and update instructions. FIXED • Translations turned into "????" after restarting the game (Minecraft 1.20.1 and 1.20.4 on Windows): saved translations and the glossary were written in the system code page, which loses Cyrillic, Chinese, Japanese and most other scripts. All files are now saved as UTF-8, and translations that were already damaged are removed automatically so they get translated again. • "Invalid formatting! Can't nest multiple substitutes!" after translating: translators sometimes damage the mod's internal text markers (a lost brace, a Cyrillic letter, extra spaces). Markers are now repaired, and leftover braces can no longer break a quest line. • DeepL errors saved as translations: when the quota was used up, the key was wrong or DeepL was busy, the original text was stored as a finished translation and never retried. These are now reported as failures. • Unreadable Google responses saved as translations: such a response is now retried through the next connection route instead of being stored. • Batch results lost on a crash: during a long batch the cache was only written to disk after the batch ended. It is now saved at least every 5 seconds, and a crash in the middle of saving can no longer leave a broken file. • Wrong quest translated: when switching quests quickly, a late result could appear on another quest. • Corrupted config files no longer crash the game; default settings are used instead. • DeepL language codes for Chinese (Simplified and Traditional) and Norwegian. REMOVED • Old 1.4.0 batch files (ftbqt-batch-cache.json, ftbqt-batch-metadata.json, tfq_batch_progress.json, tfq_batch_selection.json) are no longer loaded because they had no world or pack identity. They stay on disk, and the Saved tab points them out. Please translate your chapters again once. • Unused code and textures from earlier versions, which makes the mod file smaller. REQUIREMENTS • 1.20.1 Fabric: FTB Quests 2001.4.2+, FTB Library 2001.2.1+ • 1.20.1 Forge: FTB Quests 2001.4.0+, FTB Library 2001.2.0+ • 1.20.4 Fabric: FTB Quests 2004.2.0+, FTB Library 2004.2.0+ • 1.20.4 NeoForge: FTB Quests 2004.2.0+, FTB Library 2004.2.1+ • 1.21.1 Fabric / NeoForge: FTB Quests 2101.1.0+, FTB Library 2101.1.1+

FTB Quests Translator 1.5.0 (2026-10-14) ADDED • New Quest Translation menu: Everything about batch translation now lives in one window that uses your quest book's FTB Quests theme (custom quest pack themes apply too). – Show translated quests: one switch at the top turns translated quests on or off. – Translate tab: pick a language and a chapter (or All chapters), press Translate. Live progress with Pause, Resume, Stop and Retry failed. – Saved tab: all saved chapter translations with search and a language filter. Tick a chapter to read it translated, untick it for the original, delete with confirmation. – Settings tab: the most used options as simple ON/OFF rows, plus a shortcut to all TFQ settings. • Translations per world: batch translations, progress and the chapter selection are stored separately for every world, server and quest pack, so different packs never mix. • Show translation when finished: newly translated chapters can switch the quest book to the translation automatically. • Auto-pause on service errors: if the translation service keeps failing (no internet, rate limit), the batch waits longer between attempts and then pauses instead of marking the rest of the queue as failed. Resume continues where it stopped. • Read aloud follows what you see: the voice reads the translation that is currently shown (batch or single quest) in its language. CHANGED • Batch translation is several times faster: small quests are packed into one request (up to 10 quests), chapter titles share that request, quests without text are skipped instantly and identical lines are sent once. The 1.5 s pause between requests is unchanged, so the translation service receives fewer requests than before. Example: 8 short quests now take about 3 s instead of 15–20 s. • DeepL: a whole quest (up to 50 lines) is sent in one request instead of one request per line. • Quest view buttons: Translate and Read aloud now sit next to FTB's pin and close buttons in the title bar. A slim extra row is used only when the quest title is very long. The quest icon is no longer hidden. • Read aloud starts playing while the audio is still loading and stops reliably when you switch quests. • Missing or outdated FTB Quests / FTB Library: Fabric shows its standard incompatible-mods screen instead of crashing. Forge and NeoForge show a window with the installed and required versions and update instructions. FIXED • Translations turned into "????" after restarting the game (Minecraft 1.20.1 and 1.20.4 on Windows): saved translations and the glossary were written in the system code page, which loses Cyrillic, Chinese, Japanese and most other scripts. All files are now saved as UTF-8, and translations that were already damaged are removed automatically so they get translated again. • "Invalid formatting! Can't nest multiple substitutes!" after translating: translators sometimes damage the mod's internal text markers (a lost brace, a Cyrillic letter, extra spaces). Markers are now repaired, and leftover braces can no longer break a quest line. • DeepL errors saved as translations: when the quota was used up, the key was wrong or DeepL was busy, the original text was stored as a finished translation and never retried. These are now reported as failures. • Unreadable Google responses saved as translations: such a response is now retried through the next connection route instead of being stored. • Batch results lost on a crash: during a long batch the cache was only written to disk after the batch ended. It is now saved at least every 5 seconds, and a crash in the middle of saving can no longer leave a broken file. • Wrong quest translated: when switching quests quickly, a late result could appear on another quest. • Corrupted config files no longer crash the game; default settings are used instead. • DeepL language codes for Chinese (Simplified and Traditional) and Norwegian. REMOVED • Old 1.4.0 batch files (ftbqt-batch-cache.json, ftbqt-batch-metadata.json, tfq_batch_progress.json, tfq_batch_selection.json) are no longer loaded because they had no world or pack identity. They stay on disk, and the Saved tab points them out. Please translate your chapters again once. • Unused code and textures from earlier versions, which makes the mod file smaller. REQUIREMENTS • 1.20.1 Fabric: FTB Quests 2001.4.2+, FTB Library 2001.2.1+ • 1.20.1 Forge: FTB Quests 2001.4.0+, FTB Library 2001.2.0+ • 1.20.4 Fabric: FTB Quests 2004.2.0+, FTB Library 2004.2.0+ • 1.20.4 NeoForge: FTB Quests 2004.2.0+, FTB Library 2004.2.1+ • 1.21.1 Fabric / NeoForge: FTB Quests 2101.1.0+, FTB Library 2101.1.1+

### Added - **Glossary (Translation Memory)**: You can now configure words to remain untranslated using `config/tfq_glossary.json`. Perfect for keeping mod names like "Redstone", "Create", or "Mekanism" in their original form. The system securely masks these words as `{{gX}}` tokens before sending them to the API, ensuring they don't break the grammatical context of the translated sentence. - **Batch Translation**: Added two new buttons to the FTB Quests sidebar. You can now translate the entire questbook in the background. The mod uses a smart rate-limiting queue (1.5s delay) to avoid IP bans from free APIs. Progress is saved to `config/tfq_batch_progress.json`, allowing you to safely close the game and resume translation later. - **Text-to-Speech (TTS) Voiceover**: Added a speaker icon next to the quest translation button. Clicking it reads the quest text aloud using Google TTS. It dynamically reads either the original English or the translated text, depending on your current view state. (Note: The icon will flash red if the language isn't supported for voiceover). - **Regional Language Mapping**: The mod now correctly maps Minecraft's regional variants (like `es_mx` or `es_ar`) to their root API languages (`es`). For Chinese, it correctly splits between Simplified (`zh-CN`) and Traditional (`zh-TW`). The `[T]` tooltip in the language menu now informs users if they are using a mapped regional variant. ### Fixed - **AUTO Provider Fallback Bug**: Fixed a critical issue where falling back from Google to MyMemory could cache garbage (`???`) if the target language wasn't actually supported by MyMemory (e.g., Kyrgyz `ky`). Added strict `supportsLanguage()` checks before fallback. - **Config UI Title**: Fixed the raw translation key `ftbquesttransl.settings` showing up as the title in the FTB Quests configuration menu. It now properly displays "FTB Quests Translator Settings" (or localized equivalents).

### Added - **Glossary (Translation Memory)**: You can now configure words to remain untranslated using `config/tfq_glossary.json`. Perfect for keeping mod names like "Redstone", "Create", or "Mekanism" in their original form. The system securely masks these words as `{{gX}}` tokens before sending them to the API, ensuring they don't break the grammatical context of the translated sentence. - **Batch Translation**: Added two new buttons to the FTB Quests sidebar. You can now translate the entire questbook in the background. The mod uses a smart rate-limiting queue (1.5s delay) to avoid IP bans from free APIs. Progress is saved to `config/tfq_batch_progress.json`, allowing you to safely close the game and resume translation later. - **Text-to-Speech (TTS) Voiceover**: Added a speaker icon next to the quest translation button. Clicking it reads the quest text aloud using Google TTS. It dynamically reads either the original English or the translated text, depending on your current view state. (Note: The icon will flash red if the language isn't supported for voiceover). - **Regional Language Mapping**: The mod now correctly maps Minecraft's regional variants (like `es_mx` or `es_ar`) to their root API languages (`es`). For Chinese, it correctly splits between Simplified (`zh-CN`) and Traditional (`zh-TW`). The `[T]` tooltip in the language menu now informs users if they are using a mapped regional variant. ### Fixed - **AUTO Provider Fallback Bug**: Fixed a critical issue where falling back from Google to MyMemory could cache garbage (`???`) if the target language wasn't actually supported by MyMemory (e.g., Kyrgyz `ky`). Added strict `supportsLanguage()` checks before fallback. - **Config UI Title**: Fixed the raw translation key `ftbquesttransl.settings` showing up as the title in the FTB Quests configuration menu. It now properly displays "FTB Quests Translator Settings" (or localized equivalents).

### Added - **Glossary (Translation Memory)**: You can now configure words to remain untranslated using `config/tfq_glossary.json`. Perfect for keeping mod names like "Redstone", "Create", or "Mekanism" in their original form. The system securely masks these words as `{{gX}}` tokens before sending them to the API, ensuring they don't break the grammatical context of the translated sentence. - **Batch Translation**: Added two new buttons to the FTB Quests sidebar. You can now translate the entire questbook in the background. The mod uses a smart rate-limiting queue (1.5s delay) to avoid IP bans from free APIs. Progress is saved to `config/tfq_batch_progress.json`, allowing you to safely close the game and resume translation later. - **Text-to-Speech (TTS) Voiceover**: Added a speaker icon next to the quest translation button. Clicking it reads the quest text aloud using Google TTS. It dynamically reads either the original English or the translated text, depending on your current view state. (Note: The icon will flash red if the language isn't supported for voiceover). - **Regional Language Mapping**: The mod now correctly maps Minecraft's regional variants (like `es_mx` or `es_ar`) to their root API languages (`es`). For Chinese, it correctly splits between Simplified (`zh-CN`) and Traditional (`zh-TW`). The `[T]` tooltip in the language menu now informs users if they are using a mapped regional variant. ### Fixed - **AUTO Provider Fallback Bug**: Fixed a critical issue where falling back from Google to MyMemory could cache garbage (`???`) if the target language wasn't actually supported by MyMemory (e.g., Kyrgyz `ky`). Added strict `supportsLanguage()` checks before fallback. - **Config UI Title**: Fixed the raw translation key `ftbquesttransl.settings` showing up as the title in the FTB Quests configuration menu. It now properly displays "FTB Quests Translator Settings" (or localized equivalents).

### Added - **Glossary (Translation Memory)**: You can now configure words to remain untranslated using `config/tfq_glossary.json`. Perfect for keeping mod names like "Redstone", "Create", or "Mekanism" in their original form. The system securely masks these words as `{{gX}}` tokens before sending them to the API, ensuring they don't break the grammatical context of the translated sentence. - **Batch Translation**: Added two new buttons to the FTB Quests sidebar. You can now translate the entire questbook in the background. The mod uses a smart rate-limiting queue (1.5s delay) to avoid IP bans from free APIs. Progress is saved to `config/tfq_batch_progress.json`, allowing you to safely close the game and resume translation later. - **Text-to-Speech (TTS) Voiceover**: Added a speaker icon next to the quest translation button. Clicking it reads the quest text aloud using Google TTS. It dynamically reads either the original English or the translated text, depending on your current view state. (Note: The icon will flash red if the language isn't supported for voiceover). - **Regional Language Mapping**: The mod now correctly maps Minecraft's regional variants (like `es_mx` or `es_ar`) to their root API languages (`es`). For Chinese, it correctly splits between Simplified (`zh-CN`) and Traditional (`zh-TW`). The `[T]` tooltip in the language menu now informs users if they are using a mapped regional variant. ### Fixed - **AUTO Provider Fallback Bug**: Fixed a critical issue where falling back from Google to MyMemory could cache garbage (`???`) if the target language wasn't actually supported by MyMemory (e.g., Kyrgyz `ky`). Added strict `supportsLanguage()` checks before fallback. - **Config UI Title**: Fixed the raw translation key `ftbquesttransl.settings` showing up as the title in the FTB Quests configuration menu. It now properly displays "FTB Quests Translator Settings" (or localized equivalents).

### Added - **Glossary (Translation Memory)**: You can now configure words to remain untranslated using `config/tfq_glossary.json`. Perfect for keeping mod names like "Redstone", "Create", or "Mekanism" in their original form. The system securely masks these words as `{{gX}}` tokens before sending them to the API, ensuring they don't break the grammatical context of the translated sentence. - **Batch Translation**: Added two new buttons to the FTB Quests sidebar. You can now translate the entire questbook in the background. The mod uses a smart rate-limiting queue (1.5s delay) to avoid IP bans from free APIs. Progress is saved to `config/tfq_batch_progress.json`, allowing you to safely close the game and resume translation later. - **Text-to-Speech (TTS) Voiceover**: Added a speaker icon next to the quest translation button. Clicking it reads the quest text aloud using Google TTS. It dynamically reads either the original English or the translated text, depending on your current view state. (Note: The icon will flash red if the language isn't supported for voiceover). - **Regional Language Mapping**: The mod now correctly maps Minecraft's regional variants (like `es_mx` or `es_ar`) to their root API languages (`es`). For Chinese, it correctly splits between Simplified (`zh-CN`) and Traditional (`zh-TW`). The `[T]` tooltip in the language menu now informs users if they are using a mapped regional variant. ### Fixed - **AUTO Provider Fallback Bug**: Fixed a critical issue where falling back from Google to MyMemory could cache garbage (`???`) if the target language wasn't actually supported by MyMemory (e.g., Kyrgyz `ky`). Added strict `supportsLanguage()` checks before fallback. - **Config UI Title**: Fixed the raw translation key `ftbquesttransl.settings` showing up as the title in the FTB Quests configuration menu. It now properly displays "FTB Quests Translator Settings" (or localized equivalents).

### Added - **Glossary (Translation Memory)**: You can now configure words to remain untranslated using `config/tfq_glossary.json`. Perfect for keeping mod names like "Redstone", "Create", or "Mekanism" in their original form. The system securely masks these words as `{{gX}}` tokens before sending them to the API, ensuring they don't break the grammatical context of the translated sentence. - **Batch Translation**: Added two new buttons to the FTB Quests sidebar. You can now translate the entire questbook in the background. The mod uses a smart rate-limiting queue (1.5s delay) to avoid IP bans from free APIs. Progress is saved to `config/tfq_batch_progress.json`, allowing you to safely close the game and resume translation later. - **Text-to-Speech (TTS) Voiceover**: Added a speaker icon next to the quest translation button. Clicking it reads the quest text aloud using Google TTS. It dynamically reads either the original English or the translated text, depending on your current view state. (Note: The icon will flash red if the language isn't supported for voiceover). - **Regional Language Mapping**: The mod now correctly maps Minecraft's regional variants (like `es_mx` or `es_ar`) to their root API languages (`es`). For Chinese, it correctly splits between Simplified (`zh-CN`) and Traditional (`zh-TW`). The `[T]` tooltip in the language menu now informs users if they are using a mapped regional variant. ### Fixed - **AUTO Provider Fallback Bug**: Fixed a critical issue where falling back from Google to MyMemory could cache garbage (`???`) if the target language wasn't actually supported by MyMemory (e.g., Kyrgyz `ky`). Added strict `supportsLanguage()` checks before fallback. - **Config UI Title**: Fixed the raw translation key `ftbquesttransl.settings` showing up as the title in the FTB Quests configuration menu. It now properly displays "FTB Quests Translator Settings" (or localized equivalents).

### Added - **DoH (DNS-over-HTTPS) Bypass Rewrite**: Completely rewrote the DoH bypass using raw SSL sockets with `InetAddress.getByAddress()`. Java automatically sets correct TLS SNI from the hostname while connecting to the DoH-resolved IP, and a manually constructed HTTP/1.1 request ensures the proper `Host` header. This enables reliable Google Translate access for users in regions with DNS-level censorship (e.g., Russia). - **Batch Translation**: All text segments (title, subtitle, description lines) are now joined with a unique separator and sent in a **single HTTP request** instead of 7+ parallel requests. Dramatically reduces API rate limiting risk and improves translation speed. - **HTML Entity Decoding**: Added `decodeHtmlEntities()` to convert API-returned HTML entities (`&quot;` → `"`, `&amp;` → `&`, `&lt;` → `<`, etc.) back to plain text before rendering. - **Format Code Sanitizer**: Added `sanitizeFormatCodes()` that strips `&` before any character that isn't a valid Minecraft formatting code, preventing "Invalid formatting!" errors in quest UI. ### Fixed - **DoH 404 Error**: The old `HttpsURLConnection`-based DoH approach returned HTTP 404 because Google's edge servers couldn't route requests from raw IP + Host header. The new raw SSL socket approach resolves this completely. - **`&quot;` Artifacts in Quest Text**: MyMemory API returns HTML-encoded responses. After the format sanitizer stripped `&` from `&quot;`, the text `quot;` remained visible. Fixed by decoding HTML entities before format sanitization. - **AUTO Provider Selecting Wrong Provider**: When switching providers in config, stale probe results incorrectly marked Google as unavailable. Now `providerAvailability` is cleared on provider change, forcing a fresh availability check. - **Google Translate JSON Parsing**: Raw SSL socket responses include chunked encoding remnants after the JSON body, causing `MalformedJsonException`. Added JSON boundary detection and lenient parsing to handle this.

### Added - **DoH (DNS-over-HTTPS) Bypass Rewrite**: Completely rewrote the DoH bypass using raw SSL sockets with `InetAddress.getByAddress()`. Java automatically sets correct TLS SNI from the hostname while connecting to the DoH-resolved IP, and a manually constructed HTTP/1.1 request ensures the proper `Host` header. This enables reliable Google Translate access for users in regions with DNS-level censorship (e.g., Russia). - **Batch Translation**: All text segments (title, subtitle, description lines) are now joined with a unique separator and sent in a **single HTTP request** instead of 7+ parallel requests. Dramatically reduces API rate limiting risk and improves translation speed. - **HTML Entity Decoding**: Added `decodeHtmlEntities()` to convert API-returned HTML entities (`&quot;` → `"`, `&amp;` → `&`, `&lt;` → `<`, etc.) back to plain text before rendering. - **Format Code Sanitizer**: Added `sanitizeFormatCodes()` that strips `&` before any character that isn't a valid Minecraft formatting code, preventing "Invalid formatting!" errors in quest UI. ### Fixed - **DoH 404 Error**: The old `HttpsURLConnection`-based DoH approach returned HTTP 404 because Google's edge servers couldn't route requests from raw IP + Host header. The new raw SSL socket approach resolves this completely. - **`&quot;` Artifacts in Quest Text**: MyMemory API returns HTML-encoded responses. After the format sanitizer stripped `&` from `&quot;`, the text `quot;` remained visible. Fixed by decoding HTML entities before format sanitization. - **AUTO Provider Selecting Wrong Provider**: When switching providers in config, stale probe results incorrectly marked Google as unavailable. Now `providerAvailability` is cleared on provider change, forcing a fresh availability check. - **Google Translate JSON Parsing**: Raw SSL socket responses include chunked encoding remnants after the JSON body, causing `MalformedJsonException`. Added JSON boundary detection and lenient parsing to handle this.

### Added - **DoH (DNS-over-HTTPS) Bypass Rewrite**: Completely rewrote the DoH bypass using raw SSL sockets with `InetAddress.getByAddress()`. Java automatically sets correct TLS SNI from the hostname while connecting to the DoH-resolved IP, and a manually constructed HTTP/1.1 request ensures the proper `Host` header. This enables reliable Google Translate access for users in regions with DNS-level censorship (e.g., Russia). - **Batch Translation**: All text segments (title, subtitle, description lines) are now joined with a unique separator and sent in a **single HTTP request** instead of 7+ parallel requests. Dramatically reduces API rate limiting risk and improves translation speed. - **HTML Entity Decoding**: Added `decodeHtmlEntities()` to convert API-returned HTML entities (`&quot;` → `"`, `&amp;` → `&`, `&lt;` → `<`, etc.) back to plain text before rendering. - **Format Code Sanitizer**: Added `sanitizeFormatCodes()` that strips `&` before any character that isn't a valid Minecraft formatting code, preventing "Invalid formatting!" errors in quest UI. ### Fixed - **DoH 404 Error**: The old `HttpsURLConnection`-based DoH approach returned HTTP 404 because Google's edge servers couldn't route requests from raw IP + Host header. The new raw SSL socket approach resolves this completely. - **`&quot;` Artifacts in Quest Text**: MyMemory API returns HTML-encoded responses. After the format sanitizer stripped `&` from `&quot;`, the text `quot;` remained visible. Fixed by decoding HTML entities before format sanitization. - **AUTO Provider Selecting Wrong Provider**: When switching providers in config, stale probe results incorrectly marked Google as unavailable. Now `providerAvailability` is cleared on provider change, forcing a fresh availability check. - **Google Translate JSON Parsing**: Raw SSL socket responses include chunked encoding remnants after the JSON body, causing `MalformedJsonException`. Added JSON boundary detection and lenient parsing to handle this.

### Added - **DoH (DNS-over-HTTPS) Bypass Rewrite**: Completely rewrote the DoH bypass using raw SSL sockets with `InetAddress.getByAddress()`. Java automatically sets correct TLS SNI from the hostname while connecting to the DoH-resolved IP, and a manually constructed HTTP/1.1 request ensures the proper `Host` header. This enables reliable Google Translate access for users in regions with DNS-level censorship (e.g., Russia). - **Batch Translation**: All text segments (title, subtitle, description lines) are now joined with a unique separator and sent in a **single HTTP request** instead of 7+ parallel requests. Dramatically reduces API rate limiting risk and improves translation speed. - **HTML Entity Decoding**: Added `decodeHtmlEntities()` to convert API-returned HTML entities (`&quot;` → `"`, `&amp;` → `&`, `&lt;` → `<`, etc.) back to plain text before rendering. - **Format Code Sanitizer**: Added `sanitizeFormatCodes()` that strips `&` before any character that isn't a valid Minecraft formatting code, preventing "Invalid formatting!" errors in quest UI. ### Fixed - **DoH 404 Error**: The old `HttpsURLConnection`-based DoH approach returned HTTP 404 because Google's edge servers couldn't route requests from raw IP + Host header. The new raw SSL socket approach resolves this completely. - **`&quot;` Artifacts in Quest Text**: MyMemory API returns HTML-encoded responses. After the format sanitizer stripped `&` from `&quot;`, the text `quot;` remained visible. Fixed by decoding HTML entities before format sanitization. - **AUTO Provider Selecting Wrong Provider**: When switching providers in config, stale probe results incorrectly marked Google as unavailable. Now `providerAvailability` is cleared on provider change, forcing a fresh availability check. - **Google Translate JSON Parsing**: Raw SSL socket responses include chunked encoding remnants after the JSON body, causing `MalformedJsonException`. Added JSON boundary detection and lenient parsing to handle this.

### Added - **DoH (DNS-over-HTTPS) Bypass Rewrite**: Completely rewrote the DoH bypass using raw SSL sockets with `InetAddress.getByAddress()`. Java automatically sets correct TLS SNI from the hostname while connecting to the DoH-resolved IP, and a manually constructed HTTP/1.1 request ensures the proper `Host` header. This enables reliable Google Translate access for users in regions with DNS-level censorship (e.g., Russia). - **Batch Translation**: All text segments (title, subtitle, description lines) are now joined with a unique separator and sent in a **single HTTP request** instead of 7+ parallel requests. Dramatically reduces API rate limiting risk and improves translation speed. - **HTML Entity Decoding**: Added `decodeHtmlEntities()` to convert API-returned HTML entities (`&quot;` → `"`, `&amp;` → `&`, `&lt;` → `<`, etc.) back to plain text before rendering. - **Format Code Sanitizer**: Added `sanitizeFormatCodes()` that strips `&` before any character that isn't a valid Minecraft formatting code, preventing "Invalid formatting!" errors in quest UI. ### Fixed - **DoH 404 Error**: The old `HttpsURLConnection`-based DoH approach returned HTTP 404 because Google's edge servers couldn't route requests from raw IP + Host header. The new raw SSL socket approach resolves this completely. - **`&quot;` Artifacts in Quest Text**: MyMemory API returns HTML-encoded responses. After the format sanitizer stripped `&` from `&quot;`, the text `quot;` remained visible. Fixed by decoding HTML entities before format sanitization. - **AUTO Provider Selecting Wrong Provider**: When switching providers in config, stale probe results incorrectly marked Google as unavailable. Now `providerAvailability` is cleared on provider change, forcing a fresh availability check. - **Google Translate JSON Parsing**: Raw SSL socket responses include chunked encoding remnants after the JSON body, causing `MalformedJsonException`. Added JSON boundary detection and lenient parsing to handle this.

### Added - **DoH (DNS-over-HTTPS) Bypass Rewrite**: Completely rewrote the DoH bypass using raw SSL sockets with `InetAddress.getByAddress()`. Java automatically sets correct TLS SNI from the hostname while connecting to the DoH-resolved IP, and a manually constructed HTTP/1.1 request ensures the proper `Host` header. This enables reliable Google Translate access for users in regions with DNS-level censorship (e.g., Russia). - **Batch Translation**: All text segments (title, subtitle, description lines) are now joined with a unique separator and sent in a **single HTTP request** instead of 7+ parallel requests. Dramatically reduces API rate limiting risk and improves translation speed. - **HTML Entity Decoding**: Added `decodeHtmlEntities()` to convert API-returned HTML entities (`&quot;` → `"`, `&amp;` → `&`, `&lt;` → `<`, etc.) back to plain text before rendering. - **Format Code Sanitizer**: Added `sanitizeFormatCodes()` that strips `&` before any character that isn't a valid Minecraft formatting code, preventing "Invalid formatting!" errors in quest UI. ### Fixed - **DoH 404 Error**: The old `HttpsURLConnection`-based DoH approach returned HTTP 404 because Google's edge servers couldn't route requests from raw IP + Host header. The new raw SSL socket approach resolves this completely. - **`&quot;` Artifacts in Quest Text**: MyMemory API returns HTML-encoded responses. After the format sanitizer stripped `&` from `&quot;`, the text `quot;` remained visible. Fixed by decoding HTML entities before format sanitization. - **AUTO Provider Selecting Wrong Provider**: When switching providers in config, stale probe results incorrectly marked Google as unavailable. Now `providerAvailability` is cleared on provider change, forcing a fresh availability check. - **Google Translate JSON Parsing**: Raw SSL socket responses include chunked encoding remnants after the JSON body, causing `MalformedJsonException`. Added JSON boundary detection and lenient parsing to handle this.

### Fixed - **API Formatting Errors**: Fixed issue where manually entering target language variants (like `uk_ua` or `en_us`) crashed the DeepL integration by converting underscores `_` to proper hyphens `-`. - **MyMemory Language**: Enforced uniform `Autodetect` for MyMemory translation endpoint structure. - **Cache Efficiency**: Unchanged words (e.g., untranslatable nouns) are now cleanly cached locally. The mod will no longer relentlessly query translation APIs for words that remain identically translated. - **Text Skipping**: Removed faulty regex behavior that incorrectly skipped formatting boundaries around `{image}` macro insertions. - **DeepL Config Security**: Re-engineered the translation settings. The DeepL API token is uncoupled from shared files and strictly stored within the `local/ftbquesttranslator-secrets.json` dictionary. - **Translation Deadlock**: Added `.exceptionally()` handler to the async translation pipeline. Previously, if a background HTTP thread crashed with an unrecoverable `Error`, the `isTranslating` flag would stay `true` forever, permanently disabling the translate button until game restart. - **Bracket Text Not Translated**: Fixed `shouldSkipLine()` falsely skipping regular quest text wrapped in brackets like `[Warning: do not press!]`. The check now validates whether the content is actual JSON before skipping, instead of naively checking for `[` and `]` delimiters. - **Cache Poisoning**: Translation results are now validated before caching. When the API returns the original text unchanged (e.g. on error or rate limit), it is no longer permanently saved as a "successful translation" in the cache. - **Cache Loss on Exit**: Added a JVM shutdown hook to flush the translation cache to disk when the game exits. Previously, translations made within the last 5 seconds before closing could be silently lost.

### Fixed - **API Formatting Errors**: Fixed issue where manually entering target language variants (like `uk_ua` or `en_us`) crashed the DeepL integration by converting underscores `_` to proper hyphens `-`. - **MyMemory Language**: Enforced uniform `Autodetect` for MyMemory translation endpoint structure. - **Cache Efficiency**: Unchanged words (e.g., untranslatable nouns) are now cleanly cached locally. The mod will no longer relentlessly query translation APIs for words that remain identically translated. - **Text Skipping**: Removed faulty regex behavior that incorrectly skipped formatting boundaries around `{image}` macro insertions. - **DeepL Config Security**: Re-engineered the translation settings. The DeepL API token is uncoupled from shared files and strictly stored within the `local/ftbquesttranslator-secrets.json` dictionary. - **Translation Deadlock**: Added `.exceptionally()` handler to the async translation pipeline. Previously, if a background HTTP thread crashed with an unrecoverable `Error`, the `isTranslating` flag would stay `true` forever, permanently disabling the translate button until game restart. - **Bracket Text Not Translated**: Fixed `shouldSkipLine()` falsely skipping regular quest text wrapped in brackets like `[Warning: do not press!]`. The check now validates whether the content is actual JSON before skipping, instead of naively checking for `[` and `]` delimiters. - **Cache Poisoning**: Translation results are now validated before caching. When the API returns the original text unchanged (e.g. on error or rate limit), it is no longer permanently saved as a "successful translation" in the cache. - **Cache Loss on Exit**: Added a JVM shutdown hook to flush the translation cache to disk when the game exits. Previously, translations made within the last 5 seconds before closing could be silently lost.

### Fixed - **API Formatting Errors**: Fixed issue where manually entering target language variants (like `uk_ua` or `en_us`) crashed the DeepL integration by converting underscores `_` to proper hyphens `-`. - **MyMemory Language**: Enforced uniform `Autodetect` for MyMemory translation endpoint structure. - **Cache Efficiency**: Unchanged words (e.g., untranslatable nouns) are now cleanly cached locally. The mod will no longer relentlessly query translation APIs for words that remain identically translated. - **Text Skipping**: Removed faulty regex behavior that incorrectly skipped formatting boundaries around `{image}` macro insertions. - **DeepL Config Security**: Re-engineered the translation settings. The DeepL API token is uncoupled from shared files and strictly stored within the `local/ftbquesttranslator-secrets.json` dictionary. - **Translation Deadlock**: Added `.exceptionally()` handler to the async translation pipeline. Previously, if a background HTTP thread crashed with an unrecoverable `Error`, the `isTranslating` flag would stay `true` forever, permanently disabling the translate button until game restart. - **Bracket Text Not Translated**: Fixed `shouldSkipLine()` falsely skipping regular quest text wrapped in brackets like `[Warning: do not press!]`. The check now validates whether the content is actual JSON before skipping, instead of naively checking for `[` and `]` delimiters. - **Cache Poisoning**: Translation results are now validated before caching. When the API returns the original text unchanged (e.g. on error or rate limit), it is no longer permanently saved as a "successful translation" in the cache. - **Cache Loss on Exit**: Added a JVM shutdown hook to flush the translation cache to disk when the game exits. Previously, translations made within the last 5 seconds before closing could be silently lost.

### Fixed - **API Formatting Errors**: Fixed issue where manually entering target language variants (like `uk_ua` or `en_us`) crashed the DeepL integration by converting underscores `_` to proper hyphens `-`. - **MyMemory Language**: Enforced uniform `Autodetect` for MyMemory translation endpoint structure. - **Cache Efficiency**: Unchanged words (e.g., untranslatable nouns) are now cleanly cached locally. The mod will no longer relentlessly query translation APIs for words that remain identically translated. - **Text Skipping**: Removed faulty regex behavior that incorrectly skipped formatting boundaries around `{image}` macro insertions. - **DeepL Config Security**: Re-engineered the translation settings. The DeepL API token is uncoupled from shared files and strictly stored within the `local/ftbquesttranslator-secrets.json` dictionary. - **Translation Deadlock**: Added `.exceptionally()` handler to the async translation pipeline. Previously, if a background HTTP thread crashed with an unrecoverable `Error`, the `isTranslating` flag would stay `true` forever, permanently disabling the translate button until game restart. - **Bracket Text Not Translated**: Fixed `shouldSkipLine()` falsely skipping regular quest text wrapped in brackets like `[Warning: do not press!]`. The check now validates whether the content is actual JSON before skipping, instead of naively checking for `[` and `]` delimiters. - **Cache Poisoning**: Translation results are now validated before caching. When the API returns the original text unchanged (e.g. on error or rate limit), it is no longer permanently saved as a "successful translation" in the cache. - **Cache Loss on Exit**: Added a JVM shutdown hook to flush the translation cache to disk when the game exits. Previously, translations made within the last 5 seconds before closing could be silently lost.

### Fixed - **API Formatting Errors**: Fixed issue where manually entering target language variants (like `uk_ua` or `en_us`) crashed the DeepL integration by converting underscores `_` to proper hyphens `-`. - **MyMemory Language**: Enforced uniform `Autodetect` for MyMemory translation endpoint structure. - **Cache Efficiency**: Unchanged words (e.g., untranslatable nouns) are now cleanly cached locally. The mod will no longer relentlessly query translation APIs for words that remain identically translated. - **Text Skipping**: Removed faulty regex behavior that incorrectly skipped formatting boundaries around `{image}` macro insertions. - **DeepL Config Security**: Re-engineered the translation settings. The DeepL API token is uncoupled from shared files and strictly stored within the `local/ftbquesttranslator-secrets.json` dictionary. - **Translation Deadlock**: Added `.exceptionally()` handler to the async translation pipeline. Previously, if a background HTTP thread crashed with an unrecoverable `Error`, the `isTranslating` flag would stay `true` forever, permanently disabling the translate button until game restart. - **Bracket Text Not Translated**: Fixed `shouldSkipLine()` falsely skipping regular quest text wrapped in brackets like `[Warning: do not press!]`. The check now validates whether the content is actual JSON before skipping, instead of naively checking for `[` and `]` delimiters. - **Cache Poisoning**: Translation results are now validated before caching. When the API returns the original text unchanged (e.g. on error or rate limit), it is no longer permanently saved as a "successful translation" in the cache. - **Cache Loss on Exit**: Added a JVM shutdown hook to flush the translation cache to disk when the game exits. Previously, translations made within the last 5 seconds before closing could be silently lost.

### Fixed - **API Formatting Errors**: Fixed issue where manually entering target language variants (like `uk_ua` or `en_us`) crashed the DeepL integration by converting underscores `_` to proper hyphens `-`. - **MyMemory Language**: Enforced uniform `Autodetect` for MyMemory translation endpoint structure. - **Cache Efficiency**: Unchanged words (e.g., untranslatable nouns) are now cleanly cached locally. The mod will no longer relentlessly query translation APIs for words that remain identically translated. - **Text Skipping**: Removed faulty regex behavior that incorrectly skipped formatting boundaries around `{image}` macro insertions. - **DeepL Config Security**: Re-engineered the translation settings. The DeepL API token is uncoupled from shared files and strictly stored within the `local/ftbquesttranslator-secrets.json` dictionary. - **Translation Deadlock**: Added `.exceptionally()` handler to the async translation pipeline. Previously, if a background HTTP thread crashed with an unrecoverable `Error`, the `isTranslating` flag would stay `true` forever, permanently disabling the translate button until game restart. - **Bracket Text Not Translated**: Fixed `shouldSkipLine()` falsely skipping regular quest text wrapped in brackets like `[Warning: do not press!]`. The check now validates whether the content is actual JSON before skipping, instead of naively checking for `[` and `]` delimiters. - **Cache Poisoning**: Translation results are now validated before caching. When the API returns the original text unchanged (e.g. on error or rate limit), it is no longer permanently saved as a "successful translation" in the cache. - **Cache Loss on Exit**: Added a JVM shutdown hook to flush the translation cache to disk when the game exits. Previously, translations made within the last 5 seconds before closing could be silently lost.

### Added - **In-Game Configuration Menu**: Integrated a brand new "Translation Settings" button into the top right of the FTB Quests book. Players can now seamlessly customize their target language, translation provider (Google/MyMemory/DeepL), edit DeepL API keys, and toggle animation settings directly in-game without touching config files. - **One-Click Cache Clear**: Added a dedicated trash can button next to the settings gear. It instantly flushes all saved translation caches from memory and disk. - **Universal Backports**: Achieved 100% feature-parity by completely backporting the mod to **Minecraft 1.20.1 and 1.20.4** across both Fabric and Forge/NeoForge! ### Fixed - **Instant Connection Resets**: Changing the translation provider or API key in the new settings UI now immediately resets strict background connection lockouts, eliminating fake "Server Unavailable" errors. - **API Rate Limiting**: The background connection check no longer forcefully pings APIs every time the UI is resized or rebuilt. Added a 2-minute cooldown cache to protect against temporary rate-limit bans from Google/DeepL. - **Micro-stutters**: The translation engine now delegates HTTP requests to an isolated thread pool with background priorities. Previous versions accidentally shared Minecraft's internal `commonPool`, which could momentarily starve rendering and chunk loading loops. - **Cache Data Loss**: Rebuilt the Translation Cache with disk persistence (`ftbqt-cache.json`). The mod now asynchronously saves translations back to disk 5 seconds after translating, preventing wasted DeepL quotas on game restarts. - **Memory Leaks**: Refactored Translate Providers into strict Singleton patterns, eliminating thousands of pointless object instantiations when traversing quests.

### Added - **In-Game Configuration Menu**: Integrated a brand new "Translation Settings" button into the top right of the FTB Quests book. Players can now seamlessly customize their target language, translation provider (Google/MyMemory/DeepL), edit DeepL API keys, and toggle animation settings directly in-game without touching config files. - **One-Click Cache Clear**: Added a dedicated trash can button next to the settings gear. It instantly flushes all saved translation caches from memory and disk. - **Universal Backports**: Achieved 100% feature-parity by completely backporting the mod to **Minecraft 1.20.1 and 1.20.4** across both Fabric and Forge/NeoForge! ### Fixed - **Instant Connection Resets**: Changing the translation provider or API key in the new settings UI now immediately resets strict background connection lockouts, eliminating fake "Server Unavailable" errors. - **API Rate Limiting**: The background connection check no longer forcefully pings APIs every time the UI is resized or rebuilt. Added a 2-minute cooldown cache to protect against temporary rate-limit bans from Google/DeepL. - **Micro-stutters**: The translation engine now delegates HTTP requests to an isolated thread pool with background priorities. Previous versions accidentally shared Minecraft's internal `commonPool`, which could momentarily starve rendering and chunk loading loops. - **Cache Data Loss**: Rebuilt the Translation Cache with disk persistence (`ftbqt-cache.json`). The mod now asynchronously saves translations back to disk 5 seconds after translating, preventing wasted DeepL quotas on game restarts. - **Memory Leaks**: Refactored Translate Providers into strict Singleton patterns, eliminating thousands of pointless object instantiations when traversing quests.

### Added - **In-Game Configuration Menu**: Integrated a brand new "Translation Settings" button into the top right of the FTB Quests book. Players can now seamlessly customize their target language, translation provider (Google/MyMemory/DeepL), edit DeepL API keys, and toggle animation settings directly in-game without touching config files. - **One-Click Cache Clear**: Added a dedicated trash can button next to the settings gear. It instantly flushes all saved translation caches from memory and disk. - **Universal Backports**: Achieved 100% feature-parity by completely backporting the mod to **Minecraft 1.20.1 and 1.20.4** across both Fabric and Forge/NeoForge! ### Fixed - **Instant Connection Resets**: Changing the translation provider or API key in the new settings UI now immediately resets strict background connection lockouts, eliminating fake "Server Unavailable" errors. - **API Rate Limiting**: The background connection check no longer forcefully pings APIs every time the UI is resized or rebuilt. Added a 2-minute cooldown cache to protect against temporary rate-limit bans from Google/DeepL. - **Micro-stutters**: The translation engine now delegates HTTP requests to an isolated thread pool with background priorities. Previous versions accidentally shared Minecraft's internal `commonPool`, which could momentarily starve rendering and chunk loading loops. - **Cache Data Loss**: Rebuilt the Translation Cache with disk persistence (`ftbqt-cache.json`). The mod now asynchronously saves translations back to disk 5 seconds after translating, preventing wasted DeepL quotas on game restarts. - **Memory Leaks**: Refactored Translate Providers into strict Singleton patterns, eliminating thousands of pointless object instantiations when traversing quests.

### Added - **In-Game Configuration Menu**: Integrated a brand new "Translation Settings" button into the top right of the FTB Quests book. Players can now seamlessly customize their target language, translation provider (Google/MyMemory/DeepL), edit DeepL API keys, and toggle animation settings directly in-game without touching config files. - **One-Click Cache Clear**: Added a dedicated trash can button next to the settings gear. It instantly flushes all saved translation caches from memory and disk. - **Universal Backports**: Achieved 100% feature-parity by completely backporting the mod to **Minecraft 1.20.1 and 1.20.4** across both Fabric and Forge/NeoForge! ### Fixed - **Instant Connection Resets**: Changing the translation provider or API key in the new settings UI now immediately resets strict background connection lockouts, eliminating fake "Server Unavailable" errors. - **API Rate Limiting**: The background connection check no longer forcefully pings APIs every time the UI is resized or rebuilt. Added a 2-minute cooldown cache to protect against temporary rate-limit bans from Google/DeepL. - **Micro-stutters**: The translation engine now delegates HTTP requests to an isolated thread pool with background priorities. Previous versions accidentally shared Minecraft's internal `commonPool`, which could momentarily starve rendering and chunk loading loops. - **Cache Data Loss**: Rebuilt the Translation Cache with disk persistence (`ftbqt-cache.json`). The mod now asynchronously saves translations back to disk 5 seconds after translating, preventing wasted DeepL quotas on game restarts. - **Memory Leaks**: Refactored Translate Providers into strict Singleton patterns, eliminating thousands of pointless object instantiations when traversing quests.

### Added - **In-Game Configuration Menu**: Integrated a brand new "Translation Settings" button into the top right of the FTB Quests book. Players can now seamlessly customize their target language, translation provider (Google/MyMemory/DeepL), edit DeepL API keys, and toggle animation settings directly in-game without touching config files. - **One-Click Cache Clear**: Added a dedicated trash can button next to the settings gear. It instantly flushes all saved translation caches from memory and disk. - **Universal Backports**: Achieved 100% feature-parity by completely backporting the mod to **Minecraft 1.20.1 and 1.20.4** across both Fabric and Forge/NeoForge! ### Fixed - **Instant Connection Resets**: Changing the translation provider or API key in the new settings UI now immediately resets strict background connection lockouts, eliminating fake "Server Unavailable" errors. - **API Rate Limiting**: The background connection check no longer forcefully pings APIs every time the UI is resized or rebuilt. Added a 2-minute cooldown cache to protect against temporary rate-limit bans from Google/DeepL. - **Micro-stutters**: The translation engine now delegates HTTP requests to an isolated thread pool with background priorities. Previous versions accidentally shared Minecraft's internal `commonPool`, which could momentarily starve rendering and chunk loading loops. - **Cache Data Loss**: Rebuilt the Translation Cache with disk persistence (`ftbqt-cache.json`). The mod now asynchronously saves translations back to disk 5 seconds after translating, preventing wasted DeepL quotas on game restarts. - **Memory Leaks**: Refactored Translate Providers into strict Singleton patterns, eliminating thousands of pointless object instantiations when traversing quests.

### Added - **In-Game Configuration Menu**: Integrated a brand new "Translation Settings" button into the top right of the FTB Quests book. Players can now seamlessly customize their target language, translation provider (Google/MyMemory/DeepL), edit DeepL API keys, and toggle animation settings directly in-game without touching config files. - **One-Click Cache Clear**: Added a dedicated trash can button next to the settings gear. It instantly flushes all saved translation caches from memory and disk. - **Universal Backports**: Achieved 100% feature-parity by completely backporting the mod to **Minecraft 1.20.1 and 1.20.4** across both Fabric and Forge/NeoForge! ### Fixed - **Instant Connection Resets**: Changing the translation provider or API key in the new settings UI now immediately resets strict background connection lockouts, eliminating fake "Server Unavailable" errors. - **API Rate Limiting**: The background connection check no longer forcefully pings APIs every time the UI is resized or rebuilt. Added a 2-minute cooldown cache to protect against temporary rate-limit bans from Google/DeepL. - **Micro-stutters**: The translation engine now delegates HTTP requests to an isolated thread pool with background priorities. Previous versions accidentally shared Minecraft's internal `commonPool`, which could momentarily starve rendering and chunk loading loops. - **Cache Data Loss**: Rebuilt the Translation Cache with disk persistence (`ftbqt-cache.json`). The mod now asynchronously saves translations back to disk 5 seconds after translating, preventing wasted DeepL quotas on game restarts. - **Memory Leaks**: Refactored Translate Providers into strict Singleton patterns, eliminating thousands of pointless object instantiations when traversing quests.

## [1.2.1] - 2026-04-10 ### Added - **DeepL API Provider**: You can now select `DEEPL` as your translation provider and use a DeepL API key in configs. This provides drastically better, context-aware translations. - **Contextual Formatted Translation**: Entirely rewrote the formatted text translation logic (`TextFormatUtils`). Instead of breaking down sentences into chunked format codes (which destroyed the grammatical context), the mod now securely masks Minecraft codes and FTB tags into XML tags (`<mX/>`) before sending them. - This solves formatting-induced grammar errors (e.g., incorrect case endings like "Доля цього світ" instead of "світу"). - **Universal Tag Protection**: FTB Quests macros such as `{@pagebreak}` and `{image: ...}` handles are now perfectly shielded and treated as regular colors during translation, preventing them from being mistakenly translated and broken mid-sentence. ## [1.2.0] - 2026-04-10 ### Added - **Language Support Indicator (`[T]`)**: A new green `[T]` icon now appears in the vanilla Minecraft Language Selection screen next to the languages that are supported by the translation API. - **Visual Connection Diagnostics**: The mod now seamlessly performs asynchronous ping tests to translation APIs in the background. If you have no internet or the server is down, the translation button in the quest panel will display **pulsing red rings**. - **Error Tooltips**: Clear tooltip explanations when hovering over the button during connection failures or unsupported language selections. ### Changed - **Strict Language Whitelist**: The mod now accurately verifies the Minecraft language code against a strict whitelist of 133 real-world ISO-639-1 languages. Previously, non-standard local dialects (e.g., Галицька / Halych, Pirate Speak) would silently fail to translate while pretending to be supported. - **Graceful Failure UI**: Selecting an unsupported dialect or losing internet connection now prevents the translation attempt, displays a red error animation on the button, and updates the tooltip immediately so you know exactly why it's not working. ## [1.1.2] - 2026-04-10 ### Changed - **NeoForge**: Completely removed strict version requirements for FTB Quests and FTB Library (`versionRange` is now set to `*`), fixing crashes and loading errors in modpacks running older FTB dependencies.

## [1.2.1] - 2026-04-10 ### Added - **DeepL API Provider**: You can now select `DEEPL` as your translation provider and use a DeepL API key in configs. This provides drastically better, context-aware translations. - **Contextual Formatted Translation**: Entirely rewrote the formatted text translation logic (`TextFormatUtils`). Instead of breaking down sentences into chunked format codes (which destroyed the grammatical context), the mod now securely masks Minecraft codes and FTB tags into XML tags (`<mX/>`) before sending them. - This solves formatting-induced grammar errors (e.g., incorrect case endings like "Доля цього світ" instead of "світу"). - **Universal Tag Protection**: FTB Quests macros such as `{@pagebreak}` and `{image: ...}` handles are now perfectly shielded and treated as regular colors during translation, preventing them from being mistakenly translated and broken mid-sentence. ## [1.2.0] - 2026-04-10 ### Added - **Language Support Indicator (`[T]`)**: A new green `[T]` icon now appears in the vanilla Minecraft Language Selection screen next to the languages that are supported by the translation API. - **Visual Connection Diagnostics**: The mod now seamlessly performs asynchronous ping tests to translation APIs in the background. If you have no internet or the server is down, the translation button in the quest panel will display **pulsing red rings**. - **Error Tooltips**: Clear tooltip explanations when hovering over the button during connection failures or unsupported language selections. ### Changed - **Strict Language Whitelist**: The mod now accurately verifies the Minecraft language code against a strict whitelist of 133 real-world ISO-639-1 languages. Previously, non-standard local dialects (e.g., Галицька / Halych, Pirate Speak) would silently fail to translate while pretending to be supported. - **Graceful Failure UI**: Selecting an unsupported dialect or losing internet connection now prevents the translation attempt, displays a red error animation on the button, and updates the tooltip immediately so you know exactly why it's not working. ## [1.1.2] - 2026-04-10 ### Changed - **NeoForge**: Completely removed strict version requirements for FTB Quests and FTB Library (`versionRange` is now set to `*`), fixing crashes and loading errors in modpacks running older FTB dependencies.

### Changed - **Formatting Preservation**: Translation now preserves all text formatting codes - Bold (`&l`), italic (`&o`), underline (`&n`), strikethrough (`&m`), obfuscated (`&k`) - Minecraft color codes (`&0`-`&f`, `&6` for gold, etc.) - Hex color codes (`&#FF0923`, `&#9FFF2A`, etc.) - Reset code (`&r`) - Multiple consecutive codes (`&l&o` for bold italic) - Segment-based translation: each formatted span is translated independently - Structural elements ({@pagebreak}, {image:...}, JSON) still preserved as-is ### Fixed - Formatting codes no longer "shift" to wrong words after translation - Colors now correctly apply to the translated words they were meant for - **MyMemory provider**: Fixed URL encoding bug (`|` not encoded as `%7C`) that caused all MyMemory translations to fail - **Translate button**: Moved from top-left (overlapping title) to bottom-left corner - **Translation cache**: Failed translations are no longer cached as successful ones

### Changed - **Formatting Preservation**: Translation now preserves all text formatting codes - Bold (`&l`), italic (`&o`), underline (`&n`), strikethrough (`&m`), obfuscated (`&k`) - Minecraft color codes (`&0`-`&f`, `&6` for gold, etc.) - Hex color codes (`&#FF0923`, `&#9FFF2A`, etc.) - Reset code (`&r`) - Multiple consecutive codes (`&l&o` for bold italic) - Segment-based translation: each formatted span is translated independently - Structural elements ({@pagebreak}, {image:...}, JSON) still preserved as-is ### Fixed - Formatting codes no longer "shift" to wrong words after translation - Colors now correctly apply to the translated words they were meant for - **MyMemory provider**: Fixed URL encoding bug (`|` not encoded as `%7C`) that caused all MyMemory translations to fail - **Translate button**: Moved from top-left (overlapping title) to bottom-left corner - **Translation cache**: Failed translations are no longer cached as successful ones

🌐 FTB Quest Translator A client-side addon for FTB Quests that adds an in-game translate button to the quest view panel. ✨ Features: • One-click translation — Toggle button in the quest panel • Auto language detection — Uses your Minecraft language settings • In-memory caching — No repeated API calls for the same text • Client-side only — No server changes needed • Multiple providers — Google Translate and MyMemory API • Async translation — No UI freezing 🎮 How to Use: 1. Open any quest in FTB Quests 2. Click the translate button (top-left of the quest panel) 3. Wait for translation to complete 4. Click again to restore original text ⚙️ Configuration: Config file: .minecraft/config/ftbquesttransl-client.toml • targetLanguage — Target language (auto = Minecraft's language) • enableCaching — Cache translations in memory • translationProvider — GOOGLE or MYMEMORY 📋 Requirements: • FTB Quests (required) • FTB Library (required)