이 가이드는 스크립팅 기반 관리자 도구, 플레이어 관리, 서버 관리 기법을 포함한 Just Cause 3 Multiplayer(JC3:MP)의 서버 관리를 다룹니다.
사전 요구 사항: 이 가이드는 서버가 이미 실행 중이라고 가정합니다. 먼저 서버를 설정해야 하는 경우 Just Cause 3 Multiplayer 서버 설정 가이드를 참조하세요.
관리자 개요
JC3:MP에는 내장된 관리자 명령어 시스템이 없습니다. 대신 모든 서버 관리는 서버 측 JavaScript 패키지(스크립트)를 통해 처리됩니다. 커뮤니티에서 추방, 차단, 텔레포트 및 기타 관리 명령어를 제공하는 관리자 패키지를 만들었습니다.
관리자 패키지 설치하기
- GPanel에서 서버를 중지하세요.
- JC3:MP 커뮤니티 리소스 또는 JC3:MP Wiki에서 관리자 스크립트 패키지를 다운로드하세요.
- File Manager 또는 SFTP를 사용하여 패키지 폴더를 서버의
packages/디렉터리에 업로드하세요. - 각 패키지에는 최소한
main.js파일과package.json이 포함되어야 합니다. - 서버를 시작하세요. 콘솔에서 패키지가 성공적으로 로드되었음을 확인할 수 있습니다.
일반적인 관리자 명령어
정확한 명령어는 설치하는 관리자 패키지에 따라 다릅니다. 대부분의 커뮤니티 관리자 패키지는 인게임 채팅을 통해 다음을 제공합니다:
| 명령어 | 설명 |
|---|---|
/kick [player] |
서버에서 플레이어를 제거합니다 |
/ban [player] |
플레이어의 연결을 영구적으로 차단합니다 |
/unban [player] |
플레이어의 차단을 해제합니다 |
/tp [player] |
플레이어의 위치로 텔레포트합니다 |
/tphere [player] |
플레이어를 자신의 위치로 텔레포트합니다 |
/vehicle [name] |
자신의 위치에 차량을 스폰합니다 |
/weather [type] |
서버 날씨를 변경합니다 |
/time [hours] |
하루 중 시간을 설정합니다 |
참고: 이 명령어들은 관리자 패키지에 따라 다릅니다. 정확한 명령어 구문과 사용 가능한 기능을 확인하려면 특정 관리자 스크립트의 문서를 확인하세요.
서버 콘솔
GPanel 콘솔은 플레이어 연결, 연결 해제, 스크립트 오류를 포함한 서버 출력을 표시합니다. Console 탭에서 직접 서버 활동을 모니터링할 수 있습니다.
서버는 Ctrl+C로 정상적으로 중지됩니다(Stop을 클릭하면 GPanel이 자동으로 처리합니다).
플레이어 관리
차단 목록
관리자 패키지를 사용할 때 차단된 플레이어는 일반적으로 패키지의 데이터 디렉터리 내의 JSON 파일(예: packages/admin/bans.json)에 저장됩니다. 이 파일을 수동으로 편집하여 차단을 추가하거나 제거할 수 있습니다:
- 서버를 중지하세요.
- File Manager에서 차단 목록 파일을 여세요.
- 필요에 따라 항목을 추가하거나 제거하세요.
- 저장하고 서버를 다시 시작하세요.
비밀번호 보호
서버 접속을 제한하려면 GPanel의 Startup 탭에서 SERVER_PASSWORD 시작 변수를 설정하거나, config.json의 password 필드를 편집하세요.
커스텀 스크립트
JC3:MP는 JavaScript로 서버 측 커스텀 스크립트 작성을 지원합니다. 커스텀 패키지를 만들려면:
packages/에 새 폴더를 만드세요(예:packages/my-script/).- 패키지 이름과 진입점을 포함한
package.json을 만드세요. - 스크립트 로직이 담긴
main.js파일을 만드세요. - 새 패키지를 로드하려면 서버를 다시 시작하세요.
package.json 예시
{
"name": "my-script",
"main": "main.js"
}main.js 예시
jcmp.events.Add('PlayerReady', (player) => {
player.SendChatMessage('Welcome to the server!');
});문제 해결
| 문제 | 해결책 |
|---|---|
| 관리자 명령어가 작동하지 않음 | 관리자 패키지가 로드되었는지 확인하세요(콘솔에서 로드 메시지 확인). 패키지 구성 내의 관리자 목록에 Steam ID가 있는지 확인하세요. |
| 패키지 로드 실패 | 콘솔에서 JavaScript 오류를 확인하세요. package.json이 유효하고 main.js 파일이 존재하는지 확인하세요. |
| 플레이어가 연결할 수 없음 | 서버가 실행 중이고 포트가 올바른지 확인하세요. 클라이언트 측에 JC3:MP 모드가 설치되어 있는지 확인하세요. |
관련 문서
도움이 필요하신가요? 이 가이드에서 다루지 않은 문제가 발생하면 지원 티켓을 열어 주시면 저희 팀이 도와드리겠습니다.
