การติดตั้ง

ขั้นตอนการติดตั้ง Devil Market บนเซิร์ฟเวอร์ FiveM

ขั้นตอนที่ 1: ติดตั้งฐานข้อมูล

เปิดไฟล์ devil_market/@installme.sql แล้วนำเข้าไปยังฐานข้อมูลของเซิร์ฟเวอร์ สคริปต์จะสร้างตาราง 4 ตาราง:

devil_point - เก็บ Point และ Coin ของผู้เล่น
devil_market_stock - เก็บข้อมูลสต็อกสินค้า
devil_purchase_history - ประวัติการซื้อ
devil_payment_sessions - เซสชันการชำระเงิน

ข้อกำหนดของฐานข้อมูล (Database Requirement)

ตารางฐานข้อมูลใช้ประเภทคอลัมน์ JSON ซึ่งต้องการ MySQL 5.7+ หรือ MariaDB 10.2+ ขึ้นไป หากฐานข้อมูลเก่าเกินไปอาจเกิด syntax error ได้ (ดูทางแก้ใน การแก้ปัญหาที่พบบ่อย)

ใช้ phpMyAdmin, HeidiSQL หรือ MySQL command line ก็ได้:

mysql -u root -p your_database < devil_market/@installme.sql

ขั้นตอนที่ 2: วางไฟล์ Resource

คัดลอก folder ไปไว้ในโฟลเดอร์ resources ของเซิร์ฟเวอร์:

resources/

resources/
└── [Devil]/
    └── [DevilMarket]/
        ├── devil_market/
        └── devil_marketaddons/

ไฟล์ NUI UI สำเร็จรูป

สคริปต์ devil_market มาพร้อมกับไฟล์ NUI UI ที่คอมไพล์สำเร็จรูปแล้วภายในโฟลเดอร์ devil_market/html/dist/ คุณไม่จำเป็นต้องติดตั้ง Node.js หรือ build UI ใหม่ สามารถนำโฟลเดอร์ไปวางและใช้งานได้ทันที

ขั้นตอนที่ 3: เพิ่ม Resource ลงใน server.cfg

เปิดไฟล์ server.cfg แล้วเพิ่มบรรทัดเหล่านี้:

server.cfg

ensure oxmysql
ensure es_extended
ensure nc_inventory
ensure nc_notify
ensure nc_garage
ensure nc_vehiclekey

# Devil Market (ใช้ชื่อ resource ตรงๆ จาก fxmanifest.lua ไม่ต้องใส่ path)
ensure devil_market

devil_marketaddons ไม่ใช่ FiveM resource

devil_marketaddons เป็น Node.js application ที่รันแยกต่างหาก ไม่ใช่ FiveM resource — ห้ามใส่ใน server.cfg ด้วยคำสั่ง ensure

ให้รันแยกด้วย start.bat (Windows) หรือ node index.js แทน ดูวิธีติดตั้งได้ใน การติดตั้ง Devil Market Addons

ขั้นตอนที่ 4: ตั้งค่า Devil Market

แก้ไขไฟล์ devil_market/config/config_main.lua:

ตั้งค่า License Key: กำหนด Config_Main.Settings.License
ตั้งค่า ImagePath: ปรับ Config_Main.Settings.ImagePath ให้ชี้ไปยังโฟลเดอร์เก็บรูปไอเทมของ Inventory บนเซิร์ฟเวอร์คุณ (เช่น "nui://nc_inventory/html/img/items")
ปรับ Inventory System: ปรับ InventorySystem ให้ตรงกับระบบที่ใช้อยู่ ("limit" หรือ "weight")
ตั้งตำแหน่ง Zone: กำหนดพิกัด Zone สำหรับเปิดร้านค้าในเกม

ขั้นตอนที่ 5: ตั้งค่า Devil Market Addons

ดูรายละเอียดในหน้า การตั้งค่า Devil Market Addons

ขั้นตอนที่ 6: รีสตาร์ทเซิร์ฟเวอร์

หลังตั้งค่าเสร็จ ให้รีสตาร์ทเซิร์ฟเวอร์ FiveM แล้วตรวจสอบ console ว่า resource เริ่มทำงานสำเร็จ:

[Devil Market] Admin Commands loaded successfully!

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

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

ตำแหน่ง Zone ใน config_main.lua ถูกต้องหรือไม่
Resource devil_market เริ่มทำงานหรือไม่ (ดูที่ console)
ไฟล์ html/dist/index.html อยู่ครบหรือไม่
รายการตรวจสอบฉบับสมบูรณ์ในหน้า Production QA Checklist