이 가이드는 첫 시작 및 server.toml 구성부터 게임모드 리소스, CDN 설정, 음성 채팅, 그리고 플레이어가 alt:V 런처를 통해 연결하는 방법까지, Legion Hosting에서 alt:V 서버를 실행하는 데 필요한 모든 것을 다룹니다. 리소스 개발, 데이터베이스 설정 및 관리자 관리에 대해서는 alt:V 관리자 및 리소스 설정을 참조하세요.
alt:V란?
alt:V는 Grand Theft Auto V를 위한 무료 오픈소스 멀티플레이어 모드입니다. 플레이어가 롤플레이(RP), 데스매치, 레이싱, 자유주행(freeroam) 등 독특한 게임모드를 실행하는 사용자 지정 서버에 연결할 수 있게 해줍니다. 서버는 JavaScript, TypeScript 또는 C#으로 작성된 사용자 지정 리소스를 실행하여 서버 소유자에게 게임 플레이 로직에 대한 완전한 제어 권한을 제공합니다. 플레이어는 멀티플레이어 연결을 위해 GTA V를 수정하는 alt:V 런처를 통해 연결합니다.
첫 시작
alt:V 서버를 처음 받으면, 다음 단계를 따라 온라인 상태로 만드세요:
- GPanel에 로그인하고 alt:V 서버를 선택합니다.
- Startup 탭으로 이동하여 서버 이름, 최대 플레이어 수 및 기타 시작 변수를 구성합니다.
- Console 탭으로 이동하여 Start를 클릭합니다.
- 서버는 첫 부팅 시 alt:V 서버 파일을 다운로드합니다. 몇 분 정도 걸릴 수 있습니다.
- 콘솔에 서버가 수신 대기 중이며 연결 준비가 되었다고 표시되면, 서버가 온라인 상태입니다.
- 기본적으로 서버는 게임모드 리소스 없이 시작됩니다. 게임 플레이를 만들려면 리소스를 추가해야 합니다. 자세한 내용은 alt:V 관리자 및 리소스 설정을 참조하세요.
GPanel 시작 변수
alt:V는 여러 구성 옵션을 GPanel의 시작 변수로 노출합니다. 이를 수정하려면 Startup 탭으로 이동하세요. 변경 사항은 서버 재시작이 필요합니다.
| 변수 | 기본값 | 설명 |
|---|---|---|
PASSWORD |
ChangeMe |
서버 접속 비밀번호. 최소 6자. |
SERVER_DESC |
A Pterodactyl Hosted Server |
alt:V 서버 브라우저에 표시되는 서버 설명. |
BUILD |
release |
alt:V 서버 브랜치: release(안정), rc(릴리스 후보), 또는 dev(개발). |
서버 구성 (server.toml)
alt:V 서버의 기본 구성 파일은 서버 루트 디렉터리에 위치한 server.toml입니다. GPanel의 Files 탭이나 SFTP를 통해 이 파일을 편집할 수 있습니다.
server.toml 예시
name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]주요 설정: name(브라우저 표시 이름), host(0.0.0.0 유지), port(GPanel과 일치해야 함), players(최대 수), password(공개의 경우 비워둠), announce(브라우저에 표시하려면 true), token(alt:V 웹사이트의 공지 토큰, 브라우저 목록에 필요), gamemode("Roleplay"와 같은 브라우저 레이블), modules(스크립트 모듈: js-module 또는 csharp-module), resources(로드할 리소스 폴더 배열), tags(브라우저 필터 태그).
공지 토큰
서버가 alt:V 서버 브라우저에 표시되려면, alt:V 마스터 서버의 공지 토큰이 필요합니다:
- alt:V 웹사이트를 방문하여 로그인하거나 계정을 만듭니다.
- 서버 관리 섹션으로 이동하여 새 서버 토큰을 생성합니다.
- 토큰을 복사하여
server.toml의token필드에 붙여넣습니다. - 구성에서
announce = true인지 확인합니다. - 서버를 재시작합니다. 이제 공개 브라우저에 표시될 것입니다.
server.toml에만 있어야 합니다.
게임모드 리소스
alt:V 서버는 리소스 — 모든 게임 플레이 로직을 정의하는 스크립트에 의해 구동됩니다. 리소스가 없으면 서버에는 사용자 지정 기능이 없습니다. 리소스는 resources/ 디렉터리에 배치됩니다.
리소스 구조
resources/
myresource/
resource.toml <-- Resource configuration
server/
index.js <-- Server-side script
client/
index.js <-- Client-side script (runs on the player's GTA V)리소스 로딩
시작 시 리소스를 로드하려면 server.toml의 resources 배열에 리소스 이름을 추가하세요:
resources = ["chat", "freeroam", "spawn"]각 리소스는 해당 디렉터리에 유형, 종속성 및 스크립트 진입점을 정의하는 resource.toml 파일이 있어야 합니다. 리소스 생성 및 관리에 대한 자세한 내용은 alt:V 관리자 및 리소스 설정을 참조하세요.
CDN 설정
alt:V는 CDN 메커니즘을 사용하여 연결하는 플레이어에게 클라이언트 측 파일(모델, 텍스처, 스크립트)을 제공합니다. 내장 CDN은 추가 구성 없이 서버에서 직접 파일을 제공합니다 — 이것이 기본값이며 대부분의 서버에 잘 작동합니다. 많은 사용자 지정 에셋이 있는 대규모 서버의 경우, 클라이언트 파일을 웹 서버에 업로드하고 리소스 구성에서 CDN URL을 설정하여 선택적으로 외부 CDN을 구성하여 게임 서버 대역폭 사용량을 줄일 수 있습니다.
음성 채팅
alt:V에는 플레이어 간의 위치 기반(3D) 음성 통신을 가능하게 하는 내장 음성 채팅 시스템이 포함되어 있습니다. 음성 채팅은 server.toml에서 활성화하고 구성합니다.
음성 구성
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0bitrate는 음성 품질을 제어합니다(64000이 표준). external* 필드는 외부 음성 서버를 구성합니다 — 대부분의 설정에 권장되는 내장 음성 서버를 사용하려면 이를 비워두거나 0으로 두세요. 외부 음성 서버 옵션은 음성 처리를 별도의 머신으로 오프로드하는 고급 구성에서만 필요합니다.
플레이어 연결 방법
플레이어는 GTA V를 직접 통하지 않고 alt:V 런처를 통해 alt:V 서버에 연결합니다.
서버 브라우저를 통해
- altvmp.com에서 alt:V 런처를 다운로드하고 설치합니다.
- alt:V 런처를 실행합니다. GTA V 설치를 감지하고 확인합니다.
- 런처에서 Server Browser를 탐색합니다.
- 이름으로 서버를 검색하거나 필터(게임모드, 태그, 플레이어 수)를 사용합니다.
- 서버를 클릭하고 Connect를 선택합니다.
- 서버에 비밀번호가 있는 경우, 플레이어에게 입력하라는 메시지가 표시됩니다.
- GTA V가 alt:V 멀티플레이어 모드와 함께 실행되어 서버에 연결됩니다.
직접 연결을 통해
- alt:V 런처에서 Direct Connect를 선택합니다.
- 서버의 IP 주소와 포트를
IP:PORT형식(예:192.168.1.1:7788)으로 입력합니다. - Connect를 클릭합니다.
서버의 IP 주소와 포트를 찾으려면 서버 IP 및 포트 찾는 방법을 참조하세요.
server.toml에서 announce = true인지, 그리고 유효한 공지 토큰이 있는지 확인하세요. 서버는 시작 후 등록되는 데 1분 정도 걸릴 수 있습니다. 콘솔에서 마스터 서버 연결 오류를 확인하세요. 전용 IP가 없는 한 포트는 무작위로 할당되므로 GPanel에서 올바른 값을 확인하세요.
최대 플레이어 수 및 성능
alt:V 서버는 높은 플레이어 수를 지원할 수 있지만, 성능은 리소스와 서버 플랜에 크게 좌우됩니다:
- 32–128 플레이어: 대부분의 서버에 일반적인 범위입니다. 간단한 게임모드는 더 높은 수에서도 원활하게 실행됩니다.
- 128–512+ 플레이어: 효율적인 리소스를 갖춘 최적화된 서버에서 가능합니다. 더 많은 CPU와 RAM이 필요합니다.
- 리소스 효율성: 잘 최적화되지 않은 스크립트가 성능 문제의 주된 원인입니다. 매 틱마다 무거운 작업을 실행하거나 메모리에 큰 데이터 구조를 유지하는 서버 측 스크립트는 서버에 병목을 일으킬 수 있습니다.
- 데이터베이스 쿼리: 데이터베이스(MySQL, MongoDB)를 사용하는 게임모드는 메인 스레드 차단을 피하기 위해 비동기 쿼리를 사용해야 합니다.
관련 문서
- alt:V 관리자 및 리소스 설정 — 리소스 개발, 데이터베이스 설정, 관리자 도구 및 문제 해결
- 서버 IP 및 포트 찾는 방법
- SFTP를 통한 파일 업로드 방법
- 서버 시작 가이드 — Legion Hosting에서 모든 게임 서버를 시작하기 위한 일반 가이드
추가 도움이 필요하신가요?
이 가이드에서 다루지 않은 문제를 겪고 계시다면, 저희 지원팀이 도와드릴 준비가 되어 있습니다. legionhosting.net/submitticket.php에서 서버 세부 정보와 문제 설명과 함께 티켓을 열어주세요.
