คู่มือนี้ครอบคลุมวิธีการติดตั้ง resources (สคริปต์) บนเซิร์ฟเวอร์ FiveM ของคุณ, การตั้งค่าฐานข้อมูล MySQL สำหรับเฟรมเวิร์กอย่าง ESX หรือ QBCore, และการทำความเข้าใจลำดับการโหลด resource หากคุณยังไม่ได้ทำการตั้งค่าเซิร์ฟเวอร์เริ่มต้นให้เสร็จ ให้เริ่มต้นที่ คู่มือการตั้งค่าเซิร์ฟเวอร์ FiveM ก่อน

การติดตั้ง Resources และ Scripts

เซิร์ฟเวอร์ FiveM ขยายความสามารถด้วย resources (เรียกอีกอย่างว่า scripts) Resources เพิ่มฟีเจอร์ต่าง ๆ เช่น ตัวแทนจำหน่ายรถ, อาชีพ, องค์ประกอบ HUD, เฟรมเวิร์ก และอื่น ๆ

วิธีการติดตั้ง Resource

1. ดาวน์โหลด resource จากแหล่งที่มา (GitHub, ฟอรัม Cfx.re, Tebex ฯลฯ)
2. แตกโฟลเดอร์ resource จาก ZIP/ไฟล์เก็บถาวรหากจำเป็น
3. อัปโหลดโฟลเดอร์ resource ไปยังไดเรกทอรี resources/ ของเซิร์ฟเวอร์ของคุณโดยใช้แท็บ Files ของ GPanel หรือผ่าน SFTP
4. เปิด server.cfg และเพิ่มบรรทัด ensure สำหรับ resource:

# Add your custom resources
ensure my-new-resource

5. รีสตาร์ทเซิร์ฟเวอร์จาก GPanel หรือ TXAdmin เพื่อให้ resource โหลด

Resource Manifests

ทุก resource ที่ถูกต้องต้องมีไฟล์ manifest Resources สมัยใหม่ใช้ fxmanifest.lua ในขณะที่ resource เก่ากว่าใช้ __resource.lua หากโฟลเดอร์ resource ที่ดาวน์โหลดมาไม่มีไฟล์ใดไฟล์หนึ่งเหล่านี้ resource จะไม่โหลด การดาวน์โหลดบางรายการจะซ้อนโฟลเดอร์ resource จริงไว้ภายในโฟลเดอร์ด้านนอก — ตรวจสอบให้แน่ใจว่าโฟลเดอร์ที่คุณวางใน resources/ คือโฟลเดอร์ที่มี manifest

ลำดับการโหลด Resource

Resources โหลดตามลำดับที่ปรากฏใน server.cfg หาก resource ขึ้นอยู่กับอีก resource หนึ่ง (ตัวอย่างเช่น สคริปต์อาชีพที่ขึ้นอยู่กับเฟรมเวิร์กอย่าง ESX หรือ QBCore) ตรวจสอบให้แน่ใจว่า dependency อยู่ในรายการ ก่อน resource ที่ต้องการ:

# 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 ด้วยโฟลเดอร์หมวดหมู่

คุณสามารถจัดระเบียบ resources ลงในโฟลเดอร์ย่อยภายในไดเรกทอรี resources/ ใช้สัญลักษณ์วงเล็บใน server.cfg เพื่อ ensure โฟลเดอร์หมวดหมู่ทั้งหมด:

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

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

วิธีนี้จะโหลดทุก resource ภายในโฟลเดอร์ย่อยที่ระบุชื่อ เป็นวิธีที่สะดวกในการจัดกลุ่มสคริปต์ที่เกี่ยวข้องโดยไม่ต้องระบุแต่ละรายการแยกกัน

การ Hot-Load Resources ผ่าน TXAdmin

คุณไม่จำเป็นต้องรีสตาร์ทเซิร์ฟเวอร์เต็มรูปแบบเสมอไปเพื่อโหลด resource ใหม่ TXAdmin สามารถเริ่ม หยุด และรีสตาร์ท resource แต่ละรายการได้จากหน้า Resources ของมัน หลังจากอัปโหลด resource ใหม่และเพิ่มบรรทัด ensure คุณสามารถรันคำสั่งต่อไปนี้ในคอนโซลสดของ TXAdmin:

refresh
ensure my-new-resource

คำสั่ง refresh บอกให้เซิร์ฟเวอร์สแกนไดเรกทอรี resources/ ใหม่เพื่อหารายการใหม่

การตั้งค่าฐานข้อมูล (MySQL / MariaDB)

เฟรมเวิร์กและ resources ของ FiveM หลายรายการ (เช่น ESX, QBCore หรือ vRP) ต้องการฐานข้อมูล MySQL หรือ MariaDB Legion Hosting ให้ข้อมูลรับรองฐานข้อมูลพร้อมกับเซิร์ฟเวอร์ของคุณ

การค้นหาข้อมูลรับรองฐานข้อมูลของคุณ

1. ใน GPanel ไปที่แท็บ Databases
2. หากยังไม่มีฐานข้อมูล ให้คลิก New Database เพื่อสร้าง
3. จดรายละเอียดต่อไปนี้:
   • Database Host (ที่อยู่และพอร์ต)
   • Database Name
   • Username
   • Password (คลิกไอคอนรูปตาเพื่อแสดง)

การกำหนดค่าการเชื่อมต่อฐานข้อมูล

รายละเอียดการเชื่อมต่อฐานข้อมูลถูกตั้งค่าใน server.cfg โดยใช้สตริงการเชื่อมต่อ รูปแบบที่แน่นอนขึ้นอยู่กับ resource MySQL ที่คุณใช้ แต่รูปแบบที่พบบ่อยที่สุดคือ:

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

แทนที่ placeholder ด้วยข้อมูลรับรองจริงของคุณจากแท็บ Databases ตัวอย่างเช่น:

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

การเลือก Resource MySQL

ไม่ว่าคุณจะใช้ resource MySQL ใด ต้องมีการ ensure ใน server.cfg ก่อน resources ใด ๆ ที่ขึ้นอยู่กับมัน:

# 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

พื้นฐานเฟรมเวิร์ก

เฟรมเวิร์กให้ระบบเกมเพลย์หลักที่ resources อื่น ๆ สร้างต่อ — สิ่งต่าง ๆ เช่น ตัวตนผู้เล่น, เงิน, คลังสิ่งของ, อาชีพ และยานพาหนะ เฟรมเวิร์ก FiveM ที่ได้รับความนิยมสองอันดับแรกคือ:

เฟรมเวิร์กส่วนใหญ่ติดตั้งผ่านระบบ recipe ของ TXAdmin ระหว่างการตั้งค่าเริ่มต้น หากคุณเลือก recipe อย่าง "QBCore" หรือ "ESX" ระหว่างการตั้งค่า TXAdmin เฟรมเวิร์กและ dependencies หลักของมันได้รับการติดตั้งแล้ว หากคุณต้องการติดตั้งเฟรมเวิร์กด้วยตนเอง ให้ทำตามเอกสารทางการของมัน:

• ESX Documentation
• QBCore Documentation

การขอความช่วยเหลือ

หากคุณต้องการความช่วยเหลือเกี่ยวกับการติดตั้ง resource หรือการกำหนดค่าฐานข้อมูล:

1. ตรวจสอบเอกสารหรือหน้า GitHub ของ resource สำหรับคำแนะนำในการติดตั้งและปัญหาที่ทราบ
2. ตรวจสอบคอนโซล GPanel หรือบันทึก TXAdmin ว่ามีข้อความแสดงข้อผิดพลาดหรือไม่
3. เปิดทิกเก็ตสนับสนุนที่ https://legionhosting.net/submitticket.php พร้อมข้อความแสดงข้อผิดพลาดของคุณและชื่อ resource ที่คุณกำลังพยายามติดตั้ง

บทความที่เกี่ยวข้อง

• คู่มือการตั้งค่าเซิร์ฟเวอร์ FiveM
• การแก้ไขปัญหา FiveM
• วิธีการอัปโหลดไฟล์ผ่าน SFTP
• วิธีการค้นหา IP และพอร์ตของเซิร์ฟเวอร์