이 가이드는 Puck 전용 서버의 관리자 접근, 게임 단계 설정, 모드, 서버 관리를 다룹니다. 초기 설정은 Puck 서버 설정 가이드를 참조하세요.
1. 관리자 접근
관리자 접근은 server_configuration.json 파일의 Steam ID를 통해 제어됩니다. 자신에게 관리자 권한을 부여하려면:
- Steam64 ID를 찾으세요 (steamid.io 사용).
- SFTP를 통해
server_configuration.json을 편집하세요. - Steam ID를
adminSteamIds배열에 추가하세요:
"adminSteamIds": ["76561198012345678", "76561198087654321"]- 변경 사항을 적용하려면 서버를 재시작하세요.
2. 게임 단계 지속 시간
server_configuration.json에서 매치 단계 지속 시간(초 단위)을 사용자 지정하세요:
| 단계 | 기본값 (초) | 설명 |
|---|---|---|
| Warmup | 600 | 매치 전 워밍업 기간. |
| FaceOff | 3 | 퍽 드롭 카운트다운. |
| Playing | 300 | 실제 게임 진행 기간. |
| BlueScore | 5 | 블루 팀 득점 후 축하. |
| RedScore | 5 | 레드 팀 득점 후 축하. |
| Replay | 10 | 골 리플레이 지속 시간. |
| PeriodOver | 15 | 피리어드 사이의 휴식 시간. |
| GameOver | 15 | 게임 종료 시 점수판 표시 시간. |
server_configuration.json의 예시 설정:
"phaseDurationMap": {
"Warmup": 300,
"FaceOff": 3,
"Playing": 600,
"BlueScore": 5,
"RedScore": 5,
"Replay": 10,
"PeriodOver": 15,
"GameOver": 15
}3. 서버 설정
server_configuration.json의 추가 설정:
| 설정 | 기본값 | 설명 |
|---|---|---|
voip |
false | 음성 채팅 활성화. |
isPublic |
true | 공개 서버 목록에 서버 표시. |
startPaused |
false | 서버를 일시 정지 상태로 시작. |
allowVoting |
true | 플레이어가 맵 변경 및 설정에 투표하도록 허용. |
sleepTimeout |
60 | 비어 있을 때 서버가 절전 모드로 전환되기까지의 시간(초). |
joinMidMatchDelay |
10 | 매치 도중 입장 시 플레이어가 기다려야 하는 시간(초). |
usePuckBannedSteamIds |
true | 전역 Puck 차단 목록 사용. |
printMetrics |
true | 서버 성능 지표를 콘솔에 출력. |
4. 모드
Puck는 Steam Workshop 모드를 지원합니다. server_configuration.json의 mods 배열에서 설정하세요:
"mods": [
{
"id": 3493628417,
"enabled": true,
"clientRequired": false
}
]- id: Steam Workshop 항목 ID.
- enabled: 모드 활성화 여부.
- clientRequired: 입장하려면 플레이어가 모드를 설치해야 하는지 여부.
5. 플레이어 차단
플레이어를 차단하려면 해당 Steam ID를 서버의 차단 목록 파일에 추가하거나, usePuckBannedSteamIds를 활성화하여 전역 커뮤니티 차단 목록을 사용하세요. 또한 reloadBannedSteamIds를 true로 설정하면 재시작 없이 차단 목록을 다시 불러올 수 있습니다.
6. 문제 해결
- 서버가 브라우저에 나타나지 않음:
server_configuration.json에서isPublic이true인지 확인하세요. 콘솔에Server authenticated가 표시될 때까지 기다리세요. - 물리 효과가 어색함: 틱 레이트 설정을 확인하세요. 높은 틱 레이트는 더 부드러운 물리 효과를 제공하지만 더 많은 CPU를 필요로 합니다.
FRAME_RATE를SERVER_TICK_RATE보다 10-20 높게 유지하세요. - 플레이어가 강제 퇴장됨: 플레이어가 AFK로 너무 빨리 강제 퇴장되는 경우
KICK_TIMEOUT을 늘리세요. - 모드가 로드되지 않음: Workshop 항목 ID가 올바른지,
enabled가true로 설정되어 있는지 확인하세요.
관련 문서
도움이 필요하신가요?
추가 지원이 필요하면 서버 IP와 GPanel 콘솔의 오류 메시지를 포함하여 지원 티켓을 여세요.
