Connect Product Logs

วิธีการเชื่อม Logs ของผลิตภัณฑ์ NC Developer เข้ากับ NC Discord Logs ผ่านไฟล์ config.extensions.lua

ภาพรวม

เชื่อม Log จากผลิตภัณฑ์ NC Developer เข้ากับ nc_discordlogs อย่างเป็นระบบ

แนวทางนี้ใช้การ "จับคู่ชื่อ Webhook" ผ่าน config.extensions.lua ของแต่ละผลิตภัณฑ์

ข้อกำหนดเบื้องต้น (Prerequisites)

• ติดตั้งและ ensure nc_discordlogs เรียบร้อยแล้ว

• สร้าง Discord Webhook สำหรับช่อง Log ที่ต้องการแล้ว

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

ไฟล์ที่เกี่ยวข้อง

โดยทั่วไป คุณจะใช้งาน 2 จุดนี้:

• nc_discordlogs/config/config.main.lua (ประกาศ Config.Webhooks)

• <product_resource>/config/config.extensions.lua (จับคู่ว่าหมวด Log ของผลิตภัณฑ์จะส่งไปที่ Webhook ใด)

ตัวอย่างไฟล์ Extensions ของผลิตภัณฑ์:

• nc_inventory/config/config.extensions.lua

ข้อสำคัญด้านความปลอดภัย

Webhook URL เป็นข้อมูลสำคัญที่ต้องเก็บเป็นความลับ

หาก URL รั่วไหล บุคคลภายนอกสามารถส่งข้อความเข้า "ช่อง Log" ของคุณได้

หลักการทำงาน

1. คุณกำหนดชื่อ Webhook เป็น Key ใน Config.Webhooks

2. แต่ละผลิตภัณฑ์อ้างอิง Key ดังกล่าวผ่าน config.extensions.lua

3. เมื่อเกิดเหตุการณ์ ระบบจะส่ง Log ไปยังช่อง Discord ตาม Key ที่จับคู่ไว้

ขั้นตอนการเชื่อม (แนะนำ)

1

ตั้งค่าให้ nc_discordlogs ทำงานก่อนผลิตภัณฑ์

ตรวจสอบ server.cfg ให้ nc_discordlogs ถูก ensure ก่อน Resource ที่ต้องการส่ง Log

server.cfg

ensure es_extended
ensure nc_discordlogs

# ensure product resources after nc_discordlogs
ensure nc_inventory
ensure nc_itemset

2

สร้าง Webhook สำหรับแต่ละช่อง (หากยังไม่มี)

แนะนำให้แยกช่องตามหมวดหมู่ เช่น money_logs, item_logs, admin_logs

ปฏิบัติตามขั้นตอนที่หน้า Create Discord Webhook

3

เพิ่ม Webhook Key ใน Config.Webhooks

แก้ไขไฟล์ nc_discordlogs/config/config.main.lua แล้วเพิ่ม Key ที่ต้องการใช้งาน

nc_discordlogs/config/config.main.lua

Config.Webhooks = {
  ['money_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/MONEY',
  ['item_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/ITEM',
  ['weapon_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/WEAPON',
  ['vehiclekey_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/VEHICLE_KEY',
  ['housekey_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/HOUSE_KEY',
  ['accessory_logs'] = 'https://discord.com/api/webhooks/XXXXXXXX/ACCESSORY',
}

แนะนำให้ใช้ตัวอักษรพิมพ์เล็กและขีดล่าง เช่น money_logs

หลีกเลี่ยงการใส่ URL โดยตรงในไฟล์ Config ของผลิตภัณฑ์หลาย ๆ จุด

4

เปิดใช้งาน nc_discordlogs ใน config.extensions.lua ของผลิตภัณฑ์

เปิดไฟล์ <product_resource>/config/config.extensions.lua

จากนั้นค้นหา Section ของ nc_discordlogs แล้วเปิดใช้งานการส่ง Log

หากไฟล์มีตัวเลือก enable ให้ตั้งค่าเป็น true

หากหาไม่พบ ให้ใช้ฟังก์ชันค้นหาในไฟล์ด้วยคำว่า: nc_discordlogs

ตัวอย่างตำแหน่ง Section (รูปแบบอาจแตกต่างกันตามผลิตภัณฑ์):

5

จับคู่ชื่อ Webhook ให้ตรงกับ Config.Webhooks

ค่าที่ระบุต้องเป็น "ชื่อ Key" ที่มีอยู่จริงใน Config.Webhooks

<product_resource>/config/config.extensions.lua (example)

webhook = {
  account = 'money_logs',
  item = 'item_logs',
  weapon = 'weapon_logs',
  vehicle_key = 'vehiclekey_logs',
  house_key = 'housekey_logs',
  accessory = 'accessory_logs'
},

6

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

1. รีสตาร์ท Resource ที่แก้ไข (หรือรีสตาร์ททั้งเซิร์ฟเวอร์)

2. ทดสอบ Action ในเกมที่ควรเกิด Log (เช่น เพิ่ม/ลบ Item, โอนเงิน)

3. ตรวจสอบว่าข้อความถูกส่งเข้าช่อง Discord ตามที่จับคู่ไว้

Troubleshooting

อาการ: ไม่พบ Log ของผลิตภัณฑ์ใน Discord

ตรวจสอบตามลำดับนี้:

• nc_discordlogs ทำงานอยู่ (ตรวจสอบ Server Console ตอนบูต)

• Key ที่ระบุใน config.extensions.lua ตรงกับ Key ใน Config.Webhooks

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

• หลังจากแก้ไข Config แล้วได้รีสตาร์ท Resource แล้ว

อาการ: แก้ไขไฟล์แล้วเกิด Syntax Error (ปีกกา/คอมมา)

สิ่งที่พบบ่อย:

• ลืมใส่ , หลังปิด Block

• วางปีกกา { } ไม่ครบคู่

หากไม่แน่ใจ ให้ย้อนกลับไปเปรียบเทียบกับตัวอย่างในหน้านี้

Support

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

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

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