Configuration

ตั้งค่า Webhook และรูปแบบ Log ของ NC Discord Logs ให้พร้อมใช้งาน

Configuration

ตั้งค่า Webhook และรูปแบบการส่ง Log ให้เหมาะกับเซิร์ฟเวอร์ของคุณ

เนื้อหาครอบคลุม Log หลัก, Log แยกหมวด และการแสดงรูป/Screenshot

คำแนะนำด้านความปลอดภัย

• แนะนำให้แยก Discord สำหรับเก็บ Logs โดยเฉพาะ

• จำกัดสิทธิ์เฉพาะทีมงานที่เกี่ยวข้องเท่านั้น

• Webhook URL ถือเป็นข้อมูลสำคัญ ห้ามเผยแพร่

จุดเด่น

• แยกห้อง Log ตามหมวดได้ ด้วยการตั้งชื่อ Webhook ให้เป็นระบบ

• รองรับรูปภาพ/Screenshot ผ่าน ImageCaches เพื่อเพิ่มความเสถียร

• เชื่อม Log จากสคริปต์อื่นได้ง่าย ด้วยการอ้างอิงชื่อ Webhook

เหมาะกับใคร

• ผู้ดูแลเซิร์ฟเวอร์ที่ต้องการจัดระเบียบ Log บน Discord

• นักพัฒนาที่ต้องการส่ง Log แบบกำหนดเองจากฝั่ง Client/Server

ไฟล์ที่ใช้ตั้งค่า

ไฟล์หลักของระบบอยู่ที่:

• nc_discordlogs/config/config.main.lua

ถ้ายังไม่มี Webhook ให้เริ่มที่หน้า Create Discord Webhook ก่อน

เริ่มต้นตั้งค่า (แนะนำ)

1

เตรียม Webhook สำหรับแต่ละห้อง

สร้าง Webhook ของห้องที่ต้องการให้ระบบส่ง Log เข้าไป

แนะนำให้แยกห้องตามหมวด เช่น Admin / Economy / Combat / System

2

ตั้งค่า ImageCaches สำหรับรูปและ Screenshot (สำคัญ)

ImageCaches คือรายการ Webhook สำหรับ “อัปโหลดรูป” เพื่อสร้าง URL ไปแสดงใน Embed

สำคัญ: ตั้งค่า ImageCaches เพื่อให้รูป/Screenshot ขึ้นเสถียร

รูปภาพทั้งหมดจะถูกอัปโหลดผ่าน Config.ImageCaches ก่อน เพื่อสร้าง URL ไปแสดงใน Embed

แนะนำให้ใส่ Webhook URL อย่างน้อย 2–3 อัน เพื่อลดปัญหา Discord rate limit

config.main.lua

Config.ImageCaches = {
  'https://discord.com/api/webhooks/XXXXXXXX/IMAGE_1',
  'https://discord.com/api/webhooks/XXXXXXXX/IMAGE_2',
  'https://discord.com/api/webhooks/XXXXXXXX/IMAGE_3',
}

3

ตั้งชื่อ Webhook แยกหมวด (Config.Webhooks)

กำหนด “ชื่อ Webhook” เพื่อใช้เป็นคีย์อ้างอิงตอนส่ง Log

แนวทางตั้งชื่อที่แนะนำ:

• ใช้ตัวพิมพ์เล็กและขีดล่าง เช่น admin_logs, money_logs, combat_logs

• ห้ามตั้งชื่อซ้ำกัน

• ตั้งชื่อให้สื่อความหมายกับห้องปลายทาง

Config.Webhooks = {
  ['admin_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/ADMIN',
  ['money_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/MONEY',
  ['chat_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/CHAT',
}

4

ทดสอบการส่ง Log

ทดสอบจากตัวอย่างในหน้า Example Exports

ถ้า Log ขึ้นแล้ว แต่รูปไม่ขึ้น ให้กลับไปตรวจ ImageCaches ก่อนเสมอ

ตัวอย่าง: Log แชท (Chat logs)

Log แชท จะเก็บเฉพาะ “ข้อความในระบบแชทของ FiveM”

ไม่รวมการพิมพ์คำสั่ง (commands) และไม่ใช่ส่วนเดียวกัน

ค่า webhook ในตัวอย่างนี้คือ “Webhook URL ปลายทาง”

แนวทางที่แนะนำคือให้ผูกผ่าน Config.Webhooks เพื่อจัดระเบียบห้อง Log ได้ง่าย

chat = {
  webhook = Config.Webhooks['chat_logs'],
  title = '%s พิมพ์ข้อความในช่องสนทนา',
  description = '%s',
  color = 'ffffff' -- Hex | Default: 'ffffff'
}

หมายเหตุเรื่อง Screenshot

ตัวเลือก screenshot = true ใช้ได้เฉพาะฝั่ง Client และต้องมี resource screenshot-basic

Troubleshooting

อาการ: ไม่พบ Log ใน Discord

สิ่งที่ควรตรวจสอบ:

• Webhook URL ยังใช้งานได้ และไม่ได้ถูกลบจาก Discord

• ชื่อ Webhook ที่ส่งไป ตรงกับชื่อที่ตั้งไว้ใน Config.Webhooks

• รีสตาร์ท resource หลังแก้ไข config แล้ว

อาการ: Log ขึ้น แต่รูป/Screenshot ไม่แสดง

สิ่งที่ควรตรวจสอบ:

• ตั้งค่า ImageCaches ครบ 2–3 Webhook แล้วหรือไม่

• Webhook ใน ImageCaches เป็นห้องที่อนุญาตให้บอตส่งข้อความ/ไฟล์ได้

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

• ตั้งค่าเสร็จแล้ว ให้กลับไปทดสอบตาม Installation Guide

• ดูตัวอย่างการส่ง Log ที่ครอบคลุมมากขึ้นที่หน้า Example Exports

Support

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

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

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