Skip to content

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

License

Notifications You must be signed in to change notification settings

yf-dev/puyopuyotetris-kor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

GitHub GitHub tag (latest SemVer)

뿌요뿌요 테트리스 인트로 스크린샷

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

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

패치 다운로드 및 적용방법

  1. 아래 패치 다운로드 링크에서 가장 최신의 build-<날짜>.zip 파일을 다운로드합니다.
  2. 뿌요뿌요 테트리스가 설치된 디렉터리 (일반적으로 C:\Program Files (x86)\Steam\steamapps\common\PuyoPuyoTetris)로 이동합니다.
  3. 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 뿌요뿌요 테트리스 스크린샷 2 뿌요뿌요 테트리스 스크린샷 3 뿌요뿌요 테트리스 스크린샷 4 뿌요뿌요 테트리스 스크린샷 5 뿌요뿌요 테트리스 스크린샷 6

직접 패치 생성 방법

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

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

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 디렉터리에 복사해야 합니다.

적절하게 덤프된 스위치 롬 카트리지의 romfsppt-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.batextract_switch_all.bat 명령을 pipenv shell이 구동중인 명령 프롬프트에서 실행합니다. 변환 과정은 약 40분 정도 소요될 수 있습니다.

4. 패치 파일 생성

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

이를 위해 ppt-kor\create_font_patch.batppt-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 하에 제공됩니다.