뿌요뿌요 테트리스 Steam PC 한국어 패치

뿌요뿌요 테트리스(Steam, PC)의 한국어 패치 파일 생성을 위한 스크립트입니다.

@nickworonekin 님께서 작성한 많은 스크립트에 도움을 받았습니다. 감사합니다.

패치 다운로드 및 적용방법

아래 패치 다운로드 링크에서 가장 최신의 build-<날짜>.zip 파일을 다운로드합니다.
뿌요뿌요 테트리스가 설치된 디렉터리 (일반적으로 C:\Program Files (x86)\Steam\steamapps\common\PuyoPuyoTetris)로 이동합니다.
data_steam\data 디렉터리에 build-<날짜>.zip 파일의 압축 내용을 풀어 덮어 씌웁니다.

잘 모르겠으면, C:\Program Files (x86)\Steam\steamapps\common\PuyoPuyoTetris\data_steam\data 폴더에 build-<날짜>.zip 압축 파일 내용을 덮어 씌우면 됩니다.

자주 묻는 질문

Q1. 텍스트 앞에 [1024] 같이 이상한 숫자가 붙어서 나와요.
A1. 패치 다운로드시 build-<날짜>-debug.zip 말고 build-<날짜>.zip 를 받아서 다시 패치하세요.

스크린샷

직접 패치 생성 방법

아래의 내용은 직접 패치 파일을 처음부터 생성하기 위한 방법을 안내합니다.

(단순히 패치를 다운로드받아 적용하실 분들은 무시해주세요.)

1. 사전 준비사항

본 스크립트는 Windows 10 x64 환경에서만 테스트되었습니다.
본 스크립트를 실행하기 위해서는 파이썬 3.6 이상과 Pipenv이 필요합니다.
본 스크립트를 실행하기 위해서는 닷넷 프레임워크 4.6 이상이 필요합니다.
본 스크립트는 패치 파일을 원본 게임 데이터를 통해 생성합니다. 생성 작업을 위해 많은 디스크 용량이 필요할 수 있습니다.
본 스크립트를 처음부터 정상적으로 구동하기 위해서는 Nintendo Switch로 발매된 뿌요뿌요 테트리스 S의 데이터가 필요합니다.
텍스트 패치 이외의 이미지 패치는 본 프로젝트로 작업이 가능하지만, 패치를 위해 한국어로 수정한 이미지 데이터는 저작권 문제로 제공하지 않습니다.

2. 필요한 파일 다운로드 및 빌드 환경 준비

먼저 패치 스크립트(ppt-kor.zip)를 다음 링크에서 다운로드합니다.

다운로드 페이지

다운로드 받은 패치 스크립트의 압축을 해제한 후, ppt-kor\lib 디렉터리로 이동합니다. ppt-kor\lib 디렉터리에는 본 스크립트에서 추가로 필요한 프로그램들을 다운받아두어야 합니다. 필요한 프로그램들의 다운로드 링크는 다음과 같습니다.

위 파일들을 모두 다운로드 받아서 압축을 해제하여 ppt-kor\lib 디렉터리에 다음과 같이 배치해두어야 합니다.

- ppt-kor
    - lib
        - BNTX-Extractor-master
            bntx_extract.py
            ...

        - ImageMagick-7.0.7-38-portable-Q16-x86
            convert.exe
            magic.xml
            ...

        - Narchive-1.0.1
            Narchive.exe
            ...

        - PuyoTextEditor-1.0.1
            MtxToJson.exe
            ...

        - quickbms
            quickbms.exe
            ...

        - TppkTool-1.0.1
            TppkTool.exe
            ...

        - wtee.exe
    ...

위와 같이 폴더가 준비됬다면, 텍스트 생성에 사용할 폰트 파일을 다운로드 받아야 합니다. ppt-kor\data\fonts 디렉터리로 이동하고, 다음 링크에서 빙그레체(빙그레체II 아님)의 OTF 파일을 다운로드받습니다.

빙그레 글꼴

다운로드 받은 OTF 파일 중 빙그레체 Bold의 OTF 파일을 ppt-kor\data\fonts\Binggrae-Bold.otf 경로에 붙여넣습니다.

이후, pipenv를 정상적으로 설치한 후 명령 프롬프트를 열고 ppt-kor 폴더로 이동합니다.

그리고 다음 명령어를 통해 라이브러리를 설치하고, 스크립트의 실행을 준비합니다.

pipenv install
pipenv shell

그 다음, 적절한 한국어 번역 데이터를 다운로드합니다.

현재 구글 스프레드 시트에서 번역 데이터를 공유하고 있습니다. 위 링크에 접속하여 파일 > 다른 이름으로 다운로드 > 쉼표로 구분된 값(.csv, 현재시트) 를 클릭하여 csv 파일을 다운로드합니다.

다운로드 받은 파일의 이름을 pptko-text - data.csv로 변경하여 ppt-kor\data 디렉터리 안에 배치합니다.

3. 원본 게임 데이터 변환

본 스크립트는 원본 데이터를 기반으로 한글 패치를 생성하므로, 원본 데이터를 한글 패치를 생성할 수 있도록 변환하는 과정을 처음에 거쳐야 합니다.

원본 스팀 게임 데이터는 ppt-kor\data\steam_data 디렉터리에 복사해야 합니다.

뿌요뿌요 테트리스가 설치된 디렉터리 (일반적으로 C:\Program Files (x86)\Steam\steamapps\common\PuyoPuyoTetris) 에서 data_steam\data 디렉터리의 내용을 복사하여 ppt-kor\data\steam_data에 붙여넣습니다.

원본 스위치 게임 데이터는 ppt-kor\data\switch_romfs 디렉터리에 복사해야 합니다.

적절하게 덤프된 스위치 롬 카트리지의 romfs를 ppt-kor\data\switch_romfs에 붙여넣습니다.

붙여넣은 결과 디렉터리는 다음과 같아야 합니다.

- ppt-kor
    - data
        - steam_data
            - academy
            - adventure
            - arcade_select
            ...
        - switch_romfs
            - academy
            - adventure
            - arcade_select
            ...
        - "pptko-text - data.csv"
        ...
    ...

이후 ppt-kor\extract_steam_all.bat와 extract_switch_all.bat 명령을 pipenv shell이 구동중인 명령 프롬프트에서 실행합니다. 변환 과정은 약 40분 정도 소요될 수 있습니다.

4. 패치 파일 생성

변환된 게임 데이터에서 한국어 패치 파일을 생성합니다.

이를 위해 ppt-kor\create_font_patch.bat와 ppt-kor\create_image_patch.bat 명령을 pipenv shell이 구동중인 명령 프롬프트에서 실행합니다. 변환 과정은 약 30분 정도 소요될 수 있습니다.

5. 패치 파일 적용

ppt-kor\data\build 디렉터리와 ppt-kor\data\build-images에 생성된 디렉터리들을 뿌요뿌요 테트리스가 설치된 디렉터리 (일반적으로 C:\Program Files (x86)\Steam\steamapps\common\PuyoPuyoTetris)의 data_steam\data 디렉터리 내부에 덮어씌우면 패치가 적용됩니다.

패치 파일을 적용하시기 전에 원본 data_steam 디렉터리를 백업하시길 권장합니다.

License

본 프로젝트는 MIT License 하에 제공됩니다.

yf-dev/puyopuyotetris-kor