Repository navigation
NyanLex Translator 1.0.0
NyanLex Translator 1.0.0
The first release under the NyanLex Translator name brings together bilingual chat, item and screen translation, reusable translations and the new chat composer.
October 29 refresh: safer settings and renderer-owned layout
- All 62 JARs now use the full
NyanLex-Translatorartifact name, while the in-game mod list consistently shows NyanLex Translator. The/nyanlexcommand is unchanged. - API-key fields are masked by default and include a compact show/hide control. A key can be checked when needed without leaving it exposed on the settings screen.
- Every supported target includes ChatGPT/Codex sign-in, model and reasoning-effort selection, and session-token usage display. The default is
gpt-6-lunawith medium reasoning effort; existing saved provider and model choices are preserved. API services expose the same six choices: off, low, medium, high, xhigh and max. - OpenAI API, ChatGPT/Codex and Claude each have a separate Fast mode switch, disabled by default. Enabling it first warns that billing or account allowance may increase; unsupported Claude models automatically use standard speed and show that note on a separate result line.
- Claude API settings can read the available model list, default to Claude Haiku 5.5 with medium reasoning, and keep connection-test results inline below the button instead of opening a modal. API settings no longer show the long local key-file path paragraph.
- Translation-pack discovery runs on the last Quick setup page, after the target language has been confirmed. Players can still check packs later from Pack settings.
- On supported modern builds, pressing
Gswitches translated books back to the original immediately. Those builds also translate the four visible rows of world signs on the client, preserve the sign's colour and glow, fit long translated rows, and return to the untouched original withG. - Removed the experimental global text-width projection that could make custom server or mod tooltips overlap. Supported renderers keep ownership of their native measurement and layout.
- OCR was evaluated but deliberately not included. This refresh adds no OCR model, native OCR runtime, screenshot text scan or OCR data disclosure; text embedded only in images remains outside translation coverage.
- Existing chat timing and echo protections remain: ordered, ready-first and original-first delivery modes; persistent keep-original decisions; and bypassing unnecessary requests for already-Chinese text.
- The mod version remains 1.0.0. The replacement package is published only after all 62 loader/version artifacts pass the full build, metadata, Mixin and checksum gates. Minecraft 26.1.2 / Fabric was also checked interactively for book switching and translated tooltip display; this is not an in-game certification of every target, modpack or public server.
Security and settings update
- Antigravity is hidden by default and can be enabled in Advanced settings after reading the account, service and privacy risks. Official CLI sign-in does not establish authorization for this third-party integration.
- CLI translation uses dedicated profiles, untrusted-text boundaries, tool restrictions and bounded process lifetimes. Antigravity rejects tool requests through a pre-execution hook. Selected scenarios were tested with CLI 1.2.16; this is not an operating-system sandbox or a guarantee for every CLI version.
- The Antigravity notice retains its Don't show again checkbox. The redundant Gemini API terms popup was removed; selecting API-key mode now opens the settings directly and does not reset the current model.
- Do-not-translate terms appear first in their settings section. Remote API endpoints require HTTPS; local loopback HTTP remains available. Automatic redirects are disabled.
- Reported CLI rate limits pause requests; unavailable remaining-allowance information does not block translation. Google machine translation retains its alternate-endpoint attempt, and API keys retain individual cooldowns and rotation.
Write in your language. Join the conversation.
Enable Chat input translation, open chat, and write in the floating panel. Choose a target language (English by default), then select Translate & fill. Review or edit the result in the normal chat bar and press Enter when you are ready to send.
- The composer starts at the bottom right, preserves a saved position, and supports language search by name or code.
- Closing chat with Esc keeps the unfinished draft in memory for the current game session; quitting the game clears it.
- The mod UI supports English, Japanese, Traditional Chinese and Simplified Chinese, independently of the chosen translation target language.
- The outgoing language is independent of the language used to read game content.
- Uses your selected chat translation service and existing request pacing. Google rate-limit protection still applies.
- Drafts are sent for translation only when you submit them in the panel. They are not written to translation caches or exports.
- Editing the draft, changing the service, or closing chat discards stale results. Failed or overlong translations leave your draft available to edit and retry.
- Four complete README translations are available; Traditional Chinese remains the GitHub homepage.
- Long descriptions remain readable when an AI response loses only display-wrap markers. A single review can restore the layout; cached reads do not repeat the request, and numbers, protected names and colour markers must still survive validation.
Also included: Google, Gemini, OpenAI, DeepSeek, OpenAI-compatible services, ChatGPT/Codex sign-in, and Google sign-in through a separately installed Antigravity CLI on modern Fabric/NeoForge builds. Antigravity mode uses the signed-in Google account's allowance and obtains its model variants from the CLI. Translation import/export, downloadable translation packs and full-content warmup with selectable categories remain available. Completed translations remain reusable after switching AI providers or models.
Compatibility and display fixes
- Added optional Google account sign-in through Antigravity CLI, with live model discovery, connection status, login/logout guidance and a bounded connection test. NyanLex does not scan global CLI logs for an account email.
- Open Translation Settings from the settings menu, or enter
/nyanlexin chat if another UI mod hides that entry. - Google machine translation now tries a compatible alternate endpoint once when the primary endpoint returns a 429 or block page.
- FTB Quests supports both the older public-instance API and the newer accessor API. Quest tabs, titles and body text now share one refresh path, so pressing
Gchanges the displayed text—not only the mode indicator—and completed asynchronous translations appear without toggling twice. - Jade/WAILA-style object-name overlays have a dedicated optional compatibility hook on supported modern builds.
- Advancement toasts and advancement announcements translate the advancement title while preserving the surrounding game message.
- The chat composer keeps the selected target language visible after translation.
- The translated counter now reports the durable accumulated translation total instead of stopping at the in-memory 5,000-entry cache limit. Warmup progress remains a separate count for the current job.
Includes 62 Minecraft/loader builds: 37 Fabric, 23 NeoForge and 2 Forge. Install only the JAR matching your game version and loader; Fabric also requires Fabric API. Chat input translation starts disabled and requires online translation to be enabled.
Expanded version coverage
| Loader | Minecraft releases |
|---|---|
| Fabric · 37 builds | Every stable release from 1.16.5 through 26.3, plus 1.14.4 and 1.15.2 |
| NeoForge · 23 builds | Every stable release from 1.20.1 through 26.3 |
| Forge · 2 builds | 1.12.2 and 1.13.2 |
NeoForge does not exist for Minecraft before 1.20.1. Minecraft snapshots and pre-releases are excluded; some NeoForge loader builds are beta. Each file targets exactly the Minecraft version in its name, not all versions between endpoints. See the full download and Java requirements table.
The NeoForge 26.1.2 build is compiled against loader 26.1.2.109. The chat composer no longer creates anonymous Mixin inner classes, avoiding the generated ChatScreen$Anonymous class-resolution failure encountered during startup. Other loader/API compatibility still depends on the exact build and installed mods.
Validation covers automated tests, per-target builds, packaged classes and metadata, Java levels, Mixin selectors and invocation targets, and file hashes. It does not include an in-game playthrough of every target or compatibility certification for every modpack.
繁體中文
這是改名為 NyanLex Translator 後的首版,整合雙語聊天、物品與介面翻譯、既有譯文沿用,以及聊天輸入翻譯浮窗。
10 月 29 日更新:更安全的設定與由原渲染器掌管版面
- 全部 62 個 JAR 統一使用完整的
NyanLex-Translator成品名稱;遊戲模組列表也一致顯示 NyanLex Translator。/nyanlex指令維持不變。 - API 金鑰欄位預設遮罩,右側提供小型顯示/隱藏控制;需要核對時才顯示,不會長時間暴露在設定畫面。
- 所有支援版本都有 ChatGPT/Codex 登入、模型與推理強度選擇、工作階段 token 顯示;預設為
gpt-6-luna、中推理強度,既有玩家已儲存的服務與模型選擇不會被覆蓋。API 服務統一提供關閉、low、medium、high、xhigh、max 六檔。 - OpenAI API、ChatGPT/Codex 與 Claude 各有獨立的「快速模式」開關,預設關閉。開啟前會提醒帳單費用或帳號額度可能增加;Claude 模型不支援時會自動改用一般速度,並將提示獨立顯示在測試結果第二行。
- Claude API 設定可讀取可用模型清單,預設使用 Claude Haiku 5.5 與中推理強度;測試連線結果改在按鈕下方顯示,不再彈出視窗。API 設定頁也移除了冗長的本機金鑰檔案路徑說明。
- 翻譯包改在快速設定最後一頁、目標語言確認後才偵測;之後仍可從翻譯包設定重新檢查。
- 在支援的現代版本中,翻譯書本後按
G可立即切回原文;這些版本也會在客戶端翻譯世界中告示牌的四行可見文字,保留染色與發光效果、縮放過長譯文,按G時回到完全未修改的原文。 - 移除曾造成部分伺服器/模組自訂 tooltip 文字重疊的全域文字量寬投影;各支援渲染器重新掌管自己的原生量測與排版。
- 曾評估 OCR,但本次明確不納入:沒有 OCR 模型、原生 OCR 執行環境、畫面影像掃字或新增 OCR 資料揭露;只存在圖片裡的文字仍不在翻譯範圍。
- 既有聊天顯示時機與 echo 防護均保留:依序、完成即顯示、先原文後補譯三種模式;保留原文判定可跨重啟沿用;已是中文的內容略過不必要請求。
- 模組版本維持 1.0.0。只有在 62 個 Loader/Minecraft 成品全部通過建置、metadata、Mixin 與雜湊關卡後才會替換公開檔案。另以 Minecraft 26.1.2/Fabric 實際檢查書本切換與 tooltip 譯文顯示;不代表所有版本、整合包或公開伺服器都已通過實機驗證。
安全與設定更新
- Antigravity 預設隱藏,可在進階設定閱讀帳號、服務與隱私風險後開啟。官方 CLI 登入不代表本第三方整合已取得授權。
- CLI 翻譯使用專用設定目錄、不可信文字邊界、工具限制與程序逾時。Antigravity 透過執行前掛鉤拒絕工具請求;已以 CLI 1.2.16 驗證特定情境,不代表作業系統沙箱或所有 CLI 版本的保證。
- Antigravity 說明保留獨立的「不再顯示」勾選框。重複的 Gemini API 使用條件彈窗已移除;切換 API 金鑰模式會直接開啟設定,且不會重設既有 Gemini 模型。
- 不翻譯詞彙移至該設定區最上方。遠端 API 限用 HTTPS,本機回送位址仍可使用 HTTP,並停用自動重新導向。
- CLI 明確回報限流時暫停請求;無法查到剩餘額度不會阻止翻譯。保留 Google 備用入口嘗試,以及 API 金鑰各自冷卻與輪流使用的行為。
用自己的語言,自在回話
開啟 聊天輸入翻譯 後,打開聊天框,在小浮窗寫下想說的話。選擇目標語言(預設英文),按 翻譯並填入,譯文就會出現在下方聊天欄;確認或修改後,再按 Enter 送出。
- 浮窗預設位於右下角,已有儲存位置則保留;語言選單可搜尋名稱或代碼。
- 按 Esc 關閉聊天後,同次遊戲執行期間保留未完成草稿;結束遊戲後清除。
- 模組 UI 支援英文、日文、繁體中文、簡體中文,不限制遊戲內容的翻譯目標語言。
- 發話語言與閱讀遊戲內容的翻譯語言分開設定。
- 沿用聊天的翻譯服務、送出間隔與限流保護;Google 的 429 保護持續生效。
- 只有主動提交浮窗草稿時才會要求翻譯,草稿不寫入翻譯快取或匯出檔。
- 修改草稿、切換服務或關閉聊天後,過時結果不會覆蓋聊天欄;翻譯失敗或超過聊天長度時會保留草稿,方便修改重試。
- 提供四種語言的完整 README,GitHub 首頁維持繁體中文。
- 長篇說明只遺失自動換行標記時,先保留可讀譯文,再校正一次;讀取快取不會反覆重送。數值、受保護名稱與顏色標記仍需通過完整檢查。
同時提供 Google、Gemini、OpenAI、DeepSeek、OpenAI 相容服務與 ChatGPT/Codex 登入,以及翻譯匯入/匯出。現代版本另有翻譯包下載與可選分類的全內容預熱;切換 AI 服務或模型後,已完成的譯文仍可沿用。
相容性與顯示修正
- 現代 Fabric/NeoForge 版本新增選用的 Antigravity CLI Google 帳號登入,使用該帳號的 Antigravity 額度,並提供即時模型清單、連線狀態、登入/登出引導及有逾時限制的連線測試;不掃描全域 CLI 日誌取得信箱。
- 你可以從設定選單開啟翻譯設定;如果入口被其他 UI 模組隱藏,也可以在聊天欄輸入
/nyanlex。 - Google 機器翻譯的主要端點回傳 429 或阻擋頁面時,會改試一次相容的備用端點。
- FTB Quests 同時相容舊版公開實例 API 與新版存取方法。任務索引、標題和內文統一走同一條刷新路徑,按
G時不再只有模式提示改變;背景翻譯完成後也會直接套用,不必再切換兩次。 - 支援的現代版本新增 Jade/WAILA 類物件名稱提示的專用選用相容掛鉤。
- 成就彈窗與聊天中的成就訊息會翻譯成就名稱,並保留遊戲原本的訊息格式。
- 聊天輸入翻譯完成後仍會顯示目前選定的目標語言。
- 已翻譯數量改為顯示永久保存的累積總數,不再受記憶體快取 5,000 筆上限影響;本次預熱進度仍另外計算。
包含 62 個 Minecraft/Loader 版本:Fabric 37 個、NeoForge 23 個、Forge 2 個。請只安裝符合遊戲版本與 Loader 的單一 JAR;Fabric 另需 Fabric API。聊天輸入翻譯預設關閉,使用時也需開啟線上翻譯。
完整支援範圍請以表格為準:Fabric 提供 Minecraft 1.16.5 至 26.3 的所有正式版本,NeoForge 提供 1.20.1 至 26.3 的所有正式版本;另保留 Fabric 1.14.4、1.15.2 與 Forge 1.12.2、1.13.2。每個 JAR 僅適用於檔名所示的 Minecraft 版本與 Loader。
補齊支援版本
- Fabric:Minecraft 1.16.5~26.3 的全部正式版本,並保留 1.14.4、1.15.2。
- NeoForge:Minecraft 1.20.1~26.3 的全部正式版本;更早的 Minecraft 沒有對應的 NeoForge。
- Forge:保留 Minecraft 1.12.2、1.13.2。
不包含 Minecraft 快照/預覽版;部分 NeoForge Loader 本身為 beta。每個 JAR 都對應檔名所示的精確遊戲版本,不代表同一檔案可通用整個範圍。
NeoForge 26.1.2 以 Loader 26.1.2.109 編譯,並移除聊天浮窗中的匿名 Mixin 類別,修正啟動時 ChatScreen$Anonymous 類別解析失敗。其他 Loader/API 相容性仍取決於精確版本與已安裝模組。
驗證範圍包含自動化測試、逐版本建置、成品 class 與 metadata、Java 需求、Mixin 注入與呼叫目標,以及檔案雜湊;不代表所有版本均完成實機遊玩,或所有整合包都已通過相容性測試。