🖥️ Danders Frames 한글 패치 사용 가이드

1. 왜 .bat 파일로 실행하나요?
일반적인 PowerShell 스크립트(.ps1)는 보안 정책상 더블 클릭으로 실행되지 않거나 관리자 권한 문제로 막히는 경우가 많습니다. .bat 파일은 관리자 권한 승인과 실행 정책 우회를 자동으로 처리해주어, 사용자가 복잡한 설정 없이 더블 클릭만으로 패치를 적용할 수 있게 돕습니다.


2. 패치 대상 파일
이 스크립트는 DandersFrames 내의 다음 주요 파일들을 한글화합니다:

설정 및 메뉴: Options.lua, Main.lua, GUI.lua

기능: Search.lua, Bindings.lua, ProfilesPanel.lua, TestMode.lua

기타: Position.lua, Init.lua 등


3. 작동 원리 및 안전성

자동 경로 탐색: 레지스트리와 드라이브 스캔을 통해 와우 설치 폴더와 애드온 경로를 스스로 찾아냅니다.

줄 단위 완전 일치(Exact Match): 문장 중간의 단어를 무분별하게 바꾸는 것이 아니라, 줄 전체 내용이 코드와 100% 일치할 때만 치환합니다. 원본 코드를 건드리지 않으므로 로직 오류로부터 매우 안전합니다.

자동 백업: 수정 전 원본 파일은 .bak 확장자로 자동 저장되어 언제든 복구가 가능합니다.


4. 애드온 업데이트 시 주의사항
커즈포지(CurseForge) 등을 통해 애드온이 업데이트되면 한글화된 파일이 다시 영문 원본으로 덮어씌워집니다. 이때는 패치 스크립트를 다시 한번 실행해주시면 즉시 한글로 복구됩니다.


5. 수정 및 응용 방법

영어로 나오는 문구 수정: 애드온 버전업으로 문구가 바뀌어 치환이 안 된다면, .ps1 파일을 메모장으로 열어 $FilePatchMap 항목에서 영문 텍스트를 최신 버전과 똑같이 맞춰주세요.

다른 애드온 응용: $addonPath 변수의 경로를 다른 애드온 폴더로 바꾸고, $FilePatchMap에 해당 애드온의 파일명과 치환할 문구들을 입력하면 어떤 애드온이든 한글화 툴로 변신합니다.


6. 자주 묻는 질문 (FAQ)
Q: 글자가 깨져요.

A: 본 스크립트는 와우 클라이언트와 호환성이 가장 좋은 UTF-8(BOM 없음) 인코딩으로 파일을 저장하므로 인코딩 걱정은 안 하셔도 됩니다.

Q: 패치가 안 돼요.

A: 와우가 설치된 드라이브에 권한이 필요할 수 있으니 반드시 관리자 권한으로 실행되는지 확인하세요.


이 스크립트는 단순한 일회성 코드가 아니라, 애드온 관리를 자동화하는 **'나만의 커스텀 한글화 툴'**로서 가치가 큽니다. 구체적인 활용 방안 3가지만 짚어 드릴게요.

1. 업데이트 스트레스 해소 (가장 큰 장점)
와우 애드온은 업데이트가 잦습니다. 커즈포지(CurseForge) 등에서 업데이트를 누르는 순간, 고생해서 수정한 루아 파일은 영문 원본으로 덮어씌워져 날아갑니다. 이때 이 스크립트가 있으면 다시 일일이 수정할 필요 없이 더블 클릭 한 번으로 1초 만에 한글화를 복구할 수 있습니다.

2. 타인과의 공유 및 배포
루아 파일을 직접 배포하면 저작권이나 버전 관리 문제가 생길 수 있지만, 이 패치 스크립트는 원본 코드를 포함하지 않으면서도 누구나 한글로 쓸 수 있게 해줍니다.

"이 파일 두 개 다운로드해서 와우 폴더에 넣고 실행하세요" 한마디면 다른 사람도 쉽게 한글판을 쓸 수 있습니다.

3. 다른 애드온으로의 확장 (범용 템플릿)
현재 만든 ps1 파일의 구조는 매우 체계적입니다. 내부의 $FilePatchMap 부분만 다른 애드온의 파일명과 영문 문구로 바꾸면, **세상의 모든 영문 애드온을 한글화하는 범용 패처(Patcher)**로 바로 재활용할 수 있습니다.

이상 AI 요약 설명이었습니다~! 아래는 몇장의 스샷!
그리고 뭔가 맘에 안드는 번역이 있다면 수정해서 쓰면 됩니다!!!!!!