이 가이드는 FiveM 서버에 리소스(스크립트)를 설치하고, ESX 또는 QBCore와 같은 프레임워크를 위한 MySQL 데이터베이스를 설정하고, 리소스 로드 순서를 이해하는 방법을 다룹니다. 아직 초기 서버 설정을 완료하지 않았다면 먼저 FiveM 서버 설정 가이드로 시작하세요.

리소스 및 스크립트 설치

FiveM 서버는 리소스(스크립트라고도 함)로 확장됩니다. 리소스는 자동차 딜러, 직업, HUD 요소, 프레임워크 등의 기능을 추가합니다.

리소스 설치 방법

1. 출처(GitHub, Cfx.re 포럼, Tebex 등)에서 리소스를 다운로드합니다.
2. 필요한 경우 ZIP/아카이브에서 리소스 폴더를 추출합니다.
3. GPanel Files 탭을 사용하거나 SFTP를 통해 리소스 폴더를 서버의 resources/ 디렉터리에 업로드합니다.
4. server.cfg를 열고 리소스에 대한 ensure 줄을 추가합니다:

# Add your custom resources
ensure my-new-resource

5. 리소스가 로드되도록 GPanel 또는 TXAdmin에서 서버를 재시작합니다.

리소스 매니페스트

모든 유효한 리소스에는 매니페스트 파일이 포함되어야 합니다. 최신 리소스는 fxmanifest.lua를 사용하고, 이전 리소스는 __resource.lua를 사용합니다. 다운로드한 리소스 폴더에 이 파일 중 하나도 포함되어 있지 않으면 리소스가 로드되지 않습니다. 일부 다운로드는 실제 리소스 폴더를 외부 폴더 안에 중첩합니다 — resources/에 넣는 폴더가 매니페스트를 포함하는 폴더인지 확인하세요.

리소스 로드 순서

리소스는 server.cfg에 나타나는 순서대로 로드됩니다. 리소스가 다른 리소스에 의존하는 경우(예: ESX 또는 QBCore와 같은 프레임워크에 의존하는 직업 스크립트), 의존 대상이 이를 필요로 하는 리소스 앞에 나열되도록 하세요:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

카테고리 폴더로 리소스 정리

resources/ 디렉터리 안의 하위 폴더로 리소스를 정리할 수 있습니다. server.cfg에서 대괄호 표기법을 사용하여 전체 카테고리 폴더를 ensure하세요:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

이렇게 하면 명명된 하위 폴더 내의 모든 리소스가 로드됩니다. 각각을 개별적으로 나열하지 않고 관련 스크립트를 그룹화하는 편리한 방법입니다.

TXAdmin을 통한 리소스 핫 로딩

새 리소스를 로드하기 위해 항상 전체 서버 재시작이 필요한 것은 아닙니다. TXAdmin은 Resources 페이지에서 개별 리소스를 시작, 중지, 재시작할 수 있습니다. 새 리소스를 업로드하고 ensure 줄을 추가한 후 TXAdmin 라이브 콘솔에서 다음 명령어를 실행할 수 있습니다:

refresh
ensure my-new-resource

refresh 명령어는 서버에 새 항목을 찾기 위해 resources/ 디렉터리를 다시 스캔하도록 지시합니다.

데이터베이스 설정 (MySQL / MariaDB)

많은 FiveM 프레임워크와 리소스(예: ESX, QBCore 또는 vRP)에는 MySQL 또는 MariaDB 데이터베이스가 필요합니다. Legion Hosting은 서버와 함께 데이터베이스 자격 증명을 제공합니다.

데이터베이스 자격 증명 찾기

1. GPanel에서 Databases 탭으로 이동합니다.
2. 아직 데이터베이스가 없으면 New Database를 클릭하여 생성합니다.
3. 다음 세부 정보를 메모하세요:
   • Database Host (주소 및 포트)
   • Database Name
   • Username
   • Password (눈 아이콘을 클릭하여 표시)

데이터베이스 연결 구성

데이터베이스 연결 세부 정보는 연결 문자열을 사용하여 server.cfg에서 설정됩니다. 정확한 형식은 사용 중인 MySQL 리소스에 따라 다르지만 가장 일반적인 형식은 다음과 같습니다:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

자리 표시자를 Databases 탭의 실제 자격 증명으로 바꾸세요. 예를 들면:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

MySQL 리소스 선택

어떤 MySQL 리소스를 사용하든 server.cfg에서 이에 의존하는 모든 리소스 앞에 ensure해야 합니다:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

프레임워크 기초

프레임워크는 플레이어 신원, 돈, 인벤토리, 직업, 차량과 같은 다른 리소스가 구축되는 핵심 게임플레이 시스템을 제공합니다. 가장 인기 있는 두 가지 FiveM 프레임워크는 다음과 같습니다:

대부분의 프레임워크는 초기 설정 중에 TXAdmin의 레시피 시스템을 통해 설치됩니다. TXAdmin 설정 중에 "QBCore" 또는 "ESX"와 같은 레시피를 선택했다면 프레임워크와 핵심 종속성이 이미 설치되어 있습니다. 프레임워크를 수동으로 설치해야 하는 경우 공식 문서를 따르세요:

• ESX 문서
• QBCore 문서

도움 받기

리소스 설치나 데이터베이스 구성에 도움이 필요한 경우:

1. 설치 지침과 알려진 문제는 리소스의 문서나 GitHub 페이지를 확인하세요.
2. GPanel 콘솔 또는 TXAdmin 로그에서 오류 메시지를 검토하세요.
3. 오류 메시지와 설치하려는 리소스의 이름을 포함하여 https://legionhosting.net/submitticket.php에서 지원 티켓을 여세요.

관련 문서

• FiveM 서버 설정 가이드
• FiveM 문제 해결
• SFTP를 통한 파일 업로드 방법
• 서버 IP 및 포트 찾는 방법