이 가이드는 첫 시작 및 인증 키 설정부터 ServerConfig.toml 구성과 플레이어 접속 방법에 이르기까지, Legion Hosting에서 BeamMP 서버를 실행하는 데 필요한 모든 것을 다룹니다. 관리자 명령어, 커스텀 맵, 리소스 관리에 대해서는 BeamMP 관리자 및 리소스 설정을 참고하세요.
서버 패널: 모든 서버 관리는 gpanel.legionhosting.net의 GPanel을 통해 이루어집니다. BeamMP 서버는 SteamCMD가 아닌 독립 실행형 BeamMP-Server 애플리케이션을 사용합니다.
BeamMP란 무엇인가요?
BeamMP는 플레이어가 같은 맵에서 함께 운전하고 경주하고 충돌할 수 있게 해주는 BeamNG.drive용 멀티플레이어 모드입니다. BeamMP-Server 애플리케이션은 독립 실행형 전용 서버로 실행됩니다. 플레이어는 멀티플레이어 세션에서 표준 BeamNG.drive 런처를 대체하는 BeamMP 런처를 통해 접속합니다.
인증 키 필요: 모든 BeamMP 서버는 BeamMP Keymaster에서 발급한 고유한 인증 키가 필요합니다. 유효한 키가 없으면 서버가 서버 브라우저에 나타나지 않고 플레이어가 접속할 수 없습니다. 아래 인증 키 섹션을 참고하세요.
첫 시작
BeamMP 서버를 처음 받았을 때, 온라인으로 만들려면 다음 단계를 따르세요:
- GPanel에 로그인하고 BeamMP 서버를 선택합니다.
- 시작하기 전에 인증 키를 받아야 합니다(아래 참조). 키가 없으면 서버가 BeamMP 서비스에 인증하지 못합니다.
- Startup 탭으로 이동하여 인증 키를
AUTHKEY변수에 붙여넣습니다. - 선택적으로 서버 이름 및 최대 플레이어 수와 같은 다른 시작 변수를 조정합니다.
- Console 탭으로 이동하여 Start를 클릭합니다.
- 서버는 첫 부팅 시 BeamMP-Server 파일을 자동으로 다운로드합니다. 몇 분이 걸릴 수 있습니다.
- 콘솔에
[INFO] Server started!또는 유사한 메시지가 표시되면, 서버가 온라인 상태이며 BeamMP 서버 브라우저에 나타납니다.
첫 부팅은 더 오래 걸립니다: 초기 시작에는 BeamMP-Server 파일의 전체 다운로드가 포함됩니다. 이후 시작은 훨씬 빨라집니다.
인증 키 (BeamMP Keymaster)
모든 BeamMP 서버는 BeamMP 백엔드 서비스에 연결하는 인증 키가 필요합니다. 이 키는 무료이며 BeamMP/Discord 계정에 연결됩니다.
키를 받는 방법
- beammp.com/k/keys(BeamMP Keymaster)로 이동합니다.
- Discord 계정으로 로그인합니다. BeamMP 계정이 없는 경우 생성하라는 안내가 표시됩니다.
- Create a key(또는 현재 UI에 따라 + / New Key)를 클릭합니다.
- 서버 이름(참조용 레이블일 뿐)과 서버의 IP 주소를 입력합니다.
- 생성된 키 문자열을 복사합니다.
서버에 키 추가하기
- GPanel에서 Startup 탭으로 이동합니다.
- 키를
AUTHKEY변수에 붙여넣습니다. - 변경 사항을 적용하려면 서버를 재시작합니다.
인증 키를 비공개로 유지하세요. 공개적으로 공유하지 마세요. 키를 가진 사람은 누구나 다른 서버에서 사용할 수 있으며, 이는 충돌을 일으키거나 BeamMP에 의해 키가 취소될 수 있습니다.
키 제한: 각 BeamMP 계정은 제한된 수의 키(일반적으로 2개)를 생성할 수 있습니다. 추가 키가 필요한 경우 BeamMP Keymaster 페이지나 Discord에서 현재 제한을 확인하세요.
GPanel 시작 변수
BeamMP는 여러 구성 옵션을 GPanel의 시작 변수로 노출합니다. Startup 탭으로 이동하여 이를 보고 수정하세요. 변경 사항을 적용하려면 서버 재시작이 필요합니다.
| 변수 | 기본값 | 설명 |
|---|---|---|
AUTHKEY |
비어 있음 | Keymaster에서 받은 BeamMP 인증 키입니다. 서버 작동에 필수입니다. |
NAME |
BeamMP Server |
BeamMP 서버 브라우저에 표시되는 이름입니다. |
MAX_PLAYERS |
10 |
최대 동시 플레이어 수입니다. 값이 높을수록 더 많은 CPU와 RAM이 필요합니다. |
MAP |
/levels/gridmap_v2/info.json |
로드할 맵입니다. BeamNG.drive 맵 경로 형식을 사용합니다. 사용 가능한 맵은 맵 선택 섹션을 참고하세요. |
PORT |
30814 |
서버 포트입니다. GPanel에서 사전 구성되어 있습니다 — 지원팀의 지시가 없는 한 변경하지 마세요. |
MAX_CARS |
1 |
플레이어당 최대 차량 수입니다. 플레이어당 차량이 많을수록 대역폭과 CPU 사용량이 크게 증가합니다. |
PRIVATE |
false |
true이면 서버가 공개 서버 브라우저에 나타나지 않습니다. 플레이어는 직접 접속을 통해 연결해야 합니다. |
ServerConfig.toml
시작 변수 외에도 전체 서버 구성은 서버 루트 디렉터리의 ServerConfig.toml에 있습니다. 이 파일은 GPanel의 Files 탭이나 SFTP를 통해 편집할 수 있습니다. GPanel의 시작 변수는 매 시작 시 이 파일의 값을 덮어씁니다.
주요 구성 옵션
[General]
AuthKey = "your-key-here"
Name = "My BeamMP Server"
Description = "A fun racing and freeroam server"
MaxPlayers = 10
Port = 30814
Map = "/levels/gridmap_v2/info.json"
Private = false
MaxCars = 1
ResourceFolder = "Resources"
LogChat = true| 설정 | 설명 |
|---|---|
AuthKey |
BeamMP Keymaster 인증 키입니다. |
Name |
서버 브라우저에 표시되는 서버 이름입니다. 일부 서식 코드를 지원합니다. |
Description |
브라우저에서 서버 이름 아래에 표시되는 짧은 설명입니다. |
MaxPlayers |
플레이어 상한입니다. 일반적인 값: 부드러운 게임플레이를 위해 8–20. |
Map |
로드할 맵 경로입니다. 유효한 BeamNG.drive 레벨 경로여야 합니다. |
Private |
서버 브라우저에서 숨기려면 true로 설정합니다. |
MaxCars |
플레이어당 허용되는 차량 수입니다. 대규모 서버에는 1이 권장됩니다. |
ResourceFolder |
서버 측 모드와 플러그인이 들어 있는 Resources 디렉터리 경로입니다. |
LogChat |
true이면 플레이어 채팅 메시지가 콘솔에 기록됩니다. |
ServerConfig.toml을 편집하기 전에 항상 서버를 중지하세요. 편집하는 동안 서버가 실행 중이면 종료 시 변경 사항을 덮어쓸 수 있습니다.
맵 선택
BeamMP는 BeamNG.drive와 동일한 맵을 사용합니다. 맵은 Map 설정에서 레벨 경로로 지정됩니다. 아래는 가장 일반적으로 사용되는 기본 맵입니다:
| 맵 이름 | 맵 경로 | 설명 |
|---|---|---|
| Grid Map v2 | /levels/gridmap_v2/info.json |
평평하고 개방된 테스트 공간입니다. 자유 제작과 차량 테스트에 적합합니다. |
| West Coast USA | /levels/west_coast_usa/info.json |
고속도로, 마을, 다양한 지형이 있는 크고 상세한 맵입니다. 프리로밍에 매우 인기 있습니다. |
| East Coast USA | /levels/east_coast_usa/info.json |
완만한 언덕, 숲, 작은 마을이 있습니다. 오프로드와 드라이브에 좋습니다. |
| Italy | /levels/italy/info.json |
좁은 도로와 해안 마을이 있는 경치 좋은 이탈리아 시골입니다. |
| Utah | /levels/utah/info.json |
긴 고속도로와 오프로드 트레일이 있는 사막 지형입니다. |
| Jungle Rock Island | /levels/jungle_rock_island/info.json |
구불구불한 도로와 울창한 초목이 있는 열대 섬입니다. |
| Industrial | /levels/industrial/info.json |
램프, 점프대, 장애물 코스가 있는 작은 산업 지역입니다. |
| Small Island USA | /levels/small_island/info.json |
좁은 도로가 있는 작은 섬입니다. 적은 플레이어 수에 좋습니다. |
| Driver Training | /levels/driver_training/info.json |
차량 핸들링 연습을 위해 설계된 오토크로스 스타일 트랙입니다. |
커스텀 맵: 맵 .zip 파일을
Resources/Client 폴더에 배치하고 적절한 맵 경로를 사용하여 커스텀/모드 맵도 로드할 수 있습니다. 커스텀 콘텐츠 추가에 대한 자세한 내용은 BeamMP 관리자 및 리소스 설정을 참고하세요.
최대 플레이어 수와 성능
BeamNG.drive는 물리 연산이 많은 게임입니다. 각 플레이어와 차량은 서버와 연결된 클라이언트 모두에 상당한 부하를 추가합니다. 다음 지침을 염두에 두세요:
- MaxPlayers: 부드러운 경험을 위해 8–20명의 플레이어가 일반적입니다. 더 큰 서버(20명 이상)도 가능하지만 더 많은 리소스와 신중한 구성이 필요합니다.
- MaxCars: 10명 이상의 플레이어가 있는 서버에서는 플레이어당
1로 유지하는 것이 강력히 권장됩니다. 추가 차량마다 동기화해야 하는 물리 데이터가 배가됩니다. - 맵 선택이 중요합니다: 더 크고 상세한 맵(West Coast USA, Italy)은 더 단순한 맵(Grid Map, Industrial)보다 더 많은 메모리를 사용합니다.
- 네트워크 대역폭: BeamMP는 모든 차량에 대한 상세한 물리 데이터를 전송합니다. 플레이어당 여러 대의 차량이 있는 높은 플레이어 수는 대역폭을 빠르게 포화시킬 수 있습니다.
성능 팁: 플레이어가 지연이나 러버밴딩을 경험하는 경우,
MaxCars를 1로 줄이고 MaxPlayers를 낮춰보세요. 이것이 서버 성능을 개선하는 가장 효과적인 단일 방법입니다.
접속 방법
플레이어는 표준 BeamNG.drive 런처가 아닌 BeamMP 런처를 통해 BeamMP 서버에 접속합니다.
서버 브라우저를 통해
- beammp.com에서 BeamMP 런처를 다운로드하고 설치합니다.
- BeamMP 런처를 실행합니다. BeamMP 멀티플레이어 모드가 로드된 상태로 BeamNG.drive가 시작됩니다.
- 메인 메뉴에서 Multiplayer를 선택합니다.
- 서버 목록을 탐색하거나 검색창을 사용하여 이름으로 서버를 찾습니다.
- 서버를 클릭하고 Connect를 선택합니다.
직접 접속을 통해
- BeamMP 멀티플레이어 메뉴에서 Direct Connect를 클릭합니다.
- 서버의 IP 주소와 포트를
IP:PORT형식(예:192.168.1.1:30814)으로 입력합니다. - Connect를 클릭합니다.
서버가 브라우저에 표시되지 않나요?
PRIVATE가 false로 설정되어 있고 인증 키가 유효한지 확인하세요. 시작 후 서버가 브라우저에 나타나기까지 1~2분 정도 걸릴 수 있습니다. 여전히 나타나지 않으면 콘솔에서 인증 오류를 확인하세요. 비공개 IP가 없는 한 포트는 무작위로 할당되므로, 올바른 포트는 GPanel에서 확인하세요.
저장 관리
BeamNG.drive는 세션 기반 게임입니다. 서버에 대한 영구적인 월드 상태나 저장 파일이 없습니다. 플레이어가 접속을 끊거나 서버가 재시작되면 모든 차량 위치와 상태가 초기화됩니다. 각 세션은 새로 시작됩니다.
- 백업하거나 관리할 월드 저장이 없습니다.
- 서버 구성(
ServerConfig.toml)과 리소스는 재시작 후에도 유지됩니다. - 플레이어 차량 구성은 서버가 아닌 클라이언트 측에 저장됩니다.
참고: 일부 서버 측 Lua 플러그인은 커스텀 지속성 기능(예: 플레이어 위치 또는 경제 데이터 저장)을 구현할 수 있지만, 이는 기본 기능이 아닙니다. 플러그인에 대한 정보는 BeamMP 관리자 및 리소스 설정을 참고하세요.
관련 문서
- BeamMP 관리자 및 리소스 설정 — 관리자 명령어, 커스텀 맵, 플러그인 및 리소스 관리
- 서버 IP 및 포트 찾는 방법
- SFTP로 파일 업로드하는 방법
- 서버 시작 가이드 — Legion Hosting에서 모든 게임 서버를 시작하기 위한 일반 가이드
추가 도움이 필요하신가요?
이 가이드에서 다루지 않은 문제를 겪고 있다면, 저희 지원팀이 도와드릴 수 있습니다. 서버 세부 정보와 문제 설명과 함께 legionhosting.net/submitticket.php에서 티켓을 여세요.
