Quickstart

คำแนะนำการติดตั้งและทดสอบ NC Developer resources อย่างรวดเร็วสำหรับผู้เริ่มต้น

คู่มือฉบับย่อสำหรับการติดตั้งและทดสอบ NC Developer resources อย่างรวดเร็วบน FiveM server

หน้านี้เหมาะสำหรับผู้ที่ต้องการ "ทำให้ resource ทำงานได้ก่อน" แล้วจึงค่อยกลับมาปรับแต่งรายละเอียดในภายหลัง สำหรับการตั้งค่าขั้นสูงและรายละเอียดเพิ่มเติม กรุณาดูที่หน้า Installation Guide ของ resource แต่ละตัว

หมายเหตุ: คู่มือนี้เป็นขั้นตอนพื้นฐานทั่วไป แต่ละ resource อาจมีข้อกำหนดเฉพาะเพิ่มเติม โปรดตรวจสอบเอกสารประกอบของ resource ที่ต้องการติดตั้งด้วยเสมอ

ขั้นตอนการติดตั้งอย่างรวดเร็ว

ทำตามขั้นตอนด้านล่างเพื่อติดตั้ง NC Developer resources อย่างถูกต้องและมีประสิทธิภาพ:

1

เตรียมความพร้อมของระบบ

ก่อนเริ่มติดตั้ง กรุณาตรวจสอบข้อกำหนดพื้นฐานต่อไปนี้:

• FiveM server สามารถเปิดและเข้าเกมได้ตามปกติ

• มีสิทธิ์ในการแก้ไขไฟล์ server.cfg

• สามารถเข้าถึงและอ่าน server console ได้

• Framework ที่ใช้งาน (ถ้ามี) ทำงานได้อย่างถูกต้องแล้ว

สำคัญ: หากคุณใช้งาน ESX หรือ QBCore กรุณาตรวจสอบให้แน่ใจว่า framework และฐานข้อมูลทำงานได้อย่างสมบูรณ์ก่อนติดตั้ง resources เพิ่มเติม การติดตั้ง resource ใหม่ขณะที่ framework ยังไม่พร้อมอาจทำให้เกิดปัญหาได้

2

วางไฟล์ Resource

ทำตามขั้นตอนดังนี้เพื่อวางไฟล์ resource ลงใน server:

1. ดาวน์โหลดไฟล์ - ดาวน์โหลด resource ที่ต้องการจากแหล่งที่ได้รับ

2. แตกไฟล์ - แตกไฟล์ zip/rar ให้ได้โฟลเดอร์ resource ที่มีไฟล์ fxmanifest.lua อยู่ภายใน

3. วางไฟล์ - วางโฟลเดอร์ resource ลงในโฟลเดอร์ resources/ ของ FiveM server

ตัวอย่างโครงสร้างโฟลเดอร์ที่ถูกต้อง

📁 server-data/
└── 📁 resources/
    └── 📁 nc-example/
        ├── fxmanifest.lua
        ├── 📁 config/
        │   └── config.lua
        ├── 📁 client/
        │   └── client.lua
        └── 📁 server/
            └── server.lua

ข้อควรระวัง: ตรวจสอบให้แน่ใจว่าโฟลเดอร์ที่คุณจะใช้คำสั่ง ensure คือโฟลเดอร์ที่มีไฟล์ fxmanifest.lua อยู่โดยตรง ไม่ใช่โฟลเดอร์ parent หรือ sub-folder ที่ผิดตำแหน่ง

3

เพิ่มคำสั่ง Ensure ใน Server.cfg

เปิดไฟล์ server.cfg และเพิ่มคำสั่ง ensure เพื่อให้ resource ทำงานตอนเปิด server:

server.cfg

# Framework และ Dependencies (ต้องโหลดก่อนเสมอ)
ensure es_extended
ensure ox_lib

# NC Developer Resources
ensure nc-core
ensure nc-example

ลำดับการโหลด Resource มีความสำคัญมาก:

• Dependencies ต้องมาก่อนเสมอ - Framework และ libraries ต้องโหลดก่อน resources ที่ต้องการใช้งาน

• ตรวจสอบลำดับก่อนเป็นอันดับแรก - หากพบ error แบบ ESX is nil, ox_lib not found, หรือ attempt to call a nil value ให้กลับมาตรวจสอบลำดับการโหลด resource ใน server.cfg ก่อน

• อ่านเอกสาร Dependencies - ตรวจสอบเอกสารของ resource เพื่อดูว่ามี dependencies อะไรบ้าง

4

การกำหนดค่าเริ่มต้น

ทำตามคำแนะนำในส่วน Installation Guide และ Configuration ของ resource ที่คุณกำลังติดตั้ง

สิ่งที่มักต้องกำหนดค่าในขั้นตอนนี้:

• Webhook URLs - สำหรับการส่ง logs ไปยัง Discord

• API Keys - สำหรับการเชื่อมต่อกับบริการภายนอก

• Whitelist/Blacklist - รายการ items, jobs, หรือ permissions

• Feature Toggles - เปิด/ปิดฟีเจอร์ต่างๆ ตามความต้องการ

• Database Setup - นำเข้าไฟล์ .sql (ถ้ามี) เข้าสู่ฐานข้อมูล

• Locale Settings - เลือกภาษาที่ต้องการใช้งาน

เคล็ดลับ: แนะนำให้สำรองไฟล์ config.lua เดิมไว้ก่อนแก้ไข เพื่อความสะดวกในการเปรียบเทียบและกู้คืนการตั้งค่า

5

รีสตาร์ทและตรวจสอบ

ขั้นตอนสุดท้ายในการตรวจสอบว่า resource ทำงานได้อย่างถูกต้อง:

1. รีสตาร์ท Server - ปิดและเปิด FiveM server ใหม่อีกครั้ง

2. ตรวจสอบ Server Console - สังเกตข้อความตอนบูตว่ามี error messages หรือ warnings หรือไม่

3. ตรวจสอบ Resource Loading - ดูว่า resource โหลดสำเร็จหรือไม่ (มักจะแสดงข้อความ "Started [resource-name]")

4. เข้าเกมและทดสอบ - เข้าเกมแล้วเปิด client console (กด F8) เพื่อตรวจสอบ errors ฝั่ง client

5. ทดสอบฟีเจอร์พื้นฐาน - ทดสอบฟีเจอร์หลักของ resource ว่าทำงานได้ตามที่คาดหวัง

เป้าหมายของขั้นตอนนี้: ต้องไม่มี error ตอนบูต server และสามารถเข้าเกมได้ตามปกติ หากมี error ให้แก้ไขก่อนทดสอบฟีเจอร์เพิ่มเติม

การอ่าน Error Messages:

• Error แบบ [ERROR] หรือ [SCRIPT ERROR] = ต้องแก้ไขทันที resource จะไม่ทำงาน

• Warning แบบ [WARNING] = ควรตรวจสอบ อาจทำงานได้แต่อาจมีปัญหา

• Info แบบ [INFO] หรือ Started = ข้อความปกติ ไม่มีปัญหา

ขั้นตอนถัดไป

เมื่อติดตั้ง resource สำเร็จแล้ว คุณสามารถดำเนินการต่อไปยังขั้นตอนดังนี้:

การศึกษาเอกสารเพิ่มเติม

• Resource Documentation - ไปที่หน้า Resource Docs เพื่อดูเอกสารเฉพาะของ resource ที่คุณติดตั้ง

• Configuration Guide - ศึกษาการตั้งค่าขั้นสูงและตัวเลือกต่างๆ ที่มีให้

• API Reference - หากต้องการพัฒนาต่อยอด ให้ดูที่ API documentation ของ resource

การแก้ไขปัญหา

หากพบปัญหาระหว่างการใช้งาน:

1. ตรวจสอบ FAQs - เข้าไปดูที่หน้า FAQs สำหรับคำถามและปัญหาที่พบบ่อย

2. ค้นหาในเอกสาร - ใช้ฟีเจอร์ค้นหา (Ctrl+K หรือ ⌘+K) เพื่อหาข้อมูลที่ต้องการ

3. ตรวจสอบ Error Logs - อ่าน error messages อย่างละเอียด มักจะบอกสาเหตุของปัญหา

การพัฒนาต่อยอด

• Guides - อ่าน Guides สำหรับคำแนะนำการตั้งค่าขั้นสูง

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

หากคุณพบปัญหาหรือต้องการความช่วยเหลือเพิ่มเติม:

Discord Support

เปิด support ticket ผ่าน Discord server อย่างเป็นทางการของเรา:

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

ข้อมูลที่ควรเตรียมก่อนขอความช่วยเหลือ

เพื่อความรวดเร็วในการช่วยเหลือ กรุณาเตรียมข้อมูลดังต่อไปนี้:

• ชื่อและเวอร์ชัน Resource - ระบุชื่อ resource และหมายเลขเวอร์ชันที่ใช้งาน

• Error Messages แบบเต็ม - คัดลอก error messages ทั้งบรรทัดจาก console (ไม่ใช่เพียงบางส่วน)

• Server Console Logs - ส่ง logs ตั้งแต่ตอนบูต server จนถึงเกิด error

• Load Order - แสดงลำดับการ ensure resources ใน server.cfg

• ขั้นตอนการทำซ้ำ - อธิบายขั้นตอนที่ทำให้เกิดปัญหา (reproduction steps)

• สภาพแวดล้อม - ระบุ FiveM version, Framework (ESX/QBCore), และ dependencies ที่เกี่ยวข้อง

---

ติดตั้งสำเร็จแล้ว? ไปยังหน้า Resource Documentation เพื่อเรียนรู้การใช้งานและฟีเจอร์ขั้นสูงของ resource ที่คุณติดตั้ง