Player class

วิธีดึงและใช้งาน xPlayer ฝั่ง Server พร้อมแนวทางการใช้ filter และลิงก์ไปยังหมวดเมทอด

Player class (xPlayer)

xPlayer คือ object ของผู้เล่นที่เชื่อมต่ออยู่บนเซิร์ฟเวอร์ (Server-side)

คุณใช้ xPlayer เพื่ออ่าน/แก้ไขข้อมูลผู้เล่น เช่น เงิน, Item, อาชีพ, อาวุธ, สถานะ และ Method ทั่วไปอื่น ๆ

หน้านี้โฟกัสการใช้งาน xPlayer ฝั่ง Server เท่านั้น ถ้าต้องการ “โหลด ESX ให้ถูกลำดับ” ให้ดูที่ Framework usage

---

การดึง xPlayer (Getting a player object)

คุณสามารถดึง xPlayer ได้ 2 วิธีหลัก:

• ESX.GetPlayerFromId(playerId) — ตาม Server ID

• ESX.GetPlayerFromIdentifier(identifier) — ตาม identifier (เช่น license)

ตัวอย่าง:

-- By server ID
local xPlayer = ESX.GetPlayerFromId(source)
if not xPlayer then return end

-- By identifier
local otherPlayer = ESX.GetPlayerFromIdentifier('license:abc123')

เช็ค xPlayer เป็น nil ทุกครั้ง ผู้เล่นอาจ disconnect ระหว่าง flow ของ event ได้

---

การใช้ filter ให้ถูกต้อง (สำคัญ)

บางเซ็ตอัปจะเปิดโหมด Optimize ข้อมูลผู้เล่น ทำให้การ “ดึง xPlayer แบบไม่ระบุ filter” อาจได้ข้อมูลไม่ครบ

แนวทางที่แนะนำคือใส่ filter ให้ตรงกับสิ่งที่โค้ดจะเรียกใช้ในจุดนั้น

ตัวอย่าง:

local xPlayer = ESX.GetPlayerFromId(source, {
    'getMoney',
    'removeMoney',
    'addInventoryItem',
    'showNotification',
})
if not xPlayer then return end

ถ้าคุณเปิด Max Player Optimization (Beta) ด้วย Config.Player.UseMaxOptimization = true ให้ใส่ filter ทุกครั้งที่เรียก ESX.GetPlayerFromId() / ESX.GetPlayerFromIdentifier()

สำหรับรายละเอียดเชิงลึกของ filter ดูที่หน้า Server

---

หมวดเมทอดของ xPlayer

หมวดด้านล่างคือหน้า API ย่อยที่อยู่ใต้หัวข้อ Player class ในสารบัญ

Title

Accounts

Target

Accounts

Title

Inventory

Target

Inventory

Title

Weapons

Target

Weapons

Title

Job

Target

Job

Title

Status

Target

Status

Title

General

Target

General

---

ตัวอย่างการใช้งาน (Example)

ตัวอย่างด้านล่างเป็น pattern ที่ใช้บ่อยใน resource ฝั่ง Server

RegisterNetEvent('shop:buy', function(itemName, price)
    local xPlayer = ESX.GetPlayerFromId(source, {
        'getMoney',
        'removeMoney',
        'addInventoryItem',
        'canCarryItem',
        'showNotification',
    })
    if not xPlayer then return end

    if xPlayer.getMoney() < price then
        xPlayer.showNotification('เงินไม่พอ')
        return
    end

    if not xPlayer.canCarryItem(itemName, 1) then
        xPlayer.showNotification('ช่องเก็บของเต็ม')
        return
    end

    xPlayer.removeMoney(price, 'shop:buy')
    xPlayer.addInventoryItem(itemName, 1, 'shop:buy')
    xPlayer.showNotification('ซื้อสำเร็จ')
end)

แนวปฏิบัติที่แนะนำ (ขยายดู)

• ดึง xPlayer “เท่าที่จำเป็น” และอย่าดึงซ้ำใน loop ที่ถี่มาก

• ใส่ filter ให้ตรงกับ member ที่เรียกจริงในจุดนั้น

• ตรวจสอบ input ทุกครั้ง (เช่น price, itemName) ก่อนทำธุรกรรม

• ใส่ reason ให้เมทอดที่รองรับ เพื่อช่วย trace log และ debug

---

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

• Framework usage — ตั้งค่า imports และลำดับการโหลด

• Server — รายละเอียด ESX.GetPlayerFromId() และแนวทาง filter

• Player class overview — ภาพรวม properties และหมวดเมทอดแบบละเอียด

Support

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

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

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