안녕하세요, FVTT를 애용하는 여러분!
오늘은 컴펜디움을 공유하는 방법에 대해 안내해보려고 합니다.
컴펜디움을 새로운 월드에 옮겨와서 쓰거나, 혹은 다른 지인에게 건네줄 때 조금 불편하실 것입니다. 왜냐하면, FVTT는 컴펜디움 내보내기를 지원하지 않기 때문입니다. 아이템이나 저널은 한 요소씩 내보낼 수 있는데, 컴펜디움은 내보내기가 안됩니다.
따라서 컴펜디움을 공유하기 위해서는 약간 귀찮은 작업이 동반됩니다. 바로, 컴펜디움을 모듈로 만드는 작업입니다.
허미, 내가 모듈을 만든다고? 말만 들으면 되게 귀찮을것 같지만 엄청나게 쉽습니다.
이번에는 두 가지 방법으로 모듈을 만들어 볼건데요, 한가지 방법은 '로컬' 에서 만드는 방법이고, 다른 방법은 '깃허브' 를 이용해서 만드는 방법입니다. 둘 다 원리는 똑같기 때문에 어느 쪽이든 상관 없습니다.
모듈 만들기의 기초는 제가 이전에 작성한 적이 있으니, 그 포스팅을 참고하면 더더욱 이해가 될 것입니다.
* FVTT 공식 가이드를 참고하여 쓰고 있습니다.
https://foundryvtt.com/article/packaging-guide/
* FVTT를 제대로 사용할 예정이라면 코드 에디터는 웬만하면 설치해두시는 걸 추천합니다. 제 추천 에디터는 Visual Studio Code 입니다. 이 앞으로는 코드 에디터가 있다는 전제로 글을 쓰고 있습니다.
1. 내 월드에서 컴펜디움 파일 찾기
우선 옮기기를 원하는 컴펜디움 팩을 찾아야겠지요? 일단 월드 내에서 컴펜디움의 상태를 봅시다.
* 컴펜디움 제목은 한글보다는 영어로 저장하기를 권장합니다.
* 컴펜디움의 위치가 반드시 world로 되어있는지 확인하십시오. world로 되어있지 않다면, '컴펜디움 복제' 를 통해 world 로 복사하십시오.
우선 이 컴펜디움의 타입을 잘 기억해둡니다. 이 컴펜디움의 타입은 'Actor' 라고 적혀있습니다.
* 컴펜디움 타입 종류
Actor, Item, JournalEntry, Macro, Playlist, RollTable, Scene
다음으로 파일매니저에서 Data/worlds/월드이름/packs 경로로 들어가면 내 월드에 저장된 컴펜디움 파일이 있습니다.
원하는 컴펜디움 파일을 다운로드 or 복사해서 다른 공간으로 옮겨둡니다.
2. 로컬 (내컴퓨터)에서 모듈 만들기
내 컴퓨터에서 모듈을 만드는 방법을 알아봅시다. 여러분들이 쉽게 모듈을 만들 수 있도록 미리 모듈 틀을 만들었습니다. 다음 압축파일을 다운로드해 사용해주세요.
2-1. 모듈에 컴펜디움 파일 집어넣기
위 압축파일을 풀면, packs 라는 폴더가 있습니다.
위에서 복사/ 다운로드한 컴펜디움 파일 (.db) 를 packs 폴더 아래에 넣어주세요.
2-2. 경로 지정하기
module.json 파일을 열어주세요.
파일의 내용을 수정해줍시다. 수정해야 할 부분은 주로 packs 다음입니다.
다음과 같은 형식의 줄을 찾습니다.
- "name" : 컴펜디움 파일의 이름입니다. 띄어쓰기 없이, 영어로만 적어야 합니다.
- "label" : 월드 내에서 표시될 컴펜디움 이름입니다. 한글로 적어도 됩니다.
- "path" : 컴펜디움 파일의 경로입니다. 틀리지 않게 적읍시다.
- "type" : 해당 컴펜디움의 타입입니다. 위에서 기억한 대로 적어줍시다.
자신의 컴펜디움에 맞게 해당 내용을 변경해주세요.
2-3. 모듈 설치하기
만든 pack-mod 폴더를 다시 압축합니다.
압축 파일을 Data/modules 에 넣고 압축해제합니다.
Data/modules/pack-mod/그 하위에 module.json 및 기타등등
이렇게 압축해제 되어 있어야 합니다. (중복폴더가 만들어지지 않게 주의하세요)
압축해제한 후, 코어 FVTT 설치 단계에서 사용했던 ssh 창 (까만창) 으로 들어갑시다.
다음 커맨드를 입력한 후 재접속해보세요.
foundry stop
foundry up
* Https 설정으로 시동 중인 분은 다음 커맨드를 이용하셔야 합니다.
foundry-https stop
foundry-https up
재시동이 완료되면 모듈 설치 완료입니다!
원하는 월드 내에서 해당 모듈을 활성화해 컴펜디움을 활용합시다.
3. 깃허브에서 모듈 만들기
모듈을 깃허브에서 만들어서 다운로드받을 수도 있습니다.
* 주의!
이 방식으로 모듈을 만들면 항상 Public 상태로 만들어야 합니다. 이 말인 즉슨, 누구든지 내가 만든 컴펜디움 모듈을 다운로드받을 수 있습니다. 따라서 유출되면 곤란한 데이터들은 로컬에서 만들어 주세요.
마찬가지로 여러분들이 쉽게 모듈을 만들 수 있도록 템플릿을 마련해두었습니다. 다음 URL로 접속해주세요.
https://github.com/for-trpg/fvtt-pack-mod
3-1.템플릿 활용 및 수정
초록색으로 된 "Use this template" 버튼을 눌러 템플릿을 사용할 수 있습니다.
원하는 이름을 지정한 후, Create repository from template을 클릭. 이 때 반드시 "Public"으로 만들어야 합니다. (Private으로 하면 모듈이 제대로 다운로드되지 않습니다.)
그 다음 위쪽에서 서술한 "2-1 컴펜디움 파일 집어넣기" 와 "2-2 경로지정하기" 를 깃허브 내에서 해주세요.
3-2. 릴리즈하기
프로젝트 메인 페이지 우측에 Releases 라는 글씨가 있습니다. 그것을 클릭해서 릴리즈를 만듭니다.
Draft a release 버튼을 클릭
상단에 모듈의 버전명을 적고 Publish release 를 하면 끝입니다!
릴리즈 후 1~2분정도 기다리면 됩니다.
3-4. 모듈 설치하기
https://github.com/유저이름/레포지토리이름/releases/latest/download/module.json
이 링크를 복사해 자신의 프로젝트에 맞게 고친 후, 다시 복사합니다.
FVTT 셋업페이지로 돌아와, 모듈 파인더 하단의 "매니페스트 URL" 란에 링크를 입력한 후 설치해주면 끝!!
와!! 진짜 너무너무 쉽다!!
나만의 컴펜디움 모듈, 지금 바로 만들어보세요!
크로넬님의 창작활동을 응원하고 싶으세요?