굶지마 캐릭터 모드 만드는 과정 정리
1.캐릭터 샘플 다운받기
굶지마 캐릭터 빌드 템플릿을 다운받아 준다.
Deowolf의 extended character template 다운로드 받기
둘 다 동일한 파일이니 버전만 잘 확인하면 된다. 굶지마 포럼의 경우 다운받는데 클레이 로그인이 필요할 수 있다.
포럼에는 튜토리얼 영상도 있으니 참조.
2.vsCode 또는 Notepad++로 이름 바꾸기(대소문자 구분)
다운받은 프로젝트 파일의 폴더명으로 압축을 푼다.
vsCode 또는 Notepad++ 처럼 전체파일 내부의 텍스트 바꾸기와 같은 특수한 기능이 있는 코드 편집기로 프로젝트 폴더를 연다.
- 대소문자 구분에 유의하여 캐릭터의 이름을 수정해준다. ( ctrl + f 키를 누르면 탐색 창이 열린다. )
*샘플 캐릭터의 이름은 esctemplate로, 반드시 대소문자를 구분하여 바꾸려는 캐릭터의 이름으로 바꿔준다.
esctemplate, ESCTEMPLATE => 바꾸려는 캐릭터 소문자명, 바꾸려는 캐릭터 대문자명
.lua 내부 파일들은 물론이고, exported안에 있는 프리팹 폴더명과 .scml파일, .png파일의 이름들도 수정해주어야한다.
.xml 파일은 지우게 되니 신경쓰지 않아도 상관없다.
👉 클레이 포럼 외부 링크: 캐릭터 초상화의 이름을 수정할 수 있는 굶지마 폰트(이미지)
3.exported, images 의 png 파일 편집하기
프로젝트 폴더의 exported와 images 폴더 안에 있는 png들을 모드캐릭터에 맞게 이미지를 수정해준다.
*png파일의 픽셀 크기 및 해상도는 건드리지 않는 것이 모드 템플릿에 권고되어있다.
굶지마 애니메이션 빌드 파일을 만들기가 까다롭기 때문이다..
png이미지를 바꾼 건 좋은데, 바꾼 이미지가 비뚤어지지 않았는지 어떻게 확인할까?
스팀을 켜고, 라이브러리에 들어가서 검색 탭 바로 위쪽에 있는 필터링 바를 클릭해준다.
Don’t starve mod tools 프로그램이 보일텐데, 미설치인 경우 설치해주자.
Mod tools를 우클릭하여 실행하면, 위와 같은 창이 뜬다.
Launch Spriter를 체크하고 실행한다.
File > Open Project 로 캐릭터 exported 폴더에 있는 .scml 파일을 다음처럼 열어볼 수 있다.
.scml은 게임을 켜지 않고도 캐릭터의 모습을 미리 볼 수 있게 해준다.
*주의: png 파일만 편집. scml은 새로 저장하거나 건드리지 않기.
모습이 잘 적용된 것 같다면 .scml을 저장하지 말고 4번으로 넘어가자.
4 anim폴더 내부, .xml, .tex 파일 지우고 로컬 mods 폴더 안에 복사, 붙여넣기
굶지마는 압축된 .xml과 .tex 파일로 이미지를 불러온다.
컴퓨터가 읽을 수 있는 파일로 변환시키기 위해 프로젝트 폴더 내부의
modicon(모드 아이콘)의 tex,xml. portraits(초상화)의 tex, xml. images 폴더 안에 있는 .tex와 .xml 파일들을 모두 제거해준다.
또한 컴파일러가 애니메이션 빌드를 다시 생성해야 하기 때문에, 캐릭터 모드 폴더 안에 있는 anim폴더 내부의 zip도 없애준다.
anim폴더 내부의 zip이 없어야 컴파일러가 .scml을 다시 변환하고, xml파일이 없어야 tex파일과 xml파일을 생성한다.
anim 폴더 안의 .zip파일들과 .tex와 .xml을 다 제거해주었다면, 다음 경로로 가서 폴더를 열어준다.
1 | #굶지마 투게더 모드폴더 경로 |
로컬 모드를 적용시키기 위해
mods 폴더에다 여태껏 만든 프로젝트 폴더를 드래그하지 말고, 원본을 ctrl+c , ctrl+v 한다.
굳이 드래그해서 옮기지 않는 이유는 원본을 보존하기 위함이다.
5.Don’t starve 게임을 켜서 컴파일러 작동시키기
Don’t starve mod tools 를 다운받은 이후 게임을 켜면,
까만 콘솔창이 뜨게 되는데 이는 컴파일러이다.
컴파일러가 미변환 모드를 체크하고 .scml => .anim 또는 .zip으로, .png는 tex와 xml로 변환한다.
컴파일러가 저절로 꺼질 때까지 기다리면, 컴파일러가 변환을 완료하고 굶지마 게임이 자동으로 실행된다.
게임이 켜진 김에 모드를 적용하고 월드를 생성해 본다.
여기까지 잘 따라왔다면 캐릭터의 초상화도 잘 나올 텐데, 정작 캐릭터의 이름이 보이질 않는다.
6.tex 파일 생성 확인
steam의 mods 폴더를 열고 만든 모드 폴더에 들어가보자.
modicon을 제외하고 각 .png마다 tex와 xml 파일이 생성된 것을 확인할 수 있을 것이다.
7.캐릭터 이름 지정 xml 내부의 tex파일 지정 구문 수정하기
파일도 정상적으로 생성되었는데, 왜 캐릭터의 이름이 보이지 않는 것일까?
템플릿 파일을 주의깊게 봤다면 이름 png 옆에 조그맣게 안내문 txt 파일이 있는 것을 확인할 수 있다.
내용을 읽어보면, xml 파일을 열어 tex이름을 지정하는 구문을 수정해주어야 이름 텍스트가 적용된다는 말이다.
mods 폴더를 열고 만든 모드 폴더를 코드 에디터로 열어준다.
names와 names_gold.xml파일을 열고, 다음처럼 수정하고 저장한다.
그리고 자동으로 tex와 xml을 생성하지 않는 modicon.png도 잠깐 images 폴더에 복사해 준다.
컴파일러를 다시 실행시키면, modicon의 tex와 xml이 생성되는 걸 볼 수 있다.
변환된 모드아이콘은 tex, xml과 같이 modmain.lua가 있는 위치에 넣어주자.
8. 작동 확인
초상화와 이름도 잘 출력된다.
인게임에서 테스트하며 모드가 잘 작동되는지 확인한다.
그 외
심화
손으로 들 수 있는 간단한 물건 만들기
캐릭터 자체음성 만들기
모드 업로드하는 법
추후 게시 예정..
간단한 디버깅
로컬에서 모드 적용하기
만들어둔 모드 프로젝트 폴더를 mods 아래에 두고 게임을 실행한다.
프로젝트 폴더의 바로 아래에는 modmain.lua와 modicon.png 또는 tex가 있어야 한다.
모드 작동 시 어디서 오류가 나는지 보기
기존 게임에서는 모드 오류 시 오류 메세지를 반환하고 그대로 게임이 멈추었으나, 모더가 아닌 일반 사용자들의 이용을 고려한 탓인지 오류 메세지를 master로그에 숨기고,
사용자들이 모드를 배제하고 게임을 플레이할 수 있도록 업데이트되었다.
덕분에 모드 디버깅이 좀 까다로워졌다.
1 | #투게더 로그파일 경로 |
해당 파일에서 LUA ERROR 구문을 찾으면 된다. 무슨 오류이며 몇번째 줄에서 오류가 났는지 상세하다.
모드 파일에 문제가 없다면 대부분 resolve path, 경로를 찾지 못하는 오류이다.
asset등에서 참조하는 경로에 오탈자가 있거나, 어느 한 구문을 빼먹었거나,
tex파일이 생성되지 않아서 파일을 찾을 수 없는 경우, 파일 누락 등이 원인이다.
아이템 소환하기
모드로 만들어둔 아이템을 바로 테스트해보고싶을 수 있다.
아이템을 prefab으로 등록해두었다면 /c_give(“아이템 프리팹명”,갯수) 로 캐릭터 인벤토리에 들어오게 할 수 있다.
1 | #아이템 인벤토리에 넣기 |
1 | #아이템 소환하기 |
해결되지 않은 이슈
Together: saveslot 초상화에 대한 이슈
- 서버 리스트를 뿌려주는 화면에서 모드를 불러오지 못하기 때문에, 세이브파일 캐릭터 초상화에 항상 종이 윌슨이 그려지는 이슈. 포럼에서도 해결하기 까다로운 문제인 듯.
.dyn 파일에 관한 것
- 워톡스 등 클레이가 유료로 판매하는 아이템 또는 캐릭터의 애니메이션이 들어있는 파일이다. 이는 상업적 이용과도 연관되어 있다. 공식에서도 뜯지 말라고 하고, 무엇보다 암호화되어있다.