코드워커 1(GTA)
CodeWalker(CW)는 그랜드 테프트 오토 V를 위한 오픈 소스 모딩 애플리케이션입니다.
개요
이 소프트웨어는 실시간 절차적 우주 엔진인 "Galaxia"를 만든 것으로 알려진 Dexyfex에 의해 제작되었습니다. 2017년 초에 개발이 시작되었으며, 처음에는 인터랙티브 등각/2D 맵 생성 도구로 설계되었으나 빠르게 3D 맵 뷰어 및 편집기로 발전했습니다. 이 프로그램은 사용자가 다양한 GTA V 파일 형식을 탐색, 추출 및 편집할 수 있도록 지원합니다.
최신 '공식' 릴리스 빌드는 2018년 3월 14일에 출시된 버전 29(r29)이지만, 이후 소프트웨어는 다음 공식 릴리스를 위해 40회 이상의 개발 업데이트를 거쳤습니다. 개발 업데이트는 비교적 자주 이루어지며, 다른 사용자들이 다운로드하여 사용할 수 있도록 dexyfex/CodeWalker의 GitHub에 커밋됩니다.
이 애플리케이션은 오픈 소스 소프트웨어로, 다른 사용자가 소프트웨어 코드를 다운로드, 추출 및 수정할 수 있습니다. CodeWalker의 대다수 기능은 제작자에 의해 구현되었지만, 호스트의 Discord 서버나 Git을 통해 다른 사용자(기여자)들이 추가 파일 형식 지원 및 기존 기능에 대한 수정 및 개선 사항을 제출하기도 했습니다.
응용 프로그램
CodeWalker는 사용자가 서로 다른 파일을 다양한 방식으로 보고 탐색할 수 있도록 여러 개의 개별 실행 가능한 애플리케이션으로 나뉩니다.
CodeWalker (3D 맵 뷰어)
CodeWalker의 주 목적은 GTA V의 산 안드레아스 세계를 렌더링하는 것입니다. 자유 시점 카메라를 사용하여 사용자가 세계를 탐험할 수 있습니다.
보기
보기 모드를 변경하여 월드 뷰, Ymap 뷰, 오브젝트 뷰 등 렌더링할 3D 오브젝트를 제어할 수 있습니다. 이를 통해 개별 에셋, 맵 섹션 또는 전체 게임 월드(기본값)를 탐색할 수 있습니다.
3D 맵 뷰어에는 렌더링 대상을 추가로 제어할 수 있는 다양한 옵션과 슬라이더가 포함되어 있습니다:
- LOD(HD, OrphanHD, 상세 수준(LOD), SLOD(슈퍼 상세 수준) 포함)
- 필터 옵션(스크립트 맵, 시간대별 맵 등)
- DLC 맵 활성화/비활성화.
마커
이 애플리케이션은 세계의 특정 지점에 마커를 설정하는 데 사용할 수 있습니다. 현재 카메라 위치를 기준으로 설정하거나 특정 좌표를 입력하여 마커를 추가할 수 있습니다. 또한 사용자는 추가된 좌표로 이동할 수도 있습니다.
선택
사용자는 선택 모드에서 다양한 게임 월드 요소를 보고, 선택하고, 상호 작용할 수 있습니다:
- 선택/보기 모드:
- 엔티티(메시 오브젝트)
- 엔티티 확장
- 아키타입 확장(물방울, 불꽃, 파리 등과 같은 파티클 효과 렌더링에 주로 사용)
- 시간대 수정자(조명 및 포스트 프로세싱 필터 제어)
- 자동차 생성기(주차된 차량이 생성될 위치 정의)
- 잔디(3D 잔디 배치)
- 물 쿼드
- 물 진정 쿼드
- 물 파도 쿼드
- 충돌(충돌 BVH)
- 내비게이션 메시(보행자용 내비게이션)
- 경로(차량용 내비게이션)
- 기차 선로
- LOD 조명(가로등, 건물 등의 낮은 상세 수준의 코로나)
- MLO 인스턴스(인테리어 에셋)
- 시나리오
- 오디오(오디오 존)
- 오클루전(박스 및 메시 오클루전).
기타 옵션
애플리케이션 동작, 카메라 및 컨트롤에 대한 옵션을 사용할 수 있습니다:
- 전체 화면 모드
- 카메라 모드(원근, 등각 투영, 2D)
- 시야각(FOV)
- 맵 상세 수준
선택 모드와 관계없이 화면에 영구적으로 표시되는 도우미 기능을 활성화할 수도 있습니다:
- 기차 경로
- 자동차 생성기
- 인구 밀집 구역
- 스켈레톤(뼈대)
- 마커 스타일(설정된 마커용)
렌더링 및 디스플레이 모드를 제어하는 기타 다양한 옵션이 있습니다:
- 렌더링 모드(단일 텍스처, 정점 노멀, 정점 탄젠트, 정점 색상, 텍스처 좌표 등)
- 텍스처 샘플러(디퓨즈, 노멀 맵, 스페큘러, 하이트맵, 안개 등)
- 와이어프레임 모드
- HD 텍스처링
- 근거리/원거리 클리핑
조명 및 음영 제어도 가능합니다:
- 디퍼드 셰이딩
- HDR 렌더링
- 그림자
- 스카이돔
- HD 조명
- 자연광/인공 조명
- 시간대/빛의 방향
- 날씨
- 구름
CodeWalker Ped Viewer (보행자 뷰어)
CodeWalker Ped Viewer는 게임 내 보행자(Ped) 및 동물 모델을 탐색하고 볼 수 있게 해주는 별도의 CodeWalker 애플리케이션입니다. 사용자는 보행자의 의상 구성 요소를 선택하고, 보행자의 LOD 모델 및 텍스처를 확인하며, 애니메이션을 미리 볼 수 있습니다.
사용 가능한 보행자에는 GTA V와 GTA 온라인(GTA) DLC의 게임 내(IG) 및 컷신(CS/CSB) 보행자와 동물이 포함됩니다.
구성 요소
선택한 GTA V 보행자에 따라 다양한 구성 요소 옵션을 사용할 수 있으며, 각 구성 요소 카테고리는 드롭다운 메뉴로 분류됩니다:
Head(머리)Berd(수염)Hair(헤어)Uppr(상체)Lowr(하체)Hand(손)Feet(발)Teef(치아/입)Accs(액세서리: 가방, 벨트 등)Task(작업)Decl(데칼: 배지, 스티커 및 기타 데칼)Jbib(재킷/빕)
애니메이션
애니메이션 필드를 통해 선택한 보행자에게 모든 애니메이션을 재생할 수 있습니다. 기본적으로 보행자의 프리셋 애니메이션 클립 사전(peds.meta의 ClipDictionaryName 항목에 정의됨)이 로드되어 즉시 선택 및 미리보기가 가능하지만, 사용자가 다른 클립 사전의 파일 경로를 입력하여 재생할 수도 있어 독특한 결과를 얻을 수 있습니다.
CodeWalker Vehicle Viewer (차량 뷰어)
CodeWalker Vehicle Viewer는 게임 내 차량 모델을 탐색하고 볼 수 있게 해주는 별도의 CodeWalker 애플리케이션입니다. 사용자는 차량의 충돌 모델, 유리 파편, 와이어프레임, 정점 정보 및 텍스처를 볼 수 있습니다. 차량 제조사와 이름(HUD에 표시되는 전역 텍스트 파일에서 가져옴)도 함께 표시됩니다.
기능은 다음과 같습니다:
- 고상세 프래그먼트 - 더 높은 상세 수준의 모델 렌더링(근접 시 렌더링; 향상된 버전 모델 개선 사항)
- 충돌 메시 - 모든 충돌 경계 및 메시 렌더링(더미 충돌 경계 및 바퀴 포함)
- 스켈레톤 - 모든 뼈대 및 관계선 렌더링
- 창문 파손 맵 - 차량 창문 유리 파편 및 파손 맵 렌더링(절차적 깨진 창문 유리 파편 생성용)
-
그레인저 3600LX에 렌더링된 충돌 메시 예시. -
버스에 렌더링된 창문 파손 맵 예시.
CodeWalker RPF Explorer
CodeWalker RPF Explorer는 GTA V 게임 파일을 전반적으로 탐색하고 편집할 수 있는 별도의 애플리케이션입니다. 왼쪽의 계층 구조 트리와 함께 윈도우 탐색기와 유사한 파일 관리자 시스템을 사용합니다.
파일이나 폴더를 클릭하여 게임 파일을 원활하게 탐색할 수 있습니다. 탐색 중에 계층 구조 트리에서 폴더를 확장하거나 축소하여 하위 콘텐츠를 미리 볼 수 있습니다. "검색" 기능을 사용하여 입력한 텍스트가 포함된 파일이나 폴더 이름을 검색할 수도 있습니다. 검색 결과 목록을 선택, 복사 또는 내보낼 수 있습니다.
대부분의 파일 형식은 더블 클릭으로 열어 미리 볼 수 있습니다. 편집 모드가 활성화되어 있으면 RPF 탐색기 최신 버전에서 대부분의 텍스트 또는 메타 기반 파일의 콘텐츠를 편집할 수 있습니다.
초기 버전에서는 파일 추출만 가능했지만, 이후 버전에서는 선택한 파일을 마우스 오른쪽 버튼으로 클릭하여 다양한 파일 형식을 XML 형식으로 내보낼 수 있습니다. 내보낸 파일은 "XML" 접미사가 붙으며, 기본 텍스트 편집기(예: 메모장 또는 Notepad++)에서 편집한 후 다시 가져올 수 있습니다. 파일 유형에 따라 내보낸 XML은 DDS 텍스처나 WAV 사운드 파일과 같은 다른 에셋이 담긴 폴더를 동반할 수도 있습니다. 파일 내보내기 및 가져오기는 드래그 앤 드롭 기능을 지원합니다. 파일 가져오기나 편집을 위해서는 "편집 모드"를 활성화해야 합니다.
RPF 탐색기는 초기 CodeWalker 3D 애플리케이션에서 액세스할 수 있는 여러 도구에 대한 액세스도 제공합니다:
- 바이너리 검색
- 오디오 탐색기
- JenkGen
- JenkInd
RPF 탐색기는 다양한 테마를 지원합니다:
- 기본(Windows)
- 파랑
- 밝음
- 어두움
이전 RPF 브라우저
빌드 버전 27(r27) 이전에는 CodeWalker의 파일 브라우저(당시 "CodeWalker Explorer")가 전용 바이너리 검색 도구와 유사한 바이너리 검색 시스템을 사용했습니다. 게임 파일을 탐색하려면 먼저 GTA V 폴더를 스캔하여 패키지 파일(.rpf) 목록을 생성해야 했으며, 각 파일을 확장하여 탐색할 수 있었습니다. 초기 버전의 파일 시스템은 미리보기를 지원하지 않았으나, 기본 메타데이터, 맵 데이터 및 텍스처 파일과 같은 특정 유형의 파일은 내보낼 수 있었습니다. 텍스처 사전(ytd) 내의 텍스처를 볼 수 있는 텍스처 미리보기 도구도 지원되었습니다.
RPF 브라우저는 버전 28(r28)에서 추가된 현재의 RPF 탐색기로 대체되었지만, 기존 브라우저는 현재 RPF 탐색기의 "도구" 섹션에서 "Old RPF Browser"라는 이름으로 여전히 액세스할 수 있습니다.
도구
CodeWalker dev44에서 사용할 수 있는 도구 목록입니다.
| 도구 | 설명 | 이미지 예시 |
|---|---|---|
| 선택 정보 | 선택 정보는 3D 뷰어에서 선택한 엔티티 객체에 대한 정보를 표시합니다. 사용자가 선택한 엔티티의 계층 구조와 사용하는 셰이더 및 텍스처를 탐색할 수 있습니다. |  |
| 프로젝트 창 | 프로젝트 창은 새로운 모딩 프로젝트를 생성, 관리 및 유지 관리하는 데 사용됩니다. CodeWalker 프로젝트는 .cwproj 파일 확장자로 저장 및 열 수 있습니다. 프로젝트는 ymap(맵), ytyp(아키타입), ybn(충돌 경계), ynd(경로 노드), ynv(내비게이션 메시), 기차, 시나리오 및 오디오 데이터 파일의 생성 및 편집을 지원합니다.
|
 |
| 컷신 뷰어 | 컷신(.cut)은 컷신 뷰어를 사용하여 실시간으로 탐색하고 재생할 수 있습니다. 오디오 재생 및 자막도 지원됩니다. 컷신에 사용된 객체와 애니메이션 목록도 표시됩니다.
|
 |
| 오디오 탐색기 | 오디오 탐색기는 오디오 데이터 파일 항목을 탐색하는 데 사용할 수 있습니다. 선택한 오디오 항목의 계층 구조를 표시합니다. 오디오 데이터 파일 확장자와 오디오 항목 유형별로 탐색할 수 있습니다. |  |
| 월드 검색 | 월드 검색 도구를 사용하면 특정 엔티티나 아키타입을 검색하여 세계 내의 모든 사용처와 위치를 찾을 수 있습니다. 도구는 개별 맵 파일 내의 일치 항목 목록을 생성합니다. 선택한 결과는 마커를 사용하여 맵에 표시하거나 해당 위치로 직접 이동할 수 있습니다. 결과를 텍스트 파일로 내보낼 수도 있습니다. |  |
| 바이너리 검색 | 월드 검색과 유사하게, 바이너리 검색은 일치 항목을 검색합니다. 텍스트 또는 16진수 해시를 입력하여 특정 파일 형식으로 제한하거나 전체 게임을 대상으로 광범위한 검색을 수행할 수 있습니다. 파일 내의 일치 항목을 검색하며, 파일이 충분히 작으면 일치 항목의 미리보기가 생성됩니다. 더 큰 파일의 경우 파일을 직접 내보낼 수 있습니다. 바이너리 검색은 파일 시스템 검색을 사용하여 GTA V 디렉토리 외부의 파일 및 폴더에 대해서도 수행할 수 있습니다. |  |
| JenkGen | 'Jenkins hash generator'의 약자인 JenkGen은 입력값을 바탕으로 해시를 생성하는 작은 도구입니다. 이 생성기는 (QWORD 및 DWORD 아키텍처를 사용하여) 부호 있는 정수 값과 부호 없는 정수 값, 그리고 16진수 값을 UTF-8 또는 ASCII 인코딩으로 생성합니다. 이 도구는 GTA V 내에서 많은 해시를 생성하는 데 사용되는 해시 알고리즘인 Jenkins 해시 함수에서 이름을 따왔습니다. |  adder"라는 문자열을 Jenkins 해시 함수로 변환하여 16진수 해시 값 "0xB779A091"을 얻은 결과. |
| JenkInd | 'Jenkins index lookup'의 약자인 JenkInd는 부호 있는 정수 값과 부호 없는 정수 값, 그리고 16진수 해시 값을 역검색하는 도구입니다. 해시와 일치하는 문자열이 전역 텍스트 파일 .gxt2 또는 Jenk Index 데이터베이스 자체에 정의되어 있으면 잠재적인 일치 결과가 나열됩니다.
|
 0xB779A091"에 대한 해시 조회 예시로, 전역 텍스트 및 Jenk Index 조회 결과인 "adder"가 표시됩니다. |
| 추출 옵션 | ||
|---|---|---|
| 스크립트 추출 | 원본 파일 추출 | 셰이더 추출 |
| 다양한 파일 형식을 빠르게 추출할 수 있는 도구도 CodeWalker 도구 모음에서 사용할 수 있습니다. | ||
CodeX
CodeX는 CodeWalker의 후속작으로 설계 중인 모딩 애플리케이션이며, 그랜드 테프트 오토 IV, 그랜드 테프트 오토 V, 맥스 페인 3, 레드 데드 리뎀션 2를 포함한 여러 락스타 게임즈 타이틀과 폴아웃 4, 엘더스크롤 4: 오블리비언, 사이버펑크 2077 등 다른 게임들도 지원합니다. 2020년 초에 개발이 시작되었습니다.
현재 초기 개발 단계이며, dexyfex Patreon.com의 후원자만 사용할 수 있습니다. CodeWalker와 비교했을 때, CodeX는 처음부터 완전히 재구축되었으며 향상된 렌더링 시스템, 선택 시스템 및 추가 편집 도구 개선 사항을 갖추고 있습니다.
최신 버전인 CodeX dev019는 폴아웃 4 지원과 RDR2의 PSO/RSC 메타데이터 리소스 및 XML 파일 편집 기능을 추가했습니다. 개발 빌드와 오픈 소스 코드는 앞서 언급한 후원자를 위해 CodeWalker Discord에 공개됩니다.