본문으로 건너뛰기

server.cfg 생성기

양식만 채우면 FiveM 서버에 바로 넣을 수 있는 깔끔하고 주석이 달린 server.cfg가 나옵니다. OneSync, 엔드포인트, 태그, 로케일, 리소스, ACE 권한까지 포함합니다.

도구 아래의 설명은 아직 영어로만 제공됩니다.

설정과 코드설정, 다운로드문서 읽기
프레임워크

서버 정보

슬롯, 네트워크, 게임

OneSync

키와 브랜딩

추가 sets 변수

보안

데이터베이스

켜면 oxmysql용 mysql_connection_string을 추가합니다.

음성 (pma-voice)

켜면 pma-voice convar를 추가하고 리소스가 시작되도록 합니다.

리소스

권한 (ACE)

관리자

식별자는 txAdmin (Players에서 플레이어 선택)이나 다음으로 찾을 수 있습니다: GetPlayerIdentifiers(source). 값만 붙여넣으세요. license: 접두어는 넣지 않아도 됩니다.

커스텀 규칙

add_principal child parent 는 child가 parent의 모든 권한을 물려받게 합니다.

sv_licenseKey를 설정하세요. 키는 portal.cfx.re에서 받습니다.

관리자 식별자가 설정되지 않았습니다. 관리자 권한을 갖지 못합니다.

server.cfg
# ==========================================================
#  server.cfg
#  Generated with fivemad.com/tools/server-cfg-generator
#  Docs: https://docs.fivem.net/docs/server-manual/setting-up-a-server/
# ==========================================================
#
#  txAdmin: start the server from txAdmin, not with +exec.
#  txAdmin reads the port from the endpoint lines below, so keep them.
#  Restarts, schedules and bans are handled in the txAdmin panel.

## Networking
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

## Server identity
sv_hostname "^5My Server ^7| Serious RP | Discord: example"
sets sv_projectName "My Server"
sets sv_projectDesc "Serious roleplay with custom jobs and an active staff team"
sets locale "en-US"
sets tags "default"

## Slots and game
sv_maxclients 48
set onesync on
set sv_enforceGameBuild 3258      # Bottom Dollar Bounties

## Security
sv_scriptHookAllowed 0
sv_pureLevel 1                 # blocks modified game files, allows audio and graphics mods
sv_endpointprivacy true

## Keys
set steam_webApiKey "none"   # https://steamcommunity.com/dev/apikey
sv_licenseKey "changeme"   # https://portal.cfx.re

## Resources (load order matters)
# Default cfx resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure baseevents

## Permissions
add_ace group.admin command allow            # all commands
add_ace group.admin command.quit deny        # but not quit
# add_principal identifier.license:xxxxxxxx group.admin   # add yourself here

How to use it

  1. Pick your framework. It fills a working ensure order and the matching permission lines.
  2. Fill in the hostname, license key, slots and game build. Warnings on the right point out common mistakes.
  3. Add yourself as admin with your license or Discord identifier.
  4. Download server.cfg into your server-data folder (next to the resources folder).

Everything stays in your browser, including the license key and database password. The form is saved locally so you can come back to it.

Starting the server

With txAdmin, point the deployer or Settings, then FXServer, at this file. Without txAdmin, start FXServer from the server-data folder:

# Windows
C:\FXServer\server\FXServer.exe +exec server.cfg

# Linux
bash ~/FXServer/server/run.sh +exec server.cfg

Load order

Resources start in the order they are listed. Libraries such as oxmysql and ox_lib must come before the framework core, and the core (qb-core, qbx_core, es_extended) before any script that uses it. ensure [folder] starts everything inside a bracketed folder and you do not control the order inside it, so ensure dependencies explicitly before the folder.

OneSync and slots

  • set onesync on is what almost every modern resource expects. Without OneSync the cap is 32 players.
  • Up to 48 slots works with any key. Going higher needs an Element Club subscription on the Cfx.re account that owns the key.
  • sv_enforceGameBuild must be set before players join. Changing it makes clients download the matching game build on their next connect.

ACE permissions in short

# give a group a permission
add_ace group.admin command allow
# put a player (or group) inside a group
add_principal identifier.license:abc123 group.admin
# let one group inherit another
add_principal group.admin group.mod

Check a permission in Lua with IsPlayerAceAllowed(source, 'command.kick'). After editing ACE lines you can apply them live by pasting them into the server console.

Gotchas

  • Do not commit server.cfg to a public repo: it holds your license key and database password. Move secrets to a separate file and exec secrets.cfg.
  • Special characters in the database password must be URL-encoded in mysql_connection_string. The generator does that for you.
  • setr convars are replicated to clients, sets convars are shown publicly in the server list, plain set stays on the server.

설정과 코드 도구 더 보기

의상 디자이너

의상 .ydd나 .ydr을 .ytd 파일과 함께 열어 3D나 UV 레이아웃 위에서 레이어, 텍스트, 이미지로 칠하고 새 .ytd 텍스처로 내보냅니다.

설정과 코드의상, 3D, 텍스처, YTD

YMAP 빌더

좌표로 프롭을 배치하면 회전, extents, LOD 거리가 제대로 들어간 .ymap XML이 나옵니다.

설정과 코드맵, 프롭, 다운로드

구역 생성기

실제 GTA V 지도 위에 2D나 3D로 구역을 그리고 ox_lib, PolyZone, ox_target, qb-target 코드로 복사하세요.

설정과 코드구역, PolyZone, Target, 3D