Functions

รวมฟังก์ชันหลักของ NC Core ที่เรียกผ่าน ESX.* แยกตามฝั่ง Client และ Server (OneSync)

Functions

หมวดนี้รวม “ฟังก์ชันหลัก” ที่ NC Core เปิดให้เรียกผ่าน ESX.*

เนื้อหาจะแยกตามฝั่งการทำงาน เพื่อให้เลือกใช้งานได้ถูกบริบท

เหมาะสำหรับกรณีใด

• ต้องการเรียกใช้ API มาตรฐานของ Framework ใน resource ของคุณ

• ต้องการลดโค้ดซ้ำ โดยยึดการเรียกผ่าน ESX.* เป็นหลัก

• ต้องการทำระบบที่ต้องอ้างอิงข้อมูลผู้เล่น หรือเรียกใช้งานกับ entity ต่าง ๆ

ก่อนเริ่ม (แนะนำ)

• ตั้งค่าการเรียกใช้ Framework ให้ถูกต้องตาม Framework usage

• ถ้าจะใช้ฟังก์ชัน ESX.OneSync.* ให้เปิด OneSync ในเซิร์ฟเวอร์ FiveM ก่อน

อย่าเรียกใช้ฟังก์ชันฝั่ง Client จากฝั่ง Server (และกลับกัน) ให้แยกไฟล์ client.lua / server.lua ให้ชัดเจนเสมอ

ขอบเขตของ Functions

Client-side (ESX.*)

ใช้ในสคริปต์ฝั่งผู้เล่น เช่น

• ดึงข้อมูลผู้เล่นปัจจุบัน (ESX.GetPlayerData, accounts, inventory, job)

• ตรวจสอบความพร้อมของข้อมูล (ESX.IsPlayerLoaded, ESX.IsPlayerReady)

• จัดการ UI/Keybind/สถานะ และเรียก Server ผ่าน callback

Server-side (OneSync) (ESX.OneSync.*)

ใช้ในสคริปต์ฝั่งเซิร์ฟเวอร์ สำหรับค้นหา/จัดการ entity แบบ networked เช่น

• หา player/entity ใกล้สุด หรือในระยะที่กำหนด

• spawn vehicle/ped/object ผ่าน OneSync

เนื้อหาในหมวดนี้

หัวข้อ

Client

อ่านต่อ

Client

หัวข้อ

Server (OneSync)

อ่านต่อ

Server (OneSync)

แนวทางการใช้งาน (Best practices)

• ให้ Server เป็นแหล่งข้อมูลจริง (source of truth) เสมอ โดยเฉพาะเงิน/Item/สิทธิ์

• ฝั่ง Client ให้เช็ค ESX.IsPlayerReady() ก่อนอ่าน ESX.GetPlayerData()

• ลด loop ถี่ ๆ และหลีกเลี่ยงการคำนวณหนักบน Client โดยไม่จำเป็น

• ใช้ callback/event ให้เหมาะกับข้อมูลที่ “ต้องเชื่อถือ” และข้อมูลที่ “แสดงผล”

ควรเริ่มอ่านจากหน้าไหน (ขยายดู)

• เขียนสคริปต์ทั่วไปที่ต้องอ่านข้อมูลผู้เล่นและทำ UI → เริ่มที่ Client

• ทำระบบที่ต้องค้นหา player/vehicle/ped/object ในระยะ และ spawn entity → ไปที่ Server (OneSync)

Support

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

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

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