Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/izh318/priconne_extraction_tools_portable
게임 '프린세스 커넥트! Re:Dive'의 클라이언트 파일을 오프라인 환경에서 국가 상관 없이 Resource를 추출 및 변환하는 도구입니다.
https://github.com/izh318/priconne_extraction_tools_portable
priconne princess-connect-redive
Last synced: 1 day ago
JSON representation
게임 '프린세스 커넥트! Re:Dive'의 클라이언트 파일을 오프라인 환경에서 국가 상관 없이 Resource를 추출 및 변환하는 도구입니다.
- Host: GitHub
- URL: https://github.com/izh318/priconne_extraction_tools_portable
- Owner: IZH318
- License: mit
- Created: 2024-05-24T19:53:58.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-06-01T17:12:54.000Z (7 months ago)
- Last Synced: 2024-06-01T19:42:14.519Z (7 months ago)
- Topics: priconne, princess-connect-redive
- Homepage:
- Size: 64.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 프린세스 커넥트! Re:Dive Resource 추출 도구
게임 '프린세스 커넥트! Re:Dive'의 클라이언트 파일을 오프라인 환경에서 국가 상관 없이 Resource를 추출 및 변환하는 도구입니다.
(* 미처 발견하지 못한 오류가 있을 수 있습니다.)
## 🔍 주요 기능
■ 클라이언트 파일이 있는 위치에서 스크립트를 실행하면 각 파일 이름을 원본 이름으로 변경 후 파일이 추출됩니다.
(* 확장자 별 변환 과정은 다음과 같습니다.)
- *.unity3d -> *.png, *.txt
- *.awb, *.acb -> *.wav
- *.usm -> *.mp4
- *storydata.bytes -> *.json
- *storydata_storydata.bytes -> *.*
## 💾 다운로드
[](https://github.com/IZH318/PRICONNE_EXTRACTION_TOOLS_Portable/releases)
### ※ 추출 도구는 상단 쥬얼 아이콘을 클릭 또는 본 Repositories의 Releases로 이동하여 다운로드 하십시오.
### ※ 본 도구를 사용할 때 필요한 모든 파일들은 zip 파일 내 `📁\01_Install` 폴더에 포함되어 있습니다.
***.zip 파일 내 제공 된 파일들을 사용하려는 경우 개별 다운로드 과정을 생략해도 되며, 제공 된 설치 파일들을 신뢰하지 않을 경우 아래 링크를 통해 개별 다운로드 하시기 바랍니다.**
| Program | URL | 필수여부 | 비고 |
|----------------------------------------|----------------------------------------------------|----------|------------------------------------------------------------------------------------------------|
| `Python 3.10.11` | [Download](https://www.python.org/downloads/release/python-31011/) | 필수 | ◼ Python Script 동작, 파이썬 3.10.xx 버전 중 아무거나 사용 가능
◼ 단, 3.10.xx 버전이 아닌 다른 버전은 확인한 적 없으므로 정상적인 작동을 보장하지 못 함 |
| `dotNET 3.1` | [Download](https://dotnet.microsoft.com/en-us/download/dotnet/3.1) | 필수 | ◼ Audio 파일 또는 Video 파일을 변환할 때 사용 |
| `K-Lite Codec Pack 18.3.0 (Mega)` | [Download](https://codecguide.com/download_k-lite_codec_pack_mega.htm) | 선택 | ◼ Audio 및 Video 코덱 설치
◼ 추출 된 Audio 파일 또는 Video 파일이 정상적으로 재생되지 않을 때 설치
◼ 18.3.0 버전이 아니어도 됨 |
## ❗ 주의 사항 ❗
### ※ 모든 내용은 2024-05-29 JP, KR 서버 업데이트 기준이며, 작업 시점 또는 방법에 따라 총 용량 및 파일 개수가 달라집니다.
### ※ 반드시 저장 장치의 여유 공간을 확인 후 작업하시기 바랍니다.
### ※ 발견 된 문제를 미리 확인하여 작업 중 적절히 대처할 수 있도록 준비하십시오.
📛 지금까지 발견 된 문제
`01. 한국 서버 클라이언트 일부 *.usm 파일 소리 깨짐`
`\m\t` 폴더에 있는 *.usm 파일 중 일부 *.usm 파일이 정상적으로 변환되지 않음
**클라이언트 또는 manifest.db에서 가르키는 각 폴더별 명칭은 아래 목록을 클릭하여 참고하십시오.**
🗂 각 폴더별 이름
```
\a = Asset
\b = BGM
\s = SE(Sound Effect)
\v = Voice
\t = Temp
```
**각 manifest의 구조는 아래 목록을 클릭하여 참고하십시오.**
🧾 All Manifests (Level 2)
※ 원본 국가, 작업하는 시점 또는 방법에 따라 일부 다르게 표기될 수 있음
```
📁 Priconne_Extractor
├📁 a
│ ├📁 all
│ ├📁 animation
│ ├📁 arcade
│ ├📁 banner
│ ├📁 bg
│ ├📁 caravan
│ ├📁 clanbattle
│ ├📁 colosseum
│ ├📁 comic
│ ├📁 consttext
│ ├📁 dailytask
│ ├📁 dungeon
│ ├📁 event
│ ├📁 font
│ ├📁 gacha
│ ├📁 howtoplay
│ ├📁 icon
│ ├📁 jukebox
│ ├📁 knightenhance
│ ├📁 lipsyncothers
│ ├📁 loginbonus
│ ├📁 masterdata
│ ├📁 minigame
│ ├📁 resourcedefine
│ ├📁 room
│ ├📁 roomeffect
│ ├📁 roomfinger
│ ├📁 roomgrid
│ ├📁 roomicon
│ ├📁 roomitem
│ ├📁 roomthumb
│ ├📁 shader
│ ├📁 spine
│ ├📁 storydata
│ ├📁 talentquest
│ ├📁 travel
│ ├📁 unit
│ └📁 wac
├📁 assets
├📁 b
├📁 m
│ └📁 t
├📁 manifest
├📁 s
└📁 v
└📁 t
```
## ⏩ 사용 방법
01. zip 파일 다운로드 후 적절한 위치에 압축 해제 합니다.
2. `01_Install` 폴더로 이동 후 본문 상단 `💾 다운로드`을 참고하여 파일을 설치합니다.
**[ ※ 주의 ] Python 설치 시 Add python.exe to PATH 에 반드시 체크 후 Install Now 클릭**
(📌 미처 누르지 못했다면 설치파일을 다시 실행 또는 소프트웨어 제거 후 재 설치)
3. 모두 설치가 끝났다면 `02_Tools` 폴더로 이동합니다.
4. `00. Install required Python packages.bat` 파일을 실행하여 Python Package를 설치합니다.
(📌 필수 Python Package 설치가 끝나면 위와 같은 화면이 표시됩니다.)
5. 게임 클라이언트 원본 구조를 그대로 유지한 상태로 스크립트가 있는 경로로 불러옵니다.
6. `01. Manifest File Renamer.py` 파일을 실행하여 SHA1 Hash로 저장 된 파일 이름을 변경합니다.
(📌 파일 이름이 모두 변경되면 위와 같은 화면이 표시됩니다.)
7. `02. unity3d File Converter.py` 파일을 실행하여 *.unity3d 파일에서 Asset을 추출(변환)합니다.
**[ 🛑 경고 🛑 ] 반드시 저장 공간이 여유로운 곳에서 작업하십시오.**
(📌 작업이 성공적으로 끝나면 위와 같은 화면이 표시됩니다.)
(📌 `\a\_Converted` 폴더)
작업이 성공적으로 끝나면 원본 Resource 폴더 내 `_Converted` 폴더가 생성되며, 해당 폴더 내부에 원본 *.unity3d 파일 이름으로 추출(변환) 된 Asset이 저장되어 있는 것을 확인할 수 있습니다.
8. `03. Audio File Converter.py` 파일을 실행하여 *.acb, *.awb 파일에서 Resource를 추출(변환)합니다.
**[ 🛑 경고 🛑 ] 반드시 저장 공간이 여유로운 곳에서 작업하십시오.**
(📌 작업이 성공적으로 끝나면 위와 같은 화면이 표시됩니다.)
(📌 `\b\_Converted` 폴더)
작업이 성공적으로 끝나면 원본 Resource 폴더 내 `_Converted` 폴더가 생성되며, 해당 폴더 내부에 원본 *.acb 파일 이름 또는 *.awb 파일 이름으로 추출(변환) 된 Resource가 저장되어 있는 것을 확인할 수 있습니다.
9. `04. Video File Converter.py` 파일을 실행하여 *.usm 파일에서 Resource를 추출(변환)합니다.
**[ 🛑 경고 🛑 ] 반드시 저장 공간이 여유로운 곳에서 작업하십시오.**
(📌 작업이 성공적으로 끝나면 위와 같은 화면이 표시됩니다.)
(📌 `\m\_Converted` 폴더)
작업이 성공적으로 끝나면 원본 Resource 폴더 내 `_Converted` 폴더가 생성되며, 해당 폴더 내부에 원본 *.usm 파일 이름으로 추출(변환) 된 Resource가 저장되어 있는 것을 확인할 수 있습니다.
## 선택 작업
**아래 작업은 필수 작업은 아니며, 필요에 따라 사용하시면 됩니다.**
**[선택 작업]**
캐릭터 명을 모두 추출하고 싶다면 `05. Character List Export.py` 파일을 실행합니다.
**[선택 작업]**
입력 한 캐릭터명 전체 또는 일부를 기준으로 대사 정보 및 Audio 파일 정보를 찾고싶다면 `06. Vocal Resource Info Export.py` 파일을 실행합니다.
예를 들어, 'コッコロ(=콧코로)'를 입력하지 않고, 'コ'만 입력 후 검색을 하면 모든 캐릭터 이름 중 'コ'가 포함 된 캐릭터 모두 결과값을 반환합니다.
(📌 위 GIF에 녹화 된 내용 기준으로 'コッコロ(콧코로)', 'ペコリーヌ(=페코린느)', 'マコト(=마코토)', 'ミヤコ(=미야코)' 등 'コ'가 포함 된 결과가 출력 된 것을 확인할 수 있습니다.)
**[선택 작업]**
원본 Resource 파일을 모두 제거하려는 경우 `07. Original Resource Remover.bat` 파일을 실행하여 원본 Resource 파일을 제거합니다.
## ⚙ 고급 설정 (선택)
### ※ 이 작업은 Python 언어로 작성 된 Script의 내용을 이해하고 응용할 수 있는 분들께 추천드리는 작업입니다.
### ❗ 필수 작업 ❗
`파일 -> 옵션 -> 보기 -> 숨김 파일 및 폴더`상태를 `숨김 파일, 폴더 및 드라이브 표시`로 변경 후 확인
수정하고자 하는 파일 선택 후 `마우스 우클릭 -> 속성 -> 일반 -> 특성`항목 중 `읽기 전용(R)`상태 해제 후 확인
**위 작업을 모두 끝낸 후 작업하시기 바랍니다.**
🛠 *.usm 파일을 *.mp4 파일이 아닌 다른 확장자로 변환하고자 하는 경우?
`PRICONNE_EXTRACTION_TOOLS(Portable)_AIO`에 포함 된 `UsmToolkit`은 FFmpeg 표준 구문을 사용합니다.
01. `\04. Video File Converter.py`코드 중 `extract_path = output_folder_path / (usm_file.stem + ".mp4")` 부분에서 `.mp4` 수정
02. `\02_Tools\usmtoolkit`로 이동 후 `config.json`파일 내용 중 `OutputFormat`부분 수정
```
# 만약, *.mp4 파일이 아닌 *.mkv 파일로 저장하고 싶다면?
# ▼ 04. Video File Converter.py 파일 내용 중 일부 ▼
# 변환할 *.mp4 파일 경로 생성
extract_path = output_folder_path / (usm_file.stem + ".mp4") # <--- 확장자 수정
# ▼ config.json 파일 내용 ▼
{
"VideoParameter" : "-c:v copy",
"AudioParameter" : "-c:a ac3",
"OutputFormat" : "mkv" # <--- 확장자 수정
}
```
**보다 자세한 설정은 FFmpeg 표준 구문을 확인하시기 바랍니다.**
[📚 FFmpeg 표준 구문 보러 가기](https://ffmpeg.org/ffmpeg-codecs.html)
## 해야 할 일
- 게임 출석
- 콧코로 수첩
- 지역
- 이벤트 스토리
- 던전
- 아레나, 프레나
- 클랜전
## Special Thanks to
✨ Princess Connect! Re:Dive Game Users