วิธีติดตั้ง Qbox FiveM แบบถูกต้องสำหรับ Server ใหม่

การติดตั้ง Qbox FiveM ในปัจจุบัน วิธีที่แนะนำที่สุดคือใช้ txAdmin และ QBox Framework Recipe แทนการดาวน์โหลด qbx_core, ox_lib, ox_inventory, oxmysql และ Resources ต่าง ๆ มาประกอบด้วยตัวเอง

ภาพรวมการติดตั้งคือ

FiveM Server Artifact
↓
FXServer
↓
txAdmin
↓
QBox Framework Recipe
↓
MariaDB
↓
OX Resources
↓
qbx_core
↓
Qbox Resources
↓
เปิด Server
↓
สร้าง Character
↓
ทดสอบ Player / Job / Money / Inventory

Qbox Documentation ปัจจุบันแนะนำการติดตั้งผ่าน txAdmin โดยตรง และมีข้อกำหนดสำคัญมากคือ Qbox รองรับ MariaDB ไม่ใช่ MySQL/XAMPP

สำหรับ Server ใหม่ควรใช้ MariaDB รุ่นที่ Qbox รองรับ โดยปัจจุบันกำหนดขั้นต่ำไว้ที่

MariaDB 10.9.0

และสำหรับการติดตั้งใหม่ในปี 2026 เอกสาร Qbox แนะนำสาย LTS ปัจจุบันอย่าง

MariaDB 12.3 LTS

ดังนั้นอย่าเริ่ม Qbox Server ใหม่จาก Tutorial FiveM เก่าที่ติดตั้ง XAMPP ก่อนโดยไม่ตรวจ Requirement ปัจจุบัน

① สิ่งที่ต้องเตรียมก่อนติดตั้ง Qbox

ควรเตรียม

• เครื่อง Windows หรือ Linux

• FiveM Server Artifact ปัจจุบัน

• Cfx Account

• Server Registration Key

• MariaDB

• Database User

• Internet Connection

• txAdmin

• FiveM Client สำหรับทดสอบ

Stack โดยทั่วไปคือ

FXServer
+
txAdmin
+
MariaDB
+
Qbox

สำหรับผู้เริ่มต้นไม่จำเป็นต้องติดตั้ง Qbox Resources ทีละตัวหาก Official Recipe สามารถทำให้ได้

② Qbox ใช้ MariaDB หรือ MySQL

สำหรับ Current Qbox ให้ใช้

MariaDB

Qbox Documentation ปัจจุบันระบุว่า

MySQL is not supported

และยังระบุว่า

XAMPP is not supported

ดังนั้นการทำ Server ใหม่ไม่ควรเริ่มด้วย

XAMPP
↓
MySQL
↓
Qbox

เพียงเพราะเห็น Tutorial FiveM รุ่นเก่าใช้วิธีนี้

แนวทางที่ถูกต้องคือ

MariaDB
↓
oxmysql
↓
Qbox

③ Qbox ต้องใช้ MariaDB เวอร์ชันไหน

ขั้นต่ำปัจจุบันคือ

MariaDB 10.9.0

เหตุผลคือ Qbox ใช้ SQL Features ที่ต้องการ Database รุ่นใหม่ เช่น

JSON_VALUE()
ADD COLUMN IF NOT EXISTS
CREATE INDEX IF NOT EXISTS

โดย CREATE INDEX IF NOT EXISTS เป็นหนึ่งในเหตุผลที่ทำให้ Minimum Effective Version อยู่ที่ 10.9.0

สำหรับ Server ใหม่ Qbox แนะนำ

MariaDB 12.3 LTS

ซึ่งเป็น LTS รุ่นปัจจุบันตามเอกสารปี 2026

④ ทำไมไม่ควรใช้ MariaDB เก่าเกินไป

Core ปัจจุบันสามารถสร้างและอัปเดต Database Structure ระหว่างการทำงานได้

หาก Database Version เก่าเกินไป อาจเจอ

SQL Syntax Error
Migration Error
CREATE INDEX Error
Player Loading Error

แล้วทำให้ดูเหมือนว่า

qbx_core พัง

ทั้งที่จริง Root Cause คือ Database Version

ก่อน Debug Qbox Core จึงควรตรวจ

SELECT VERSION();

หรือดู Version จาก Database Administration Tool ก่อน

⑤ สร้าง Database สำหรับ Qbox

ตัวอย่างแนวคิด

Database:
qbox

User:
fivem

Password:
StrongPassword

ควรสร้าง Dedicated Database User

แทนการใช้

root

กับ Production Server โดยไม่จำเป็น

Architecture ที่ดีกว่า

FXServer
↓
fivem database user
↓
qbox database

ช่วยจำกัดสิทธิ์หาก Credential หลุด

⑥ อย่าใช้ Database Root แบบไม่มี Password

Development Environment บางแห่งอาจเปิด Database ด้วย

root
password ว่าง

แต่ Production ไม่ควรทำ

อย่างน้อยควรมี

Dedicated User
Strong Password
Limited Network Access
Database Backup

เพราะ Database มีข้อมูล Character และ Economy ของผู้เล่นจำนวนมาก

⑦ ดาวน์โหลด FiveM Server Artifact

เริ่มจาก FiveM Server Artifact ปัจจุบัน

ขั้นตอนคือ

Download Artifact
↓
Extract
↓
เปิด FXServer

Qbox Documentation แนะนำให้ดาวน์โหลด Artifact ล่าสุดจากรายการ FiveM Server Builds

บน Windows จะเปิด

FXServer.exe

เพื่อเริ่ม Setup

อย่าใช้ Artifact ที่เก็บมาจาก Server Pack เก่าโดยไม่ตรวจ Version

⑧ txAdmin ต้องติดตั้งเพิ่มหรือไม่

ไม่ต้อง

txAdmin ถูก Bundle มากับ FXServer รุ่นปัจจุบัน

เมื่อเปิด

FXServer.exe

ระบบจะเริ่ม txAdmin Setup

จากนั้นใช้ Browser เพื่อ

Link Account
สร้าง Profile
เลือก Recipe
Deploy Server

นี่เป็นเส้นทางที่ Qbox Documentation แนะนำ

⑨ Link Cfx Account

ตอน Setup txAdmin ให้เชื่อม Cfx Account

Flow คือ

FXServer
↓
txAdmin
↓
Cfx Account
↓
Authorize

ควรใช้ Account ที่ตั้งใจเป็นเจ้าของ Production Server ระยะยาว

เพราะต่อไปอาจเกี่ยวข้องกับ

Server Registration Keys
Paid Resources
Asset Entitlements
Server Management

อย่าใช้ Account ชั่วคราวของ Freelancer หากคุณเป็นเจ้าของ Server ระยะยาว

⑩ สร้าง Server Profile

ตั้งชื่อ Profile ให้ชัด เช่น

Qbox-Development

หรือ

Qbox-Production

ถ้ามีหลาย Environment ควรแยก

Development
Staging
Production

ตั้งแต่แรก

หลีกเลี่ยงชื่อ

test
test2
new
newserver

เพราะในอนาคตจะสับสนว่า Config และ Database ตัวไหนเป็น Server จริง

⑪ เลือก Popular Recipes

เมื่อ txAdmin ถาม Deployment Type ให้เลือก

Popular Recipes

จากนั้นเลือก

QBox Framework

Qbox Documentation ปัจจุบันแนะนำวิธีนี้โดยตรง

ข้อดีคือ Recipe จะจัดการ

Resources
Configuration
Database
Dependencies
SQL
Start Structure

ให้จำนวนมากโดยอัตโนมัติ

⑫ Qbox Recipe มีหลายแบบหรือไม่

Qbox Project ปัจจุบันมี Recipe หลายแนวทางใน Repository เช่น

Qbox
Qbox Stable
Qbox Lean

รายละเอียด Resources ที่ติดตั้งอาจแตกต่างกัน

สำหรับผู้ใช้ทั่วไปที่ต้องการ Server ใช้งานได้ง่าย ควรเลือก Recipe ที่ txAdmin แสดงใน Popular Recipes ตามคำแนะนำปัจจุบัน

ถ้าต้องการควบคุม Stack ละเอียดจึงค่อยศึกษา Lean/Stable Recipe เพิ่ม

⑬ Qbox Stable คืออะไร

Qbox Stable Recipe ถูกออกแบบให้ใช้ Resources ที่มี Release แบบ Stable

แนวคิดคือ

Stable Released Resources
↓
ลดการดึง Code ที่กำลังพัฒนา
↓
เหมาะกับ Server ที่ต้องการ Stability

แต่ Stable Recipe อาจไม่มี Resource ใหม่บางตัวที่อยู่ใน Main Recipe

สำหรับ Production Server ความนิ่งมักสำคัญกว่าการใช้ Feature ใหม่ที่สุดทุกตัว

⑭ Qbox Lean คืออะไร

Lean Recipe มีแนวคิดลด Resources ที่ไม่จำเป็นออก เพื่อให้ได้ Base ที่เบากว่าและนำไป Custom ต่อเอง

เหมาะกับ

Developer
ทีมที่สร้าง Custom Scripts เอง
Server ที่ไม่ต้องการ Full RP Pack

สำหรับมือใหม่ที่ต้องการ Server RP พร้อมเริ่มต้น Recipe ปกติหรือ Stable อาจง่ายกว่า

⑮ Recipe ติดตั้งอะไรให้บ้าง

Current Qbox Recipe ดาวน์โหลดทั้ง Qbox และ OX ecosystem หลายตัว

ตัวอย่างสำคัญ เช่น

qbx_core
qbx_vehicles
qbx_management
qbx_hud
qbx_adminmenu

รวมถึง OX resources เช่น

ox_lib
ox_target
oxmysql
ox_inventory
ox_doorlock
ox_fuel

และ Voice/Phone Resources ตาม Recipe ปัจจุบัน

รายละเอียดอาจเปลี่ยนเมื่อ Recipe ถูกอัปเดต จึงควรใช้ Current Recipe แทนการจดชื่อ Resource จาก Tutorial เก่าแล้วดาวน์โหลดเอง

⑯ qbx_core คือ Resource สำคัญที่สุด

Core หลักของ Framework คือ

qbx_core

หน้าที่เกี่ยวกับ

Player
Character
Jobs
Gangs
Groups
Money
Metadata
Vehicles
Permissions

รวมถึง Public APIs ที่ Resources อื่นเรียกใช้งาน

หาก qbx_core ไม่ Start Qbox Resources จำนวนมากจะทำงานไม่ได้

ดังนั้น Core Error ต้องแก้ก่อน Script ลูกเสมอ

⑰ qbx_core ต้องใช้ Dependency อะไร

Current qbx_core พึ่ง Resources สำคัญอย่าง

ox_lib
oxmysql
ox_inventory

โดย Current Core มี Startup Checks สำหรับ Dependency สำคัญด้วย

หาก Dependency Version ไม่ผ่าน Core สามารถหยุด Initialization และแสดง Error ได้

จึงไม่ควรติดตั้ง OX Resources รุ่นสุ่ม ๆ จาก ZIP เก่ามาปะกับ Qbox ใหม่

⑱ Current qbx_core ตรวจ Version อะไรบ้าง

Current Core มี Runtime Check อย่างน้อยสำหรับ

ox_lib >= 3.20.0
ox_inventory >= 2.42.1

ตาม Source ปัจจุบัน

ถ้าใช้ Version ต่ำกว่านี้ Core สามารถแจ้ง Startup Error

ดังนั้น Error เช่น

ox_lib version ... required

ไม่ควรถูกแก้ด้วยการลบ Version Check ออกจาก Core

ให้ Update Dependency ให้ตรง Requirement แทน

⑲ Qbox ใช้ oxmysql ทำอะไร

oxmysql เป็น Database Resource

Architecture คือ

qbx_core
↓
oxmysql
↓
MariaDB

มันเป็นตัวเชื่อม Lua Server Scripts กับ Database

อย่าสับสนว่า

oxmysql = Database

จริง ๆ แล้ว MariaDB คือ Database Server

ส่วน oxmysql คือ Interface/Wrapper ที่ FiveM Resources ใช้สื่อสารกับ Database

⑳ Qbox ใช้ ox_lib ทำอะไร

ox_lib เป็น Library ที่ Resources ใช้สำหรับ

Callbacks
Zones
UI
Utilities
Locale
Logging
Dialogs
Context Menus

และระบบอื่นตาม Resource ที่ใช้

qbx_core ปัจจุบันโหลด

@ox_lib/init.lua

โดยตรง

ดังนั้น ox_lib เป็น Dependency สำคัญของ Qbox Stack

㉑ Qbox ใช้ ox_inventory หรือไม่

ใช่ใน Current Qbox Stack

qbx_core ปัจจุบันตรวจว่า ox_inventory มี Version ที่ต้องการ และตรวจ Inventory Framework Configuration ด้วย

Qbox Recipe ยังติดตั้ง

ox_inventory

พร้อม Configuration สำหรับ Qbox

จึงไม่ควรสร้าง Qbox ใหม่แล้วพยายามใช้ Inventory คนละตัวโดยไม่ศึกษาการ Integration ก่อน

㉒ inventory:framework ต้องเป็น qbx

Current qbx_core ตรวจ Convar

inventory:framework

และต้องเป็น

qbx

Current ox.cfg ของ Official Recipe มี

setr inventory:framework "qbx"

หากแก้เป็น Framework อื่น Qbox Core อาจไม่ยอม Initialize

ดังนั้นหากเห็น Error ประมาณ

inventory:framework must be set to "qbx"

ให้ตรวจ ox.cfg

ไม่ใช่แก้ Source Core

㉓ OneSync สำคัญกับ Qbox

Qbox Core ปัจจุบันตรวจ OneSync Infinity ด้วย

ถ้าไม่เปิดจะเกิด Startup Error

Official Recipe กำหนด OneSync ไว้ให้ผ่าน Recipe Engine

ดังนั้นถ้า Install ด้วย Official Recipe โดยสมบูรณ์ไม่ควรต้องปิด OneSync เอง

อย่านำ Config จาก FiveM Server รุ่นเก่ามาทับแล้วปิด Network Features ที่ Framework รุ่นใหม่ต้องใช้

㉔ Server Artifact Version ก็สำคัญ

Current qbx_core Manifest มี Runtime Constraint สำหรับ Server Build

ดังนั้น Artifact เก่าเกินไปสามารถทำให้ Core ไม่รองรับ

วิธีที่ดีคือใช้ Current FiveM Artifact ตาม Qbox Installation Guide

ไม่ควรพยายามลบ

/server:<build>

จาก Manifest เพื่อบังคับ Core ให้ Run บน Artifact เก่า

ควร Update FXServer แทน

㉕ เตรียม Database Connection

ระหว่าง Recipe Deployment txAdmin จะขอ Database Information

ต้องมี

Host
Port
Database
Username
Password

พร้อม

จากนั้น Recipe จะสร้าง Connection String

ใน server.cfg จะมี

set mysql_connection_string "..."

อย่า Copy Connection String ตัวอย่างจากคนอื่น

ต้องใช้ Credential ของ Database Server จริง

㉖ อย่าเผย mysql_connection_string

Connection String สามารถมี

Database User
Database Password
Database Host
Database Name

จึงไม่ควรส่ง server.cfg ทั้งไฟล์ลง Discord สาธารณะ

หากต้องขอความช่วยเหลือให้ปิดข้อมูล เช่น

set mysql_connection_string "mysql://fivem:********@localhost/qbox"

และปิด

sv_licenseKey
API Tokens
Webhook URLs

ด้วย

㉗ Qbox Recipe Import SQL ให้หรือไม่

ใช่

Current Recipe มีขั้นตอน

connect_database
query_database

และ Import Qbox Base SQL ให้

จากนั้น Resources บางตัวมี SQL ของตัวเอง เช่น

qbx_core
qbx_vehicles
qbx_vehiclesales
qbx_vehicleshop

ตาม Recipe ที่ใช้งาน

ดังนั้นถ้า Recipe Deploy สำเร็จ อย่า Import SQL ชุดเดียวกันซ้ำโดยไม่ตรวจ Database

㉘ qbx_core.sql มีอะไร

Current qbx_core.sql มี Base Table เช่น

players

ซึ่งเก็บ Character Data ประเภท

citizenid
license
name
money
charinfo
job
gang

และข้อมูลอื่นตาม Current Schema

นอกจากนั้น Current Core ยังมีระบบ Storage/Migrations เพิ่มเติม

ดังนั้น Database ของ Qbox ไม่ควรถูกสร้างตาม Schema จาก QBCore Tutorial โดยเดาเอง

㉙ users Table คืออะไรใน Qbox รุ่นปัจจุบัน

Current Qbox Core มีระบบ User Storage เพิ่มเติม และสามารถสร้าง Table

users

เพื่อช่วย Resolve Player Identity จาก Identifiers

เช่น

license
license2
fivem
discord

Current Core ยังสร้าง Index ที่เหมาะสมเพื่อป้องกัน Full Table Scan ตอน Player Connect

นี่เป็นหนึ่งในเหตุผลที่ MariaDB Version ใหม่มีความสำคัญ

㉚ Run Recipe

เมื่อ

MariaDB พร้อม
Database User พร้อม
Cfx Key พร้อม
Recipe ถูก

ให้ Run Recipe

ระบบจะ

Download Config
↓
เตรียม Database
↓
Download Dependencies
↓
Download Qbox Resources
↓
Import SQL
↓
สร้าง Resource Structure

หาก Recipe หยุดกลางทาง อย่ากด Run ซ้ำทันทีหลายครั้ง

ให้อ่าน Step ที่ Error ก่อน

㉛ Server Registration Key ต้องใช้

Qbox ยังเป็น FiveM Server ดังนั้นต้องมี Cfx Server Registration Key

ใน Config จะมี

sv_licenseKey "YOUR_KEY"

ควรสร้าง Key จาก Cfx Account ที่ Production Server ควบคุมเอง

อย่าใช้ Key จาก

Server Pack
Developer คนอื่น
เพื่อน
Tutorial

และอย่าเผย Key สาธารณะ

㉜ Resource Structure หลังติดตั้ง

โครงสร้างอาจคล้าย

resources/
├── [cfx-default]/
├── [ox]/
│   ├── ox_lib/
│   ├── ox_inventory/
│   ├── ox_target/
│   ├── oxmysql/
│   └── ...
├── [qbx]/
│   ├── qbx_core/
│   ├── qbx_vehicles/
│   ├── qbx_management/
│   └── ...
├── [standalone]/
├── [voice]/
├── [assets]/
└── [npwd-apps]/

รายละเอียดขึ้นกับ Recipe เวอร์ชัน

อย่า Rename หรือย้าย Core Dependencies หลังติดตั้งโดยไม่จำเป็น

㉝ server.cfg ของ Qbox แบ่ง Config อย่างไร

Official Recipe ปัจจุบันแยก Configuration หลายไฟล์

เช่น

server.cfg
ox.cfg
voice.cfg
permissions.cfg
misc.cfg

server.cfg จะ exec Config เหล่านี้

ตัวอย่าง

exec voice.cfg
exec ox.cfg
exec permissions.cfg

ข้อดีคือ Config ไม่รวมอยู่ไฟล์เดียวหลายร้อยบรรทัด

เวลาแก้ Inventory ควรไป ox.cfg

เวลาแก้ Permissions ควรไป permissions.cfg

㉞ Start Order ของ Qbox ปัจจุบัน

Official server.cfg ปัจจุบันมีโครงสร้างประมาณ

ensure ox_lib
ensure qbx_core
ensure ox_target

ensure [ox]
ensure [qbx]
ensure [standalone]
ensure [voice]
ensure [assets]

พร้อม Resources อื่นตาม Recipe

ไม่ควร Copy Start Order แบบสุ่มจาก Server อื่น

ให้ใช้ Official server.cfg เป็น Base ก่อน

㉟ ทำไม qbx_core มาก่อน [ox] ทั้งกลุ่มได้

แม้ qbx_core ต้องใช้ OX Dependencies แต่ FiveM Resource Dependency และ Recipe Structure จะจัดความสัมพันธ์ของ Resources สำคัญให้

สิ่งที่ควรสนใจคือ Dependency ที่ Core ต้องใช้จริงต้องพร้อม

หากคุณแก้ Start Order เองหลังติดตั้ง ควรเข้าใจ

dependency
provide
ensure category

ก่อน

ไม่ควรย้าย qbx_core ไปตำแหน่งสุ่มเพียงเพราะคิดว่า OX ทุกตัวต้อง Start ก่อนทั้งหมด

㊱ qbx:enableBridge คืออะไร

Current server.cfg มี

setr qbx:enableBridge "true"

เพื่อเปิด QB Compatibility Bridge

ทำให้ QBCore Scripts จำนวนมากที่ใช้ Supported QB APIs สามารถทำงานบน Qbox ได้

หาก Server ใหม่ใช้ Qbox Native Resources ทั้งหมด ในอนาคตอาจพิจารณา Dependency ต่อ Bridge ได้

แต่ตอนเริ่มต้นควรใช้ค่าจาก Official Recipe ก่อน

㊲ ห้ามลง qb-core คู่กับ qbx_core โดยไม่จำเป็น

Qbox Bridge สามารถ

provide qb-core compatibility

ให้ Resources จำนวนมาก

ดังนั้นไม่ควรทำ

ensure qb-core
ensure qbx_core

เพียงเพราะ Paid Script บอกว่าใช้ QBCore

ควรตรวจก่อนว่า Script ใช้ได้ผ่าน Qbox QB Bridge หรือมี Native Qbox Integration

การเปิด Framework Core สองตัวอาจทำให้

Player Data
Jobs
Money
Events
Callbacks

สับสน

㊳ qbx_core มี provide qb-core

Current qbx_core Manifest มี

provide 'qb-core'

ซึ่งเป็นส่วนสำคัญของ Compatibility Architecture

จึงช่วยให้ Resource Dependency บางประเภทที่คาดหวัง qb-core สามารถรู้ว่า qbx_core สามารถ Provide capability นั้นได้

แต่ไม่ได้หมายความว่า QB Script ทุกตัว Compatible 100%

ยังต้องตรวจ API Usage ของ Resource ด้วย

㊴ เปิด Server ครั้งแรก

หลัง Recipe Deploy เสร็จให้ Run Server

จากนั้นอ่าน Console ตั้งแต่ต้น

ตรวจว่าไม่มี Error สำคัญ เช่น

ox_lib version too old
ox_inventory version too old
inventory framework invalid
OneSync disabled
Database connection failed
Missing dependency
SCRIPT ERROR

ถ้า qbx_core มี Startup Error ให้หยุดเพิ่ม Custom Script ก่อน

Base Framework ต้องผ่านก่อน

㊵ ตรวจ ox_lib

Current Core ต้องการ ox_lib รุ่นที่รองรับ

ถ้าเห็น

ox_lib version ... or higher is required

ให้ Update ox_lib

ไม่ควรเข้า qbx_core/server/main.lua แล้วลบ Version Check

Version Check มีไว้ป้องกัน Core ทำงานกับ API ที่ Dependency ไม่มี

㊶ ตรวจ ox_inventory

เช่นเดียวกัน

ถ้า Core แจ้ง

ox_inventory version ... or higher is required

ให้ Update ox_inventory

และตรวจ

setr inventory:framework "qbx"

ด้วย

Inventory เป็นส่วนที่ Qbox Core เชื่อมใช้งานโดยตรงใน Current Stack

㊷ ตรวจ oxmysql

ถ้า Error Database ให้ตรวจ

MariaDB Running?
Version ถูก?
Host ถูก?
Username ถูก?
Password ถูก?
Database มี?
Permission ถูก?

อย่าแก้ Qbox Player Script ก่อน Database Connection สำเร็จ

เพราะ Player Persistence พึ่ง Database

㊸ ตรวจ OneSync

ถ้า Console ระบุว่า

OneSync Infinity is not enabled

ให้ตรวจ Server Configuration/Recipe

Qbox Core Current Version ต้องการ OneSync

ไม่ควร Comment Out Startup Check เพื่อให้ Server เปิด

เพราะ Resource อาจพึ่ง OneSync Features ต่อไปอีกหลายจุด

㊹ เข้า Server ทดสอบ Character

เมื่อ Core Start สำเร็จ ให้เข้า Server

ทดสอบ

Connect
↓
Character Selection
↓
Create Character
↓
Spawn

Qbox Core มี Built-in Multicharacter ตาม Current Project

ดังนั้น Base Character Flow ควรทำงานก่อนติดตั้ง Character Resource ตัวอื่น

㊺ Qbox มี Multicharacter ใน Core

Current qbx_core ระบุ Features ว่ามี

Built-in multicharacter

ดังนั้นไม่ควรติดตั้ง QBCore Multicharacter Resource เพิ่มแบบสุ่ม

อาจทำให้ Character Flow ซ้อนกัน

ก่อนลง Character Selector Third-party ให้ตรวจว่าเขา Replace Qbox System อย่างไร

㊻ ทดสอบ Character Persistence

หลังสร้าง Character

Create
↓
Spawn
↓
ออก Server
↓
เข้าใหม่
↓
เลือก Character เดิม

ถ้าข้อมูล Character หาย ให้ตรวจ

Database
qbx_core
Player Save
Identifier
SQL

ก่อนลง Gameplay Scripts เพิ่ม

㊼ ตรวจ citizenid

Qbox ยังคงมี Character Identity เช่น

citizenid

ใน Player Data/Database Architecture

ควรตรวจว่า Character ใหม่ได้รับ Citizen ID

และ Reconnect แล้ว Character เดิมยังมี ID เดิม

ข้อมูล Persistent Resources เช่น Vehicles หรือ Phone มักเชื่อมกับ Character Identifier

㊽ ทดสอบ Money

ตรวจระบบ Money ของ Character

ทดสอบใน Development Environment

มีเงินเริ่มต้น
↓
เปลี่ยนยอด
↓
ออก Server
↓
เข้าใหม่
↓
ตรวจยอด

เป้าหมายคือดูว่า

Memory State
↓
Database
↓
Load กลับมา

ทำงานครบ

ถ้ายอดหายหลัง Reconnect ให้แก้ Persistence ก่อนสร้าง Economy ต่อ

㊾ ทดสอบ Job

Qbox รองรับ Jobs และ Multi-job architecture

ให้ทดสอบ

Default Job
Job Change
Job Grade
Reconnect

และดูว่า Player Group ถูก Save ถูกต้อง

ถ้า Custom Job ยังไม่ได้เพิ่ม อย่าใช้ Job Name ที่ไม่มีใน Shared/Core Data แล้วสรุปว่า SetJob พัง

㊿ ทดสอบ Gang/Group

ทำเช่นเดียวกับ Job

ตรวจ

Gang
Grade
Primary Group
Persistence

Current Qbox มี Multi-job/Multi-gang Features และ Config เช่น

qbx:max_jobs_per_player
qbx:max_gangs_per_player

ใน Official Configuration

ควรเข้าใจ Config เหล่านี้ก่อนติดตั้ง Multi-job Script ภายนอก

51. qbx:max_jobs_per_player คืออะไร

Current server.cfg มีตัวอย่าง

set qbx:max_jobs_per_player 1

หมายถึงจำนวน Jobs ที่ Player สามารถมีได้ตามระบบของ Qbox

เช่นเดียวกับ

set qbx:max_gangs_per_player 1

สำหรับ Gang

หากต้องการ Multi-job มากกว่าหนึ่ง ต้องออกแบบระบบและ Config ให้สอดคล้อง

ไม่ควรติดตั้ง Resource Multi-job ที่แก้ Tables ของ Qbox โดยตรงแบบไม่ตรวจ Compatibility

52. qbx:setjob_replaces คืออะไร

Current Config มี

set qbx:setjob_replaces "true"

เมื่อเปิด ระบบ SetJob สามารถแทน Primary Job เดิมตาม Behavior ของ Framework

มี Config เทียบเท่าสำหรับ Gang ด้วย

นี่เป็นตัวอย่างว่าก่อนลง Custom Job Manager ควรอ่าน Qbox Config ก่อน

บาง Feature ที่กำลังหาอาจมีอยู่ใน Core อยู่แล้ว

53. ทดสอบ Inventory

เปิด

ox_inventory

แล้วตรวจ

Inventory เปิด
Items แสดง
Item ย้ายได้
Item ใช้ได้
Reconnect แล้ว Item ยังอยู่

ดูทั้ง F8 และ Server Console

ถ้า Inventory Base พัง อย่าเพิ่งติดตั้ง Shop/Crafting/Job Scripts เพิ่ม

เพราะทุกตัวจะสร้าง Error ตามมา

54. ทดสอบ ox_target

Qbox Recipe ติดตั้ง ox_target

ให้ทดสอบ Interaction ที่ Base Resources มี

เช่น

NPC
Vehicle
Door
Zone

ถ้า Target ไม่ขึ้น ตรวจ

ox_target Started?
ox_lib Started?
Config ถูก?
F8 มี Error?

อย่าติดตั้ง qb-target ซ้อนทันทีเพื่อหวังแก้ปัญหา

55. ทดสอบ Voice

Current Recipe มี Voice Resources เช่น

pma-voice

ตาม Recipe ที่ใช้

ทดสอบ

Proximity Voice
Radio
Microphone
Voice Range

Voice มี Layer ของตัวเอง

ถ้าไม่มีเสียง ไม่ควรแก้ qbx_core ก่อนโดยไม่มีหลักฐาน

56. ตรวจ F8

ปัญหาฝั่ง Client ให้เปิด

F8

อาการเช่น

UI ไม่เปิด
Target ไม่ขึ้น
HUD Error
Character Screen Error
NUI Error

มักจะมี Client Error ให้ดู

หา Resource และ Error แรกก่อน

เช่น

@some_resource/client/main.lua:120

แล้ว Debug จากตรงนั้น

57. ตรวจ Server Console

ปัญหาเช่น

Player ไม่โหลด
Money ไม่ Save
Job ไม่ Save
Database Error
Callback Error

ให้ดู Server Console

เน้น Error แรก

เพราะ Error ชุดยาวอาจมาจาก Root Cause เดียว เช่น

oxmysql ไม่ Connect

แล้ว Qbox Resources อีก 20 ตัว Error ตาม

58. วิธีรู้ว่า Base Qbox พร้อมจริง

ก่อนลง Paid/Custom Scripts ควรผ่าน

FXServer เปิดได้
↓
MariaDB Connected
↓
ox_lib ทำงาน
↓
ox_inventory ทำงาน
↓
qbx_core Start
↓
เข้า Server
↓
สร้าง Character
↓
Spawn
↓
Money โหลด
↓
Job โหลด
↓
Inventory ทำงาน
↓
Reconnect
↓
ข้อมูลยังอยู่

เมื่อครบจึงถือว่า Clean Base พร้อม

59. Backup หลัง Base ใช้งานได้

เมื่อ Server ใช้งานได้แล้ว ให้ Backup

server.cfg
ox.cfg
voice.cfg
permissions.cfg
resources/
Database
txAdmin Profile

ตั้งชื่อ Backup เช่น

qbox-clean-base-working

จุดนี้มีค่ามาก

เพราะเมื่อเพิ่ม Script ใหม่แล้ว Server พัง คุณสามารถย้อนกลับไปยัง Base ที่รู้ว่าใช้งานได้

60. อย่าลง Script 100 ตัวพร้อมกัน

หลัง Clean Base ทำงาน ควรใช้ Workflow

Install Script A
↓
Test
↓
Backup/Commit

Install Script B
↓
Test

ไม่ใช่

Download 100 Scripts
↓
ใส่ทั้งหมด
↓
Restart
↓
Console มี 500 Errors

Server ที่สร้างเป็นระบบตั้งแต่แรกจะดูแลง่ายกว่าในระยะยาวมาก

Script QBCore ใช้กับ Qbox ได้ไหม

หลาย Resource ใช้ได้ผ่าน QB Bridge

แต่ต้องตรวจว่า Script

ใช้ Public QBCore API
ไม่แก้ qb-core Internals
ไม่ Query Core Tables โดยตรงแบบผิด Architecture
ไม่ใช้ Undocumented API

หากมี Native Qbox Support ให้เลือก Native Integration ก่อน

ตัวอย่าง Config

Config.Framework = 'qbox'

จะเหมาะกว่าบังคับใช้ QBCore Mode ถ้า Developer รองรับ Qbox จริง

อย่าลง qb-core เพิ่มเพื่อให้ QBCore Script ทำงาน

Current qbx_core มี

QB Bridge

และ Manifest มี

provide 'qb-core'

ดังนั้นถ้า QB Script ไม่ทำงานบน Qbox ให้ตรวจ Compatibility ก่อน

ไม่ใช่ติดตั้ง

qb-core
+
qbx_core

พร้อมกันทันที

ปัญหาอาจอยู่ที่ Script ใช้ API ที่ Qbox Bridge ไม่รองรับ

Qbox Script ขึ้น Missing Dependency

ถ้า Console แจ้ง

Missing dependency ox_lib

หรือ Resource อื่น

ให้ตรวจ

Resource มีอยู่หรือไม่
Folder Name ถูกหรือไม่
fxmanifest.lua มีหรือไม่
Version ถูกหรือไม่
Start สำเร็จหรือไม่

อย่าลบ Dependency จาก Manifest เพียงเพื่อให้ Resource Start

เพราะ Code ยังอาจเรียก API ของ Dependency นั้นอยู่

Qbox ขึ้น ox_inventory version too old

ให้ Update

ox_inventory

ไป Version ที่ Current Qbox Core รองรับ

Current Source ขณะนี้ตรวจขั้นต่ำที่

2.42.1

หรือใหม่กว่า

แต่ Version Minimum สามารถเปลี่ยนในอนาคตได้

ดังนั้นให้ยึด Error จาก Current qbx_core และ Official Recipe เป็นหลัก

Qbox ขึ้น ox_lib version too old

หลักเดียวกัน

Current Core ตรวจขั้นต่ำ

ox_lib 3.20.0

หรือใหม่กว่า

ไม่ควร Patch Core เพื่อลด Requirement

Qbox Update และ Dependency Update ควรทดสอบเป็นชุดบน Test Server

Qbox ขึ้น inventory framework error

ถ้าเจอ

inventory:framework must be set to "qbx"

ให้เปิด

ox.cfg

แล้วตรวจ

setr inventory:framework "qbx"

นี่เป็น Configuration Error ไม่ใช่ Source Code Error

Qbox ขึ้น OneSync Infinity Error

ถ้า

OneSync Infinity is not enabled

ให้ตรวจ txAdmin/Server Configuration

Official Qbox Recipe เปิด OneSync ให้แล้วตาม Recipe

หากคุณเอา server.cfg เก่ามาทับ Current Config อาจทำค่าหาย

จึงควรเปรียบเทียบกับ Official Recipe ก่อนแก้ Core

ติดตั้ง Qbox แบบ Manual ได้ไหม

ทำได้ แต่ไม่ใช่ตัวเลือกแรกสำหรับมือใหม่

ต้องจัดการเองทั้ง

MariaDB
oxmysql
ox_lib
ox_inventory
ox_target
qbx_core
Qbox Resources
SQL
Configs
Permissions
Voice
Start Order

และต้องเลือก Version ที่เข้ากัน

Manual Installation เหมาะกับ

DevOps
Custom Deployment
Docker
Infrastructure as Code
Minimal Server Stack
Version Pinning

มากกว่า

Manual Install ต้องระวังอะไรที่สุด

สิ่งที่มักพังคือ

Version Mismatch

ตัวอย่าง

qbx_core ใหม่
+
ox_inventory เก่า

หรือ

qbx_core ใหม่
+
ox_lib เก่า

Core ปัจจุบันมี Version Checks เพื่อช่วยป้องกันปัญหาแบบนี้อยู่แล้ว

จึงไม่ควรเอา Resource Folder จาก Server Pack คนละยุคมาผสมกัน

อย่าแก้ qbx_core โดยตรงหากไม่จำเป็น

Official Qbox Project แนะนำไม่ให้แก้ Core นอก Configuration Files หากไม่จำเป็น

Architecture ที่ควรใช้คือ

qbx_core
↓
Exports / Modules / Events
↓
Custom Resource

แทน

เปิด qbx_core
↓
แก้ Player Functions
↓
แก้ Database
↓
แก้ Events

จน Core แตกต่างจาก Official Version

เพราะเมื่อ Update จะ Merge ยากมาก

Production Server ควรแยก Test Server

ก่อน Update

qbx_core
ox_lib
ox_inventory
oxmysql
Qbox Resources

ควรมี Test Environment

Workflow ที่ดีคือ

Backup Production
↓
Clone Database
↓
Update Test
↓
ทดสอบ Character
↓
ทดสอบ Inventory
↓
ทดสอบ Money
↓
ทดสอบ Jobs
↓
ทดสอบ Paid Scripts
↓
ค่อย Update Production

Framework Core ไม่ควรถูกทดลองครั้งแรกบน Production Server

Checklist ติดตั้ง Qbox FiveM

FXServer

• Artifact ปัจจุบัน

• txAdmin ทำงาน

• Cfx Account ถูก

• Server Registration Key ถูก

Database

• ใช้ MariaDB

• Version ≥ 10.9.0

• Server ใหม่ควรพิจารณา Current LTS

• Database User ถูก

• Password ถูก

• Connection String ถูก

• Database Connection สำเร็จ

OX

• ox_lib ถูก Version

• oxmysql ทำงาน

• ox_inventory ถูก Version

• ox_target ทำงาน

• inventory:framework = qbx

Qbox

• qbx_core Start

• OneSync เปิด

• QB Bridge ตั้งตามต้องการ

• ไม่มี Critical Startup Error

Player

• เข้า Server ได้

• Character สร้างได้

• Spawn ได้

• Citizen ID มี

• Money โหลด

• Job โหลด

• Gang/Group โหลด

• Inventory โหลด

• Reconnect แล้วข้อมูลยังอยู่

Debug

• Server Console สะอาด

• F8 ไม่มี Critical Error

• ไม่มี Missing Dependency

• ไม่มี SQL Error

• ไม่มี Version Error

เมื่อผ่านรายการนี้จึงค่อยติดตั้ง Custom Scripts

วิธีติดตั้ง Qbox แบบสั้นที่สุด

ถ้าต้องการเฉพาะขั้นตอนหลัก ให้ทำตามนี้

① ติดตั้ง MariaDB รุ่นที่ Qbox รองรับ

② สร้าง Database และ Database User

③ ดาวน์โหลด FiveM Server Artifact ปัจจุบัน

④ แตกไฟล์ Server

⑤ เปิด FXServer.exe

⑥ เข้า txAdmin

⑦ Link Cfx Account

⑧ สร้าง Server Profile

⑨ เลือก Popular Recipes

⑩ เลือก QBox Framework

⑪ ใส่ Database Connection

⑫ ใส่ Server Registration Key

⑬ Run Recipe

⑭ รอ SQL และ Resources ติดตั้งครบ

⑮ Save & Run Server

⑯ ตรวจ ox_lib

⑰ ตรวจ oxmysql

⑱ ตรวจ ox_inventory

⑲ ตรวจ qbx_core

⑳ ตรวจ OneSync

㉑ เข้า Server

㉒ สร้าง Character

㉓ ทดสอบ Money / Job / Inventory

㉔ Reconnect ตรวจ Persistence

㉕ Backup Clean Base

㉖ ค่อยเพิ่ม Custom Scripts ทีละตัว

สรุปวิธีติดตั้ง Qbox FiveM

สำหรับ FiveM Server ใหม่ วิธีติดตั้ง Qbox ที่แนะนำที่สุดคือ

FXServer
+
txAdmin
+
Official QBox Framework Recipe
+
MariaDB

ไม่ควรเริ่มต้นด้วย XAMPP/MySQL ตาม Tutorial เก่า เพราะ Qbox Documentation ปัจจุบันระบุชัดว่า Framework Target MariaDB และกำหนดขั้นต่ำไว้ที่

MariaDB 10.9.0

ขณะที่ Server ใหม่ในปี 2026 ควรพิจารณา LTS รุ่นที่ Qbox แนะนำในเอกสารปัจจุบัน

Qbox Stack ยังเชื่อมกับ OX ecosystem อย่างใกล้ชิด โดย Current qbx_core พึ่งระบบสำคัญอย่าง

ox_lib
oxmysql
ox_inventory

และ Official Recipe ยังติดตั้ง ox_target รวมถึง Qbox Resources อื่นให้ด้วย

Current Core มี Startup Checks ที่ช่วยตรวจปัญหา เช่น

ox_lib version ต่ำเกินไป
ox_inventory version ต่ำเกินไป
inventory:framework ไม่ใช่ qbx
OneSync ไม่เปิด

ดังนั้นถ้าเจอ Error เหล่านี้ให้แก้ Dependency หรือ Configuration ตามข้อความ ไม่ควรลบ Check ออกจาก Coreเพื่อบังคับให้ Server เปิด

อีกจุดสำคัญคือ Qbox มี QB Compatibility Bridge และ qbx_core สามารถ provide 'qb-core' สำหรับ Compatibility บางส่วน จึงไม่ควรติดตั้ง qb-core คู่กับ qbx_core เพียงเพื่อให้ QBCore Script ทำงาน ก่อนอื่นควรตรวจว่า Resource รองรับ Qbox Native หรือ QB Bridge หรือไม่

แนวทางของ comsiam คือหลัง Recipe ติดตั้งเสร็จ อย่ารีบลง Script เพิ่ม ให้พิสูจน์ Clean Base ก่อนตามลำดับ Database → OX → qbx_core → Character → Money → Job → Inventory → Reconnect แล้ว Backup ทันที

สำหรับ Production Server comsiam แนะนำให้รักษา qbx_core ให้ใกล้ Official Version และทำ Customization ผ่าน Resources, Exports, Modules หรือ Bridges แยกออกมา เพราะเมื่อ Qbox หรือ OX dependencies อัปเดตในอนาคต Server จะ Maintenance และ Migration ง่ายกว่าการแก้ Core โดยตรงจำนวนมาก