이 가이드는 Legion Hosting에서 운영하는 Brickadia 전용 서버의 관리자 명령어, 월드 관리, 서버 구성을 다룹니다. 플레이어 관리, 월드 저장, 서버 커스터마이즈 방법을 배워보세요. 초기 설정에 대해서는 Brickadia 서버 설정 가이드를 참고하세요.
콘솔 명령어
Brickadia 서버 명령어는 GPanel 서버 콘솔을 통해 입력됩니다. 명령어는 Brickadia 전용 기능을 위해 br. 접두사를 사용합니다.
월드 관리
| 명령어 | 설명 |
|---|---|
br.world.save |
현재 월드를 자동 저장 슬롯에 저장합니다 |
br.world.saveas <name> |
현재 월드를 특정 이름으로 저장합니다 |
br.world.load <name> |
이전에 저장된 월드를 이름으로 로드합니다 |
br.world.clear |
현재 월드에서 모든 브릭을 제거합니다 |
경고:
br.world.clear 명령어는 월드에서 모든 브릭을 영구적으로 제거합니다. 이 명령어를 사용하기 전에 항상 저장하세요.
플레이어 관리
| 명령어 | 설명 |
|---|---|
br.kick <player> |
플레이어를 서버에서 추방합니다 |
br.ban <player> |
플레이어를 서버에서 차단합니다 |
br.unban <player> |
플레이어의 차단을 해제합니다 |
서버 제어
| 명령어 | 설명 |
|---|---|
exit |
서버를 안전하게 종료합니다(먼저 저장) |
서버 가시성
서버가 공개 목록에 나타날지 여부를 제어합니다:
SERVER_LIST_PUBLIC = True— 서버가 공개 서버 브라우저에 나타납니다SERVER_LIST_PUBLIC = False— 서버가 숨겨지며, 플레이어는 직접 접속을 사용해야 합니다
목록에는 표시되지만 비밀번호로 보호되는 비공개 서버를 위해 SERVER_PASSWORD와 결합하세요.
월드 파일 관리
월드 파일은 다음 위치에 저장됩니다:
.config/Epic/Brickadia/Saved/Worlds/백업
- 스냅샷을 생성하려면 GPanel의 내장 backup 기능을 사용하세요
- 로컬 백업을 위해 SFTP를 통해 월드 파일을 다운로드하세요
- 최신 변경 사항이 저장되도록 백업하기 전에
br.world.save를 실행하세요
월드 전환
- 서버를 중지합니다
- GPanel에서
WORLD_NAME시작 변수를 원하는 월드 이름으로 변경합니다 - 서버를 시작합니다 — 지정된 월드를 자동으로 로드합니다
월드 초기화
- 서버를 중지합니다
- File Manager를 엽니다
.config/Epic/Brickadia/Saved/Worlds/로 이동합니다- 초기화하려는 월드 파일을 삭제합니다
- 서버를 시작합니다 — 새로운 빈 월드가 생성됩니다
경고: 월드 파일 삭제는 영구적입니다. 해당 월드의 모든 빌드와 창작물이 손실됩니다. 초기화하기 전에 항상 백업하세요.
호스팅 토큰 관리
호스팅 토큰이 만료되거나 교체해야 하는 경우:
- brickadia.com/account를 방문합니다
- 새 서버 호스팅 토큰을 생성합니다
- GPanel에서
SERVER_HOSTING_TOKEN시작 변수를 업데이트합니다 - 서버를 재시작합니다
문제 해결
서버가 브라우저에 나타나지 않음
SERVER_LIST_PUBLIC가True로 설정되어 있는지 확인하세요SERVER_HOSTING_TOKEN이 유효한지 확인하세요- 서버가 완전히 시작되었는지 확인하세요(
Finished preloading primary assets를 찾으세요) - 목록이 전파되도록 2-3분 기다리세요
서버 시작 실패
- 유효하지 않은 토큰 — 호스팅 토큰이 유효하고 올바르게 입력되었는지 확인하세요. 필요한 경우 brickadia.com에서 새 토큰을 생성하세요.
- 월드 손상 — 다른 월드를 로드하거나 새 월드로 시작해 보세요.
- 파일 누락 — GPanel의 재설치 옵션을 통해 재설치를 시도하세요.
월드가 저장되지 않음
WORLD_NAME변수는 기존 월드와 일치해야 합니다. 먼저br.world.saveas로 하나를 생성하세요.- GPanel에서 디스크 공간을 확인하세요 — 디스크가 가득 차면 서버가 저장할 수 없습니다.
관련 문서
도움이 필요하신가요?
Brickadia 서버에 대한 추가 지원이 필요하면, 저희 지원팀이 도와드릴 준비가 되어 있습니다. 지원 티켓을 제출하시면 최대한 빨리 응답해 드리겠습니다.
