Getting Started

เริ่มต้นใช้งาน NC Core และตัวอย่างพื้นฐาน

Getting Started

หน้านี้สรุปลำดับการเริ่มใช้งาน NC Core หลังติดตั้งเสร็จ

เนื้อหาถูกจัดเป็นขั้นตอน เพื่อให้ตั้งค่าถูกต้องตั้งแต่รอบแรก

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

• ทำตาม Installation Guide จนจบทุกขั้น

• เตรียมฐานข้อมูลที่รองรับ utf8mb4 และสามารถเชื่อมต่อได้จากตัวเซิร์ฟเวอร์

• ตรวจสอบว่า server.cfg สามารถกำหนดลำดับ ensure ได้ตามต้องการ

ขั้นตอนเริ่มใช้งาน (แนะนำ)

1

ติดตั้งและตรวจสอบให้สมบูรณ์

ดำเนินการตาม Installation Guide ให้ครบทุกขั้น

ตรวจสอบ 3 จุดที่พลาดบ่อยที่สุด:

• (หากเลือกติดตั้ง) ติดตั้ง NC Addons ไม่ตรง OS หรือวางไฟล์ไม่ตรง artifact folder

• ensure es_extended ไม่อยู่ลำดับบนสุดของ server.cfg

• Import nc_core.sql ไม่ครบ หรือฐานข้อมูลไม่ได้เป็น utf8mb4

2

เลือกวิธีนำ Framework ไปใช้ใน resource

อ่านและเลือกแนวทางที่เหมาะสมที่หน้า Framework usage

แนวทางที่แนะนำ:

• Resource ใหม่: ใช้ @es_extended/imports.lua

• Resource เดิม: ใช้ trigger/exports ตามเดิม และวางแผนปรับเป็น imports.lua ภายหลัง

3

อ่านหัวข้ออ้างอิงสำหรับงานพัฒนา

• Player class overview: ภาพรวมเมทอดสำคัญของ xPlayer

• Custom functions: เพิ่ม/override ฟังก์ชันโดยไม่แก้ไขไฟล์แกนหลักของ NC Core

ตรวจสอบหลังติดตั้ง (Checklist)

หากเริ่มเซิร์ฟเวอร์แล้วไม่มั่นใจว่าพร้อมใช้งาน ให้ตรวจสอบรายการต่อไปนี้

1. คอนโซลของเซิร์ฟเวอร์แสดงว่า es_extended เริ่มทำงานสำเร็จ

2. เชื่อมต่อฐานข้อมูลสำเร็จ และไม่เกิด error ต่อเนื่อง

3. Resource ที่เรียกใช้งาน Framework ถูก ensure หลัง es_extended

ตัวอย่างลำดับที่แนะนำใน server.cfg:

ensure es_extended

# resource อื่น ๆ ที่เรียกใช้งาน Framework ต้องอยู่หลังจากนี้
ensure my_resource
ensure my_resource_2

หากต้องการเทมเพลตเริ่มต้นของ resource ให้ระบุประเภทการใช้งาน (Client-only / Server-only / Shared) เพื่อรับตัวอย่างโครงสร้างไฟล์ และบรรทัดที่ต้องกำหนดใน fxmanifest.lua

Support

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

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

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