Installation Guide

คู่มือการติดตั้ง NC Core และ NC Addons แบบทีละขั้นตอน

Installation Guide

หน้านี้เป็นคู่มือสำหรับติดตั้ง NC Core (es_extended) และตั้งค่าพื้นฐานให้ใช้งานได้ทันที

ลำดับการติดตั้งจะเน้น 3 เรื่อง: วางไฟล์ให้ถูกที่, เตรียมฐานข้อมูล, และจัดลำดับ ensure ให้ถูกต้อง

Requirements

• Server: เปิดใช้ OneSync

• Database: MySQL / MariaDB

• Database Driver: oxmysql

• Resource: spawnmanager

Optional

• NC Addons v1.0.1+ (จำเป็นเฉพาะบางฟีเจอร์ เช่น Max Player Optimization)

สิ่งที่ควรเตรียมก่อนเริ่ม

• สิทธิ์เข้าถึงไฟล์เซิร์ฟเวอร์ (FTP/RDP/SSH)

• สิทธิ์ import ฐานข้อมูล (phpMyAdmin หรือ command line)

• รู้ตำแหน่ง artifact folder ของ FiveM (กรณีติดตั้ง NC Addons)

ข้อกำหนดของระบบ

ต้องมี

• FiveM Server ที่เปิดใช้งาน OneSync Infinity

• MySQL / MariaDB

แนะนำ

• NC Addons v1.0.1+ (ใช้เมื่อเปิด Max Player Optimization และต้องติดตั้งให้ตรง OS)

• nc_notify (ระบบแจ้งเตือน)

NC Core สามารถทำงานได้ตามปกติแม้ไม่ติดตั้ง NC Addons

แต่บางฟีเจอร์ (เช่น Config.Player.UseMaxOptimization) ต้องใช้ NC Addons v1.0.1+ และต้อง import @es_extended/imports.lua

ขั้นตอนการติดตั้ง

1

ดาวน์โหลด NC Core

วางโฟลเดอร์ es_extended ไว้ใน resources/ ของเซิร์ฟเวอร์

📁 server-data/
└── 📁 resources/
    └── 📁 es_extended/
        ├── fxmanifest.lua
        ├── nc_core.sql
        ├── 📁 client/
        ├── 📁 server/
        └── ...

ควรใช้ชื่อโฟลเดอร์เป็น es_extended ตามมาตรฐาน เพื่อความเข้ากันได้ของ resource อื่น ๆ

2

(ทางเลือก) ติดตั้ง NC Addons

NC Addons คือ artifact เสริมสำหรับเปิดใช้ความสามารถบางส่วนของ NC Core เช่น Max Player Optimization (Beta)

1) ดาวน์โหลด

ดาวน์โหลดจาก GitHub Releases:

• https://github.com/NC-Developer-FiveM/nc-addons/releases/tag/v1.0.1

• ไฟล์ addons.zip

2) แตกไฟล์และเลือก OS

แตกไฟล์ addons.zip จะได้ 2 โฟลเดอร์:

📁 addons/
├── 📁 linux/          (สำหรับ Linux Server)
│   ├── libscripting-server.json
│   └── libscripting-server.so
│
└── 📁 windows/        (สำหรับ Windows Server)
    └── scripting-server.dll

เลือกโฟลเดอร์ตาม OS ของเซิร์ฟเวอร์:

• ใช้ Linux Server → ใช้ไฟล์จาก folder linux/

• ใช้ Windows Server → ใช้ไฟล์จาก folder windows/

3) คัดลอกไฟล์ไปวางทับใน artifact folder

Linux

# คัดลอกไฟล์จาก linux/ ไปยัง artifact directory
# Path มาตรฐานของ FiveM Linux: fx/alpine/opt/cfx-server
cp linux/* /path/to/fx/alpine/opt/cfx-server/

Windows

# คัดลอกไฟล์จาก windows/ ไปยัง artifact directory
copy windows\* C:\path\to\your\fivem-server-artifact\

ตัวอย่างโครงสร้าง (ตำแหน่ง artifact อาจต่างกันตามเครื่อง):

Linux:

📁 server-data/
├── 📁 fx/
│   └── 📁 alpine/
│       └── 📁 opt/
│           └── 📁 cfx-server/         ← วางไฟล์ตรงนี้ (Linux)
│               ├── fxserver
│               ├── libscripting-server.so     ← ไฟล์ที่วางทับ
│               ├── libscripting-server.json   ← ไฟล์ที่วางทับ
│               └── ...
│
├── 📁 resources/
│   └── 📁 es_extended/
│
└── server.cfg

Windows:

📁 FXServer/              (หรือ server-data/)
├── 📁 alpine/            (artifact folder)
│   ├── fxserver.exe
│   ├── scripting-server.dll     ← วางทับไฟล์ตรงนี้ (Windows)
│   └── ...
│
├── 📁 resources/
│   └── 📁 es_extended/
│
└── server.cfg

หลังจากคัดลอกแล้ว ไฟล์ใหม่จะทับไฟล์เดิมของ FiveM artifact และเปิดใช้ความสามารถเพิ่มเติม

4) (Linux เท่านั้น) เพิ่มสิทธิ์การรันไฟล์

Linux ต้องเพิ่มสิทธิ์รันไฟล์ก่อนเปิดเซิร์ฟเวอร์

chmod +x libscripting-server.so

3

ติดตั้ง Database

Import ไฟล์ SQL เพื่อสร้างตารางที่จำเป็น (อยู่ที่ resources/es_extended/nc_core.sql)

ตารางหลักที่จะถูกสร้าง:

• users - ข้อมูลผู้เล่น

• accounts - บัญชีเงินของผู้เล่น (money, bank)

• items - รายการ Item ทั้งหมด

• job_grades - ระดับตำแหน่งงาน

• jobs - ข้อมูลอาชีพ

• และอื่นๆ

แนะนำให้ตั้งค่า charset/collation เป็น utf8mb4 เพื่อรองรับภาษาไทยและอีโมจิ

4

ตั้งค่า Server Configuration

เพิ่ม resource ใน server.cfg:

# NC Core Framework
ensure es_extended

# (Optional) NC Notify สำหรับระบบแจ้งเตือน
ensure nc_notify

ต้อง ensure es_extended ก่อน resource ใด ๆ ที่เรียกใช้งาน Framework

ตัวอย่างสิ่งที่ถือว่า “เรียกใช้งาน Framework”: ESX.*, exports['es_extended']:*, trigger callback/event, หรือ import @es_extended/imports.lua

ตัวอย่างลำดับ resource แบบเต็ม (ขยายดู)

# ========================================
# NC CORE FRAMEWORK (ต้องอยู่บนสุด) {#nc-core-position}
# ========================================
ensure es_extended

# ========================================
# RESOURCES ที่ใช้งาน NC CORE
# ========================================
ensure nc_discordlogs
ensure nc_itemset
ensure nc_economy
ensure nc_notify
ensure nc_playersname
ensure nc_proximityradius
ensure nc_inventory
ensure nc_squad
ensure nc_stealjobs
ensure nc_vault
ensure nc_indicators
ensure nc_vehiclekey
ensure nc_vehiclestorage
ensure nc_garage_images
ensure nc_garage
ensure nc_thief
ensure nc_crafting
ensure nc_itemsfusion
ensure nc_minigames
ensure nc_tradingjobs
ensure nc_musicplayers_props
ensure nc_musicplayers
ensure nc_quests
ensure nc_radiolist
ensure nc_baccarat_props
ensure nc_sicbo_props
ensure nc_sicbo
ensure nc_baccarat
ensure nc_tattoos

5

ตั้งค่า Configuration Files

ไฟล์ config ทั้งหมดอยู่ในโฟลเดอร์ config/ และสามารถปรับได้ตามต้องการ

ไฟล์ที่ใช้บ่อย:

• config.general.lua - การตั้งค่าทั่วไปของ Framework

• config.player.lua - การตั้งค่าเกี่ยวกับผู้เล่น (เงินเริ่มต้น, น้ำหนักกระเป๋า)

• config.database.lua - การเชื่อมต่อฐานข้อมูล

• config.locale.lua - ภาษา

• config.modules.lua - เปิด/ปิดโมดูล

• config.status.lua - สถานะ (ความหิว, ความกระหาย)

• config.weapons.lua - อาวุธและส่วนประกอบ

• config.skinchanger.lua - ระบบหน้าตาตัวละคร

ตัวอย่างการปรับแต่งเงินเริ่มต้น:

-- config/config.player.lua
Config.StartingAccountMoney = {
    money = 5000,        -- เงินสด 5,000 บาท
    bank = 50000,        -- เงินในธนาคาร 50,000 บาท
    black_money = 0      -- เงินดำ 0 บาท
}

(Optional) เปิด Max Player Optimization (Beta)

หากไม่เปิด ระบบจะทำงานได้ตามปกติ

เปิดใช้โหมดนี้ต้องเรียก @es_extended/imports.lua และต้องมี NC Addons v1.0.1+

-- config/config.player.lua
Config.Player.UseMaxOptimization = true

อ่านรายละเอียดและข้อควรระวังเพิ่มเติมที่หน้า Max Player Optimization (Beta)

6

ทดสอบการติดตั้ง

ตรวจสอบทั้งฝั่ง Server และ Client เพื่อยืนยันว่า Framework ทำงานสมบูรณ์

1) เปิดเซิร์ฟเวอร์

./run.sh +exec server.cfg    # Linux
FXServer.exe +exec server.cfg  # Windows

2) ตรวจสอบ Server Console

ตรวจสอบว่าไม่มี error ที่เกี่ยวข้องกับ Framework/NC Core ระหว่างบูตเซิร์ฟเวอร์

3) เข้าเกมและยืนยันการ Spawn

เข้าเกมจนผ่านหน้าโหลดตัวละคร และต้อง spawn ได้ตามปกติ

4) ตรวจสอบ Client Console (F8)

เปิด F8 แล้วตรวจสอบ error ใหม่ โดยโฟกัสที่ Framework/NC Core

ตัวอย่าง error ที่พบบ่อย:

• ESX is nil

• attempt to index a nil value (global 'ESX')

มักเกิดจากการเรียกใช้งานก่อน es_extended พร้อมใช้งาน หรือการเรียกใช้งานผิดลำดับ ensure

ติดตั้งสำเร็จ คุณสามารถเริ่มใช้งาน NC Core เพื่อพัฒนา resource ได้แล้ว

ขั้นตอนถัดไป (หลังติดตั้งสำเร็จ)

• ไปที่ Framework usage เพื่อเลือกวิธี import ที่เหมาะกับ resource ของคุณ

• ไปที่ Custom functions ถ้าต้องการ extend ฟังก์ชันแบบไม่แก้ไฟล์ core

• ดู Player class overview ถ้าต้องใช้เมทอดของ xPlayer บ่อย ๆ

การแก้ปัญหาที่พบบ่อย

ปัญหา: Server ไม่สามารถเริ่มต้นได้

สาเหตุที่พบบ่อย

• ติดตั้ง NC Addons ไม่ตรง OS

• วางไฟล์ไม่ตรง artifact folder (เฉพาะกรณีที่ติดตั้ง NC Addons)

แนวทางแก้ไข

1. ตรวจสอบว่าเลือกโฟลเดอร์ linux/ หรือ windows/ ให้ตรงกับเซิร์ฟเวอร์

2. ตรวจสอบว่าไฟล์ถูกวางทับใน artifact folder ที่ถูกต้อง

3. หากยังไม่จำเป็นต้องใช้ฟีเจอร์ที่พึ่ง NC Addons ให้ถอดออก แล้วทดสอบอีกครั้ง

ปัญหา: ESX is nil

สาเหตุ

• Resource เริ่มทำงานก่อน es_extended

แนวทางแก้ไข

1. ตรวจสอบ server.cfg ว่า ensure es_extended อยู่บนสุด

2. หากเป็น resource เก่าที่ดึง ESX เอง ให้ปรับไปใช้ @es_extended/imports.lua ตามหน้า Framework usage

ปัญหา: Database connection failed

สาเหตุ

• ตั้งค่าฐานข้อมูลไม่ถูกต้อง

• MySQL/MariaDB ไม่ได้ทำงานอยู่

แนวทางแก้ไข

1. ตรวจสอบ config/config.database.lua

2. ตรวจสอบสถานะ service ของ MySQL/MariaDB

3. ตรวจสอบ host/user/password/database ว่าตรงกับฐานข้อมูลจริง

ต้องการความช่วยเหลือ? เปิด Ticket บน Discord ทางการ

Support

ติดต่อทีมงานผ่าน Ticket บน Discord ทางการ

• Discord: https://discord.gg/ncdeveloper

เพื่อความเร็ว โปรดแนบรูปภาพ ตอนบูตเซิร์ฟเวอร์ + error ที่พบ (Server console/F8)