이 가이드는 CryoFall 전용 서버의 관리자 설정, 콘솔 명령어, 모드 지원, 플레이어 관리, 서버 와이프 및 문제 해결을 다룹니다. CryoFall은 적대적인 외계 행성을 배경으로 한 SF 식민지 생존 게임으로, 기술 트리, 농사, 제작, PvP/PvE 게임플레이를 특징으로 합니다. 초기 서버 설정, 구성 및 접속 안내는 CryoFall 서버 설정 가이드를 참고하세요.
1. 관리자 설정
CryoFall은 인게임 명령어가 아닌 구성 파일을 통해 관리자 권한이 부여되는 서버 운영자 모델을 사용합니다.
서버 운영자 추가
서버의 플레이어에게 관리자 접근 권한을 부여하려면:
- GPanel에서 서버를 중지합니다.
- Files 탭 또는 SFTP를 통해
Data/디렉터리에 있는 운영자 목록 파일을 엽니다. - 플레이어의 CryoFall 계정 이름 또는 ID를 운영자 목록에 추가합니다.
- 파일을 저장하고 서버를 재시작합니다.
서버 운영자는 게임 내에서 플레이어를 킥, 밴하고 월드를 관리하는 기능을 포함한 관리자 도구에 접근할 수 있습니다.
2. 콘솔 명령어
CryoFall은 운영자를 위해 GPanel 콘솔 및 인게임에서 접근할 수 있는 콘솔 명령어를 제공합니다. 아래는 서버 관리를 위한 주요 명령어입니다.
| 명령어 | 설명 |
|---|---|
/player.kick <name> |
서버에서 플레이어를 킥합니다. |
/player.ban <name> |
서버에서 플레이어를 영구적으로 밴합니다. |
/player.unban <name> |
밴 목록에서 플레이어를 제거합니다. |
/player.list |
현재 접속 중인 모든 플레이어를 나열합니다. |
/world.save |
즉시 월드 저장을 실행합니다. |
/server.shutdown |
저장과 함께 정상적인 서버 종료를 시작합니다. |
/admin.add <name> |
플레이어에게 운영자(관리자) 상태를 부여합니다. |
/admin.remove <name> |
플레이어로부터 운영자 상태를 취소합니다. |
/admin.list |
현재 모든 서버 운영자를 나열합니다. |
3. 모드 지원 (ModsConfig.xml)
CryoFall은 게임플레이를 수정하거나, 콘텐츠를 추가하거나, 서버 동작을 변경할 수 있는 서버 측 모드를 지원합니다.
모드 설치
- GPanel에서 서버를 중지합니다.
- CryoFall 모딩 커뮤니티 또는 Steam Workshop에서 원하는 모드를 다운로드합니다.
- SFTP를 통해 모드 파일을 서버의
Mods/디렉터리에 업로드합니다. 안내는 SFTP로 파일 업로드하는 방법을 참고하세요. Data/디렉터리에 있는ModsConfig.xml파일을 편집하여 모드를 등록합니다.- 서버를 시작합니다. 콘솔에서 모드가 성공적으로 로드되었는지 확인하세요.
ModsConfig.xml 형식
<ModsConfig>
<Mods>
<Mod>ModFolderName1</Mod>
<Mod>ModFolderName2</Mod>
</Mods>
</ModsConfig>각 <Mod> 항목은 Mods/ 디렉터리 내의 폴더 이름에 해당합니다. 로드 순서는 XML 파일에 나열된 순서를 따릅니다.
Data/ 디렉터리를 백업하세요.
4. 플레이어 관리
킥 및 밴
/player.kick <name>를 사용하여 방해가 되는 플레이어를 즉시 제거합니다./player.ban <name>을 사용하여 플레이어의 재접속을 영구적으로 차단합니다./player.unban <name>을 사용하여 밴을 해제합니다.- 밴 목록은 서버 재시작 후에도 유지됩니다.
비밀번호 보호
비공개 서버의 경우 ServerSettings.yml에서 비밀번호 보호를 활성화하세요:
IsPasswordProtected: true
ServerPassword: "YourSecretPassword"비밀번호는 신뢰할 수 있는 플레이어와만 공유하세요. 비밀번호 설정을 변경한 후에는 서버를 재시작하세요.
5. 서버 와이프
PvP 서버는 경제를 초기화하고 모든 플레이어에게 새로운 시작을 제공하기 위해 주기적인 와이프로 이점을 얻는 경우가 많습니다.
전체 와이프 수행
- GPanel에서 서버를 중지합니다.
- SFTP를 통해
Data/디렉터리를 백업합니다(나중에 복원하려는 경우를 대비하여). Data/디렉터리에서 월드 저장 파일을 삭제합니다. 설정을 유지하려면ServerSettings.yml및ModsConfig.xml과 같은 구성 파일은 그대로 두세요.- 서버를 시작합니다. 기존 구성으로 새 월드가 생성됩니다.
예약된 와이프
반복적인 와이프의 경우 일정을 정하고 플레이어에게 알리세요:
- 일반적인 일정은 주간(경쟁적 PvP) 또는 격주(균형 잡힌)입니다.
- 서버 설명이나 커뮤니티 Discord를 통해 와이프 날짜를 공지하세요.
- 방해를 최소화하기 위해 활동이 적은 시간대에 와이프를 수행하세요.
6. 문제 해결
시작 시 서버 충돌
- GPanel 콘솔에서 오류 메시지를 확인하세요. 일반적인 원인으로는 잘못된 YAML 구문(잘못된 들여쓰기, 콜론 누락 또는 공백 대신 탭 문자)이 있습니다.
- 최근에 모드를 추가했다면
ModsConfig.xml에서 모드를 제거하여 모드가 충돌을 일으키는지 확인해 보세요. ServerSettings.yml을 삭제하고 재시작하여 기본값으로 새 구성을 다시 생성하세요.- 충돌이 계속되면 서버 IP와 전체 콘솔 출력을 첨부하여 지원 티켓을 여세요.
플레이어가 접속할 수 없음
- GPanel에서 서버가 실행 중인지 확인하고 콘솔에서 오류를 확인하세요.
- 플레이어가 GPanel Network 탭의 올바른 IP와 포트를 사용하고 있는지 확인하세요.
- 비밀번호 보호가 활성화된 경우 서버 비밀번호가 올바른지 확인하세요.
- 서버와 클라이언트가 동일한 CryoFall 버전을 실행하고 있는지 확인하세요.
- 모드를 실행 중인 경우 플레이어가 필요한 클라이언트 측 모드를 설치했는지 확인하세요.
모드 관련 충돌
- 최근에 추가한 모드를 하나씩 제거하여 문제가 되는 모드를 식별하세요.
- 현재 CryoFall 버전과 모드 호환성을 확인하세요.
ModsConfig.xml파일에 유효한 XML 구문이 있고 모드 폴더 이름에 오타가 없는지 확인하세요.- 월드가 손상된 경우 모드 추가 이전의 백업에서 복원하세요.
성능 문제
- 서버가 많은 동시 접속 플레이어로 인해 어려움을 겪는 경우
MaxPlayers를 줄이세요. - 많은 수의 플레이어 구조물과 토지 점유권은 시간이 지남에 따라 성능에 영향을 줄 수 있습니다. 예약된 와이프는 이를 초기화하는 데 도움이 됩니다.
- 설치된 모드 중 성능 문제를 일으키는 것으로 알려진 것이 있는지 확인하세요.
- 성능이 계속 좋지 않으면 서버 플랜 업그레이드에 대해 지원팀에 문의하세요.
관련 문서
도움이 필요하신가요?
여기에서 다루지 않은 CryoFall 서버 문제가 발생하면 지원 티켓을 열고 서버 IP, 문제 설명 및 GPanel 콘솔의 관련 오류 메시지를 포함하세요.
