Soulmask 서버 설정 가이드

이 가이드는 Legion Hosting에서 Soulmask 전용 서버를 설정하고 구성하는 데 필요한 모든 내용을 다룹니다. 여기에는 첫 시작, GPanel 시작 변수, 서버 구성, PvE 대 PvP 모드, 맵 및 월드 설정, 서버 연결, 세이브 관리가 포함됩니다. 관리자 설정 및 게임 내 명령어는 Soulmask 관리자 명령어를 참조하세요.

Soulmask란 무엇인가

Soulmask는 플레이어가 초자연적 능력을 부여하는 신비로운 고대 마스크를 쓴 채 깨어나는 오픈 월드 생존 제작 게임입니다. 무성하고 광활한 세계를 배경으로 플레이어는 자원을 모으고, 도구와 무기를 제작하고, 정착지를 건설하고, NPC 부족을 모집하고 관리해야 합니다. 마스크 시스템은 게임플레이의 핵심으로, 플레이어는 각각 고유한 기술과 특성을 가진 다양한 부족민을 빙의하고 제어하여 정착지와 전투 효율성을 최적화할 수 있습니다.

전용 서버의 주요 기능은 다음과 같습니다:

단일 서버에서 최대 70명의 동시 플레이어 지원
구성 가능한 규칙을 갖춘 PvE 및 PvP 게임 모드
GameXishu.json 구성 파일을 통한 광범위한 게임플레이 조정
구성 가능한 멤버 제한이 있는 부족(길드) 시스템
원격 서버 관리를 위한 RCON 및 Telnet 지원
자동 백업 및 세이브 관리

구성 파일을 편집하기 전에 서버를 중지하세요. 구성 파일을 편집하기 전에 항상 GPanel의 Console 탭에서 서버를 중지하세요. 서버가 실행 중일 때 변경한 사항은 덮어쓰이거나 손상을 일으킬 수 있습니다.

첫 시작

Legion Hosting에서 Soulmask 서버를 처음 받으면 플레이하기 전에 초기 설치를 완료해야 합니다.

GPanel에 로그인하고 서버 목록에서 Soulmask 서버를 선택합니다.
Console 탭을 클릭하고 Start를 누릅니다.
서버가 Steam을 통해 Soulmask 전용 서버 파일을 다운로드하고 설치합니다. 게임이 상당한 디스크 공간을 필요로 하므로 이 초기 다운로드는 몇 분이 걸릴 수 있습니다.
다운로드가 완료되면 서버가 자동으로 시작됩니다. 서버가 초기 월드 데이터베이스를 생성하는 동안 첫 부팅은 이후 시작보다 시간이 더 걸립니다.
콘솔 출력이 서버가 준비되어 연결을 수신 대기 중임을 나타낼 때까지 기다립니다.

RAM 요구 사항. Soulmask는 메모리 집약적인 게임입니다. 전용 서버를 시작하려면 최소 11 GB의 여유 RAM이 필요합니다. 호스팅 플랜이 예상 플레이어 수에 충분한 메모리를 제공하는지 확인하세요. 플레이어 수가 많고 월드가 클수록 더 많은 RAM을 사용합니다.

GPanel 시작 변수

핵심 서버 설정은 GPanel에서 시작 변수로 구성됩니다. 이 값들은 서버가 시작될 때 명령줄 매개변수로 서버 프로세스에 전달됩니다.

GPanel에서 Soulmask 서버를 선택합니다.
Startup 탭을 클릭합니다.
아래에 나열된 변수를 설정합니다. 변경 사항은 다음에 서버를 시작하거나 재시작할 때 적용됩니다.

변수	기본값	설명
`SERVER_NAME`	`My Soulmask Server`	Steam 서버 브라우저와 게임 내 서버 목록에 표시되는 이름입니다. 플레이어가 서버를 쉽게 찾을 수 있도록 설명적으로 만드세요.
`SERVER_PASSWORD`	(비어 있음)	플레이어가 접속하는 데 필요한 비밀번호(`-PSW` 매개변수)입니다. 공개 서버로 두려면 비워 두세요. 초대된 플레이어만 접근하도록 제한하려면 비밀번호를 설정하세요.
`ADMIN_PASSWORD`	(비어 있음)	GM 관리자 비밀번호(`-adminpsw` 매개변수)입니다. 게임 내 관리자 패널에 접근하고 관리자 명령어를 실행하는 데 필요합니다. 비밀로 유지하세요.
`MAX_PLAYERS`	`60`	동시 플레이어의 최대 수(`-MaxPlayers` 매개변수)입니다. Soulmask는 최대 70명의 플레이어를 지원하지만 수가 많을수록 더 많은 RAM과 CPU가 필요합니다.
`GAME_MODE`	`pve`	서버 게임 모드입니다. PvE의 경우 `pve`, PvP의 경우 `pvp`로 설정합니다. 아래 PvE 대 PvP 섹션을 참조하세요.
`GAME_PORT`	`8777`	게임 연결을 위한 주요 UDP 포트(`-Port` 매개변수)입니다. 호스팅 플랜에 의해 자동으로 구성됩니다.
`QUERY_PORT`	`27015`	서버 브라우저 쿼리를 위해 Steam이 사용하는 UDP 포트(`-QueryPort` 매개변수)입니다. 자동으로 구성됩니다.

시작 변수는 구성 파일을 재정의합니다. 설정이 시작 변수와 구성 파일 모두에 구성된 경우 시작 변수가 우선합니다. 핵심 정체성 설정에는 시작 변수를, 세부적인 게임플레이 조정에는 구성 파일을 사용하세요.

서버 구성(명령줄 매개변수)

Soulmask는 서버 구성을 위해 광범위한 명령줄 매개변수를 사용합니다. 아래는 사용 가능한 매개변수의 전체 참조입니다:

매개변수	기본값	설명
`-SteamServerName="Name"`	-	서버 브라우저에 표시되는 서버 이름입니다.
`-MaxPlayers=N`	`60`	최대 동시 플레이어 연결 수(최대 70)입니다.
`-PSW="password"`	(없음)	서버 접속 비밀번호입니다. 공개 서버의 경우 생략하세요.
`-adminpsw="password"`	(없음)	게임 내 관리자 명령어를 위한 관리자/GM 비밀번호입니다.
`-pve`	-	PvE 모드를 강제합니다. 플레이어가 서로에게 피해를 줄 수 없습니다.
`-pvp`	-	PvP 모드를 강제합니다. 플레이어가 서로에게 피해를 줄 수 있습니다.
`-Port=N`	`8777`	게임 연결 포트(UDP)입니다.
`-QueryPort=N`	`27015`	Steam 쿼리 포트(UDP)입니다.
`-EchoPort=N`	`18888`	Telnet 콘솔 포트(TCP, 로컬 전용)입니다. 로컬 원격 관리에 사용됩니다.
`-saving=N`	-	메모리로의 월드 상태 저장 주기(초)입니다.
`-backup=N`	-	인메모리 데이터베이스를 디스크로 백업하는 주기(초)입니다.
`-initbackup`	-	서버가 시작될 때마다 월드의 백업 복사본을 생성합니다.
`-backupinterval=N`	-	자동 백업 생성 주기(분)입니다.
`-GongHuiMaxMember=N`	-	부족(길드)당 최대 멤버 수입니다.
`-MULTIHOME=IP`	-	서버를 특정 로컬 IP 주소에 바인딩합니다(멀티홈 서버 전용).
`-rconpsw="password"`	(없음)	지정된 비밀번호로 RCON 원격 콘솔 접근을 활성화합니다.
`-rconport=N`	`19000`	RCON 리스너 TCP 포트입니다. RCON이 활성화된 경우에만 관련됩니다.
`-rconaddr=IP`	-	RCON 리스너 IP 바인딩입니다. 모든 인터페이스에서 수신 대기하려면 `0.0.0.0`을 사용하세요.
`-log`	-	콘솔 창과 로깅 출력을 활성화합니다.
`-UTF8Output`	-	출력에서 비라틴 문자의 올바른 처리를 활성화합니다.

GPanel이 대부분을 자동으로 처리합니다. Legion Hosting에서는 필수 매개변수가 GPanel Startup 탭을 통해 구성됩니다. RCON 설정이나 부족 제한과 같은 고급 매개변수는 가능한 경우 GPanel의 추가 시작 매개변수 필드를 통해 추가하거나 지원팀에 문의하여 추가할 수 있습니다.

PvE 대 PvP 모드

Soulmask는 멀티플레이어 경험을 근본적으로 바꾸는 두 가지 주요 게임 모드를 지원합니다:

PvE 모드(`-pve`)

플레이어가 서로에게 직접 피해를 줄 수 없습니다.
구조물과 기지가 다른 플레이어로부터 보호됩니다.
협력적 생존, 건설 및 탐험에 중점을 둡니다.
플레이어는 여전히 상호 작용하고, 거래하고, 부족을 형성할 수 있습니다.
협력 커뮤니티와 캐주얼 서버에 권장됩니다.

PvP 모드(`-pvp`)

플레이어가 서로를 공격하고 죽일 수 있습니다.
기지와 구조물이 다른 플레이어에 의해 약탈되고 파괴될 수 있습니다.
부족 간 전쟁과 영토 통제가 핵심 게임플레이 요소가 됩니다.
PvP 피해 비율은 GameXishu.json 구성 파일에서 미세 조정할 수 있습니다.
경쟁 서버와 숙련된 플레이어에게 권장됩니다.

모드는 초기화 없이 변경할 수 없습니다. 월드가 생성된 후 PvE와 PvP 간을 변경하면 게임플레이 불일치가 발생할 수 있습니다. 첫 시작 전에 모드를 결정하는 것이 좋습니다. 기존 월드에서 모드를 변경해야 하는 경우 새로 시작하는 것을 고려하세요.

맵 및 월드 설정(GameXishu.json)

세부적인 월드 및 게임플레이 설정은 GameXishu.json 구성 파일을 통해 제어됩니다. 이 파일에는 자원 비율, 전투, 침공, 건설, 동물 등을 조정하기 위한 광범위한 옵션이 포함되어 있습니다.

파일 위치 찾기

구성 파일은 다음 위치에 있습니다:

WS/Saved/GameplaySettings/GameXishu.json

이 파일에 GPanel Files 탭 또는 SFTP를 통해 접근하세요.

주요 설정 참조

아래는 가장 일반적으로 조정되는 설정입니다. 매개변수 이름은 원래 형식(중국어 병음)으로 되어 있습니다. 각각에 대한 영어 설명이 제공됩니다.

경험치 및 진행

설정	영어 이름	설명
`ExpRatio`	Experience Ratio	일반 경험치 획득 배율입니다. 값이 높을수록 레벨업이 빨라집니다.
`ChengZhangExpRatio`	Growth Experience Ratio	캐릭터 성장 경험치 획득 배율입니다.
`ShaGuaiExpRatio`	Monster Kill Experience Ratio	몬스터 처치로 획득하는 경험치 배율입니다.

전투 및 피해

설정	영어 이름	설명
`DongWuDamageRatio`	Animal Damage Ratio	야생 동물과 생물이 가하는 피해 배율입니다.
`BeDamageByYeShengRatio`	Damage Taken from Wildlife	야생 생물로부터 받는 피해 배율입니다.
`ShengMingHuiFuRatio`	Health Recovery Ratio	자연 체력 회복 속도 배율입니다.
`QiXiHuiFuRatio`	Stamina Recovery Ratio	스태미나 회복 속도 배율입니다.
`TiLiHuiFuRatio`	Energy Recovery Ratio	에너지/지구력 회복 속도 배율입니다.
`PVP_ShangHaiRatio_JinZhan`	PvP Melee Damage Ratio	PvP 근접 전투 피해 배율입니다(기본값: `0.4`).

자원 및 소비

설정	영어 이름	설명
`ShiWuXiaoHaoRatio`	Food Consumption Ratio	음식이 소비되는 속도 배율입니다. 값이 낮을수록 음식 소비가 느려집니다.
`ShuiXiaoHaoRatio`	Water Consumption Ratio	물이 소비되는 속도 배율입니다.
`RanLiaoXiaoHaoRatio`	Fuel Consumption Ratio	제작대와 불에 의해 연료가 소비되는 속도 배율입니다.

동물 및 농사

설정	영어 이름	설명
`DongWuShengZhangRatio`	Animal Growth Ratio	동물 성장 속도 배율입니다. 값이 높을수록 동물이 더 빨리 성숙합니다.
`FanZhiJianGeRatio`	Breeding Interval Ratio	동물 번식 주기 사이의 시간 배율입니다.
`DongWuChanChuRatio`	Animal Production Ratio	동물 생산 산출량(알, 우유 등) 배율입니다.
`DongWuPinZhiRatio`	Animal Quality Ratio	길들인 동물 속성의 품질 배율입니다.
`ZuoWuShengZhangRatio`	Crop Growth Ratio	작물 성장 속도 배율입니다.
`ZuoWuFeiLiaoXiaoHaoRatio`	Crop Fertilizer Consumption	비료 소비율 배율입니다.

건설 및 구조물

설정	영어 이름	설명
`JianZhuFuLanKaiGuan`	Building Decay Toggle	시간 경과에 따른 건물 부패를 활성화 또는 비활성화합니다. 비활성화하려면 `0`으로 설정하세요.
`JianZhuFuLanMul`	Building Decay Multiplier	구조물이 부패하는 속도입니다. 값이 낮을수록 부패가 느려집니다.
`JianZhuXiuLiMul`	Building Repair Multiplier	건물 수리 비용 및 속도 배율입니다.
`JianZhuZiYuanJinShuaBanJing`	Building Resource Exclusion Radius	건물 주변에서 자연 자원이 재생성되지 않는 반경입니다.

침공 시스템

설정	영어 이름	기본값	설명
`RuQinGuaiCountMax`	Max Invasion Monsters	`128`	침공 웨이브의 최대 몬스터 수입니다.
`RuQinQiangDuXiShu`	Invasion Intensity	-	전반적인 침공 난이도와 몬스터 강도를 제어합니다.
`RuQinBeginHour`	Invasion Start Hour	-	침공이 시작될 수 있는 게임 내 시간입니다.
`RuQinEndHour`	Invasion End Hour	-	침공이 멈추는 게임 내 시간입니다.
`RuQinPerBoGuaiMax`	Max Monsters Per Wave	`16`	개별 웨이브당 생성되는 최대 몬스터 수입니다.

GameXishu.json을 편집하기 전에 항상 서버를 중지하세요. 서버가 실행 중일 때 파일을 편집하면 서버가 저장할 때 변경 사항이 덮어쓰입니다. 서버를 중지하고 변경한 다음 다시 시작하세요.

연결 방법

플레이어는 게임 내 서버 브라우저나 직접 연결을 통해 Soulmask 서버에 연결할 수 있습니다.

게임 내 서버 브라우저를 통해

Soulmask를 실행합니다.
메인 메뉴에서 Multiplayer를 선택한 다음 Server Browser를 선택합니다.
이름으로 서버를 검색합니다(SERVER_NAME 시작 변수에서 설정한 이름).
서버를 클릭하고 Join을 누릅니다. 비밀번호가 설정되어 있으면 입력합니다.

Steam 서버 브라우저를 통해

Steam에서 보기 > 게임 서버(또는 서버)로 이동합니다.
즐겨찾기 탭을 클릭한 다음 서버 추가를 클릭합니다.
서버의 IP와 쿼리 포트(기본값 27015)를 IP:PORT 형식으로 입력합니다.
서버가 나타나면 더블 클릭하여 Soulmask를 통해 연결합니다.

직접 연결을 통해

GPanel Console 탭에서 서버 IP와 게임 포트를 찾습니다. 도움이 필요하면 서버 IP 및 포트를 찾는 방법을 참조하세요.
Soulmask에서 멀티플레이어 메뉴의 Direct Connect 옵션을 찾습니다.
서버 IP와 게임 포트(기본값 8777)를 IP:PORT 형식으로 입력합니다.
Connect를 누르고 필요한 경우 서버 비밀번호를 입력합니다.

서버가 나타나지 않나요? 서버가 브라우저에 표시되지 않으면 완전히 시작되어 로딩이 완료되었는지 확인하세요. 새 서버는 Steam 마스터 서버 목록에 나타나는 데 2-5분이 걸릴 수 있습니다. IP와 게임 포트로 직접 연결을 항상 사용할 수 있습니다. 전용 IP가 없는 한 포트는 무작위로 할당됩니다.

세이브 관리

Soulmask는 데이터베이스 기반 세이브 시스템을 사용합니다. 세이브가 어떻게 작동하는지 이해하는 것은 데이터 손실을 방지하는 데 매우 중요합니다.

세이브 위치

주요 월드 세이브 파일은 다음 위치에 있습니다:

WS/Saved/Worlds/Dedicated/Level01_Main/world.db

이 SQLite 데이터베이스에는 지형 수정, 구조물, NPC 상태 및 플레이어 데이터를 포함한 모든 월드 데이터가 들어 있습니다.

저장 프로세스

Soulmask는 2단계 저장 프로세스를 사용합니다:

메모리 저장(-saving): 월드 상태가 -saving 매개변수에 지정된 주기(초)로 인메모리 데이터베이스에 주기적으로 기록됩니다.
디스크 백업(-backup): 인메모리 데이터베이스가 -backup 매개변수에 지정된 주기(초)로 디스크에 플러시됩니다.

항상 서버를 올바르게 종료하세요. GPanel Stop 버튼, gm exit 게임 내 명령어, 또는 shutdown RCON 명령어를 사용하여 서버를 깨끗하게 종료하는 것이 매우 중요합니다. 서버 프로세스를 강제 종료하면 인메모리 데이터베이스가 디스크에 기록되지 않아 마지막 디스크 저장으로 롤백될 수 있습니다.

자동 백업

다음 시작 매개변수를 사용하여 자동 백업을 구성하세요:

-initbackup -- 서버가 시작될 때마다 백업 복사본을 생성합니다.
-backupinterval=N -- 런타임 중 N분마다 순환 백업을 생성합니다.

수동 백업

수동 백업을 생성하려면:

GPanel에서 서버를 중지합니다.
GPanel Files 탭 또는 SFTP를 통해 WS/Saved/로 이동합니다.
다음 파일을 다운로드합니다:
- Worlds/Dedicated/Level01_Main/world.db -- 월드 세이브 데이터베이스
- GameplaySettings/GameXishu.json -- 게임플레이 구성
이 파일들을 로컬 컴퓨터에 안전하게 저장합니다.

백업 복원

서버를 중지합니다.
백업한 world.db 파일을 WS/Saved/Worlds/Dedicated/Level01_Main/에 업로드합니다.
설정도 복원하려면 백업한 GameXishu.json을 WS/Saved/GameplaySettings/에 업로드합니다.
서버를 시작합니다.

새 월드 시작

월드를 초기화하고 새로 시작하려면:

서버를 중지합니다.
WS/Saved/Worlds/Dedicated/Level01_Main/의 world.db 파일 이름을 변경하거나 삭제합니다.
서버를 시작합니다. 처음부터 새 월드 데이터베이스를 생성합니다.

초기화 전에 백업하세요. 월드 데이터를 삭제하기 전에 나중에 복원하고 싶을 경우를 대비하여 world.db 복사본을 백업으로 다운로드하세요.

포트 참조

Soulmask는 다음 포트를 사용합니다. 이들은 Legion Hosting의 호스팅 플랜에 의해 자동으로 구성됩니다.

포트	프로토콜	기본값	용도
Game Port	UDP	`8777`	주요 게임 연결입니다. 플레이어가 이 포트에 연결합니다.
Query Port	UDP	`27015`	Steam 서버 브라우저 쿼리입니다.
Echo Port (Telnet)	TCP	`18888`	로컬 telnet 관리입니다(로컬 연결 전용).
RCON Port	TCP	`19000`	원격 콘솔(RCON) 접근입니다. `-rconpsw`가 설정된 경우에만 활성화됩니다.

도움이 필요하신가요?

Soulmask 서버에 여전히 문제가 있으면 지원 티켓을 열어 주시면 저희 팀이 기꺼이 도와드리겠습니다.

Soulmask 서버 설정 가이드 - 지식베이스

Support

Categories