이 가이드는 Legion Hosting의 Soulmask 전용 서버에 대한 관리자 설정, 게임 내 관리자 명령어, RCON 구성 및 서버 관리 명령어를 다룹니다. 서버 설정 및 구성은 Soulmask 서버 설정 가이드를 참조하세요.
서버 패널: 모든 서버 관리는 gpanel.legionhosting.net의 GPanel을 통해 이루어집니다. 구성 파일을 편집하려면 파일 관리자 또는 SFTP를 사용하세요.
관리자 권한 설정
Soulmask는 비밀번호 기반 관리자 시스템을 사용합니다. 관리자가 되려면 서버 시작 구성에서 관리자 비밀번호를 설정한 다음 게임 내에서 인증해야 합니다.
1단계: 관리자 비밀번호 설정
- GPanel에서 Soulmask 서버를 선택합니다.
- Startup 탭을 클릭합니다.
ADMIN_PASSWORD변수를 강력하고 고유한 비밀번호로 설정합니다. 이는-adminpsw명령줄 매개변수에 해당합니다.- 변경 사항을 적용하기 위해 서버를 재시작합니다.
관리자 비밀번호는 비밀로 유지하세요. 관리자 비밀번호를 아는 사람은 누구나 서버에서 전체 GM 권한을 얻을 수 있습니다. 신뢰할 수 있는 공동 관리자와만 공유하세요.
2단계: 게임 내 인증
- 플레이어로 Soulmask 서버에 접속합니다.
- `(억음/물결표) 키 또는 Numpad -(숫자 패드 빼기)를 눌러 게임 내 콘솔을 엽니다.
- 다음 명령어를 입력하고 Enter 키를 누릅니다:
gm key YOUR_ADMIN_PASSWORD - 비밀번호가 올바르면 확인 메시지가 표시되고 GM(게임 마스터) 관리자 권한을 얻게 됩니다.
- GM 패널 인터페이스에 나타나는 "Become the admin" 버튼을 클릭할 수도 있습니다.
세션 기반 인증. 서버에 접속할 때마다 다시 인증해야 합니다. 관리자 상태는 세션 간에 저장되지 않으므로 로그인할 때마다
gm key를 실행해야 합니다.
게임 내 관리자 명령어
관리자로 인증되면 콘솔(` 또는 Numpad -)을 열고 명령어를 입력합니다. 모든 관리자 명령어는 gm 접두사로 시작합니다.
플레이어 관리
| 명령어 | 설명 |
|---|---|
gm AddExp [value] |
캐릭터에 일반 경험치를 추가합니다. |
gm Addmjexp [value] |
캐릭터에 마스크 경험치를 추가합니다(마스크 레벨업). |
gm Addshoulieexp [value] |
캐릭터에 사냥 경험치를 추가합니다. |
gm XiDian |
캐릭터의 모든 스킬 포인트를 초기화하여 재배분을 허용합니다. |
gm FuHuo |
캐릭터를 부활시킵니다(사망 시 사용). |
gm ZiSha 1 |
자신의 캐릭터를 죽입니다(자살 명령어). |
gm shanhao |
서버에서 계정/캐릭터를 삭제합니다. 극도로 주의하여 사용하세요 -- 되돌릴 수 없습니다. |
gm ShowInfo 1 |
자신의 캐릭터에 대한 상세 정보(스탯, ID, 위치)를 표시합니다. |
gm ShowInfo 0 |
현재 대상으로 지정된 캐릭터 또는 NPC에 대한 상세 정보를 표시합니다. |
gm ChongZhiRenWu |
캐릭터의 모든 튜토리얼과 가이드 퀘스트를 초기화합니다. |
탐색 및 가시성
| 명령어 | 설명 |
|---|---|
gm Go [x] [y] [z] |
특정 월드 좌표로 순간이동합니다. 먼저 GPS를 사용하여 현재 좌표를 확인하세요. |
GPS |
현재 월드 좌표(X, Y, Z)를 표시합니다. 순간이동 대상에 유용합니다. |
gm SetAttr YinShen 1 |
투명화를 활성화합니다. 몬스터와 NPC가 당신을 감지할 수 없습니다. |
gm SetAttr YinShen 0 |
투명화를 비활성화합니다. 정상 가시성으로 돌아갑니다. |
gm ShowMap |
전체 맵을 공개하여 캐릭터의 모든 전장의 안개를 해제합니다. |
NPC 및 월드 제어
| 명령어 | 설명 |
|---|---|
gm ZhaoMu |
대상으로 지정된 NPC를 부족에 즉시 모집합니다. |
gm ClearAllNpc |
서버에서 모든 비플레이어 NPC를 제거합니다. 주의하여 사용하세요 -- 서버 전체의 모든 NPC에 영향을 미칩니다. |
gm ClearSelect |
현재 선택/대상으로 지정된 엔티티(NPC, 생물 또는 오브젝트)를 제거합니다. |
gm ShuaXinZhiBei |
인근의 모든 식생과 채집 가능한 식물을 새로 고치고 다시 자라게 합니다. |
gm KeJiShu |
캐릭터의 모든 기술 트리 노드를 잠금 해제합니다. |
침공 및 열기(Heat) 관리
| 명령어 | 설명 |
|---|---|
gm ShowReDu |
현재 침공 열기 차트를 표시하여 여러 지역의 위협 수준을 보여줍니다. |
gm ClearAllReDu |
맵 전체의 모든 침공 열기를 제거하여 위협 수준을 0으로 초기화합니다. |
gm AddReDu [value] |
지정된 양만큼 침공 열기를 수동으로 증가시킵니다. 열기가 높을수록 더 많은 침공을 유발합니다. |
서버 및 디버그
| 명령어 | 설명 |
|---|---|
gm exit |
저장과 함께 서버를 정상적으로 종료합니다. 게임 내에서 서버를 중지하는 가장 안전한 방법입니다. |
Debuginfo 1 |
틱 레이트, 엔티티 수 및 리소스 사용량을 보여주는 서버 성능 모니터링 오버레이를 활성화합니다. |
Debuginfo 0 |
서버 성능 모니터링 오버레이를 비활성화합니다. |
명령어를 신중하게 사용하세요. 관리자 명령어는 서버 안정성과 플레이어 경험에 상당한 영향을 미칠 수 있습니다. 대량의 엔티티 생성, 서버 전체 NPC 제거, 월드 데이터의 빠른 수정은 지연이나 충돌을 유발할 수 있습니다. 먼저 접속자가 적은 시간에 명령어를 테스트하세요.
서버 관리 명령어
이 명령어들은 서버 전체 관리에 사용되며 게임 내(콘솔을 통해)와 원격(RCON/Telnet을 통해) 모두에서 실행할 수 있습니다.
서버 제어
| 명령어 | 설명 |
|---|---|
SaveWorld |
월드를 메모리에(선택적으로 디스크에) 즉시 강제 저장합니다. 위험한 작업을 수행하기 전에 사용하세요. |
SaveAndExit [seconds] |
월드를 저장하고 지정된 시간(초) 후에 서버를 종료합니다. 플레이어는 경고 카운트다운을 받습니다. |
StopCloseServer |
SaveAndExit로 시작된 대기 중인 종료를 취소합니다. |
shutdown [seconds] |
지정된 카운트다운(초)으로 서버의 정상 종료를 시작합니다. |
broadcast [message] |
연결된 모든 플레이어에게 전역 메시지를 보냅니다. 공지 및 경고에 유용합니다. |
플레이어 관리(원격)
| 명령어 | 설명 |
|---|---|
List_AllPlayers |
서버에 등록된 모든 플레이어 계정(온라인 및 오프라인)을 나열합니다. |
List_OnlinePlayers |
현재 연결된 모든 플레이어를 Steam ID 및 캐릭터 이름과 함께 나열합니다. |
List_Guilds |
서버의 모든 부족(길드)을 멤버 수와 함께 나열합니다. |
kick [PlayerName] |
캐릭터 이름으로 서버에서 플레이어를 추방합니다. |
ban [PlayerName] |
서버에서 플레이어를 차단합니다. 다시 연결할 수 없게 됩니다. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Steam ID로 특정 플레이어의 인벤토리에 아이템을 직접 추가합니다. |
GotoPosition [SteamID] [x] [y] [z] |
특정 플레이어를 월드 좌표로 순간이동시킵니다. |
FlyMode [SteamID] [0/1] |
플레이어의 유령/비행 모드를 활성화(1) 또는 비활성화(0)합니다. |
서버 정보
| 명령어 | 설명 |
|---|---|
ServerFPS |
현재 서버 틱 레이트(FPS)를 표시합니다. 정상적인 서버는 30 FPS 이상을 유지해야 합니다. |
Show_Coefficient_Settings |
GameXishu.json의 모든 현재 게임플레이 계수 설정을 나열합니다. |
Set_Coefficient [key] [value] |
파일을 편집하지 않고 런타임에 게임플레이 계수를 수정합니다. 변경 사항은 즉시 적용됩니다. |
List_AllTalent [level] |
지정된 레벨에서 사용 가능한 모든 천부적 재능(특성)을 봅니다. |
디버그 및 고급
| 명령어 | 설명 |
|---|---|
Dump_AllActorPositions |
월드 상태 디버깅을 위해 모든 액터 위치를 데이터 파일로 내보냅니다. |
DrawActorImage |
맵에 액터 위치의 시각화를 생성합니다. |
ExecScriptCommands [filename] |
명령어 배치 파일을 실행합니다. 여러 명령어를 한 번에 실행하는 데 유용합니다. |
RCON 접근
RCON(원격 콘솔)을 사용하면 게임에 연결하지 않고도 원격으로 서버 명령어를 실행할 수 있습니다. Soulmask는 원격 관리를 위해 RCON과 Telnet을 모두 지원합니다.
RCON 활성화
RCON은 기본적으로 비활성화되어 있으며 시작 매개변수를 통해 활성화해야 합니다:
- GPanel에서 Startup 탭으로 이동합니다.
- 다음 매개변수를 추가합니다(추가 시작 매개변수를 통하거나 지원팀에 문의하여 추가):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - 서버를 재시작합니다.
RCON 보안. Soulmask의 RCON 구현은 보안을 위해 IP 화이트리스트를 사용합니다. 화이트리스트에 등록된 IP 주소만 RCON 서비스에 연결할 수 있습니다. IP를 추가해야 하는 경우 화이트리스트 위치는 서버 문서나 구성 파일을 확인하세요.
RCON을 통한 연결
RCON이 활성화되면 표준 RCON 클라이언트를 사용하여 연결할 수 있습니다:
- rcon-cli와 같은 RCON 클라이언트 또는 mcrcon과 같은 GUI 도구를 다운로드합니다.
- 다음을 사용하여 서버에 연결합니다:
- 호스트: 서버의 IP 주소
- 포트: RCON 포트(기본값
19000) - 비밀번호:
-rconpsw로 설정한 RCON 비밀번호
- 연결되면
help를 입력하여 사용 가능한 명령어 목록을 확인합니다.
Telnet 접근
Soulmask는 Echo 포트(기본값 18888)에서 Telnet 기반 관리도 지원합니다. Telnet은 기본적으로 로컬 연결로만 제한되며 추가 포트 포워딩이 필요하지 않습니다. 이는 주로 서버 머신 자체에서 스크립트 기반 관리에 사용됩니다.
RCON 세션 예시
# Connect to RCON (using rcon-cli as example)
rcon -a your.server.ip:19000 -p YOUR_RCON_PASSWORD
# Check server performance
ServerFPS
# List online players
List_OnlinePlayers
# Send a global message
broadcast Server restart in 10 minutes!
# Initiate a 600-second (10-minute) shutdown countdown
SaveAndExit 600
# Cancel the shutdown if needed
StopCloseServer올바른 서버 종료
Soulmask 서버를 종료하는 안전한 방법은 여러 가지가 있습니다. 데이터 손실을 방지하려면 항상 다음 중 하나를 사용하세요:
- GPanel Stop 버튼: 가장 간단한 방법입니다. GPanel Console 탭에서 Stop을 클릭합니다.
- 게임 내 명령어: 관리자로 인증하고
gm exit를 실행하여 저장하고 종료합니다. - RCON/Telnet: 플레이어가 준비할 시간을 주는 카운트다운 종료를 위해
shutdown [seconds]또는SaveAndExit [seconds]를 실행합니다.
서버 강제 종료를 피하세요. GPanel Kill 버튼을 사용하거나 프로세스를 강제 종료하면 저장 단계를 건너뜁니다. 마지막 자동 디스크 백업 이후의 모든 진행 상황이 손실됩니다. 서버가 완전히 응답하지 않을 때 최후의 수단으로만 Kill을 사용하세요.
서버 관리자를 위한 팁
- 자동 백업을 설정하세요.
-initbackup과-backupinterval=30을 사용하여 정기적인 백업 스냅샷을 생성하세요. - 서버 FPS를 모니터링하세요.
ServerFPS명령어를 정기적으로 사용하세요. 틱 레이트가 15-20 FPS 미만으로 떨어지면 서버가 어려움을 겪고 있는 것이며 최적화나 재시작이 필요할 수 있습니다. - 실시간 조정에
Set_Coefficient를 사용하세요. 서버를 재시작하지 않고 런타임에 게임플레이 설정을 조정할 수 있습니다. 먼저Show_Coefficient_Settings를 실행하여 현재 값을 확인하세요. - 정기적인 재시작을 예약하세요. 메모리 누수를 제거하고 보류 중인 업데이트를 적용하려면 서버를 매일 재시작하세요.
- 유지 보수 전에 방송하세요. 서버 재시작이나 유지 보수 시간 전에 항상
broadcast명령어를 사용하여 플레이어에게 경고하세요. - 위험한 작업 전에
SaveWorld를 사용하세요. NPC 제거나 계수 수정과 같은 중요한 변경을 하기 전에 강제로 저장하세요.
관련 문서
도움이 필요하신가요?
Soulmask 관리자 명령어나 서버 관리에 대한 추가 지원이 필요하면 지원 티켓을 열어 주시면 저희 팀이 기꺼이 도와드리겠습니다.
