Shared

ฟังก์ชันที่ใช้ได้ทั้งฝั่ง Client และ Server ผ่าน ESX.* สำหรับข้อมูลอาวุธ และการเรียกชุดคำสั่งแบบ batch

ฟังก์ชันที่ใช้ได้ทั้ง Client และ Server (ESX.*)

หน้านี้รวบรวมฟังก์ชันที่เรียกใช้ได้ทั้งฝั่ง Client-side และ Server-side ผ่าน ESX.*

เหมาะสำหรับงานที่ต้องอ่านข้อมูลอาวุธ และเรียกหลายคำสั่งต่อเนื่องแบบเป็นชุด

ก่อนเริ่ม (แนะนำ)

• ตั้งค่าการเรียกใช้ Framework ให้ถูกต้องตาม Framework Usage

ฟังก์ชันในหน้านี้ “เรียกได้ทั้งสองฝั่ง” แต่ข้อมูลบางอย่างอาจต่างกันตาม context ของฝั่งที่เรียกใช้

---

ESX.GetWeapon

ดึงข้อมูลอาวุธจากชื่ออาวุธที่ระบุ

รูปแบบการใช้งาน (Syntax)

ESX.GetWeapon(weaponName)

พารามิเตอร์ (Parameters)

Name	Type	Description
weaponName	string	ชื่ออาวุธ (เช่น 'WEAPON_PISTOL')

ค่าที่ส่งคืน (Returns)

Type	Description
table	ตารางข้อมูลอาวุธ (name, label, hash, components, tints) หรือ nil

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

example.lua

local weapon = ESX.GetWeapon('WEAPON_PISTOL')
if weapon then
    print('Label: ' .. weapon.label)
    print('Hash: ' .. weapon.hash)
end

---

ESX.GetWeaponFromHash

ดึงข้อมูลอาวุธจาก weapon hash ที่ระบุ

รูปแบบการใช้งาน (Syntax)

ESX.GetWeaponFromHash(weaponHash)

พารามิเตอร์ (Parameters)

Name	Type	Description
weaponHash	number	ค่า hash ของอาวุธ

ค่าที่ส่งคืน (Returns)

Type	Description
table	ตารางข้อมูลอาวุธ หรือ nil หากไม่พบ

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

example.lua

local weapon = ESX.GetWeaponFromHash(453432689)
if weapon then
    print(weapon.name)
end

---

ESX.GetWeaponLabel

ดึงชื่อแสดงผล (label) ของอาวุธจากชื่ออาวุธที่ระบุ

รูปแบบการใช้งาน (Syntax)

ESX.GetWeaponLabel(weaponName)

พารามิเตอร์ (Parameters)

Name	Type	Description
weaponName	string	ชื่ออาวุธ (เช่น 'WEAPON_PISTOL')

ค่าที่ส่งคืน (Returns)

Type	Description
string	ชื่อแสดงผลของอาวุธ หรือ nil หากไม่พบ

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

example.lua

local label = ESX.GetWeaponLabel('WEAPON_PISTOL')
print(label) -- "Pistol"

---

ESX.GetWeaponComponent

ดึงข้อมูล component ของอาวุธ (เช่น magazine, suppressor) จากชื่ออาวุธและชื่อ component ที่ระบุ

รูปแบบการใช้งาน (Syntax)

ESX.GetWeaponComponent(weaponName, weaponComponent)

พารามิเตอร์ (Parameters)

Name	Type	Description
weaponName	string	ชื่ออาวุธ (เช่น 'WEAPON_PISTOL')
weaponComponent	string	ชื่อ component (เช่น 'clip_extended')

ค่าที่ส่งคืน (Returns)

Type	Description
table	ตารางข้อมูล component (name, hash, label) หรือ nil

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

example.lua

local component = ESX.GetWeaponComponent('WEAPON_PISTOL', 'clip_extended')
if component then
    print('Component hash: ' .. component.hash)
end

---

ESX.IsWeaponValid

ตรวจสอบว่า weaponName หรือ weaponHash ที่ระบุ “ถูกต้องและมีอยู่ในระบบ” หรือไม่

รูปแบบการใช้งาน (Syntax)

ESX.IsWeaponValid(weaponName)

พารามิเตอร์ (Parameters)

Name	Type	Description
weaponName	string|number	ชื่ออาวุธ (เช่น 'WEAPON_PISTOL') หรือ hash ของอาวุธ

ค่าที่ส่งคืน (Returns)

Type	Description
boolean	true ถ้าค่าที่ระบุถูกต้อง

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

example.lua

if ESX.IsWeaponValid('WEAPON_PISTOL') then
    print('Valid weapon')
end

---

ESX.Transaction

เรียกฟังก์ชัน ESX.* หลายรายการแบบ “เป็นชุด (batch)” ตามลำดับ และคืนค่าผลลัพธ์ทั้งหมดกลับมา

เหมาะกับเคสที่ต้องเรียกหลายฟังก์ชันติดกัน แล้วอยากจัดการผลลัพธ์แบบก้อนเดียว

รูปแบบการใช้งาน (Syntax)

ESX.Transaction(transaction)

พารามิเตอร์ (Parameters)

Name	Type	Description
transaction	table	รายการ operation ที่ต้องการให้รันตามลำดับ

แต่ละ operation เป็น table ที่มี field ดังนี้:

Field	Type	Description
name	string	ชื่อฟังก์ชันที่ต้องการเรียก (ไม่ต้องใส่ prefix ESX.)
values	table|any	ค่าพารามิเตอร์ที่ส่งให้ฟังก์ชันนั้น (ปกติใช้เป็น array)

ค่าที่ส่งคืน (Returns)

Type	Description
table	รายการผลลัพธ์ของแต่ละ operation ตามลำดับที่เรียก

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

example.lua

local results = ESX.Transaction({
    { name = 'GetWeapon', values = { 'WEAPON_PISTOL' } },
    { name = 'GetWeaponLabel', values = { 'WEAPON_SMG' } }
})
-- results[1] = { weaponData }
-- results[2] = { 'SMG' }