이 가이드는 Legion Hosting에서 호스팅되는 ARK: Survival Ascended 서버의 GameUserSettings.ini 및 Game.ini 파일을 구성하는 방법을 다룹니다.
구성 파일을 편집하기 전에 서버를 중지하세요.
.ini 파일을 편집하기 전에 항상 GPanel Console 탭에서 서버를 중지하세요. ARK는 종료 시 파일을 덮어쓸 수 있으므로, 서버가 실행 중일 때 변경한 내용은 손실될 수 있습니다.
구성 파일 개요
ARK: Survival Ascended는 서버 동작을 제어하기 위해 두 개의 기본 구성 파일을 사용합니다. 둘 다 서버의 ShooterGame/Saved/Config/WindowsServer/ 디렉터리 안에 있습니다.
| 파일 | 목적 |
|---|---|
GameUserSettings.ini |
핵심 서버 설정 — 세션 이름, 비밀번호, 플레이어 수, 비율, 크로스플레이, BattleEye 등. 이 파일은 서버 첫 시작 시 생성됩니다. |
Game.ini |
고급 게임플레이 재정의 — 엔그램 포인트, 스탯 스케일링, 아이템 스택 크기, 커스텀 NPC 스폰. 정확히 Game.ini여야 합니다(대소문자 구분). 존재하지 않으면 수동으로 생성하세요. |
Game.ini는 기본적으로 존재하지 않을 수 있습니다. 파일이 없으면 GPanel 파일 편집기에서 수동으로 생성하세요. 파일 이름은 대문자 G와 I를 사용하여 정확히
Game.ini여야 합니다 — game.ini 또는 GAME.INI는 작동하지 않습니다.
1단계 — GPanel에서 File Manager 접근
- GPanel에 로그인합니다.
- 서버 목록에서 ARK: Survival Ascended 서버를 선택합니다.
- 서버가 실행 중이면 Console 탭에서 Stop을 클릭하고 상태가 Offline으로 바뀔 때까지 기다립니다.
- Files 탭을 클릭하여 파일 관리자를 엽니다.
ShooterGame/Saved/Config/WindowsServer/로 이동합니다. 서버가 최소 한 번 시작된 후에는 여기서GameUserSettings.ini를 찾을 수 있습니다.Game.ini가 없으면 3단계에서 수동으로 생성합니다.
2단계 — GameUserSettings.ini 구성
파일 관리자에서 GameUserSettings.ini를 클릭하여 인라인 편집기에서 엽니다. 파일은 섹션으로 나뉩니다 — 서버 구성에 가장 중요한 것은 [SessionSettings]와 [ServerSettings]입니다.
[SessionSettings]의 주요 설정
| 설정 | 예시 값 | 설명 |
|---|---|---|
SessionName |
My Legion Server |
게임 내 서버 브라우저에 나타나는 이름. 플레이어가 쉽게 찾을 수 있도록 고유하게 유지하세요. |
QueryPort |
7778 |
서버 브라우저가 사용하는 쿼리 포트. GPanel에 할당된 포트와 일치해야 합니다. 기본값은 게임 포트 + 1입니다. |
[ServerSettings]의 주요 설정
| 설정 | 예시 값 | 설명 |
|---|---|---|
ServerPassword |
mypassword |
플레이어가 접속하는 데 필요한 비밀번호. 공개 서버의 경우 비워둡니다. |
ServerAdminPassword |
adminpass123 |
게임 내 관리자 명령어를 인증하는 데 사용되는 관리자 비밀번호. 비공개로 유지하세요. |
MaxPlayers |
20 |
동시 플레이어 최대 수. 플랜의 플레이어 슬롯 한도와 일치해야 합니다. |
XPMultiplier |
2.0 |
획득 XP에 대한 배율. 1.0이 기본값이며, 2.0은 XP 획득량을 두 배로 만듭니다. |
TamingSpeedMultiplier |
3.0 |
길들이기 속도에 대한 배율. 값이 높을수록 길들이기가 빨라집니다. |
HarvestAmountMultiplier |
2.0 |
채집 행동당 수집되는 자원에 대한 배율. |
DifficultyOffset |
1.0 |
생물 레벨 분포를 제어합니다. 공식 스타일 설정에서 최대 야생 레벨을 위해 1.0으로 설정합니다. |
OverrideOfficialDifficulty |
5.0 |
DifficultyOffset=1.0일 때 최대 야생 공룡 레벨을 설정합니다. 5.0 값은 레벨 150까지 허용합니다. |
AllowCrateSpawnsOnTopOfStructures |
True |
보급품 드롭이 플레이어 구조물 위에 떨어지도록 허용합니다. PvE 서버에 권장됩니다. |
EnablePvPGamma |
True |
PvP에서 플레이어가 감마를 조정할 수 있도록 허용합니다. 더 경쟁적인 경험을 위해 비활성화하세요. |
구성된 GameUserSettings.ini 섹션의 최소 예시:
[SessionSettings]
SessionName=My Legion Server
QueryPort=7778
[ServerSettings]
ServerPassword=
ServerAdminPassword=adminpass123
MaxPlayers=20
XPMultiplier=2.0
TamingSpeedMultiplier=3.0
HarvestAmountMultiplier=2.0
DifficultyOffset=1.0
OverrideOfficialDifficulty=5.03단계 — Game.ini 생성 및 구성
Game.ini 생성
Game.ini가 아직 존재하지 않는 경우 사용자가 수동으로 생성해야 합니다. GPanel 파일 관리자에서 ShooterGame/Saved/Config/WindowsServer/로 이동합니다. Game.ini가 목록에 없으면 정확한 이름 Game.ini(대문자 G와 대문자 I — game.ini 또는 GAME.INI는 작동하지 않음)로 새 파일을 생성합니다.
다음 헤더로 파일을 시작합니다 — 모든 Game.ini 설정은 이 단일 섹션 아래에 들어갑니다:
[/script/shootergame.shootergamemode]Game.ini 편집
Game.ini는 섹션 기반 형식을 사용합니다. 서버 커스터마이징에 가장 일반적인 섹션은 [/script/shootergame.shootergamemode]입니다. 설정은 적절한 섹션 내에서 한 줄에 하나씩 추가됩니다.
일반적인 Game.ini 커스터마이징:
[/script/shootergame.shootergamemode]
; Engram points per level (one entry per level, starting at level 1)
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
; Increase max XP required per level (one entry per level)
LevelExperienceRampOverrides=(...)
; Custom harvest amounts per resource
ResourceItemReplacementClasses=(...)
; Disable specific engrams
EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TurretGun_Rocket_C",LevelToAutoUnlock=0)| 설정 | 설명 |
|---|---|
OverridePlayerLevelEngramPoints=N |
각 레벨에서 부여되는 엔그램 포인트를 설정합니다. 플레이어 레벨당 한 줄씩 추가하세요. 레벨업당 더 많은 엔그램을 부여하는 데 사용합니다. |
MaxCustomNodes=N |
최대 커스텀 스폰 노드를 제어합니다. 고급 모드 스폰 구성과 관련이 있습니다. |
EngramEntryAutoUnlocks=(...) |
특정 엔그램을 정의된 레벨에서 자동 잠금 해제하도록 강제합니다. 포인트를 소비하지 않고 모든 플레이어에게 특정 아이템에 대한 접근 권한을 부여하는 데 유용합니다. |
ConfigOverrideItemMaxQuantity=(...) |
특정 아이템의 최대 스택 크기를 재정의합니다. |
팁:
[/script/shootergame.shootergamemode] 섹션 헤딩은 Game.ini에 정확히 한 번만 있어야 합니다. 두 번째로 추가하면 마지막 항목만 사용됩니다. 모든 설정을 단일 헤딩 아래에 추가하세요.
쿼리 포트 구성
쿼리 포트는 게임 포트와 별개이며 서버 브라우저(Steam/Epic)가 서버를 나열하는 데만 사용됩니다. 쿼리 포트가 잘못되었거나 도달할 수 없으면 서버가 올바르게 실행 중이더라도 브라우저에 나타나지 않습니다.
| 포트 | 기본값 | 구성 위치 | 목적 |
|---|---|---|---|
| 게임 포트 | 7777 |
GPanel Startup / Network 탭 | 플레이어가 이 포트를 통해 접속하여 서버에 참여합니다 |
| 쿼리 포트 | 7778 |
GameUserSettings.ini — [SessionSettings] 아래의 QueryPort |
서버 브라우저 폴링 — GPanel에 할당된 포트와 일치해야 함 |
쿼리 포트는 GPanel과 일치해야 합니다.
GameUserSettings.ini의 QueryPort 값은 GPanel Network 탭에 표시된 쿼리 포트와 정확히 일치해야 합니다. Legion Hosting은 서버가 생성될 때 두 포트를 모두 사전 할당합니다 — .ini 파일을 편집하기 전에 Network 탭에서 특정 값을 확인하세요. 기본값 7777/7778이 서버에 적용된다고 가정하지 마세요.
변경 사항 적용
- GPanel 파일 편집기의 Save 버튼을 사용하여 편집한
.ini파일을 저장합니다. - Console 탭으로 돌아갑니다.
- Start를 클릭하여 서버를 시작합니다. GPanel은 시작 시 업데이트된 구성을 로드합니다.
- 오류가 있는지 콘솔 출력을 모니터링합니다. 잘못된 값이나 중복된 섹션 헤더와 같은 구성 실수는 종종 시작 로그에 경고를 생성합니다.
항상 서버가 중지된 동안 구성 파일을 편집하세요. 서버가 중지된 동안
GameUserSettings.ini 또는 Game.ini를 편집한 다음 서버를 시작하는 것으로 충분합니다. 서버가 실행 중일 때 구성 파일을 핫 리로드하려고 시도하지 마세요 — ARK는 대부분의 설정에 대해 실시간 구성 다시 로드를 지원하지 않습니다.
문제 해결
Game.ini가 존재하지 않거나 설정이 읽히지 않음
Game.ini는 자동으로 생성되지 않습니다. 파일이 존재하지 않으면ShooterGame/Saved/Config/WindowsServer/안의 GPanel 파일 편집기에서 수동으로 생성하세요.- 파일 이름은 대소문자를 구분합니다. 정확히
Game.ini여야 합니다 —game.ini,GAME.INI또는 기타 변형이 아닙니다. - 파일에
[/script/shootergame.shootergamemode]헤더가 첫 번째 줄로 포함되어 있고, 이 헤더가 한 번만 나타나는지 확인하세요.
Game.ini 또는 GameUserSettings.ini의 설정이 적용되지 않음
- 파일을 편집하기 전에 서버가 완전히 중지되었는지 확인하세요. 서버가 실행 중이었다면 다음 종료 시 변경 사항을 덮어썼을 수 있습니다.
- 섹션 헤더(예:
[ServerSettings]또는[/script/shootergame.shootergamemode])가 파일에 정확히 한 번 나타나는지 확인하세요. 중복된 섹션 헤더는 파서에 따라 나중 설정이 이전 설정을 재정의하거나 완전히 무시되게 합니다. - 파일을 저장한 후 테스트하기 전에 GPanel에서 서버를 완전히 재시작하세요.
- 파일이 올바른 디렉터리에 있는지 확인하세요:
ShooterGame/Saved/Config/WindowsServer/. 잘못된 위치에 배치된 파일은 조용히 무시됩니다.
설정 구성 후 서버가 서버 브라우저에 나타나지 않음
GameUserSettings.ini의QueryPort가 GPanel의 Network 탭에 나열된 포트와 정확히 일치하는지 확인하세요.- 서버 브라우저는 새로 시작되거나 재구성된 서버를 인덱싱하는 데 5~10분이 걸릴 수 있습니다. 브라우저가 따라잡는 동안 ASA 게임 내 콘솔에서
open IP:GAMEPORT로 다이렉트 커넥트를 시도하여 서버에 도달 가능한지 확인하세요. - 크로스플레이가 활성화된 경우, 플레이어는 서버 브라우저에서 플랫폼 잠금 필터를 해제해야 합니다. 자세한 내용은 접속 가이드를 참조하세요.
