이 가이드는 Legion Hosting의 Empyrion: Galactic Survival 전용 서버에서 사용할 수 있는 모든 관리자 및 콘솔 명령어를 다룹니다. 관리자 권한을 설정하고, 플레이어를 관리하며, GameMaster 명령어를 사용하여 서버를 관리하는 방법을 알아보세요. 초기 서버 설정 및 구성에 대해서는 Empyrion: Galactic Survival 서버 설정 가이드를 참조하세요.
권한 레벨
Empyrion은 낮은 숫자가 더 높은 권한을 부여하는 번호 매김 권한 시스템을 사용합니다. 각 권한 레벨은 더 높은 번호의 레벨에서 사용할 수 있는 모든 명령어를 포함합니다.
| 레벨 | 역할 | 코드 | 설명 |
|---|---|---|---|
| 0 | Player | pl |
모든 플레이어의 기본 권한 레벨입니다. 기본 명령어에만 접근할 수 있습니다. |
| 3 | GameMaster | gm |
게임 관리, 텔레포트, 스폰 및 월드 제어를 위한 상승된 권한입니다. |
| 6 | Moderator | mod |
차단, 아이템 지급 및 엔티티 관리를 포함한 플레이어 관리 기능입니다. |
| 9 | Admin | admin |
역할 할당, 플레이필드 관리 및 서버 제어를 포함한 전체 관리 권한입니다. |
권한 상속: GameMaster(레벨 3) 권한을 가진 플레이어는 레벨 3 이상(3+, 6+, 9+)을 요구하는 모든 명령어에 접근할 수 있습니다. Admin(레벨 9)은 모든 명령어에 접근할 수 있습니다.
관리자 권한 설정하기
방법 1: adminconfig.yaml (권장)
관리자 권한을 설정하는 가장 안정적인 방법은 adminconfig.yaml 파일을 통하는 것입니다. 이 파일은 서버의 Saves/ 폴더(또는 경우에 따라 dedicated.yaml 옆)에 위치합니다.
다음 구조로 adminconfig.yaml을 생성하거나 편집하세요:
Elevated:
- Id: 76561198012345678
Permission: 3
Name: "PlayerOne"
- Id: 76561198087654321
Permission: 9
Name: "ServerAdmin"
Banned:
- Id: 76561198099999999
Until: "2027-01-01 00:00:00"각 항목에는 다음이 필요합니다:
Id— 플레이어의 SteamID64 (7656으로 시작하는 17자리 숫자)Permission— 할당할 권한 레벨 (3 = GameMaster, 6 = Moderator, 9 = Admin)Name— 플레이어 이름 (선택 사항, 참고용)
SteamID64 찾기: 플레이어는 steamid.io를 방문하여 Steam 프로필 URL을 입력함으로써 자신의 SteamID64를 찾을 수 있습니다. SteamID64는
7656으로 시작하는 17자리 숫자입니다.
방법 2: initadmin 콘솔 명령어
플레이어로 서버에 로그인되어 있고 아직 관리자가 설정되지 않은 경우, initadmin 명령어를 사용하여 자신을 초기 관리자로 설정할 수 있습니다:
initadmin이는 현재 관리자가 구성되지 않은 경우에만 작동합니다. 관리자가 존재하면 추가 역할 할당은 setrole 명령어 또는 adminconfig.yaml 파일을 통해 수행해야 합니다.
방법 3: setrole 콘솔 명령어
기존 관리자(권한 레벨 9)는 setrole 명령어를 사용하여 다른 플레이어에게 역할을 할당할 수 있습니다:
setrole PlayerName gm # Set as GameMaster (level 3)
setrole PlayerName mod # Set as Moderator (level 6)
setrole PlayerName admin # Set as Admin (level 9)
setrole PlayerName pl # Reset to Player (level 0)플레이어 이름 대신 SteamID64를 사용할 수도 있습니다:
setrole 76561198012345678 gm콘솔 열기
게임 내 콘솔에 접근하려면 키보드의 물결표 키(~)를 누르세요. 콘솔을 사용하면 플레이하는 동안 직접 명령어를 입력할 수 있습니다. 모든 명령어는 대소문자를 구분하지 않습니다.
Telnet 콘솔:
dedicated.yaml에서 활성화된 경우 Telnet을 통해 원격으로 명령어를 보낼 수도 있습니다. PuTTY 또는 유사한 터미널 클라이언트를 사용하여 Raw 연결 유형(표준 Telnet이 아님)으로 Telnet 포트(기본값: 1030)에 연결하세요. Telnet 구성 세부 정보는 서버 설정 가이드를 참조하세요.
플레이어 명령어 (레벨 0+)
이 명령어들은 모든 플레이어가 사용할 수 있습니다.
| 명령어 | 설명 |
|---|---|
help |
사용 가능한 모든 콘솔 명령어를 나열합니다. 특정 명령어에 대한 세부 정보는 help [command]를 사용하세요. |
detach |
로컬 플레이어가 조종석 아래나 지형에 끼었을 때 분리합니다 |
destroyme |
자신의 캐릭터를 죽입니다 (끼었을 때 유용) |
undock |
지정된 SV 또는 HV를 상위 구조물에서 분리합니다 |
difficulties |
게임의 현재 난이도 설정을 표시합니다 |
origins |
사용 가능한 출신(시작 팩션)을 나열합니다 |
oxygen |
POI 내의 산소가 공급된 영역을 표시합니다 |
combiner |
메시 결합기를 켜고 끕니다 (성능) |
deco |
지형 장식을 켜고 끕니다 (성능) |
initadmin |
자신을 초기 관리자로 설정합니다 (관리자가 설정되지 않은 경우에만 작동) |
GameMaster 명령어 (레벨 3+)
GameMaster 명령어는 게임 월드, 엔티티 및 플레이어 상태에 대한 제어를 제공합니다.
플레이어 및 엔티티 관리
| 명령어 | 설명 |
|---|---|
godmode / gm |
자신에 대한 갓 모드(무적)를 켜고 끕니다 |
itemmenu / im |
모든 아이템을 스폰할 수 있는 크리에이티브 아이템 메뉴를 활성화/비활성화합니다 |
kick [player] |
플레이어(또는 모든 플레이어)를 게임에서 추방합니다 |
unban [player|SteamID] |
플레이어의 차단을 해제합니다 |
list |
특수 권한을 가진 플레이어와 차단된 플레이어를 나열합니다 |
level [set|add] [value] |
현재 플레이어의 레벨, 경험치 또는 업그레이드 포인트를 수정합니다 |
entity [operation] |
엔티티에 대한 다양한 작업을 수행합니다 (세부 정보는 help entity 사용) |
ents |
현재 플레이필드의 모든 엔티티를 나열합니다 |
find [name] |
현재 플레이필드 내에서 이름으로 구조물을 찾아 ID를 표시합니다 |
faction [operation] |
팩션 관리 도우미 기능 |
텔레포트 및 이동
| 명령어 | 설명 |
|---|---|
teleport [x] [y] [z] / tt |
자신(및 조종 중인 함선)을 특정 좌표로 텔레포트합니다 |
setposition [entity] [x] [y] [z] |
엔티티의 위치를 특정 좌표로 설정합니다 |
setrotation [entity] [x] [y] [z] |
구조물의 회전을 설정합니다 |
sector [x] [y] [z] |
우주의 특정 섹터로 점프합니다 |
월드 및 게임 관리
| 명령어 | 설명 |
|---|---|
changemode |
게임을 Survival과 Creative 모드 사이에서 전환합니다 |
map |
현재 맵의 모든 자원과 POI를 공개합니다 |
regenerate [entityId] |
POI 또는 구조물을 재생성하여 원래 상태로 복원합니다 |
weather [type] |
현재 플레이필드에서 사용자 지정 날씨 설정을 활성화합니다 |
time [set] [value] |
전역 서버 시간을 가져오거나 설정합니다 |
finishbp / fbp |
현재 청사진 생산을 즉시 완료합니다 |
spawnanyblueprint / sbp |
요구 사항에 관계없이 모든 청사진을 스폰하는 기능을 켜고 끕니다 |
gameoptions / gopt |
현재 모든 게임 옵션 값을 나열합니다 (아래 게임 옵션 섹션 참조) |
op [entityId] |
특정 구조물의 오프라인 보호를 켜고 끕니다 |
wipe [target] |
서버 재부팅 후 대상 측면을 초기화합니다 (주의해서 사용) |
stats |
현재 플레이필드에 대한 상태 정보를 출력합니다 |
traders |
모든 상인을 나열하고 상인 구성 파일을 다시 로드합니다 |
상태 효과 및 플레이어 상태
| 명령어 | 설명 |
|---|---|
statuseffect [effect] |
플레이어에게 상태 효과를 적용합니다 |
statuseffectremove [effect] |
플레이어로부터 상태 효과를 제거합니다 |
prefabactivate |
구조물의 모든 전원 블록을 켭니다 |
prefabinfo |
사용자 청사진에 대한 정보를 표시합니다 |
resetcore |
로컬 구조물의 연료와 산소를 비웁니다 |
Moderator 명령어 (레벨 6+)
Moderator 명령어는 플레이어 관리 및 엔티티 제어 기능을 추가합니다.
| 명령어 | 설명 |
|---|---|
ban [player] [duration] |
지정된 시간 동안 플레이어를 차단합니다 |
give [player] [itemId] [amount] |
아이템 ID로 플레이어에게 아이템을 지급합니다 |
repair [player] |
플레이어의 아이템을 수리합니다 |
destroy [entityId] |
엔티티 또는 구조물을 파괴합니다 |
debugmenu / dm |
디버그 메뉴를 활성화/비활성화합니다 |
armor [operation] |
플레이어 방어구 조정 |
gents [factionId] |
특정 팩션에 속한 모든 구조물을 나열합니다 |
alliances |
동맹, 동맹 요청을 나열하고 동맹 설정을 관리합니다 |
sectors [reveal|hide] |
맵에서 플레이필드를 공개하거나 숨깁니다 |
ai |
현재 플레이필드의 AI를 켜거나 끕니다 |
si |
구조적 무결성 계산을 켜거나 끕니다 |
globaleffects |
서버에서 활성화된 현재 전역 효과를 표시합니다 |
marker [operation] |
맵 마커를 관리합니다 |
weathersv [type] |
서버 전체에서 사용자 지정 날씨 설정을 활성화합니다 |
poimanager |
POI(관심 지점) 관리 명령어 |
Admin 명령어 (레벨 9)
Admin 명령어는 가장 높은 수준의 서버 제어를 제공합니다.
| 명령어 | 설명 |
|---|---|
setrole [player|SteamID] [role] |
플레이어의 권한 역할을 설정합니다 (gm, mod, admin, pl) |
playfield / pf |
현재 플레이필드를 다시 로드합니다 (서버 전용 명령어) |
replaceblocks [entityId] [blockFrom] [blockTo] |
구조물의 지정된 블록을 다른 블록 유형으로 교체합니다 |
setdevicespublic [entityId] |
구조물의 모든 장치를 공개 접근으로 설정합니다 |
pda [operation] |
PDA 관련 명령어를 실행합니다 (세부 정보는 help pda 사용) |
게임 옵션 (gopt) 명령어
gameoptions(또는 gopt) 명령어를 사용하면 구성 파일을 편집하거나 서버를 다시 시작하지 않고도 런타임에 서버 게임플레이 설정을 보고 수정할 수 있습니다.
설정 보기
# Show all game options
gopt
# Show only settings that differ from defaults
gopt nd설정 수정
# Set a specific option
gopt set DecayTime 48
gopt set MaxStructures 150
gopt set ForcePvP true
gopt set DiffAttackStrength Hard
gopt set DiffConstrCraftTime Instant사용 가능한 게임 옵션
| 옵션 | 기본값 | 설명 |
|---|---|---|
DecayTime |
24 | 방문하지 않은 코어 없는/작은 구조물이 제거되기까지의 시간 |
WipeTime |
0 | 방문하지 않은 모든 구조물이 제거되기까지의 시간 (0 = 비활성화) |
ProtectTime |
48 | 플레이어 구조물에 대한 오프라인 보호 시간 |
ProtectDelay |
300 | 오프라인 보호가 활성화되기까지의 초 |
MaxStructures |
200 | 플레이필드당 최대 구조물 수 (0-255) |
AntiGriefDistancePvE |
30 | PvE에서 팩션 기지 간 최소 미터 |
AntiGriefDistancePvP |
300 | PvP에서 팩션 기지 간 최소 미터 |
ForcePvP |
false | 모든 플레이필드에서 PvP를 강제합니다 |
DiffAmountOfOre |
Normal | 광석 매장량 풍부도 (Rich, Normal, Poor) |
DiffNumberOfDeposits |
Normal | 매장지 빈도 (Plenty, Normal, Few) |
DiffAttackStrength |
Medium | NPC 공격 피해 (Easy, Medium, Hard) |
DiffConstrCraftTime |
Normal | 제작기 속도 (Faster, Normal, Slower, Instant) |
서버 관리 명령어
이것들은 게임 내 콘솔 또는 Telnet을 통해 사용할 수 있는 일상적인 서버 관리에 필수적인 명령어입니다.
# Save and shut down the server (with countdown in minutes, max 15)
saveandexit 5
# List all connected players
plys
# List all active playfield servers
servers
# Regenerate a specific playfield
regenerateplayfield [name]
# View server performance statistics
stats
서버 종료: 서버를 안전하게 종료하려면 항상
saveandexit [minutes]를 사용하세요. 이것은 자동 저장을 트리거하고 연결된 플레이어에게 경고 카운트다운을 제공합니다. 서버 프로세스를 직접 종료하면 데이터 손실이 발생할 수 있습니다.
일반적인 관리자 작업
끼인 플레이어 처리
플레이어가 지형에 끼었거나 조종석 아래에 끼인 경우:
# Player can try this themselves:
detach
# If that fails, teleport them:
tt [player] [x] [y] [z]
# Or as a last resort, kill and respawn:
destroyme버려진 구조물 정리
# List all structures for a faction
gents [factionId]
# Find a specific structure
find "Structure Name"
# Destroy a structure by ID
destroy [entityId]
# Adjust automatic decay timers
gopt set DecayTime 12
gopt set WipeTime 168플레이어 차단 및 차단 해제
# Ban a player (duration examples: 1h, 24h, 7d, permanent)
ban PlayerName 7d
# Unban a player
unban PlayerName
# List all players with special roles or bans
list관련 문서
도움이 필요하신가요?
Empyrion 서버 관리에 대한 추가 지원이 필요하거나 특정 명령어에 대한 질문이 있는 경우, 저희 지원팀이 도와드릴 준비가 되어 있습니다. 지원 티켓을 제출하시면 최대한 빨리 답변드리겠습니다.
