BG3模组翻译器

[left][b][color=#cc0000][size=4]⚠ 重要 — 输出仅供个人使用 本工具会重新打包整个原始模组，因此生成的翻译后 .pak 包含原作者的资源和脚本。未经原作者明确许可，请勿上传或再分发输出文件——这样做会侵犯其权利并违反 Nexus 规则，可能导致账号封禁。请将翻译文件保留供个人使用，或在分享前获得作者许可。[/size][/color]
[/b]
⚠ 这是一个一次性设置工具，不是拖放式模组。仅下载文件是不够的——使用前你必须遵循 GitHub 上的完整设置指南（链接见下方）。

🆕 v7.1 的新内容（错误修复版本）
[list]
[]旧版 PAK 支持：使用旧版 LSLib（V15/V16）打包的模组现在可以正确解包。这修复了“PAK 解包失败”错误，以及“翻译完成”立即出现但未生成翻译后 PAK 的情况。[/]
[]修复了包含空（零字节）文件的 PAK 解包失败问题——这在 Toolkit 构建的模组中很常见（例如 Thor、若干职业模组）。这些模组现在可以正常翻译。[/]
[]失败原因现在可见：如果解包或重新打包失败，原因会以红色显示在翻译日志和“审查”标签页的错误对话框中，并附带“Failed”摘要行。[/]
[]你的自定义术语表现在优先于翻译缓存和官方语言包（例如 Bonus Action → 你设定的术语）。[/]
[]日志显示修复：不再出现原始的“LogEvent(...)”行，“翻译完成！”不再出现两次。[/]
[/list]🆕 v7.0 的新内容
[list]
[]不再需要外部工具：Divine.exe (LSLib) 和 .NET 运行时已被移除。应用现在原生读取并重新打包 .pak/.loca，因此唯一的设置就是一个免费的 Gemini API 密钥。[/]
[]官方语言包参考现在默认开启：完全匹配的内容会复用官方翻译，零 API 调用——术语更一致，成本更低。[/]
[]现在以便携式 ZIP（文件夹构建）分发：解压即可运行，无杀毒软件误报。[/]
[/list]🆕 v6.0 的新内容
[list]
[]应用界面现支持 15 种语言，并在首次启动时自动检测你的游戏语言（为你匹配目标语言 + UI）。[/]
[]官方语言包参考：使用已安装游戏的官方翻译作为参考——完全匹配的内容复用官方措辞（节省 API 调用），句内术语保持一致。适用于全部 15 种语言。[/]
[]“审查”标签页重新设计为垂直卡片列表：每条记录的原文和译文上下堆叠，显示完整原文（不再截断），翻译框会根据内容自动扩展。[/]
[]“我的术语表”现在可以像电子表格一样内联编辑。[/]
[]首次运行设置向导 + 自动检测 BG3 安装文件夹（Steam），使初始设置更加容易。[/]
[/list]描述

[size=5][b]BG3 Mod Translator 是一款免费的独立桌面应用，使用 Google Gemini AI 自动翻译《博德之门 3》模组的文本。它不是一个游戏内模组——而是一个在 PC 上运行的工具，用于将模组的 .pak 转换为翻译版本。与单向翻译器不同，它支持任意语言到任意语言：源语言自动检测，你可以翻译成 15 种目标语言中的任意一种（例如俄语模组翻译成英语、波兰语模组翻译成韩语、英语模组翻译成日语）。[/b][/size]

主要功能
[list]
[]15 种目标语言：韩语、英语、日语、法语、德语、西班牙语、拉丁西班牙语、意大利语、波兰语、俄语、乌克兰语、土耳其语、巴西葡萄牙语、中文（简体）、中文（繁体）[/]
[]应用界面支持全部 15 种语言——自动匹配你的游戏语言（任何未翻译的文本回退为英语）[/]
[]源语言自动检测[/]
[]无需 Python、无需安装、无需外部工具（原生处理 .pak/.loca——不再需要 Divine.exe 和 .NET）[/]
[]同时支持当前（V18）和旧版（V15/V16）的 .pak 文件[/]
[]首次运行设置向导引导你完成 API 密钥和 BG3 文件夹的设置；BG3 安装文件夹自动检测（Steam）[/]
[]批量模式：一次翻译文件夹中的所有 .pak[/]
[]官方语言包参考（默认开启）：复用已安装游戏的官方翻译，在全部 15 种语言中保持术语一致，并节省 API 调用。词典从你的本地游戏文件构建一次并缓存——官方文本绝不会被再分发。[/]
[]内置 347 条术语的 BG3 术语表（角色名、能力、法术）——英语到韩语。你也可以内联添加和编辑自己的自定义术语表（电子表格风格）；你自己的条目始终优先于内置术语表、缓存和官方语言包。对于其他语言，请启用上方的官方语言包参考以获得一致的官方术语。[/]
[]翻译缓存复用过去的结果以节省时间和 API 用量[/]
[]“审查”标签页：垂直卡片列表，显示每条记录的完整原文及其下方的翻译（可内联编辑；文本框自动调整大小），让你在构建最终 .pak 之前校对和修正错误[/]
[]MCM 支持：也翻译模组配置菜单模组（蓝图 + Lua 文本）[/]
[]原始 .pak 绝不会被修改；会创建一个单独的 _<语言>.pak[/]
[/list]要求（一次性，免费）
[list]
[]一个免费的 Google Gemini API 密钥 — [url=https://aistudio.google.com/]https://aistudio.google.com[/url]（执行翻译的 AI）。这是你唯一需要的东西——无需 Divine.exe，也无需 .NET 运行时。[/]
[/list]关于 API 费用 Gemini API 提供免费层级，对大多数用户来说足够使用。极高频率的使用可能会超出免费限额，并可能在你自己的 Google 账户上产生费用。你可以在 [url=https://aistudio.google.com/]https://aistudio.google.com[/url] 查看用量。默认情况下，该工具使用轻量、低成本的模型。

安装
[list=1]
[]从“文件”标签页下载 ZIP，将所有文件解压到一个文件夹中，然后运行该文件夹内的 BG3_ModTranslator.exe。无需安装。文件夹构建版没有杀毒软件误报——不要删除 .exe 旁边的其他文件；它们是必需的。[/]
[]首次启动时，设置向导会引导你输入免费的 Gemini API 密钥并确认 BG3 文件夹（尽可能自动检测）。你也可以稍后在“设置”中更改这些内容。[/]
[]在“翻译”标签页中，选择一个 .pak（或一个文件夹），选择目标语言和 AI 模型，然后按“开始”。[/]
[]用你的模组管理器安装生成的 _<语言>.pak，并相应设置游戏语言。只启用翻译后的 PAK——不要同时启用原始 .pak（相同的模组 UUID → 冲突）。[/]
[/list]请注意（AI 生成内容） 翻译由 Google Gemini AI 生成，可能包含错误。使用内置的“审查”标签页和术语表进行校对和修正。

报告问题 自 v7.1 起，当出现失败时，翻译日志会显示确切原因（红色行）。如果你报告问题，请附上模组名称和那些红色日志行——这能让修复工作快得多。

⚠ 使用前请阅读——完整设置与使用指南 本工具需要一次性设置（一个免费的 Gemini API 密钥）。如果你只在这里下载文件，它将无法工作。请遵循 GitHub 上的完整分步指南——它包含截图，以英语和韩语引导你完成所有步骤：👉 [url=https://github.com/anboyu-alt/BG3-Auto-Korean]https://github.com/anboyu-alt/BG3-Auto-Korean[/url] 几乎所有“我该怎么用这个？”的问题都已经在那里解答了。在评论区发帖前请先阅读它。谢谢！

鸣谢 感谢所有在 v7.0 上报告错误的人——v7.1 中的每一项修复都直接来自你们的报告。特别感谢 frodocompl 提供的塑造了近期更新的想法和建议——非常感谢！特别感谢 DCInside 的《博德之门 3》社区在整个开发过程中提供的无数错误报告、测试和评测——没有你们，这个工具不会是今天的样子。[url=https://gall.dcinside.com/mgallery/board/lists/?id=bg3]https://gall.dcinside.com/mgallery/board/lists/?id=bg3[/url] 还要感谢 Norbyte 开发的 LSLib——它的 .pak/.loca 格式使原生实现成为可能——以及整个 BG3 模组社区。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[한국어]
참고: Nexus는 실행 파일이 포함된 업로드를 자동으로 검토(일시 격리)할 수 있습니다. 이 ZIP은 폴더형 빌드라 백신 오탐이 없지만, 검토 중 다운로드가 일시적으로 막히면 GitHub 릴리스를 이용하세요.

[b][color=#cc0000][size=4]⚠ 중요 — 출력물은 개인적인 용도로만 사용하십시오. 이 도구는 원본 모드 전체를 다시 패키징하므로, 생성된 번역된 .pak 파일에는 원작자의 에셋과 스크립트가 모두 포함되어 있습니다. 원작자의 명시적 허가 없이 번역된 파일을 업로드·재배포하지 마십시오. 이는 원작자의 권리와 Nexus 규칙 위반이며 계정 정지 등 불이익을 받을 수 있습니다. 번역된 파일은 개인 용도로만 사용하거나, 공유 전 반드시 원작자의 허가를 받으십시오.[/size][/color][/b]

⚠ 이 도구는 1회 설정이 필요한 도구이며, 드래그 앤 드롭 방식의 모드가 아닙니다. 파일 다운로드만으로는 작동하지 않으며, 사용 전 GitHub(하단 링크)의 전체 설정 가이드를 반드시 따라야 합니다.

🆕 v7.1의 새로운 점 (오류 수정 판)
[list]
[]구버전 PAK 지원: 예전 LSLib(V15·V16)로 묶인 모드도 정상 언팩됩니다. "PAK 언팩에 실패했습니다" 오류와, 곧바로 "번역 완료"만 뜨고 번역 PAK이 생성되지 않던 문제가 해결됩니다.[/]
[]빈 파일(크기 0)이 든 PAK 언팩 실패 수정 — 툴킷으로 만든 모드(Thor, 여러 클래스 모드 등)에 흔한 경우로, 이제 정상 번역됩니다.[/]
[]실패 이유가 보입니다: 언팩·리팩이 실패하면 번역 로그에 빨간색으로 이유가 표시되고, 검수 탭 오류 창에도 나타나며 "Failed" 요약 줄이 남습니다.[/]
[]내 용어집이 번역 캐시·공식 언어팩보다 먼저 적용됩니다(예: Bonus Action → 내가 정한 용어).[/]
[]로그 표시 오류 수정: "LogEvent(...)" 형태로 찍히던 문제, "번역 완료!"가 두 번 뜨던 문제.[/]
[/list]🆕 v7.0의 새로운 점
[list]
[]외부 툴이 더 이상 필요 없습니다: Divine.exe(LSLib)와 .NET 런타임이 사라졌습니다. 앱이 .pak/.loca를 자체적으로 읽고 다시 패킹하므로, 설정은 무료 Gemini API 키 하나뿐입니다.[/]
[]공식 언어팩 참조가 기본 켜짐: 정확히 일치하는 텍스트는 API 호출 없이 공식 번역을 그대로 재사용합니다 — 용어 일관성↑, 비용↓.[/]
[]포터블 ZIP(폴더형)으로 배포: 압축만 풀어 실행하면 되고, 백신 오탐이 없습니다.[/]
[/list]🆕 v6.0의 새로운 점
[list]
[]앱 화면이 15개 언어를 지원하며, 첫 실행 시 게임 설정 언어를 자동 감지해 번역 대상 언어와 UI를 함께 맞춰 줍니다.[/]
[]공식 언어팩 참조(신규, 선택): 설치된 게임의 공식 번역을 기준으로 활용합니다. 정확히 일치하는 텍스트는 공식 번역을 그대로 재사용해 API 사용을 줄이고, 문장 속 용어는 공식 표기와 일관되게 번역합니다. 15개 언어 모두 지원합니다.[/]
[]검수 탭을 세로 카드 리스트로 개편: 항목마다 원문과 번역이 위아래로 쌓이고, 긴 원문도 잘리지 않고 전부 표시되며 번역 칸은 내용에 맞춰 늘어납니다.[/]
[]내 용어집을 표에서 바로 입력·수정(엑셀식 인라인 편집)할 수 있습니다.[/]
[]첫 실행 안내 위저드 + BG3 설치 폴더 자동 감지(Steam)로 초기 설정이 훨씬 쉬워졌습니다.[/]
[/list]설명

[b][size=5]BG3 Mod Translator는 Google Gemini AI로 Baldur's Gate 3 모드 텍스트를 자동 번역하는 무료 독립형 데스크톱 앱입니다. 게임 내 모드가 아니라, PC에서 실행해 모드의 .pak을 번역본으로 변환하는 도구입니다. 단방향 번역기와 달리 어떤 언어→어떤 언어로든 번역됩니다. 원어는 자동 감지되며 15개 대상 언어 중 원하는 언어로 번역할 수 있습니다(예: 러시아어→영어, 폴란드어→한국어, 영어→일본어).[/size][/b]

주요 특징
[list]
[]15개 지원 언어: 한국어, 영어, 일본어, 프랑스어, 독일어, 스페인어, 라틴 스페인어, 이탈리아어, 폴란드어, 러시아어, 우크라이나어, 터키어, 브라질 포르투갈어, 중국어(간체), 중국어(번체)[/]
[]앱 화면도 15개 언어 전부 제공 — 게임 언어에 자동으로 맞춰지며, 번역되지 않은 텍스트는 영어로 표시됩니다[/]
[]원어 자동 감지[/]
[]파이썬·설치·외부 툴 모두 불필요 (.pak/.loca를 자체 처리 — Divine.exe와 .NET이 더 이상 필요 없습니다)[/]
[]최신(V18)·구버전(V15·V16) .pak 모두 지원[/]
[]첫 실행 안내 위저드가 API 키·BG3 폴더 설정을 안내하며, BG3 설치 폴더는 자동 감지(Steam)됩니다[/]
[]일괄 모드: 폴더 안 모든 .pak 한 번에 번역[/]
[]공식 언어팩 참조(기본 켜짐): 설치된 게임의 공식 번역을 기준으로 활용해 15개 언어 모두에서 용어를 일관되게 유지하고 API 사용을 줄입니다. 사전은 내 로컬 게임 파일에서 한 번만 만들어 캐시하며, 공식 텍스트를 외부로 재배포하지 않습니다.[/]
[]347개 용어 내장 BG3 용어집(캐릭터·능력·주문) — 영어→한국어. 사용자 지정 용어집을 표에서 바로 추가·수정(엑셀식 인라인)할 수 있으며, 내 용어집은 기본 용어집·캐시·공식 언어팩보다 항상 우선합니다. 다른 언어는 위의 공식 언어팩 참조를 켜면 공식 용어를 일관되게 쓸 수 있습니다.[/]
[]번역 캐시로 시간·API 사용량 절약[/]
[]검수 탭: 세로 카드 리스트로, 항목마다 원문 전체와 그 아래 번역을 함께 보여줍니다(바로 편집, 칸 높이 자동 조절). 최종 .pak 생성 전 교정·수정하세요.[/]
[]MCM 지원: 모드 구성 메뉴(MCM) 모드(블루프린트 + Lua)도 번역[/]
[]원본 .pak은 절대 수정되지 않고 별도 _<언어>.pak 생성[/]
[/list]필수 사항 (1회, 무료)
[list]
[]무료 Google Gemini API 키 — [url=https://aistudio.google.com/]https://aistudio.google.com[/url] (번역을 수행하는 AI). 필요한 건 이것 하나뿐이며, Divine.exe와 .NET 런타임은 필요 없습니다.[/]
[/list]API 비용에 관하여 Gemini API는 대부분 사용자에게 충분한 무료 요금제를 제공합니다. 사용량이 매우 많으면 무료 한도를 초과해 본인 Google 계정에 요금이 부과될 수 있습니다. 사용량은 [url=https://aistudio.google.com/]https://aistudio.google.com[/url] 에서 확인하세요. 기본적으로 가볍고 저렴한 모델을 사용합니다.

설치 방법
[list=1]
[]파일 탭에서 ZIP을 받아 모든 파일을 한 폴더에 압축 해제한 뒤, 그 폴더 안의 BG3_ModTranslator.exe를 실행하세요. 설치 불필요. 폴더형 빌드라 백신 오탐이 없습니다 — .exe 옆의 다른 파일들은 실행에 필요하니 지우지 마세요.[/]
[]첫 실행 시 안내 위저드가 무료 Gemini API 키 입력과 BG3 폴더 확인을 단계별로 도와줍니다(가능하면 자동으로 채워집니다). 이 값들은 나중에 설정에서 바꿀 수 있습니다.[/]
[]번역 탭에서 .pak(또는 폴더)을 선택하고 대상 언어·AI 모델을 고른 뒤 시작을 누르세요.[/]
[]생성된 _<언어>.pak을 모드 매니저로 설치하고 게임 언어를 설정하세요. 번역 PAK 하나만 활성화하고, 원본 .pak은 함께 등록하지 마세요(같은 모드 UUID라 충돌합니다).[/]
[/list]참고

(AI 생성 콘텐츠) 번역은 Google Gemini AI가 생성하므로 오류가 있을 수 있습니다. 내장 검수 탭과 용어집으로 교정·수정하세요.
문제 제보 시 v7.1부터 번역이 실패하면 로그에 정확한 이유가 빨간색으로 표시됩니다. 제보하실 때 모드 이름과 그 빨간 로그 줄을 함께 적어주시면 훨씬 빨리 고칠 수 있습니다.

⚠ 사용 전 반드시 읽어주세요 — 전체 설치·사용 가이드 이 도구는 1회 설정(무료 Gemini API 키)이 필요합니다. 여기서 파일만 받아서는 작동하지 않습니다. GitHub의 전체 단계별 가이드(영어·한국어 스크린샷 포함)를 따라주세요: 👉 [url=https://github.com/anboyu-alt/BG3-Auto-Korean]https://github.com/anboyu-alt/BG3-Auto-Korean[/url] "어떻게 쓰나요?"에 대한 답은 거의 모두 README에 있습니다. 댓글 전에 먼저 README를 읽어주세요. 감사합니다!

샤우트아웃

v7.0의 오류를 제보해 주신 모든 분께 감사드립니다. v7.1의 수정은 전부 여러분의 제보에서 나왔습니다. 최근 업데이트의 방향을 잡아준 아이디어와 제안을 주신 frodocompl님께 특별히 감사드립니다. 덕분에 더 좋은 도구가 되었습니다! 개발 기간 내내 수많은 버그 제보·테스트·리뷰로 도와주신 디시인사이드 발더스 게이트 3 갤러리 여러분께 진심으로 감사드립니다. 여러분이 없었다면 이 도구는 지금의 모습이 될 수 없었습니다. [url=https://gall.dcinside.com/mgallery/board/lists/?id=bg3]https://gall.dcinside.com/mgallery/board/lists/?id=bg3[/url] LSLib을 만들어주신 Norbyte님께 감사드립니다 — 그 .pak/.loca 포맷 덕분에 자체 구현이 가능했습니다. BG3 모딩 커뮤니티 전체에도 감사드립니다.[/left]