diff --git a/docs/kr/README.md b/docs/kr/README.md index 13f317fa7..8ba2773c1 100644 --- a/docs/kr/README.md +++ b/docs/kr/README.md @@ -34,7 +34,7 @@ 다음 스폰서들에게 큰 박수를 보냅니다!

-ShoeBoom  doomhound188  AshishT112203  pabumake   +doomhound188  AshishT112203  pabumake  stoprx  KiKoS0  inspired-by-nudes  PulsarFTW  

## Official Documentation @@ -161,15 +161,39 @@ docker run -d \ 공식 Helm 차트는 별도의 저장소에서 찾을 수 있습니다, [palworld-server-chart](https://github.com/Twinki14/palworld-server-chart) +### 루트권한 없이 실행하기 + +해당 항목은 고급사용자를 위한 항목입니다. + +해당 컨테이너는 [기본사용자 덮어씌우기](https://docs.docker.com/engine/reference/run/#user)가 가능합니다. 해당 이미지의 기본사용자는 루트입니다. + +사용자가 유저와 그룹을 설정하기 떄문에 `PUID`와 `PGID`가 무시됩니다. + +UID를 찾으려면: `id -u`를 사용합니다. +GID를 찾으려면: `id -g`를 사용합니다. + +반드시 유저를 `NUMBERICAL_UID:NUMBERICAL_GID`와 같이 설정하셔야합니다. + +아래는 UID를 1000으로 GID를 1001로 가정해 작성된 예제문입니다. + +* docker run에서 `--user 1000:1001 \`를 마지막 줄위에 추가하세요. +* docker compose에서 `user: 1000:1001`를 포트설정위에 추가하세요. + +만약 다른 UID/GID를 사용해 실행하려면 디렉토리의 소유권을 변경해야합니다: `chown UID:GID palworld/` 또는 모든 계정의 권한를 수정하셔야합니다: `chmod o=rwx palworld/` + +#### helm chart 사용 + +공식 helm chart 사용법은 다른 리포지토리에 있습니다, [palworld-server-chart](https://github.com/Twinki14/palworld-server-chart) + ### 환경 변수 다음 값을 사용하여 부팅 시 서버의 설정을 변경할 수 있습니다. 서버를 시작하기 전에 다음 환경 변수를 설정하는 것이 좋습니다: -- PLAYERS -- PORT -- PUID -- PGID +* PLAYERS +* PORT +* PUID +* PGID | 변수명 | 정보 | 기본값 | 허용되는 값 | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------ | @@ -200,6 +224,8 @@ docker run -d \ | AUTO_REBOOT_CRON_EXPRESSION | 자동 서버 재부팅 주기 | 0 0 \* \* \* | Cron 표현식 필요 - [cron을 이용한 자동 재부팅 설정](#cron을-이용한-자동-재부팅-설정) 참조 | | AUTO_REBOOT_ENABLED | 자동 서버 재부팅 활성화 여부 | false | true/false | | AUTO_REBOOT_WARN_MINUTES | 재부팅 대기 시간 설정(분), 이때 사용자는 분 단위로 서버 종료에 대한 알림을 받습니다. | 5 | !0 | +| AUTO_REBOOT_EVEN_IF_PLAYERS_ONLINE | 온라인 사용자가 있어도 재시작. | false | true/false | +| TARGET_MANIFEST_ID | 게임의 버젼을 스팀 다운로드 디포의 해당 Manifest ID로 고정. | | [Manifest ID Table](#버전별Manifest ID표) 보 | | DISCORD_WEBHOOK_URL | 디스코드 웹훅 URL | | `https://discord.com/api/webhooks/` | | DISCORD_CONNECT_TIMEOUT | 디스코드 명령 초기 연결 시간 초과 | 30 | !0 | | DISCORD_MAX_TIMEOUT | Discord 총 훅 시간 초과 | 30 | !0 | @@ -209,6 +235,9 @@ docker run -d \ | DISCORD_PRE_SHUTDOWN_MESSAGE | 서버가 종료되기 시작할 때 전송되는 디스코드 메시지 | Server is shutting down... | "string" | | DISCORD_POST_SHUTDOWN_MESSAGE | 서버가 멈췄을 때 전송되는 디스코드 메시지 | Server is stopped! | "string" | | DISABLE_GENERATE_SETTINGS | 자동으로 PalWorldSettings.ini를 생성할지 여부 | false | true/false | +| DISABLE_GENERATE_ENGINE | 자동으로 Engine.ini를 생성할지 여부 | true | true/false | +| ENABLE_PLAYER_LOGGING | 플레이어가 접속 또는 종료시 로깅과 공지를 활성화 | true | true/false | +| PLAYER_LOGGING_POLL_PERIOD | 플레이어의 접속과 종료를 확인하기위한 폴링시간(초) 설정| 5 | !0 | *설정하는 것을 적극 권장합니다. @@ -329,8 +358,8 @@ BACKUP_CRON_EXPRESSION을 설정하여 기본 스케줄을 변경합니다. 이 서버에서 자동 업데이트를 사용하려면 다음 환경 변수들을 `true`로 **설정해야 합니다**: -- RCON_ENABLED -- UPDATE_ON_BOOT +* RCON_ENABLED +* UPDATE_ON_BOOT > [!IMPORTANT] > 도커 `restart` 정책이 `always` 또는 `unless-stopped`로 설정 되어있지 않다면, 서버는 종료되고 @@ -380,15 +409,15 @@ AUTO_REBOOT_CRON_EXPRESSION을 설정하여 기본 스케줄을 변경하세요. 서버 설정을 환경 변수로 바꾸는 과정은 다음과 같은 규칙을 따릅니다 (몇가지 예외 있음): -- 모두 대문자로 작성 -- 밑줄을 삽입하여 단어를 분할 -- 한 글자로 시작하는 설정(예: 'b')의 경우 그 한 글자를 제거 +* 모두 대문자로 작성 +* 밑줄을 삽입하여 단어를 분할 +* 한 글자로 시작하는 설정(예: 'b')의 경우 그 한 글자를 제거 아래는 예시입니다: -- Difficulty -> DIFFICULTY -- PalSpawnNumRate -> PAL_SPAWN_NUM_RATE -- bIsPvP -> IS_PVP +* Difficulty -> DIFFICULTY +* PalSpawnNumRate -> PAL_SPAWN_NUM_RATE +* bIsPvP -> IS_PVP | 변수 | 설명 | 기본값 | 허용값 | |-------------------------------------------|----------------------------------------------------------------|----------------------------------------------------------------------------------------------|----------------------------------------| @@ -445,6 +474,7 @@ AUTO_REBOOT_CRON_EXPRESSION을 설정하여 기본 스케줄을 변경하세요. | REGION | Region | | String | | USEAUTH | 인증 사용 여부 | True | Boolean | | BAN_LIST_URL | 사용할 BAN 목록 | [https://api.palworldgame.com/api/banlist.txt](https://api.palworldgame.com/api/banlist.txt) | string | +| SHOW_PLAYER_LIST | Enable show player list | True | Boolean | ### 수동 설정 @@ -486,6 +516,26 @@ docker compose로 디스코드 메시지 보내기: - DISCORD_PRE_UPDATE_BOOT_MESSAGE=Server is updating... ``` +## 게임버전 고정하기 + +>[!WARNING] +>다운그레이딩이 가능하나 세이브 파일에 어떠한 영향이 있을지 알 수 없습니다. +> +>**본인의 책임하에 하세요!** + +만약 **TARGET_MANIFEST_ID** 환경변수가 정해졌다면, 서버의 버전은 특정 manifest로 고정됩니다. +Manifest는 게임의 릴리즈 시간/업데이트 버젼에 따라 정해집니다. Manifest는 SteamCMD나 [SteamDB](https://steamdb.info/depot/2394012/manifests/)와 +같은 웹사이트에서 검색가능합니다. + +### 버전별 Manifest ID 표 + +| Version | Manifest ID | +|---------|----------------------| +| 1.3.0 | 1354752814336157338 | +| 1.4.0 | 4190579964382773830 | +| 1.4.1 | 6370735655629434989 | +| 1.5.0 | 3750364703337203431 | + ## 이슈/기능 요청 문제/기능 요청은 다음 [링크](https://github.com/thijsvanloef/palworld-server-docker/issues/new/choose)에서 제출할 수 있습니다.