이 가이드는 Legion Hosting에서 운영하는 BeamMP 서버의 관리자 설정, 서버 측 리소스, 커스텀 맵, 차량 관리 및 문제 해결을 다룹니다. 초기 서버 설정, 인증 키, 기본 구성에 대해서는 BeamMP 서버 설정 가이드를 참고하세요.
관리자 설정
BeamMP는 전통적인 관리자 로그인이나 비밀번호 시스템을 갖추고 있지 않습니다. 대신 관리자 명령어는 서버 콘솔을 통해 또는 플레이어 식별자를 확인하는 서버 측 Lua 플러그인을 통해 실행됩니다.
콘솔 명령어
GPanel의 서버 콘솔은 내장 서버 명령어에 직접 접근할 수 있게 해줍니다. 콘솔 입력 필드에 명령어를 직접 입력하세요:
| 명령어 | 설명 |
|---|---|
kick <player_id> <reason> |
선택적인 사유 메시지와 함께 플레이어를 서버에서 추방합니다. |
ban <player_name> |
플레이어를 서버에서 차단합니다. 차단된 플레이어는 재접속할 수 없습니다. |
unban <player_name> |
플레이어의 차단을 해제하여 재접속할 수 있게 합니다. |
list |
현재 접속 중인 모든 플레이어와 그 ID를 나열합니다. |
say <message> |
콘솔에서 서버 전체에 채팅 메시지를 보냅니다. |
status |
플레이어 수와 가동 시간을 포함한 서버 상태 정보를 표시합니다. |
help |
사용 가능한 모든 콘솔 명령어를 나열합니다. |
list 명령어를 사용하여 접속 중인 플레이어와 그 ID를 확인하세요. 이 ID는 kick과 같은 명령어에 필요합니다.
Resources 폴더 구조
BeamMP는 서버 측 콘텐츠를 정리하기 위해 Resources 폴더를 사용합니다. 이 폴더에는 서로 다른 목적을 가진 두 개의 하위 디렉터리가 있습니다:
Resources/
Client/ <-- Client-side mods (maps, vehicles) synced to players
Server/ <-- Server-side Lua plugins (not sent to players)클라이언트 리소스
Resources/Client/에 배치된 파일은 플레이어가 접속할 때 자동으로 다운로드됩니다. 다음 용도로 사용됩니다:
- 커스텀 맵 — 플레이어가 서버의 맵을 로드하는 데 필요한 맵 모드 .zip 파일.
- 커스텀 차량 — 새로운 차량을 추가하거나 기존 차량을 수정하는 차량 모드 .zip 파일.
- 기타 클라이언트 모드 — 클라이언트에 존재해야 하는 모든 BeamNG.drive 모드.
Resources/Client/ 내의 모든 것은 접속하는 모든 플레이어가 다운로드합니다. 큰 파일이나 많은 모드는 접속 시간을 크게 증가시킵니다. 최상의 플레이어 경험을 위해 클라이언트 리소스를 간결하게 유지하세요.
서버 리소스 (Lua 플러그인)
Resources/Server/ 디렉터리에는 서버 측 Lua 플러그인이 들어 있습니다. 이들은 서버에서만 실행되며 플레이어에게 전송되지 않습니다. 각 플러그인은 main.lua 파일과 함께 자체 하위 폴더에 위치합니다:
Resources/
Server/
MyPlugin/
main.lua <-- Plugin entry point
AnotherPlugin/
main.lua서버 측 플러그인은 다음을 할 수 있습니다:
- 플레이어 이벤트(접속, 퇴장, 채팅 메시지, 차량 스폰)에 응답합니다.
- 채팅을 통해 실행되는 커스텀 명령어(예:
/tp,/give)를 구현합니다. - 차량 권한 및 제한을 관리합니다.
- 경제 시스템, 텔레포트 또는 기타 커스텀 게임플레이 기능을 추가합니다.
- 플레이어 활동을 기록하고 규칙을 시행합니다.
커스텀 맵 추가하기
BeamMP 서버에서 커스텀(기본이 아닌) 맵을 실행하려면:
- BeamNG.drive 모드 소스(예: BeamNG.drive 모드 저장소)에서 맵 모드를
.zip파일로 다운로드합니다. - GPanel에서 서버를 중지합니다.
- Files 탭 또는 SFTP를 통해
.zip파일을Resources/Client/에 업로드합니다. zip을 압축 해제하지 마세요. MAP시작 변수(또는ServerConfig.toml의Map)를 커스텀 맵에 맞는 올바른 맵 경로로 업데이트합니다. 이 경로는 일반적으로/levels/map_name/info.json형식입니다 — 정확한 경로는 모드 문서를 확인하세요.- 서버를 시작합니다.
Map 값이 모드 .zip 파일 내부의 실제 경로와 일치하지 않으면 서버가 맵을 로드하지 못합니다. 올바른 /levels/ 경로를 찾으려면 모드 문서를 확인하거나 .zip 구조를 살펴보세요.
Resources/Client/ 내의 모든 파일을 자동으로 다운로드합니다. 플레이어는 맵 모드를 수동으로 설치할 필요가 없습니다.
차량 관리
BeamMP 서버의 차량 관리는 MaxCars 설정과 선택적으로 서버 측 Lua 플러그인을 통해 제어됩니다.
MaxCars 설정
ServerConfig.toml의 MaxCars 설정(또는 MAX_CARS 시작 변수)은 각 플레이어가 동시에 스폰할 수 있는 차량 수를 제어합니다:
1— 각 플레이어가 한 번에 차량 한 대를 가질 수 있습니다(대규모 서버에 권장).2–3— 플레이어가 여러 대의 차량을 가질 수 있게 하며, 소규모 서버나 카 미팅에 유용합니다.- 값이 높을수록 서버 부하가 비례하여 증가합니다.
커스텀 차량 모드
서버에 커스텀 차량을 추가하려면:
- 차량 모드를
.zip파일로 다운로드합니다. Resources/Client/에 배치합니다.- 서버를 재시작합니다. 플레이어는 접속 시 자동으로 차량 모드를 다운로드합니다.
플러그인을 통한 차량 제한
보다 세밀한 제어(예: 특정 차량 차단, 차량 유형 제한)를 위해서는 서버 측 Lua 플러그인이 필요합니다. 이러한 플러그인은 차량 스폰 이벤트를 가로채어 커스텀 규칙에 따라 허용하거나 거부할 수 있습니다. 차량 관리 플러그인은 BeamMP 포럼을 확인하세요.
플러그인 설치 및 관리
서버 측 Lua 플러그인은 서버의 기능을 확장합니다. 설치 및 관리 방법은 다음과 같습니다:
플러그인 설치
- 플러그인 파일(일반적으로
main.lua와 기타 파일이 포함된 폴더)을 다운로드합니다. - 서버를 중지합니다.
- Files 탭 또는 SFTP를 통해 플러그인 폴더를
Resources/Server/에 업로드합니다. - 폴더 구조가 올바른지 확인합니다:
Resources/Server/PluginName/main.lua. - 서버를 시작합니다. 플러그인이 로드될 때 콘솔에 메시지가 표시됩니다.
플러그인 제거
- 서버를 중지합니다.
Resources/Server/에서 플러그인 폴더를 삭제합니다.- 서버를 시작합니다.
문제 해결
인증 키 오류
- 키가
AUTH_KEY시작 변수에 올바르게 붙여넣어졌는지 확인하세요 — 추가 공백이나 줄바꿈이 없어야 합니다. - 키가 BeamMP Keymaster에서 취소되거나 만료되지 않았는지 확인하세요.
- 각 키는 한 번에 하나의 서버에서만 사용할 수 있습니다. 동일한 키를 다른 곳에서 사용 중이라면 실패합니다.
- 키가 유효하지 않은 경우 시작 시 콘솔에 인증 오류가 표시됩니다.
플레이어가 접속할 수 없음
- 서버가 완전히 시작되어 GPanel에서 온라인으로 표시되는지 확인하세요.
- 플레이어가 표준 BeamNG.drive 런처가 아닌 BeamMP 런처를 사용하고 있는지 확인하세요.
- 서버가
Private = true로 설정된 경우, 플레이어는 올바른 IP와 포트로 직접 접속을 사용해야 합니다. 서버 IP 및 포트 찾는 방법을 참고하세요. - 플레이어의 BeamMP 런처 버전이 서버 버전과 호환되는지 확인하세요. 오래된 런처는 접속에 실패할 수 있습니다.
- 서버가 가득 찬 경우(
MaxPlayers에 도달), 누군가 나갈 때까지 추가 플레이어가 접속할 수 없습니다.
모드 동기화 문제
- 플레이어가 다운로드 중에 멈추거나 누락된 모드에 대한 오류를 받는 경우,
Resources/Client/내의 모드 .zip 파일이 손상되지 않았는지 확인하세요. - .zip이 손상된 경우 모드 파일을 다시 다운로드하고 다시 업로드하세요.
- 매우 큰 모드 파일은 느린 연결의 플레이어에게 타임아웃을 일으킬 수 있습니다. 불필요하게 큰 모드를 제거하는 것을 고려하세요.
- 모드 .zip 파일이 중첩되지 않았는지 확인하세요(즉, 또 다른 .zip 안의 폴더 안에 있는 .zip).
플레이어/차량이 많을 때의 성능 문제
- 플레이어당
MaxCars를1로 줄이세요. - 서버에서 지속적인 지연이 발생하는 경우
MaxPlayers를 낮추세요. - 높은 플레이어 수에서 더 나은 성능을 위해 더 단순한 맵(Grid Map 또는 Industrial)으로 전환하세요.
- 다운로드 시간과 메모리 사용량을 줄이기 위해
Resources/Client/에서 불필요한 클라이언트 모드를 제거하세요. - GPanel의 리소스 사용량 그래프를 확인하세요 — CPU나 RAM이 지속적으로 한계에 있다면 서버 요금제 업그레이드를 고려하세요. 옵션을 논의하려면 지원 티켓을 여세요.
서버가 브라우저에 나타나지 않음
- 구성에서
Private가false로 설정되어 있는지 확인하세요. - 인증 키가 유효하고 다른 서버에서 사용 중이 아닌지 확인하세요.
- 서버가 BeamMP 백엔드에 등록되도록 시작 후 1–2분 정도 기다리세요.
- 마스터 서버 연결과 관련된 오류가 있는지 콘솔을 확인하세요.
관련 문서
- BeamMP 서버 설정 가이드 — 초기 설정, 인증 키, 구성 및 접속 안내
- 서버 IP 및 포트 찾는 방법
- SFTP로 파일 업로드하는 방법
- 서버 시작 가이드 — Legion Hosting에서 모든 게임 서버를 시작하기 위한 일반 가이드
추가 도움이 필요하신가요?
이 가이드에서 다루지 않은 문제를 겪고 있다면, 저희 지원팀이 도와드릴 수 있습니다. 서버 세부 정보, 문제 설명, GPanel 콘솔의 관련 오류 메시지와 함께 legionhosting.net/submitticket.php에서 티켓을 여세요.
