Example Exports

ตัวอย่างการใช้งาน exports สำหรับส่งข้อมูล Log จากเกมไปยัง Discord สามารถนำไปประยุกต์ใช้ร่วมกับระบบต่าง ๆ ได้ทั้ง client-side และ server-side

Example Exports

ตัวอย่างการเรียก exports.nc_discordlogs:Discord() เพื่อส่ง Log ไปยัง Discord

รองรับทั้งฝั่ง Client, Server และรูปแบบ Global (ไม่ผูกกับผู้เล่น)

พารามิเตอร์ที่ใช้บ่อย

เปิดดูรายการพารามิเตอร์

webhook: ชื่อ Webhook key ที่ตั้งไว้ใน Config.Webhooks
title: หัวข้อของ Embed
message: ข้อความหลักของ Log
- ถ้าใส่ title และ message พร้อมกัน ระบบจะใช้ title เป็นหลัก
description: รายละเอียดเพิ่มเติมของเหตุการณ์
fields: ข้อมูลเสริมแบบเป็นบล็อก (เช่น จำนวนเงิน, Item, ตำแหน่ง)
imageURL: URL รูปภาพประกอบ
color: สีของ Embed (Hex) เช่น ff0000 (ค่าเริ่มต้น ffffff)
public: ตั้งค่าว่าเป็น Log สาธารณะหรือไม่
screenshot: ส่ง Screenshot (ใช้ได้เฉพาะฝั่ง Client และต้องมี screenshot-basic)

พารามิเตอร์ฝั่ง Server (เลือกอย่างใดอย่างหนึ่ง):

playerId: ไอดีผู้เล่นต้นทาง (source) แนะนำให้ใช้
targetId: ไอดีผู้เล่นปลายทาง/ผู้ถูกกระทำ (ถ้ามี)
xPlayer: อ็อบเจ็กต์ผู้เล่นจาก ESX (ใช้แทน playerId ได้)
xTarget: อ็อบเจ็กต์ผู้เล่นปลายทางจาก ESX (ใช้แทน targetId ได้)

ฝั่ง Server จะไม่รองรับ screenshot โดยตรง

ถ้าต้องการ Screenshot ต้องเรียกจากฝั่ง Client เท่านั้น

ใช้เมื่อเหตุการณ์เกิดกับ “ผู้เล่นคนปัจจุบัน”

ตัวอย่างเช่น ใช้ Item, เข้าโซน, ยิงปืน, ใช้เมนู

Client-side (template)

exports.nc_discordlogs:Discord({
  webhook = 'webhook',
  title = 'title',
  message = 'message',
  description = 'description',
  fields = {
    { name = 'field title', value = 'field value', inline = true },
  },
  imageURL = 'url',
  color = 'ff0000',
  public = true,
  screenshot = true
})

ตัวอย่าง: แต่งยานพาหนะ + Screenshot

exports.nc_discordlogs:Discord({
  webhook = 'customs_vehicle',
  message = '丨`แต่งยานพาหนะ หมวดของแต่ง`',
  description = '```ได้แต่งชิ้นส่วน '.. string.upper(modName) ..' ระดับของแต่ง/ชื่อรุ่นของแต่ง ' .. string.upper(menuOption.label) .. ' เข้ากับยานพาหนะ ' .. GetLabelText(vehDisplayName) .. ' ป้ายทะเบียน ' .. GetVehicleNumberPlateText(customVehicle) .. ' และเสียค่าใช้จ่าย ' .. tempPrice .. ' $```',
  color = '008000',
  screenshot = true
})

ตัวอย่าง: ใช้กล่องซ่อม + Screenshot

exports.nc_discordlogs:Discord({
  webhook = 'repair_vehicle',
  message = string.format('丨`ได้ใช้งานกล่องซ่อม \"%s\"`', name),
  description = string.format('```ซ่อมยานพาหนะ %s ป้ายทะเบียน %s```', vehicleName, vehiclePlate),
  color = '008000',
  screenshot = true
})

ใช้เมื่อเซิร์ฟเวอร์เป็นผู้ “ตัดสินเหตุการณ์”

ตัวอย่างเช่น คำสั่งแอดมิน, ระบบกันโกง, ระบบตรวจเงื่อนไข

ฝั่ง Server ส่งได้ทั้ง xPlayer หรือ playerId

แนะนำให้ส่ง playerId (source) เป็นหลัก

Server-side (template)

exports.nc_discordlogs:Discord({
  webhook = 'webhook',
  playerId = source, -- แนะนำ
  targetId = targetId, -- optional
  -- xPlayer = xPlayer, -- ใช้แทน playerId ได้
  -- xTarget = xTarget, -- ใช้แทน targetId ได้
  title = 'title',
  message = 'message',
  description = 'description',
  fields = {
    { name = 'field title', value = 'field value', inline = true },
  },
  imageURL = 'url',
  color = 'ff0000',
  public = true
})

ตัวอย่างด้านล่างบางส่วนใช้ xPlayer/xTarget เพื่อให้เห็นการแนบชื่อผู้เล่นแบบชัดเจน

แต่ถ้าคุณต้องการส่งแบบเบาและไม่ผูกกับ Framework แนะนำให้ส่ง playerId/targetId เป็นหลัก

ตัวอย่าง: ส่ง Log จากระบบมายสโตน

exports.nc_discordlogs:Discord({
  webhook = 'mile_stone',
  xPlayer = xPlayer,
  message = string.format('丨`ได้รับมายสโตน (%s)`', itemKey),
  description = string.format('```ได้รับของรางวัลจากเป้าหมายมายสโตนเป็น สิ่งของ: %s จำนวน: %s```', itemKey, count),
  color = '6efa12'
})

ตัวอย่าง: Log ปล่อยตัวผู้ต้องขัง

exports.nc_discordlogs:Discord({
  webhook = 'jail_players',
  xPlayer = xTarget,
  xTarget = xPlayer,
  message = '丨`ได้ถูกนายตำรวจปล่อยตัวจากเรือนจำ`',
  fields = {
    {
      name = 'ผู้ดำเนินการปล่อยตัว',
      value = '```นายตำรวจ ' .. xPlayer.name .. ' เป็นผู้ปล่อยตัวผู้ต้องขัง```',
      inline = true
    },
    {
      name = 'ผู้ถูกปล่อยตัว',
      value = '```ผู้ต้องขัง ' .. xTarget.name .. ' ได้รับการปล่อยตัวจากเรือนจำ```',
      inline = true
    }
  },
  color = 'A6EE1F'
})

ใช้เมื่อเป็นเหตุการณ์ระดับเซิร์ฟเวอร์ และไม่ต้องอ้างอิงผู้เล่น

ตัวอย่างเช่น รีสตาร์ทเซิร์ฟเวอร์, งานอัตโนมัติ, ระบบจัดการข้อมูลออฟไลน์

Global (template)

exports.nc_discordlogs:Discord({
  webhook = 'webhook',
  title = 'title',
  message = 'message',
  description = 'description',
  fields = {
    { name = 'field title', value = 'field value', inline = true },
  },
  imageURL = 'url',
  color = 'ff0000',
  public = true
})

ตัวอย่าง: Log มายสโตนแบบ Global

exports.nc_discordlogs:Discord({
  webhook = 'mile_stone',
  message = string.format('ผู้เล่นชื่อ %s `ได้รับมายสโตน (%s)`', playerName, itemKey),
  description = string.format('```ได้รับของรางวัลจากเป้าหมายมายสโตนเป็น สิ่งของ: %s จำนวน: %s```', itemKey, count),
  color = '6efa12'
})

ตัวอย่าง: แจ้งเตือนรีสตาร์ทเซิร์ฟเวอร์

exports.nc_discordlogs:Discord({
  webhook = 'server_restart',
  message = 'เซิร์ฟเวอร์กำลังจะรีสตาร์ทในอีก ' .. restartTime .. ' นาที',
  description = 'โปรดเก็บยานพาหนะ และออกประเทศ เพื่อป้องกันการสูญหายของข้อมูล',
  color = '6efa12'
})

Troubleshooting

ถ้าไม่พบ Log ใน Discord ให้ตรวจ Config.Webhooks และชื่อ webhook ที่ส่งไป
ถ้า Log ขึ้นแต่รูปไม่ขึ้น ให้ตรวจ Config.ImageCaches และดูที่ FAQ

Support

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

Discord: https://discord.gg/ncdeveloper

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

Last updated 9 hours ago

hashtagExample Exports

hashtagพารามิเตอร์ที่ใช้บ่อย

hashtagTroubleshooting

hashtagSupport

Example Exports

พารามิเตอร์ที่ใช้บ่อย

Troubleshooting

Support