이 가이드는 Rust 서버에 Oxide/uMod 또는 Carbon 모딩 프레임워크를 설치하고, 커뮤니티 플러그인을 추가하며, 콘솔을 통해 이를 관리하는 방법을 다룹니다. 일반적인 서버 구성 및 시작 변수에 대해서는 Rust 서버 구성 가이드를 참조하세요.

Oxide/uMod 또는 Carbon 설치

Oxide(현재 uMod로 유지 관리됨)와 Carbon은 커뮤니티가 제작한 플러그인을 설치할 수 있게 해주는 Rust용 모딩 프레임워크입니다. 이 프레임워크는 경제 시스템, 커스텀 키트, 투표 보상, PvE 보호 구역 등과 같은 기능을 추가합니다.

파일을 수동으로 업로드할 필요는 없습니다. 모딩 프레임워크는 단일 시작 변수를 설정하면 자동으로 설치됩니다:

1. GPanel Console 탭에서 서버를 중지합니다.
2. GPanel에 로그인하고 Startup 탭으로 이동합니다.
3. FRAMEWORK 변수를 찾아 다음과 같이 설정합니다:
   • oxide — Oxide/uMod용(가장 널리 사용되는 프레임워크로, 가장 큰 플러그인 라이브러리를 보유)
   • carbon — Carbon 프레임워크용(자체 플러그인 생태계를 갖춘 대안)
   • vanilla — 모딩 프레임워크 없이 실행
4. 서버를 시작합니다. 프레임워크 파일은 자동으로 다운로드되어 적용됩니다. Oxide로 처음 시작하면 oxide/ 디렉터리 구조가 생성됩니다.
5. Oxide가 활성화되었는지 확인하려면 콘솔 로그에서 Loaded plugin Oxide.Core와 같은 줄을 확인하세요.

플러그인 설치

플러그인은 .cs(C# 소스) 파일로 배포됩니다. Oxide는 런타임에 서버에서 이를 컴파일하므로 사전 컴파일이 필요하지 않습니다.

1. umod.org 또는 다른 신뢰할 수 있는 출처에서 플러그인 .cs 파일을 다운로드합니다.
2. SFTP 또는 GPanel 파일 관리자를 사용하여 서버의 oxide/plugins/ 디렉터리에 .cs 파일을 업로드합니다. SFTP에 대한 도움말은 SFTP로 파일 업로드하는 방법을 참조하세요.
3. 서버가 실행 중인 경우 플러그인은 몇 초 이내에 자동으로 감지되어 컴파일됩니다. 콘솔에서 로드되었음을 확인하는 출력을 볼 수 있습니다(예: Loaded plugin MyPlugin v1.2.3 by Author).
4. 서버가 실행 중이 아닌 경우 플러그인은 다음 시작 시 로드됩니다.

Oxide 디렉터리 구조

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

플러그인 구성

대부분의 플러그인은 처음 로드될 때 oxide/config/에 JSON 구성 파일을 생성합니다. 플러그인을 사용자 지정하려면:

1. 플러그인이 기본 구성 파일을 생성하도록 최소 한 번 로드되게 합니다.
2. 서버를 중지합니다(또는 일부 플러그인은 실시간 구성 다시 로드를 지원함을 참고하세요).
3. GPanel 파일 관리자 또는 SFTP를 사용하여 oxide/config/PluginName.json에서 플러그인의 구성 파일을 엽니다.
4. 설정을 편집하고 파일을 저장합니다.
5. oxide.reload PluginName으로 플러그인을 다시 로드하거나 서버를 다시 시작합니다.

콘솔을 통한 플러그인 관리

이 명령은 GPanel 콘솔에서 또는 RCON 클라이언트를 통해 실행할 수 있습니다. RCON 설정에 대해서는 Rust RCON 접속 및 관리자 명령을 참조하세요.

플러그인 업데이트

플러그인을 최신 버전으로 업데이트하려면:

1. umod.org의 플러그인 페이지에서 업데이트된 .cs 파일을 다운로드합니다.
2. 새 파일을 oxide/plugins/에 업로드하여 기존 파일을 덮어씁니다.
3. 서버가 실행 중인 경우 Oxide가 파일 변경을 감지하고 자동으로 플러그인을 다시 컴파일하고 다시 로드합니다. 또는 oxide.reload PluginName을 실행하세요.
4. 콘솔에서 오류가 있는지 확인합니다. 일부 플러그인 업데이트는 oxide/config/의 구성 파일 변경이 필요할 수 있습니다.

플러그인 제거

플러그인을 완전히 제거하려면:

1. 서버가 실행 중인 동안 플러그인을 언로드하려면 oxide.unload PluginName을 실행합니다.
2. oxide/plugins/에서 .cs 파일을 삭제합니다.
3. 더 이상 필요하지 않은 경우 선택적으로 oxide/config/의 플러그인 구성 파일과 oxide/data/의 데이터 파일을 삭제합니다.

인기 플러그인

플러그인 문제 해결

플러그인이 로드되지 않는 경우 다음을 확인하세요:

• Oxide가 설치되어 활성화되어 있는지 확인합니다. GPanel의 Startup 탭에서 FRAMEWORK 변수가 oxide로 설정되어 있어야 합니다. 시작 중에 콘솔 로그에 Loaded plugin Oxide.Core가 표시되어야 합니다.
• 플러그인 파일은 정확한 .cs 확장자로 oxide/plugins/에 직접 배치되어야 합니다. 하위 디렉터리에 있거나 잘못된 확장자를 가진 파일은 무시됩니다.
• 콘솔과 oxide/logs/에서 컴파일 오류를 확인합니다. 구문 오류가 있는 플러그인은 로드에 실패하며 오류 메시지가 문제를 설명합니다.
• 일부 플러그인은 다른 플러그인에 대한 종속성이 있습니다(예: 많은 상점 플러그인은 Economics를 필요로 함). 필요한 모든 종속성을 먼저 설치하세요.

다른 일반적인 서버 문제에 대해서는 Rust 서버 문제 해결을 참조하세요.

도움이 필요하신가요?

이 가이드에서 다루지 않은 문제가 발생하면 지원팀이 도와드립니다. 지원 티켓을 제출하고 서버 ID, 문제에 대한 설명, 관련 콘솔 출력을 포함해 주세요.