Unturned 모드 및 플러그인 설치

Unturned 모드 및 플러그인 설치 - 지식베이스

이 가이드는 Unturned 서버에 Steam Workshop 모드와 RocketMod/LDM 플러그인을 설치하는 방법을 다룹니다. 초기 서버 구성에 대해서는 Unturned 서버 설정 가이드를 참조하세요.

Workshop 모드 설치

Unturned는 커스텀 맵, 아이템, 스킨, 게임플레이 수정 등을 포함한 모드를 위해 Steam Workshop을 사용합니다. 서버는 구성 파일을 사용하여 시작 시 워크샵 콘텐츠를 자동으로 다운로드합니다.

Workshop 구성 파일

워크샵 구성 파일의 위치는 다음과 같습니다:

Servers/default/WorkshopDownloadConfig.json

이 파일은 GPanel 파일 관리자 또는 SFTP를 통해 편집할 수 있습니다.

최초 시작 필요: 모든 기본 구성 파일이 생성되도록 이 파일을 편집하기 전에 GPanel에서 서버를 최소 한 번 시작하세요.

Workshop 모드 추가

모드의 Workshop ID를 찾으려면 해당 Steam Workshop 페이지를 열고 URL을 확인하세요 — ?id= 뒤에 오는 숫자가 Workshop ID입니다.

WorkshopDownloadConfig.json을 편집하고 File_IDs 배열에 Workshop ID를 추가하세요:

{
  "File_IDs": [
    1234567890,
    9876543210
  ],
  "Ignore_Children_File_IDs": [],
  "Query_Cache_Max_Age_Seconds": 600,
  "Max_Query_Retries": 2,
  "Use_Temporary_Token": false,
  "Steam_Token": ""
}

JSON 형식: Workshop ID는 정수여야 합니다 — 따옴표로 감싸지 마세요. 마지막 ID를 제외하고 각 ID 뒤에 쉼표를 추가하세요. 잘못된 JSON은 서버가 워크샵 콘텐츠를 전혀 로드하지 못하게 만듭니다.

Workshop 모드 제거

모드를 제거하려면 File_IDs 배열에서 해당 Workshop ID를 삭제하고 서버를 재시작하세요. 다운로드된 모드 파일은 디스크에 남아 있지만 더 이상 로드되지 않습니다.

Workshop 맵

Workshop 맵도 동일한 방식으로 설치됩니다 — Workshop ID를 WorkshopDownloadConfig.json에 추가하세요. 서버가 맵을 다운로드한 후, Commands.dat의 Map 값으로 맵 폴더 이름을 설정하세요. 맵 폴더 이름은 일반적으로 시작 중에 서버 콘솔 출력에서 확인할 수 있습니다.

Workshop 모드 팁

플레이어도 커스텀 콘텐츠(스킨, 맵, 오브젝트)를 보려면 Steam에서 동일한 워크샵 아이템을 구독해야 합니다.
공식 큐레이트 맵(PEI, Washington, Russia 등)은 Unturned에 포함되어 있으며 Workshop ID가 필요하지 않습니다.
모드 다운로드에 실패하면 GPanel의 서버 콘솔 로그에서 Steam 다운로드 오류를 확인하세요.
일부 모드는 다른 워크샵 아이템에 대한 종속성이 있습니다 — 모드의 워크샵 페이지에서 필요한 아이템을 확인하고 해당 ID도 추가하세요.

재시작 필요: 서버는 시작 시 워크샵 콘텐츠를 다운로드하고 로드합니다. 변경 사항을 적용하려면 WorkshopDownloadConfig.json을 편집한 후 GPanel에서 서버를 재시작하세요.

RocketMod / LDM 플러그인 프레임워크

RocketMod(및 커뮤니티에서 유지 관리하는 포크 LDM — Legally Distinct Mod)는 Unturned에서 가장 널리 사용되는 플러그인 프레임워크입니다. 경제 시스템, 키트, 홈 명령, 권한, 텔레포트 등 다양한 기능을 포함한 플러그인을 위한 서버 측 API를 제공합니다.

설치 확인: 많은 Legion Hosting Unturned 플랜에는 RocketMod가 사전 설치되어 제공됩니다. GPanel 파일 관리자를 사용하여 서버 파일에 Rocket/ 디렉터리가 있는지 확인하세요. 존재한다면 RocketMod가 이미 활성화되어 있는 것입니다.

플러그인 디렉터리

Rocket 플러그인은 다음 위치에 배치되는 .dll 파일입니다:

Rocket/Plugins/

플러그인 설치

플러그인 작성자의 릴리스 페이지 또는 저장소에서 플러그인 .dll 파일을 다운로드하세요.
GPanel 파일 관리자 또는 SFTP를 사용하여 .dll 파일을 Rocket/Plugins/에 업로드하세요.
GPanel에서 서버를 재시작하세요.
최초 실행 시 RocketMod는 플러그인용 구성 파일을 생성합니다(예: Rocket/Plugins/PluginName/PluginName.configuration.xml).
필요에 따라 생성된 구성을 편집한 후, 변경 사항을 적용하기 위해 서버를 다시 재시작하세요.

중요: .dll 파일은 하위 폴더가 아니라 Rocket/Plugins/에 직접 배치하세요. 일부 플러그인은 ZIP 압축 파일로 제공됩니다 — 업로드하기 전에 .dll을 추출하세요. 플러그인에 종속성 DLL이 있는 경우 해당 파일도 Plugins 폴더에 배치해야 합니다.

Rocket 권한

Rocket 플러그인 명령에 대한 플레이어 권한은 다음에서 관리됩니다:

Rocket/Permissions.config.xml

이 파일은 권한 그룹, 그 구성원, 그리고 각 그룹이 사용할 수 있는 명령을 정의합니다. 예시:

<Group Id="vip" DisplayName="VIP" Color="yellow" Prefix="" Suffix="" Priority="1">
  <Members>
    <Member>76561198000000001</Member>
  </Members>
  <Permissions>
    <Permission Cooldown="0">home</Permission>
    <Permission Cooldown="120">kit vip</Permission>
  </Permissions>
</Group>

주요 필드:

필드	설명
`Id`	내부 그룹 식별자(고유해야 함).
`DisplayName`	채팅 접두사 또는 플러그인 출력에 표시되는 이름.
`Members`	이 그룹에 속한 64비트 SteamID 목록.
`Permissions`	이 그룹이 사용할 수 있는 명령. `Cooldown`은 초 단위입니다.
`Priority`	플레이어가 여러 그룹에 속한 경우 우선순위가 높은 그룹이 낮은 그룹을 재정의합니다.

플러그인	설명
Uconomy	인게임 경제 및 화폐 시스템.
AviRockets / RocketKits	플레이어 및 VIP를 위한 구성 가능한 아이템 키트.
HomeCommand	플레이어가 홈 위치를 설정하고 텔레포트할 수 있게 합니다.
TeleportRequest (TPA)	플레이어 간 텔레포트 요청 시스템.
Vehicles / VehicleShop	인게임 화폐를 사용하여 차량을 구매하고 스폰합니다.

도움이 필요하신가요?

모드 또는 플러그인에 대한 도움이 필요하시면 저희 지원팀이 기꺼이 도와드리겠습니다.

지원 티켓 열기

Unturned 모드 및 플러그인 설치 - 지식베이스

Support

Categories

Unturned 모드 및 플러그인 설치