Introduction

ภาพรวม NC Core, ฟีเจอร์หลัก, โครงสร้างโปรเจ็กต์ และลิงก์สำหรับเริ่มต้นใช้งาน

ภาพรวม

NC Core เป็น Framework สำหรับเซิร์ฟเวอร์ FiveM ที่ได้รับการออกแบบโครงสร้างใหม่ทั้งหมด เพื่อเพิ่มประสิทธิภาพการทำงาน ลดภาระการประมวลผลฝั่งเซิร์ฟเวอร์ และยกระดับความเสถียรของระบบโดยรวม ระบบนี้รองรับการทำงานร่วมกับสคริปต์ในกลุ่ม ESX ภายใต้แนวทางที่กำหนดไว้

คู่มือฉบับนี้จัดทำขึ้นเพื่อให้ครอบคลุมฟังก์ชันหลัก โมดูล และ Methods ของ Player Class (xPlayer) โดยเนื้อหาได้รับการจัดหมวดหมู่อย่างเป็นระบบ เพื่อสะดวกในการอ้างอิงและนำไปประยุกต์ใช้ในทรัพยากร (Resource) ได้ทันที

ความเข้ากันได้ (Compatibility)

• OneSync: Infinity

• ภาษา: Lua (FiveM/CitizenFX)

• เวอร์ชันที่ใช้งาน: ตรวจสอบได้จาก fxmanifest.lua ในโฟลเดอร์ Resource

ความสามารถหลัก

• การจัดการผู้เล่น (Player Management) — จัดการบัญชีเงิน กระเป๋า อาวุธ อาชีพ และ Metadata

• ระบบ Callback — การสื่อสารระหว่าง Client และ Server อย่างเป็นระบบ พร้อมลดโค้ดซ้ำซ้อน

• รองรับ OneSync — ออกแบบให้เหมาะสมกับ OneSync Infinity

• ระบบสถานะ (Status) — รองรับระบบ Hunger และ Thirst พร้อมรองรับการปรับแต่งเพิ่มเติม สามารถเพิ่มสถานะต่าง ๆ ได้ เป็นระบบจัดการเรื่องค่าสถานะของผู้เล่น โดยไม่ต้องพึ่งพาทรัพยากรแยก

• ระบบบันทึกข้อมูลผู้เล่น — บันทึกค่าเลือด เกราะ และสถานะการเสียชีวิตหรือมีชีวิตอยู่ของผู้เล่นโดยอัตโนมัติภายในตัว Framework โดยไม่ต้องพึ่งพาทรัพยากรแยก

• เครื่องมือ UI — เมนู การแจ้งเตือน และ Utilities ฝั่ง Client สำหรับงานทั่วไป

• ตัวช่วย Streaming — โหลด Asset แบบมีโครงสร้าง พร้อมแนวทางจัดการ Timeout

• ฟังก์ชันเสริม — Utilities สำหรับ Math, String และ Table เพื่องานทั่วไป

ตัวอย่างการใช้งานเบื้องต้น

Server

-- ดึงข้อมูล xPlayer จาก Server ID
local xPlayer = ESX.GetPlayerFromId(source)

-- เพิ่มเงินให้ผู้เล่น
xPlayer.addAccountMoney('money', 5000, 'เงินเดือน')

-- ตัวอย่าง: ลงทะเบียน Item ที่สามารถใช้งานได้
ESX.RegisterUsableItem('bread', function(playerId, itemName)
    local xTarget = ESX.GetPlayerFromId(playerId)
    xTarget.removeInventoryItem(itemName, 1)
    TriggerClientEvent('esx_status:add', playerId, 'hunger', 200000)
end)

Client

Shared

หากต้องการรูปแบบการ Import ที่แนะนำ (imports.lua) โปรดศึกษาเพิ่มเติมที่หน้า Framework Usage

โครงสร้างโปรเจ็กต์

Directory	Description
functions/	ฟังก์ชันหลักของ Framework (Client/Server/Shared)
modules/	โมดูลเสริม (Game/Streaming/UI ฯลฯ)
server/classes/	Player Class และ Methods ของ xPlayer
config/	ไฟล์กำหนดค่าระบบ
client/	โค้ดหลักฝั่ง Client
server/	โค้ดหลักฝั่ง Server
lib/	ไลบรารีที่สามารถปรับแต่งได้

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

โปรดศึกษารายละเอียดการติดตั้งอย่างครบถ้วนที่หน้า Installation Guide

รายการตรวจสอบขั้นต่ำมีดังนี้:

1. วาง es_extended ลงในโฟลเดอร์ resources/

2. (ทางเลือก) ติดตั้ง NC Addons v1.0.1+ ให้ตรงกับ OS และวางไฟล์ใน Artifact Folder (เมื่อต้องการเปิดฟีเจอร์เสริมบางอย่าง)

3. Import nc_core.sql เข้าสู่ฐานข้อมูล

4. กำหนดค่า ensure es_extended ที่ลำดับต้น ๆ ของ server.cfg

5. ปรับค่าใน config/ ตามความต้องการของเซิร์ฟเวอร์

ข้อสำคัญ

NC Addons ไม่จำเป็นสำหรับการใช้งานพื้นฐานของ NC Core

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

Support

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

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

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