이 가이드는 Legion Hosting의 StarMade 서버에 대한 서버 관리, 콘솔 명령어, 팩션 관리, 유니버스 유지 관리를 다룹니다. 초기 설정 및 플레이어 접속 지침은 StarMade 서버 설정 가이드를 참조하세요.
1. 서버 콘솔
StarMade 서버는 GPanel의 Console 탭을 통해 접근할 수 있는 콘솔을 제공합니다. 명령어를 콘솔 입력 필드에 직접 입력하세요. 명령어를 수락하려면 서버가 실행 중이어야 합니다.
2. 관리자 접근
게임 내에서 관리자 접근 권한을 얻으려면 server.cfg에 구성된 SUPER_ADMIN_PASSWORD를 사용하세요.
- 플레이어로 서버에 접속합니다.
- 게임 내 채팅을 열고 다음을 입력합니다:
/login [SUPER_ADMIN_PASSWORD] - 현재 세션에 대한 관리자 권한을 받게 됩니다.
서버 디렉터리의 관리자 구성 파일을 편집하여 영구 관리자를 추가할 수도 있습니다.
기본 슈퍼 관리자 비밀번호를 변경하세요. 무단 관리자 접근을 방지하기 위해
server.cfg에 강력하고 고유한 비밀번호를 설정하세요.
3. 일반 서버 명령어
명령어는 GPanel 콘솔에서 입력하거나, 관리자로 로그인한 경우 게임 내 채팅(/ 접두사 사용)에서 입력할 수 있습니다.
| 명령어 | 설명 |
|---|---|
/help |
사용 가능한 명령어를 나열합니다. |
/status |
서버 상태와 접속된 플레이어를 표시합니다. |
/kick [player] |
서버에서 플레이어를 추방합니다. |
/ban [player] |
서버에서 플레이어를 차단합니다. |
/unban [player] |
플레이어의 차단을 해제합니다. |
/tp [player] [x] [y] [z] |
플레이어를 특정 좌표로 순간이동시킵니다. |
/give [player] [item] [amount] |
플레이어에게 아이템을 지급합니다. |
/god_mode [player] |
플레이어의 무적 상태를 전환합니다. |
/change_sector [player] [x] [y] [z] |
플레이어를 유니버스의 다른 섹터로 이동시킵니다. |
/save |
월드 저장을 강제합니다. |
/shutdown [seconds] |
지정된 지연 후 서버를 종료합니다. 즉시 종료하려면 /shutdown 0을 사용하세요. |
깔끔한 종료를 위해
/shutdown을 사용하세요. 유니버스 데이터 손상을 방지하기 위해 강제 종료보다 항상 /shutdown 0 또는 GPanel Stop 버튼을 사용하세요.
4. 팩션 관리
StarMade는 플레이어가 팩션을 만들고 가입할 수 있는 팩션 시스템을 특징으로 합니다. 관리자로서 명령어를 통해 팩션을 관리할 수 있습니다:
- 팩션 보기 -- 서버 로그를 확인하거나 팩션 명령어를 사용하여 활성 팩션을 확인합니다.
- 분쟁 해결 -- 순간이동 및 추방 명령어를 사용하여 팩션 충돌을 처리합니다.
- 버려진 팩션 정리 -- 비활성 팩션과 그 구조물을 제거하여 서버 리소스를 확보합니다.
5. 유니버스 유지 관리
백업
StarMade 유니버스를 백업하려면:
- 서버를 중지합니다(또는 먼저
/save를 사용하여 저장을 강제합니다). - SFTP를 통해 월드 디렉터리와 구성 파일을 다운로드합니다.
- 안전한 위치에 백업을 저장합니다.
성능 최적화
- 서버 리소스를 소비하는 버려진 우주선과 정거장을 정기적으로 정리합니다.
- GPanel에서 메모리 사용량을 모니터링합니다 -- StarMade는 대규모 건설물의 경우 메모리를 많이 사용할 수 있습니다.
- 성능 저하를 방지하기 위해
server.cfg에서 엔티티 제한을 설정하는 것을 고려하세요.
6. 구성 파일 참조
주요 구성 파일은 서버 루트 디렉터리에 있습니다:
| 파일 | 용도 |
|---|---|
server.cfg |
핵심 서버 설정(이름, 비밀번호, 최대 클라이언트 수, 관리자 비밀번호). |
blacklist.txt |
차단된 플레이어 이름/IP 목록. |
whitelist.txt |
허용된 플레이어 목록(화이트리스트 모드가 활성화된 경우). |
admins.txt |
영구 서버 관리자 목록. |
구성 파일을 편집하기 전에 항상 서버를 중지하세요. 변경 사항은 시작 시에만 읽힙니다.
7. 문제 해결
| 문제 | 해결책 |
|---|---|
| 서버가 OutOfMemoryError로 충돌함 | 서버에 더 많은 RAM이 필요합니다. 할당량을 늘리려면 지원팀에 문의하거나, 유니버스 크기와 엔티티 수를 줄이세요. |
| 플레이어가 접속할 수 없음 | 서버가 실행 중인지 확인하고, GPanel의 Network 탭에서 IP와 포트를 확인하며, 비밀번호가 올바른지 확인하세요. |
| 서버 지연 / 낮은 TPS | 버려진 구조물을 정리하고, 최대 플레이어 수를 줄이거나, 메모리 할당량을 늘리세요. |
| 유니버스 손상 | 백업에서 복원하세요. 백업이 없으면 서버를 재설치해 보세요(이렇게 하면 유니버스가 재설정됩니다). |
관련 문서
도움이 필요하신가요?
StarMade 서버에 문제가 발생하면 지원 티켓을 열어 서버 IP, 문제 설명, GPanel 콘솔의 관련 오류 메시지를 포함해 주세요.
