기술 자료

지원

Multiplay Hosting

Multiplay Hosting

실행 파라미터

Learn how launch parameters control command-line arguments passed to your game executable.
읽는 시간 1분최근 업데이트: 21일 전

실행 파라미터는 시작 시 게임 서버에 전달되는 변수입니다. 실행 파라미터는 다른 구성 변수보다 먼저 로드되며 구성 변수
server.json
파일
과는 별개입니다. 실행 파라미터는 서버가 시작된 후 즉시 액세스해야 하는 정보를 로드하는 데 가장 적합합니다.
다음 시나리오에서 구성 변수보다 실행 파라미터를 사용하는 것이 좋을 수 있습니다.
  • 포트 번호를 초기화합니다.
  • 로그 디렉토리를 설정합니다.
하지만 대부분의 경우 실행 파라미터 대신 구성 변수를 사용하는 것이 더 좋습니다. 실행 파라미터 변수는 양쪽 끝을 2개의 달러 기호(
$$
)로 묶어야 합니다. 예를 들어,
port
라는 이름의 실행 파라미터는
$$port$$
로 전환됩니다. 다음 코드 스니핏에서 실행 파라미터의 예시를 확인할 수 있습니다.
-port $$port$$ -queryport $$query_port$$ -log $$log_dir$$

서버 변수

빌드 구성 변수와 마찬가지로 다음 서버 전용 변수를 실행 파라미터로 사용할 수 있습니다. 다음 표에 서버 변수의 예시와 함께 각 변수의 유형, 설명, 예시 값이 나와 있습니다.

변수

유형

설명

예시 값

$$commandline$$
문자열실행 시 게임 서버나 애플리케이션에 전달되는 실행 파라미터의 문자열입니다.
-config path/to/server.json
$$config_dir$$
문자열Unity의 server.json 구성이 담긴 디렉토리입니다.
/mnt/unity/
$$fleetid$$
문자열서버가 멤버로 속한 플릿의 ID입니다.
5050693b-0bea-4752-858b-52c074d485fa
$$game_exe$$
문자열빌드 실행 파일의 이름입니다.
server-linux
$$log_dir$$
문자열서버가 로그 파일을 전송해야 할 디렉토리입니다.
/mnt/unity/logs/
$$file_dir$$
문자열서버가 게임 파일을 전송해야 할 디렉토리입니다. 로그 파일도 여기서 작성할 수 있습니다.
/mnt/unity/files/
$$machineid$$
정수서버가 실행되는 머신의 ID입니다.
123456
$$port$$
정수서버가 트래픽에 바인드해야 하는 네트워크 포트입니다.
1234
$$query_port$$
정수서버가 쿼리 프로토콜 트래픽에 바인드해야 하는 네트워크 포트입니다.
5678
$$query_type$$
문자열서버에서 실행 중인 빌드가 지원하는 쿼리 프로토콜입니다.
sqp
$$serverid$$
정수서버의 ID입니다.
123456
$$regionid$$
문자열서버가 멤버로 속한 영역의 ID입니다.
3d9e29e8-3bb3-4cab-9d11-b79c90d0934d
$$regionname$$
문자열서버가 멤버로 속한 영역의 이름입니다.
North America
$$ip$$
문자열서버의 IP(v4) 주소입니다.
1.2.3.4
$$ipv6$$
문자열서버의 IP(v6) 주소입니다.
2001:db8:3333:4444:5555:6666:7777:8888
$$timestamp$$
문자열서버가 시작된 시점의 UTC 타임스탬프입니다.
1661430055

기본 실행 파라미터

다음 섹션에는 Unity로 제작된 게임과 Unreal로 제작된 게임의 기본 실행 파라미터가 나와 있습니다.

Unity

Unity로 제작된 게임의 기본 실행 파라미터에는
-nographics
,
-batchmode
,
-logFile
이 포함됩니다.
-nographics -batchmode -port $$port$$ -logFile $$log_dir$$/Engine.log

실행 파라미터

설명

-nographics
그래픽스 없이 게임 실행 파일을 실행합니다.
-batchmode
Unity를 배치 모드 실행합니다. 배치 모드에서는 Unity가 사람의 상호 작용 없이 커맨드 라인 인자를 실행합니다.
-logFile
서버가 로그 파일을 저장할 위치를 지정합니다. 서버 ID가 기준인 디렉토리를 받으며 빌드 구성 변수가 포함될 수 있습니다.
게임에 따라 실행 파라미터에 쿼리 포트(
queryPort
)와 쿼리 프로토콜(
queryType
)이 포함될 수 있습니다.
-nographics -batchmode -logFile $$log_dir$$/Engine.log -queryPort $$query_port$$ -queryType $$query_type$$

Unreal

Unreal로 제작된 게임의 기본 실행 파라미터에는
-log
-port
가 포함됩니다.
-log=$serverid.log -port=$$port$$

실행 파라미터

설명

-log
서버가 로그 파일을 저장할 위치를 지정합니다.
-port
클라이언트가 게임 서버에 연결하기 위해 사용할 수 있는 포트를 지정합니다.
사용하는 SDK와 게임에 따라 실행 파라미터에 쿼리 포트(
queryPort
)와 쿼리 프로토콜(
queryType
)이 포함될 수 있습니다.
-log=$serverid.log -port=$$port$$ -queryPort $$query_port$$ -queryType $$query_type$$