이 가이드는 Legion Hosting에서 Avorion 전용 서버에 사용할 수 있는 모든 관리자 명령어, 모드 지원, 서버 관리 도구를 다룹니다. 플레이어 관리, 은하 제어, 모드 설치, 일반적인 문제 해결 방법을 알아보세요. 초기 서버 설정 및 구성에 대해서는 Avorion 서버 설정 가이드를 참고하세요.
관리자 설정
Avorion은 특정 플레이어에게 상승된 권한을 부여하는 XML 기반 관리자 시스템을 사용합니다. 관리자는 admin.xml 파일에 정의하거나 게임 내 명령어를 통해 추가할 수 있습니다.
admin.xml을 통한 관리자 추가
admin.xml 파일은 은하의 저장 폴더(예: galaxies/your_galaxy_name/admin.xml)에 있습니다. 이 파일은 GPanel의 파일 관리자(File Manager)를 통해 편집할 수 있습니다.
<?xml version="1.0" encoding="UTF-8"?>
<admin>
<admin id="76561198012345678" />
<admin id="76561198087654321" />
</admin>각 <admin> 항목에는 플레이어의 Steam ID(SteamID64 형식)가 포함됩니다. 플레이어의 Steam ID를 찾으려면:
- 플레이어의 Steam 프로필로 이동합니다
- 프로필 URL이 사용자 지정 이름을 사용하는 경우 SteamID 조회 도구를 사용하여 SteamID64를 찾습니다
- SteamID64는
7656119로 시작하는 17자리 숫자입니다
게임 내에서 관리자 추가
이미 관리자인 경우 게임 내 채팅 명령어를 사용하여 다른 관리자를 추가할 수 있습니다:
/admin <playerName>이 명령어는 서버 재시작 없이 지정된 플레이어를 즉시 관리자 목록에 추가합니다.
첫 관리자: 초기 관리자 설정의 경우, 게임 내 명령어를 실행할 관리자가 아직 없으므로 GPanel의 파일 관리자를 통해
admin.xml을 직접 편집해야 합니다. Steam ID를 추가하고 서버를 재시작한 후에는 게임 내 명령어를 사용하여 추가 관리자를 추가할 수 있습니다.
일반 관리자 명령어
관리자 명령어는 게임 내 채팅(Enter를 눌러 채팅 열기)에 / 접두사를 붙여 입력합니다. 이 명령어들은 GPanel 서버 콘솔에서도 실행할 수 있습니다.
플레이어 관리
| 명령어 | 설명 |
|---|---|
/kick <name> |
플레이어를 서버에서 추방합니다. 즉시 재접속할 수 있습니다. |
/ban <name> |
플레이어를 서버에서 차단합니다. 해당 플레이어의 Steam ID가 banlist.txt에 추가됩니다. |
/unban <steamid> |
Steam ID로 플레이어의 차단을 해제합니다. |
/admin <name> |
플레이어에게 관리자 권한을 부여합니다. |
/removeadmin <name> |
플레이어의 관리자 권한을 제거합니다. |
/say <message> |
모든 플레이어에게 서버 전체 메시지를 방송합니다. |
/players |
접속 중인 모든 플레이어를 Steam ID 및 현재 섹터와 함께 나열합니다. |
/whisper <name> <message> |
특정 플레이어에게 비공개 메시지를 보냅니다. |
서버 제어
| 명령어 | 설명 |
|---|---|
/save |
로드된 모든 섹터와 플레이어 데이터를 디스크에 수동으로 저장합니다. |
/stop |
모든 데이터를 안전하게 저장하고 서버를 종료합니다. |
/seed |
현재 은하 시드를 표시합니다. |
/status |
플레이어 수, 로드된 섹터, 성능 지표를 포함한 서버 상태를 표시합니다. |
/difficulty <value> |
서버 난이도 레벨을 변경합니다 (-3 ~ 3). 새로 생성되는 섹터에 적용됩니다. |
/pvp <on|off> |
플레이어 대 플레이어 전투를 켜거나 끕니다. |
/maxplayers <number> |
서버가 실행 중인 동안 최대 플레이어 수를 변경합니다. |
/password <password> |
서버 비밀번호를 설정하거나 변경합니다. 비밀번호를 제거하려면 비워둡니다. |
순간이동 및 내비게이션
| 명령어 | 설명 |
|---|---|
/tp <x> <y> |
섹터 좌표(x, y)로 자신을 순간이동합니다. |
/tp <playerName> |
다른 플레이어의 위치로 자신을 순간이동합니다. |
/tp <playerName> <x> <y> |
특정 플레이어를 섹터 좌표로 순간이동합니다. |
/give <playerName> <amount> <material> |
플레이어에게 자원을 지급합니다. 재료: Iron, Titanium, Naonite, Trinium, Xanion, Ogonite, Avorion. |
은하 관리
관리자는 은하 구조와 섹터를 관리할 수 있는 도구를 가지고 있습니다.
섹터 관리
| 명령어 | 설명 |
|---|---|
/sector |
현재 섹터에 대한 정보(좌표, 엔티티, 팩션)를 표시합니다. |
/regeneratesector <x> <y> |
섹터를 재생성하여 절차적으로 생성된 상태로 되돌립니다. 경고: 해당 섹터의 모든 플레이어 건축물을 파괴합니다. |
/clearsector <x> <y> |
섹터에서 모든 엔티티를 제거하여 비웁니다. |
경고: 섹터 재생성 및 초기화는 파괴적인 작업입니다. 영향받는 섹터의 모든 플레이어 함선, 정거장, 건축물이 영구적으로 삭제됩니다. 이러한 명령어를 사용하기 전에 항상 플레이어에게 경고하고 백업하세요.
재료 등급
Avorion의 은하는 점점 더 높은 재료 등급의 고리 형태로 구성되어 있으며, 핵심부의 장벽을 향해 안쪽으로 퍼져 있습니다. 이를 이해하면 플레이어를 순간이동하거나 섹터 콘텐츠를 관리할 때 도움이 됩니다.
| 재료 | 등급 | 은하 고리 | 색상 |
|---|---|---|---|
| Iron | 0 | 최외곽 고리 | 회색 |
| Titanium | 1 | 두 번째 고리 | 흰색 |
| Naonite | 2 | 세 번째 고리 | 녹색 |
| Trinium | 3 | 네 번째 고리 | 파란색 |
| Xanion | 4 | 다섯 번째 고리 | 노란색 |
| Ogonite | 5 | 여섯 번째 고리 | 주황색 |
| Avorion | 6 | 핵심부 (장벽 너머) | 금색 |
모드 및 워크샵 지원
Avorion은 강력한 Steam Workshop 지원을 제공하여 커뮤니티에서 제작한 모드로 서버를 확장할 수 있습니다.
모드 설치
- Avorion용 Steam Workshop에서 원하는 모드를 찾습니다
- 모드의 URL에서 Workshop ID(끝에 있는 숫자)를 기록합니다
- GPanel에서 서버를 중지합니다
- GPanel의 파일 관리자(File Manager)를 엽니다
galaxies/your_galaxy_name/디렉터리로 이동합니다modconfig.lua파일을 편집합니다 (없으면 생성)- 모드의 Workshop ID를 구성에 추가합니다
- 서버를 시작합니다 — 모드가 자동으로 다운로드됩니다
modconfig.lua 형식
-- Avorion Mod Configuration
modLocation = ""
forceEnabling = false
mods =
{
{workshopid = "1234567890"},
{workshopid = "0987654321"},
{workshopid = "1122334455"},
}
중요: 모드가 적용된 서버에 접속하는 모든 플레이어는 동일한 모드를 설치해야 합니다. Steam Workshop 모드는 일반적으로 플레이어가 접속할 때 자동으로 다운로드되지만, 일부 모드는 클라이언트 측에서 수동 설치가 필요할 수 있습니다.
모드 관리 팁
- 모드를 하나씩 추가하고 추가할 때마다 테스트하여 호환성 문제를 파악하세요
- 일부 모드는 완전히 적용되려면 은하 재설정이 필요합니다(특히 섹터 생성을 수정하는 모드)
- 설치 전에 알려진 비호환성에 대해 모드 댓글과 설명을 확인하세요
- 모드를 추가하거나 제거하기 전에
modconfig.lua와 은하 폴더의 백업을 유지하세요 - 서버 측 전용 모드는 클라이언트가 설치할 필요가 없지만 대부분의 게임플레이 모드는 양쪽 모두 필요합니다
문제 해결
서버가 브라우저에 표시되지 않음
server.ini또는 시작 변수에서listed=true인지 확인합니다- Steam 쿼리 포트(
steamQueryPort)에 접근 가능한지 확인합니다 — 일반적으로 게임 포트 + 1입니다 - Steam 목록이 전파되도록 서버 시작 후 2~3분 기다립니다
- 직접 접속(Direct Connect)을 통해 서버가 실행 중인지 확인해 봅니다
- 콘솔에서
Server startup complete를 확인하여 서버가 완전히 시작되었는지 확인합니다
서버 충돌
Avorion 서버가 충돌하는 경우 다음 단계를 따르세요:
- 충돌 로그 확인 — GPanel 콘솔과 은하 디렉터리 내의
logs/폴더에서 오류 메시지를 찾습니다 - 최근에 추가한 모드 제거 — 모드를 추가한 후 충돌이 시작되었다면
modconfig.lua에서 제거하고 재시작합니다 - 섹터 손상 확인 — 특정 섹터를 로드할 때 충돌이 발생하면 해당 섹터가 손상되었을 수 있습니다. 콘솔에서
/regeneratesector를 사용하거나(접근 가능한 경우)sectors/폴더에서 섹터 파일을 삭제합니다 - 서버 업데이트 — GPanel을 통해 서버가 최신 버전으로 실행되고 있는지 확인합니다
- 워커 스레드 감소 — 서버 리소스가 부족한 경우
server.ini의workerThreads와generatorThreads를 줄여 봅니다 - 백업에서 복원 — 다른 모든 방법이 실패하면 문제가 시작되기 전에 만든 백업에서 은하 폴더를 복원합니다
성능 문제
- 높은 틱 타임 —
/status를 사용하여 서버 성능을 확인합니다. 높은 틱 타임은 서버가 시뮬레이션 요구를 따라가지 못하고 있음을 나타냅니다. - 너무 많은 로드된 섹터 — 플레이어나 활성 AI가 있는 각 섹터는 리소스를 소비합니다. 플레이어가 은하 전체에 동시에 너무 멀리 퍼지지 않도록 권장하세요.
- 대형 함선 — 블록 수가 과도한 함선은 시뮬레이션 부하를 증가시킵니다. 최대 함선 크기에 대한 가이드라인 설정을 고려하세요.
- 정거장 스팸 — 단일 섹터에 플레이어가 건축한 정거장이 많으면 성능이 저하될 수 있습니다.
/sector로 섹터 엔티티 수를 모니터링하세요.
플레이어 접속 문제
- 버전 불일치 — 모든 플레이어는 서버와 동일한 게임 버전이어야 합니다. 모두가 Steam을 통해 업데이트했는지 확인하세요.
- 모드 불일치 — 플레이어는 동일한 모드를 설치해야 합니다. 플레이어가 접속할 수 없는 경우 모드 목록이 서버의
modconfig.lua와 일치하는지 확인하세요. - 타임아웃 오류 — 서버 과부하나 네트워크 문제를 나타낼 수 있습니다.
/status로 서버 성능을 확인하세요. - 비밀번호 문제 — 플레이어가 비밀번호가 작동하지 않는다고 보고하면 시작 변수와
server.ini의 비밀번호가 일치하는지 확인하세요.
빠른 참조
일상적인 서버 관리에 가장 일반적으로 사용되는 관리자 명령어:
# Check server health
/status
# See who is online
/players
# Save all data
/save
# Broadcast a message
/say Server restarting in 5 minutes!
# Kick a player
/kick PlayerName
# Ban a player
/ban PlayerName
# Teleport to a player
/tp PlayerName
# Give resources to a player
/give PlayerName 10000 Trinium
# View current sector info
/sector
# Check galaxy seed
/seed
# Safely shut down
/stop관련 문서
도움이 필요하신가요?
Avorion 서버 관리에 추가 지원이 필요하거나 특정 명령어에 대한 질문이 있는 경우 저희 지원팀이 도와드릴 준비가 되어 있습니다. 지원 티켓을 제출하시면 최대한 빨리 답변해 드리겠습니다.
