모딩 가이드

Nearly Dead는 공식적으로 모딩을 지원하며, 이를 위한 툴과 에셋, 공유할 장소인 스팀 창작마당 또한 준비되어 있습니다. 해당 장에서는 여러분이 기초적인 모딩을 하기 위한 기본 환경 설정 및 여러분이 모드를 올리기 위한 방법의 설명이 나옵니다.

## 기본 환경 설정

Nearly Dead의 모딩을 위한 기본 환경 설정은 다음과 같은 순서로 진행합니다.

1. **unity package 다운로드**
2. **Unity Hub 와 Unity Editor 설치**
3. **Unity 계정 생성 (이미 있다면 생략) 후 비상업 라이선스 활성화**
4. **Unity 실행 후 프로젝트 생성**
5. **(1)에서 받았던 Custom Package 를 import**

우선, Nearly Dead의 에셋이 담긴 **'unity package'**를 받아주세요. 최신 버전은 해당 문서에서 받으실 수 있습니다.

ND는 개발에 **Unity**를 사용하고 있으며, 따라서 모딩툴을 사용하기 위해서는 먼저 **Unity 에디터**를 설치해야 할 필요가 있습니다. **링크**를 통해 **Unity Hub**를 받아 설치한 후, 설치 파일을 실행해 설치하세요.

유니티를 사용하려면 라이선스에 계약을 해야 하며 이를 위해 계정을 만들어야 합니다.

Unity Hub의 우측 상단에 **톱니바퀴 모양의 아이콘**이 있습니다. 누르면 환경 설정 창으로 넘어갑니다.

**라이선스 관리** 탭을 누르고 하단의 **로그인**을 누르세요.

**'새로 ID를 만드세요'**를 클릭해 회원 가입 화면으로 넘어갑니다. **이미 계정이 있는 분들은 해당 과정을 생략**하고 로그인하시면 됩니다.

사용할 **이메일, 암호, 사용자 이름, 성명**을 입력하고 필수 항목에 동의, reCAPTCHA를 체크하고 **'Unity ID 만들기'**를 누르세요.

입력한 이메일로 확인 이메일이 올 것입니다. **'Link to confirm email'**을 누르면 계정 생성이 끝납니다.

다시 Unity Hub로 돌아와 로그인 후, **환경 설정**의 **라이선스 관리**로 돌아오면 **'새 라이선스 활성화'** 버튼이 활성화됩니다. **클릭**하세요.

라이선스 계약에서 **'Unity Personal' → 'Unity를 상업적으로 사용하지 않습니다'** 순으로 체크 후 완료를 누르세요.

라이선스 활성화가 끝났습니다. 이제 Unity Editor를 사용할 준비가 되었습니다.

하지만 Unity Hub에는 처음에 아무 것도 준비되어 있지 않을 것입니다. Unity Hub는 각 버전별 에디터를 이용하는 창구에 불과하기 때문에, 우선 에디터를 다운받아야 합니다. Nearly Dead는 **Unity 2020.1.13f1** 버전을 사용하고 있습니다. 해당 버전의 Unity 에디터는 **링크**에서 받으실 수 있습니다.

에디터 설치까지 끝마쳤다면 프로젝트 탭으로 다시 넘어와 새로 생성 탭을 클릭하세요.

템플릿은 그대로 두고 원하는 프로젝트 이름, 저장 위치를 지정 뒤 생성 버튼을 누르면 됩니다.

새 프로젝트 창이 뜨면 **에셋(Assets)** 탭에서 **'Import Package' → 'Custom Package'**를 누르고, 맨 처음에 받아 두었던 에셋을 엽니다.

**Import Unity Package** 창에서 전부 체크되어 있는 상태로 **Import**를 눌러주세요. 보통은 다른 항목을 추가로 체크 할 필요없이 누르기만 하면 될 것입니다. 해당 작업이 끝나기까지 시간이 상당히 소요될 수도 있습니다.

모든 작업이 끝나면 이제 모딩 툴을 사용할 준비가 끝났습니다! **Window** 탭에서 **'Nearly Dead' → 'JSON\_Editor'**를 클릭해 준비한 ND 전용 에디터를 원하는 위치에 배치시키면 기본 환경 설정 작업이 끝났습니다.

## 에디터 내 기초 요소

Nearly Dead의 데이터를 주로 생성 및 변경할 공간인 JSON\_Editor는 JSON 파일 자체와 하위 항목으로 이루어져 있습니다.

우선 코어 파일을 만들기 위한 JSON파일을 생성해야 합니다. 에디터가 들어 있는 경로 내 Resources 폴더 안에 우클릭 후 '새로 만들기 (W)' → '텍스트 문서' 순으로 누르면 텍스트 파일이 만들어집니다. 텍스트 파일에 해당 텍스트를 그대로 넣으세요:

```
{
  "mod id": "core",
  "data": [
    {

    }
  ]
}
```

그 후 확장자를 json으로 변경하면 코어 파일 파일 준비가 끝납니다.

하위 항목의 내용은 항목의 속성에 따라 다르지만, 총괄하는 부분은 동일하기 때문에 해당 부분부터 짚고 넘어가겠습니다.

1. 작업할 JSON 코어 파일을 선택합니다.
2. 작업한 JSON 코어 파일을 저장합니다.
3. 모드를 생성합니다.
4. 모드를 업로드합니다. 스팀 클라이언트에 로그인되어있어야 합니다.
5. 해당 하위 JSON 항목의 유형을 선택합니다.
6. 새로운 하위 JSON 항목을 추가합니다.

이제 모드를 만들 준비가 끝났습니다. 다음은 하위 JSON 항목에 따른 세부 요소입니다.

* 모딩 가이드/아이템
* 모딩 가이드/레시피

모드 제작 예시는 아래 문서에서 보실 수 있습니다.

모딩 가이드/예시

## 모드 생성 & 스팀 창작마당 업로드

추가된 json 코어 파일들과 여러 형식의 파일들을 모드를 생성하기 위해서는 'Generate Mod'를 통해 meta.json 파일을 생성해서 해당 폴더의 하위 폴더들을 모드로써 인식시키는 과정이 필요합니다.

모드를 생성, 또는 업로드하기 위해서는 미리보기 이미지가 해당 폴더 내에 'preview.jpg'의 이름과 확장자로 반드시 존재해야 합니다.

'Generate Mod' 버튼을 눌러 나오는 Window 탐색기로 모드화시킬 프로젝트 폴더를 선택하면 다음과 같은 화면이 나옵니다. 이 때, 다른 곳을 클릭할 경우 해당 창이 사라지므로 유의하시기 바랍니다.

1. 해당 모드의 이름을 작성합니다.
2. 해당 모드의 설명을 작성합니다.
3. 해당 모드의 변경 사항을 작성합니다.
4. 해당 모드 업로드 시 스팀 창작마당의 표시 형태를 지정합니다.
5. 해당 모드의 meta.json 파일을 생성합니다.
6. 해당 작업을 취소합니다.

'Upload Mod'를 통한 창작마당 업로드도 모드 생성과 기능이 거의 동일합니다. 다만, 업로드 기능을 정상적으로 실행하려면 스팀 클라이언트에 로그인되어 있어야 한다는 점을 명심하시기 바랍니다.

'Generate Mod'를 통해 meta.json 파일이 생성된 모드를 업로드할 경우, 해당 meta.json 파일의 정보를 그대로 가져옵니다.

1. 해당 모드의 이름을 작성합니다.
2. 해당 모드의 설명을 작성합니다.
3. 해당 모드의 변경 사항을 작성합니다.
4. 해당 모드 업로드 시 스팀 창작마당의 표시 형태를 지정합니다.
5. 해당 모드를 스팀 창작마당에 업로드합니다.
6. 해당 작업을 취소합니다.