이 가이드는 Legion Hosting으로 호스팅되는 FiveM(GTA V 멀티플레이어) 서버를 설정하는 과정을 안내합니다 — CFX 라이선스 키 획득과 TXAdmin 구성부터 server.cfg 편집과 플레이어 연결까지.

사전 요구 사항

• Legion Hosting FiveM 서버(계정에서 활성화됨)
• Cfx.re 포럼 계정(무료 — 라이선스 키 생성에 필요)
• GPanel 접근 권한
• PC에 설치된 FiveM 클라이언트(fivem.net)

1단계: CFX 라이선스 키 획득

모든 FiveM 서버에는 Cfx.re(FiveM 개발자)의 고유한 라이선스 키가 필요합니다. 이 키는 무료이며 Cfx.re 계정에 연결됩니다.

1. https://keymaster.fivem.net/로 이동하여 Cfx.re 포럼 계정으로 로그인합니다.
2. New Server(또는 Register a new server)를 클릭합니다.
3. 세부 정보를 입력합니다:
   • Label: 서버의 친숙한 이름(예: "My Legion FiveM Server")
   • Server IP Address: GPanel에서 서버의 IP 주소를 입력합니다(서버 IP 및 포트 찾는 방법 참조)
   • Server Type: 적절한 유형을 선택합니다(일반적으로 "Other / Apache / nginx")
4. Generate를 클릭합니다.
5. 생성된 라이선스 키를 복사합니다 — 다음 단계에서 필요합니다.

2단계: 첫 서버 시작 및 TXAdmin 설정

Legion Hosting으로 호스팅되는 FiveM 서버에는 TXAdmin이 포함되어 있습니다 — FiveM 서버와 함께 실행되는 웹 기반 관리 패널입니다. 첫 시작 시 TXAdmin이 초기 설정을 안내합니다.

서버 시작

1. GPanel에 로그인하고 FiveM 서버를 선택합니다.
2. Startup 탭으로 이동하여 FIVEM_LICENSE(또는 유사한 이름의) 변수를 찾습니다. 여기에 CFX 라이선스 키를 붙여넣고 저장합니다.
3. Console 탭으로 이동하여 Start를 클릭합니다.
4. 콘솔 출력을 지켜봅니다. 첫 시작 시 서버는 필요한 FiveM 아티팩트를 다운로드합니다 — 몇 분이 걸릴 수 있습니다.
5. TXAdmin이 준비되면 콘솔에 TXAdmin URL과 PIN 코드가 포함된 메시지가 표시됩니다.

TXAdmin 설정 완료

1. 브라우저에서 TXAdmin URL을 엽니다.
2. GPanel 콘솔 출력에 표시된 PIN을 입력합니다.
3. TXAdmin 관리자 계정(사용자 이름 및 비밀번호)을 생성합니다.
4. TXAdmin이 설정 마법사를 안내합니다:
   • Server Name: FiveM 서버 브라우저에 표시되는 이름을 선택합니다.
   • Deployment Type: 템플릿을 선택합니다(예: 사전 구성된 기반의 경우 "Popular Recipes", 커스텀 설정이 있는 경우 "Remote URL / Template").
   • Server Data Folder: 변경할 특별한 이유가 없는 한 기본값으로 둡니다.
   • CFX Key: 다시 메시지가 표시되면 라이선스 키를 붙여넣습니다.
5. 마법사를 완료하고 TXAdmin이 서버 파일 배포를 완료하도록 합니다. 몇 분이 걸릴 수 있습니다.

3단계: server.cfg 구성

server.cfg 파일은 FiveM 서버의 기본 구성 파일입니다. TXAdmin이 설정 중에 기본 파일을 생성하지만 검토하고 사용자 정의하는 것이 좋습니다.

server.cfg 접근

1. GPanel에서 Files 탭을 클릭합니다.
2. 서버 데이터 폴더(일반적으로 루트 디렉터리 또는 TXAdmin 템플릿이 생성한 폴더)로 이동합니다.
3. server.cfg를 클릭하여 인라인 편집기에서 엽니다.

필수 설정

최소한의 server.cfg 예시:

# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"

# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"

# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"

# Player Limit
sv_maxclients 48

# Privacy
sv_endpointprivacy true

# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat

4단계: FiveM 서버 연결

서버가 구성되어 실행되면 플레이어는 FiveM 서버 브라우저 또는 직접 연결을 사용하여 연결할 수 있습니다.

직접 연결

1. FiveM 클라이언트를 엽니다.
2. F8을 눌러 FiveM 콘솔을 열거나 홈 화면에서 Direct Connect 버튼을 클릭합니다.
3. 서버의 IP와 게임 포트를 IP:PORT 형식으로 입력합니다.
4. Connect를 클릭합니다.

서버 브라우저

1. FiveM 클라이언트를 열고 Play를 클릭합니다.
2. 서버 브라우저에서 서버 이름(server.cfg의 sv_hostname 값)을 검색합니다.
3. 서버를 클릭한 다음 Connect를 클릭합니다.

TXAdmin으로 서버 관리

초기 설정 후 TXAdmin은 일상적인 서버 관리를 위한 웹 대시보드를 제공합니다. http://YOUR_SERVER_IP:TXADMIN_PORT에서 접근하세요.

도움 받기

이 가이드를 따랐는데도 여전히 문제가 발생하는 경우:

1. GPanel 콘솔 또는 TXAdmin 로그에서 오류 메시지를 복사합니다.
2. 어느 단계에서 막혔는지와 이미 시도한 것을 메모합니다.
3. 이 정보와 함께 https://legionhosting.net/submitticket.php에서 지원 티켓을 여세요. 저희 팀이 최대한 빨리 도와드리겠습니다.

관련 문서

• FiveM 리소스, 스크립트 및 데이터베이스 설정
• FiveM 문제 해결
• 서버 IP 및 포트 찾는 방법
• SFTP를 통한 파일 업로드 방법
• 서버 시작 가이드