유니티 게임 한글화 - dll파일 내 대사 수정
예시 게임
:Muck (https://store.steampowered.com/app/1625450/Muck/)
-------
필요 프로그램 / 자료
* dnSpy or ILSpy+Reflexil 둘 중 하나만 받으면 된다.
dnSpy(개발 중지): https://github.com/dnSpy/dnSpy/releases
dnSpyEx(후속 툴): https://github.com/dnSpyEx/dnSpy/actions
* dnSpy/dnSpyEx 둘 중 하나만 있어도 된다. 근데 dnSpyEx가 디컴파일이 더 잘 됐었다.
* dnSpyEx를 다운받기 위해선 Github 계정이 있어야 한다.
* Github 계정으로 로그인한 후, Actions - 제일 최신 workflow run - dnSpy-net-win64를 누르면 최신 버전이 다운된다.
* Releases에 있는 버전은 구버전이니 주의
ILSpy 6.2.1 (https://github.com/icsharpcode/ILSpy/releases)
Reflexil 2.5 (https://github.com/sailro/Reflexil/releases)
-------
본문에선 Mono방식의 게임을 다루도록 하겠다.
-------
선 3줄요약
1. dnSpy 혹은 ilspy+reflexil 다운로드 후 실행
2. 대사 검색 (코드 추출 혹은 직접 검색)
3. 대사 수정 후 패치된 dll파일 저장/교체
-------
게임에서 나오는 (Press "E" to pickup 부분이 monobehaviour 파일을 통한 수정으로도 변화가 없었다.
그러므로 dll 파일을 뜯어보도록 하자.
1번(Dnspy) 혹은 2번(ILSpy)과 중 하나를 선택하자. Dnspy를 추천한다.
1. Dnspy를 이용하여 검색 및 수정하기
기본적으로 dnSpy에서 직접 검색할 수 있고,
전체적인 검색이 필요하다면 소스코드로 내보내서 타사 툴을 이용해 검색할 수 있다.
두가지 다 설명하겠다.
따라서, 검색부분과 수정부분을 점선으로 분리하였다.
----------------------------------------------------------------------------
1-1. dnSpy 자체적으로 텍스트 검색하는 법
{게임이름}_Data\Managed 폴더에 찾아가 보면 Assembly-CSharp.dll이 있을 것이다.
이 파일을 dnSpy에 로드시킨 후,
상단 메뉴 Edit - Search Assemblies를 클릭하면 좌측 하단 "Search"창이 뜬다.
우측 하단 Search For: 오른쪽 박스를 "All"에서 "Number/String"으로, "All Files"를 "Selected Files"를 누른다.
그럼 우리가 불러온 "Assembly-CSharp.dll" 파일 안에 있는 Number/String만 검색된다.
정상적으로 검색된 것이 보인다.
1-2. 소스코드를 내보낸 후, 텍스트 에디터로 검색해서 수정하기
File - Export to Project를 누른다.
소스코드로 내보내는 이유는 "파일에서 찾기" 기능을 이용하기 위함이다.
이 과정이 필요없고, dnSpy에서 직접 찾고 싶다면 아래 내용을 건너뛰면 된다.
Folder는 걍 아무 곳에나 하나 만든 후 지정해주고, Export를 누르자.
Notepad++의 "파일에서 찾기(Ctrl+Shift+F)" 기능을 사용하여
아까 Export한 폴더에서 파일검색을 하면 바로 튀어나온다. "PickupInteract.cs" 파일에 있댄다.
Assembly-CSharp.dll 트리를 열어 내려가다 보면,
"-" 안에 "PickupInteract" 클래스가 있는 것을 볼 수 있다.
오른쪽 창을 보면 우리가 찾던 대사가 보인다.
----------------------------------------------------------------------------
* dnSpy에서 수정하기
검색은 위 두가지 방법이 있으니 알아서 편한 방법대로 하고, 이제 수정을 해보자.
수정은 보통 "Edit Method", "Edit IL" 두 가지 방법을 주로 사용한다.
대사 부분을 우클릭하여 일단 "Edit Method (C#)..."를 눌러보자.
수정할 수 있는 창이 뜬다.
원하는 대로 수정하고 아래 "Compile"을 누르자.
에러가 떴다면 후술할 "Edit IL Instructions" 메뉴 이용하는 법을 참고하자.
제대로 변경되었는지 확인하고, Save All을 누르면 dll에 변경사항이 저장된다.
이후 실행해서 확인해보자.
----
* "Edit IL Instruction..." 메뉴 이용하기
위에서 대사부분을 우클릭하면 떴던 메뉴 중 "Edit IL Instruction..."이라는 메뉴가 있다.
Edit Method로 수정이 안 될 경우 Edit IL을 이용하여 수정할 수 있다.
보통 이렇게 생겼다.
대사가 그대로 들어있기에 참 고마운 경우이다.
보통 숫자 부분을 에딧하려면 16진수로 써져있고,
단순 텍스트가 아닌 좀 복잡한 수정을 하기 위해선 IL을 알아야 하므로 주의할 필요가 있다.
대사를 수정한 다음 OK버튼 - Save all - 인게임 출력 확인 과정을 거치면 된다.
2. ILSpy + Reflexil을 이용하여 수정하기
reflexil.for.ILSpy.2.5.AIO.bin.zip과 ILSpy_binaries_6.2.1.6137.zip를 다운받아서 한 폴더에 압축을 푼다.
ILSpy.exe를 실행한다.
File -> Open -> 한글화하고자 하는 게임 폴더 -> {이름}_data -> Managed를 들어가서
Assembly-CSharp.dll을 선택한다.
불러온 다음, Save Code를 눌러 폴더에 원본 소스들을 저장한다. 이는 검색을 편하게 하기 위해서다.
다른 dll파일의 경우, 이름만 바꿔서 생각하면 된다.
검색을 편리하게 하기 위해 Notepad++를 실행 후
찾기-> 파일에서 찾기 -> 아까 세이브한 폴더 지정 후 to pickup을 검색한다.
pickupinteract.cs 파일에 대사가 있다고 한다.
ilspy로 - 라고 쓰여져 있는 부분을 열어보면, 뭐가 엄청 나오는데 쭉 내리다 보면 PickupInteract라는 항목이 보인다.
ilspy 상단 View -> Reflexil v2.5를 클릭하면 프로그램 하단부에 Reflexil이 뜨게 된다.
변경하고자 하는 부분을 클릭 후 우클릭하면 Edit... 메뉴가 뜨는데, 누른 다음 수정을 하고 update를 누른다.
이후 제대로 변경되었는지 확인한다.
다시 좌측 트리 제일 윗부분으로 스크롤을 올린 다음, Assembly-CSharp을 우클릭한 후 Save as...를 누른다.
원본 파일을 백업하고, Assembly-CSharp.Patched.dll를 Assembly-CSharp.dll으로 바꾼 후 게임을 실행해 보자.
지금 보니까 뒤에 큰따옴표를 잘못 썼는데, 어쨌건 한글화가 완료되었다.
나머지도 비슷한 방식으로 처리할 수 있다.