이 가이드는 tModLoader로 전환, .tmod 파일 업로드, 모드 목록 구성을 포함하여 tModLoader를 사용해 Terraria 서버에 모드를 설치하고 관리하는 방법을 다룹니다. 기본 서버 구성 및 접속에 대해서는 Terraria 서버 설정 가이드를 참조하세요.
tModLoader란 무엇인가요?
tModLoader는 바닐라 Terraria와 함께(또는 대신) 별도의 실행 파일로 실행되는 모딩 플랫폼입니다. Legion Hosting은 tModLoader를 선택 가능한 서버 버전으로 지원합니다. tModLoader가 활성화되면 mods/ 디렉터리에서 모드를 설치하고 실행합니다.
tModLoader로 전환하기
- GPanel에 로그인합니다.
- 서버를 중지합니다.
- Startup 또는 Configuration 섹션으로 이동합니다.
- 서버 버전 또는 실행 파일을 tModLoader로 변경합니다.
- 설정을 저장하고 서버를 재시작합니다.
.wld)을 사용하지만, tModLoader 월드에는 모드가 적용된 콘텐츠가 포함되어 있을 수 있습니다. tModLoader 월드를 바닐라 Terraria에서 로드하거나 그 반대의 경우 데이터 손실 또는 손상이 발생할 수 있습니다. 각각에 대해 별도의 월드 파일을 유지하세요.
바닐라로 다시 전환하기
바닐라 Terraria로 다시 전환하려면 위의 단계를 반복하고 표준 Terraria 서버 버전을 선택하세요. 전환 중에 월드 파일이 삭제되지는 않지만 serverconfig.txt가 바닐라 호환 월드를 가리키도록 확인하세요.
모드 설치하기
tModLoader용 모드는 .tmod 파일 형식을 사용하며 서버의 mods/ 디렉터리에 배치됩니다. 모드가 로드되려면 서버가 tModLoader를 실행하고 있어야 합니다.
방법 1: .tmod 파일 직접 업로드
- Steam Workshop 또는 tModLoader 브라우저에서 모드의
.tmod파일을 다운로드합니다. - SFTP를 통해 서버에 연결합니다 — SFTP를 통한 파일 업로드 방법을 참조하세요.
.tmod파일을mods/디렉터리에 업로드합니다.- 서버를 재시작합니다. tModLoader는 시작 시
mods/디렉터리에서 발견된 모든.tmod파일을 로드합니다.
방법 2: Workshop 모드(enabled.json)
tModLoader는 또한 어떤 모드가 활성화되어야 하는지 나열하는 mods/ 디렉터리 내의 enabled.json 파일을 지원합니다. 이 파일은 tModLoader의 인게임 모드 브라우저를 사용할 때 자동으로 관리되지만 수동으로 편집할 수도 있습니다.
{
"EnabledMods": [
"ModName1",
"ModName2"
]
}
enabled.json에서 사용되는 모드 이름은 표시 이름이 아닌 내부 모드 이름과 일치합니다. 정확한 내부 이름은 모드 페이지 또는 .tmod 파일 이름을 확인하세요.
모드가 로드되었는지 확인하기
재시작한 후 GPanel에서 서버의 콘솔 로그를 확인하세요. tModLoader는 시작 중에 로드된 각 모드를 나열합니다. 모드 로드에 실패하면 원인(버전 불일치, 종속성 누락 등)을 나타내는 오류 메시지가 로그에 표시됩니다.
모드 제거 또는 비활성화하기
모드를 완전히 제거하려면 SFTP 또는 GPanel 파일 관리자를 통해 mods/ 디렉터리에서 해당 .tmod 파일을 삭제한 다음 서버를 재시작하세요.
모드를 삭제하지 않고 비활성화하려면 mods/enabled.json을 편집하고 EnabledMods 배열에서 모드의 내부 이름을 제거하세요. .tmod 파일은 디스크에 남아 있지만 다음 재시작 시 로드되지 않습니다.
파일 참조
| 경로 | 내용 |
|---|---|
mods/ |
tModLoader 모드 파일(.tmod 형식) |
mods/enabled.json |
활성화된 모드 내부 이름 목록 |
관련 문서
- Terraria 서버 설정 가이드 — 서버 구성, 월드 설정 및 접속
- Terraria 문제 해결 — 일반적인 문제 및 해결 방법
- SFTP를 통한 파일 업로드 방법
