Weapons

ฟังก์ชันฝั่ง Server สำหรับจัดการอาวุธ (Loadout) ของผู้เล่นผ่าน xPlayer เช่น เพิ่ม/ลบอาวุธ, กระสุน, components และสีอาวุธ (tint)

Weapons (xPlayer)

กลุ่มฟังก์ชันสำหรับจัดการอาวุธของผู้เล่น (Loadout) เช่น เพิ่ม/ลบอาวุธ, ปรับกระสุน, ติดตั้งอุปกรณ์เสริม และตั้งสีอาวุธ

ใช้งานผ่านออบเจกต์ผู้เล่น xPlayer และทำงานฝั่ง Server-side เท่านั้น

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

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

• ดึง xPlayer จาก source ก่อนเรียกใช้งาน:

local xPlayer = ESX.GetPlayerFromId(source)

ชื่ออาวุธต้องเป็นชื่อมาตรฐานของ GTA V เช่น WEAPON_PISTOL ไม่ใช่ชื่อเล่น เช่น pistol

ห้ามเชื่อข้อมูลจาก Client เช่น weaponName, ammo, components, tintIndex ควรตรวจสอบสิทธิ์และตรวจสอบความถูกต้อง (validate) เสมอ และแนะนำให้ทำ “รายการที่อนุญาต (allowlist)” สำหรับอาวุธ/อุปกรณ์เสริม

โครงสร้างข้อมูลอาวุธ (Weapon object)

อาวุธใน loadout มักมีฟิลด์สำคัญดังนี้:

• name ชื่ออาวุธ (เช่น WEAPON_PISTOL)

• label ชื่อแสดง

• ammo จำนวนกระสุน

• components รายการอุปกรณ์เสริม

• tintIndex สีอาวุธ (โดยทั่วไป 0-7)

---

xPlayer.addWeapon

ให้อาวุธแก่ผู้เล่น

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

xPlayer.addWeapon(name, ammo, reason)

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

Name	Type	Description
name	string	ชื่ออาวุธ (เช่น 'WEAPON_PISTOL', 'WEAPON_COMBATPISTOL')
ammo	number	(ไม่บังคับ) จำนวนกระสุนเริ่มต้น (default: 0)
reason	string	(ไม่บังคับ) เหตุผลในการให้อาวุธ

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

Type	Description
boolean	true หากสำเร็จ, false หากผู้เล่นมีอาวุธนี้อยู่แล้ว

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addWeapon('WEAPON_PISTOL', 120, 'Admin give')

ตัวอย่างเพิ่มเติม (ขยายดู)

RegisterNetEvent('gunshop:buy', function(weaponName, ammo)
    local xPlayer = ESX.GetPlayerFromId(source)
    local weaponPrice = Config.WeaponPrices[weaponName]
    local ammoPrice = Config.AmmoPrices[weaponName] * ammo
    local totalPrice = weaponPrice + ammoPrice
    
    if xPlayer.getMoney() >= totalPrice then
        if not xPlayer.hasWeapon(weaponName) then
            xPlayer.removeMoney(totalPrice, 'ซื้ออาวุธ')
            xPlayer.addWeapon(weaponName, ammo, 'ซื้อจากร้าน')
            
            TriggerClientEvent('esx:showNotification', source, 
                'ซื้ออาวุธสำเร็จ!')
        else
            TriggerClientEvent('esx:showNotification', source, 
                'คุณมีอาวุธนี้แล้ว')
        end
    else
        TriggerClientEvent('esx:showNotification', source, 'เงินไม่พอ!')
    end
end)

-- ตัวอย่าง: ระบบงาน (Police Job)
RegisterNetEvent('police:takeService', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.job.name == 'police' then
        -- ให้อาวุธตามยศ
        if xPlayer.job.grade >= 3 then
            xPlayer.addWeapon('WEAPON_CARBINERIFLE', 250, 'Police duty')
        end
        xPlayer.addWeapon('WEAPON_PISTOL', 150, 'Police duty')
        xPlayer.addWeapon('WEAPON_NIGHTSTICK', 0, 'Police duty')
        xPlayer.addWeapon('WEAPON_STUNGUN', 0, 'Police duty')
    end
end)

-- ตัวอย่าง: รางวัลจากภารกิจ
RegisterNetEvent('mission:completeHard', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    
    xPlayer.addMoney(50000, 'Mission reward')
    xPlayer.addWeapon('WEAPON_SPECIALCARBINE', 300, 'Mission reward')
    
    TriggerClientEvent('esx:showNotification', source, 
        'ภารกิจสำเร็จ! ได้รับปืน Special Carbine')
end)

กรณีการใช้งาน (Use cases)

• ร้านขายอาวุธ/ซื้ออาวุธ

• ระบบอาชีพ (แจกอาวุธตอนเข้าเวร)

• รางวัลจากภารกิจ/กิจกรรม

• เครื่องมือแอดมิน

ชื่ออาวุธต้องเป็นชื่อมาตรฐานของ GTA V เช่น WEAPON_PISTOL

แนะนำให้ตรวจด้วย xPlayer.hasWeapon() ก่อน เพื่อป้องกันการให้อาวุธซ้ำ

---

xPlayer.addWeaponSet

ให้อาวุธพร้อมอุปกรณ์เสริมและสีครบชุดให้กับผู้เล่น

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

xPlayer.addWeaponSet(weapon, reason)

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

Name	Type	Description
weapon	table	ตารางข้อมูลอาวุธ (ดูโครงสร้างด้านล่าง)
reason	string	(ไม่บังคับ) เหตุผลในการให้อาวุธ

โครงสร้างตาราง Weapon set

ฟิลด์	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
ammo	number	(ไม่บังคับ) จำนวนกระสุน
components	table	(ไม่บังคับ) Array ของชื่อ components
tintIndex	number	(ไม่บังคับ) ดัชนีสี (0-7)

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addWeaponSet({
    name = 'WEAPON_PISTOL',
    ammo = 120,
    components = { 'clip_extended', 'flashlight' },
    tintIndex = 2
}, 'VIP Package')

ตัวอย่างเพิ่มเติม (ขยายดู)

RegisterNetEvent('police:giveLoadout')
AddEventHandler('police:giveLoadout', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.job.name == 'police' then
        -- ปืนพกพื้นฐานสำหรับทุกยศ
        xPlayer.addWeaponSet({
            name = 'WEAPON_COMBATPISTOL',
            ammo = 150,
            components = { 'clip_extended', 'flashlight' },
            tintIndex = 0
        }, 'Police Standard Issue')
        
        -- ไรเฟิลสำหรับยศสูง
        if xPlayer.job.grade >= 5 then
            xPlayer.addWeaponSet({
                name = 'WEAPON_CARBINERIFLE',
                ammo = 250,
                components = { 'clip_extended', 'scope', 'grip', 'flashlight' },
                tintIndex = 0
            }, 'Police SWAT Weapon')
        end
        
        xPlayer.addWeapon('WEAPON_NIGHTSTICK', 0, 'Police Equipment')
        xPlayer.addWeapon('WEAPON_STUNGUN', 0, 'Police Equipment')
    end
end)

RegisterNetEvent('vip:claimWeaponPackage')
AddEventHandler('vip:claimWeaponPackage', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    
    -- ตรวจสอบว่าเป็น VIP
    if xPlayer.getGroup() == 'vip' then
        -- ปืนพก VIP
        xPlayer.addWeaponSet({
            name = 'WEAPON_APPISTOL',
            ammo = 200,
            components = { 'clip_extended', 'suppressor', 'luxe_finish' },
            tintIndex = 7 -- สีทอง
        }, 'VIP Gold Pistol')
        
        -- SMG VIP
        xPlayer.addWeaponSet({
            name = 'WEAPON_SMG',
            ammo = 300,
            components = { 'clip_drum', 'scope', 'luxe_finish' },
            tintIndex = 7
        }, 'VIP Gold SMG')
        
        TriggerClientEvent('esx:showNotification', source, 
            '~y~คุณได้รับอาวุธ VIP Package')
    end
end)

-- ลูกค้าสั่งปรับแต่งอาวุธ
RegisterNetEvent('gunsmith:customizeWeapon')
AddEventHandler('gunsmith:customizeWeapon', function(weaponData, totalPrice)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.getMoney() >= totalPrice then
        -- ลบอาวุธเก่าออก
        xPlayer.removeWeapon(weaponData.name, 'Gunsmith upgrade')
        
        -- ให้อาวุธใหม่ที่ปรับแต่งแล้ว
        xPlayer.addWeaponSet(weaponData, 'Gunsmith custom')
        xPlayer.removeMoney(totalPrice, 'Gunsmith service')
        
        TriggerClientEvent('esx:showNotification', source, 
            '~g~ปรับแต่งอาวุธเสร็จสิ้น')
    else
        TriggerClientEvent('esx:showNotification', source, '~r~เงินไม่พอ!')
    end
end)

กรณีการใช้งาน (Use cases)

• แจกอาวุธแบบ “ชุด” ตามตำแหน่ง/ยศ

• VIP package / อาวุธพิเศษ

• Gunsmith / ระบบปรับแต่งอาวุธ

ชื่อ component ต้องตรงกับที่กำหนดใน config.weapons.lua เช่น clip_extended, suppressor, scope

---

xPlayer.removeWeapon

ลบอาวุธออกจาก loadout ของผู้เล่น

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

xPlayer.removeWeapon(name, reason)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
reason	string	(ไม่บังคับ) เหตุผลในการลบอาวุธ

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ, false ถ้าไม่พบอาวุธ

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

RegisterNetEvent('police:confiscateWeapons')
AddEventHandler('police:confiscateWeapons', function(targetId)
    local xPlayer = ESX.GetPlayerFromId(source)
    local xTarget = ESX.GetPlayerFromId(targetId)
    
    if xPlayer.job.name == 'police' and xTarget then
        local loadout = xTarget.getLoadout()
        
        for i=1, #loadout do
            xTarget.removeWeapon(loadout[i].name, 'Police confiscate')
        end
        
        TriggerClientEvent('esx:showNotification', targetId, 
            '~r~ตำรวจยึดอาวุธของคุณ')
        TriggerClientEvent('esx:showNotification', source, 
            '~g~ยึดอาวุธผู้ต้องสงสัยเรียบร้อย')
    end
end)

ตัวอย่างเพิ่มเติม (ขยายดู)

RegisterNetEvent('police:offDuty')
AddEventHandler('police:offDuty', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    
    -- ลบอาวุธของตำรวจ
    xPlayer.removeWeapon('WEAPON_CARBINERIFLE', 'Off duty')
    xPlayer.removeWeapon('WEAPON_COMBATPISTOL', 'Off duty')
    xPlayer.removeWeapon('WEAPON_NIGHTSTICK', 'Off duty')
    xPlayer.removeWeapon('WEAPON_STUNGUN', 'Off duty')
    
    TriggerClientEvent('esx:showNotification', source, 'คืนอาวุธเรียบร้อย')
end)

RegisterNetEvent('gunshop:sellWeapon')
AddEventHandler('gunshop:sellWeapon', function(weaponName)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.hasWeapon(weaponName) then
        local sellPrice = math.floor(Config.WeaponPrices[weaponName] * 0.5)
        
        xPlayer.removeWeapon(weaponName, 'Sold to shop')
        xPlayer.addMoney(sellPrice, 'Weapon sale')
        
        TriggerClientEvent('esx:showNotification', source, 
            '~g~ขายอาวุธได้ $' .. sellPrice)
    end
end)

local playerWeapons = {}

RegisterNetEvent('safezone:enter')
AddEventHandler('safezone:enter', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    local loadout = xPlayer.getLoadout()
    
    -- เซฟอาวุธ
    playerWeapons[source] = loadout
    
    -- ลบอาวุธทั้งหมด
    for i=1, #loadout do
        xPlayer.removeWeapon(loadout[i].name, 'Safe zone')
    end
    
    TriggerClientEvent('esx:showNotification', source, 
        '~y~เข้าสู่พื้นที่ปลอดภัย อาวุธถูกเก็บชั่วคราว')
end)

RegisterNetEvent('safezone:exit')
AddEventHandler('safezone:exit', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    local loadout = playerWeapons[source]
    
    if loadout then
        -- คืนอาวุธ
        for i=1, #loadout do
            xPlayer.addWeaponSet(loadout[i], 'Return from safe zone')
        end
        playerWeapons[source] = nil
    end
end)

---

xPlayer.removeWeapons

ลบอาวุธหลายชิ้นพร้อมกันจาก loadout

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

xPlayer.removeWeapons(weapons, reason)

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

ชื่อ	ประเภท	คำอธิบาย
weapons	table	ตารางชื่ออาวุธ {['WEAPON_PISTOL'] = true}
reason	string	(ไม่บังคับ) เหตุผลในการลบ

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.removeWeapons({
    ['WEAPON_PISTOL'] = true,
    ['WEAPON_SMG'] = true,
    ['WEAPON_CARBINERIFLE'] = true
}, 'Confiscated by police')

---

xPlayer.hasWeapon

ตรวจสอบว่าผู้เล่นมีอาวุธที่ระบุหรือไม่

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

xPlayer.hasWeapon(name)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ

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

ประเภท	คำอธิบาย
boolean	true ถ้าผู้เล่นมีอาวุธ

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

local xPlayer = ESX.GetPlayerFromId(source)
if not xPlayer.hasWeapon('WEAPON_PISTOL') then
    xPlayer.addWeapon('WEAPON_PISTOL', 120)
else
    TriggerClientEvent('esx:showNotification', source, 'คุณมีปืนนี้แล้ว')
end

-- ตรวจสอบก่อนเข้าอีเว้นท์
RegisterNetEvent('event:join')
AddEventHandler('event:join', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.hasWeapon('WEAPON_PISTOL') or 
       xPlayer.hasWeapon('WEAPON_CARBINERIFLE') then
        TriggerClientEvent('esx:showNotification', source, 
            '~r~ห้ามนำอาวุธเข้าอีเว้นท์')
        return
    end
    
    -- เข้าอีเว้นท์
end)

---

xPlayer.getWeapon

ดึงข้อมูลอาวุธจาก loadout ของผู้เล่น

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

local index, weapon = xPlayer.getWeapon(name)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ

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

Type	Description
number	index ของอาวุธใน loadout (อาจเป็น nil หากไม่พบ)
table	weapon object { name, ammo, label, components, tintIndex } (อาจเป็น nil หากไม่พบ)

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

local xPlayer = ESX.GetPlayerFromId(source)
local index, weapon = xPlayer.getWeapon('WEAPON_PISTOL')

if weapon then
    print('กระสุน: ' .. weapon.ammo)
    print('สี: ' .. weapon.tintIndex)
    print('อุปกรณ์เสริม: ' .. #weapon.components)
end

---

xPlayer.getLoadout

ดึงอาวุธทั้งหมดของผู้เล่น

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

xPlayer.getLoadout(minimal)

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

ชื่อ	ประเภท	คำอธิบาย
minimal	boolean	(ไม่บังคับ) ถ้าเป็น true จะคืนค่าแบบย่อ

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

Type	Description
table	แบบเต็ม: array ของ { name, ammo, label, components, tintIndex }
table	แบบย่อ (minimal = true): {[weaponName] = { ammo, tintIndex?, components? }}

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

-- แบบย่อ
local xPlayer = ESX.GetPlayerFromId(source)
local loadout = xPlayer.getLoadout(true)

for weaponName, data in pairs(loadout) do
    print(weaponName .. ': ' .. data.ammo .. ' กระสุน')
end

-- แบบเต็ม
local fullLoadout = xPlayer.getLoadout(false)
for i=1, #fullLoadout do
    print(fullLoadout[i].label .. ' (' .. fullLoadout[i].ammo .. ')')
end

---

xPlayer.clearLoadout

ลบอาวุธทั้งหมดของผู้เล่น

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

xPlayer.clearLoadout(reason)

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

ชื่อ	ประเภท	คำอธิบาย
reason	string	(ไม่บังคับ) เหตุผลในการลบ

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ

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

-- ลบอาวุธทั้งหมดเมื่อเข้าคุก
local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.clearLoadout('Sent to jail')

-- ลบอาวุธทั้งหมดเมื่อเสียชีวิต
RegisterNetEvent('esx:onPlayerDeath')
AddEventHandler('esx:onPlayerDeath', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    xPlayer.clearLoadout('Player died')
end)

---

xPlayer.addWeaponComponent

เพิ่มอุปกรณ์เสริมให้กับอาวุธ

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

xPlayer.addWeaponComponent(name, componentName)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
componentName	string	ชื่อ component (เช่น 'clip_extended')

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ

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

-- เพิ่มไซเลนเซอร์ให้ปืน
local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addWeaponComponent('WEAPON_PISTOL', 'suppressor')

ตัวอย่างเพิ่มเติม (ขยายดู)

RegisterNetEvent('gunsmith:buyComponent')
AddEventHandler('gunsmith:buyComponent', function(weaponName, componentName, price)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.getMoney() >= price then
        if xPlayer.hasWeapon(weaponName) then
            xPlayer.addWeaponComponent(weaponName, componentName)
            xPlayer.removeMoney(price, 'Weapon component')
            TriggerClientEvent('esx:showNotification', source, 
                '~g~ติดตั้งอุปกรณ์เสริมสำเร็จ')
        end
    end
end)

---

xPlayer.removeWeaponComponent

ลบอุปกรณ์เสริมออกจากอาวุธ

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

xPlayer.removeWeaponComponent(name, componentName)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
componentName	string	ชื่อ component

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ

---

xPlayer.hasWeaponComponent

ตรวจสอบว่าอาวุธมีอุปกรณ์เสริมที่ระบุหรือไม่

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

xPlayer.hasWeaponComponent(name, componentName)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
componentName	string	ชื่อ component

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

ประเภท	คำอธิบาย
boolean	true ถ้ามี component ติดอยู่

---

xPlayer.addWeaponAmmo

เพิ่มกระสุนให้อาวุธ

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

xPlayer.addWeaponAmmo(name, ammo)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
ammo	number	จำนวนที่เพิ่ม

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ

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

-- ซื้อกระสุน
RegisterNetEvent('gunshop:buyAmmo')
AddEventHandler('gunshop:buyAmmo', function(weaponName, ammoCount, price)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.hasWeapon(weaponName) and xPlayer.getMoney() >= price then
        xPlayer.addWeaponAmmo(weaponName, ammoCount)
        xPlayer.removeMoney(price, 'Ammo purchase')
        TriggerClientEvent('esx:showNotification', source, 
            '~g~ซื้อกระสุน ' .. ammoCount .. ' นัด')
    end
end)

---

xPlayer.removeWeaponAmmo

ลดกระสุนจากอาวุธ

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

xPlayer.removeWeaponAmmo(name, ammo)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
ammo	number	จำนวนที่ลด

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ

---

xPlayer.updateWeaponAmmo

อัปเดตจำนวนกระสุนจาก game state (ใช้ภายใน)

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

xPlayer.updateWeaponAmmo(name, ammo)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
ammo	number	จำนวนกระสุนปัจจุบัน

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ, false ถ้ากระสุนไม่เปลี่ยนแปลง

ฟังก์ชันนี้ถูกเรียกโดย framework เพื่อ sync กระสุนจาก client ไปยัง server โดยทั่วไปไม่จำเป็นต้องเรียกเอง

---

xPlayer.getWeaponTint

ดึงดัชนีสีของอาวุธ

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

xPlayer.getWeaponTint(name)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ

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

ประเภท	คำอธิบาย
number	ดัชนีสี (default: 0)

---

xPlayer.setWeaponTint

ตั้งสีให้กับอาวุธ

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

xPlayer.setWeaponTint(name, tintIndex)

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

ชื่อ	ประเภท	คำอธิบาย
name	string	ชื่ออาวุธ
tintIndex	number	ดัชนีสี (0-7)

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

ประเภท	คำอธิบาย
boolean	true ถ้าสำเร็จ, false ถ้าสีไม่ถูกต้อง

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

-- ร้านสีปืน
RegisterNetEvent('gunsmith:paintWeapon')
AddEventHandler('gunsmith:paintWeapon', function(weaponName, tintIndex, price)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.hasWeapon(weaponName) and xPlayer.getMoney() >= price then
        xPlayer.setWeaponTint(weaponName, tintIndex)
        xPlayer.removeMoney(price, 'Weapon tint')
        TriggerClientEvent('esx:showNotification', source, 
            '~g~ทาสีอาวุธสำเร็จ')
    end
end)

คำแนะนำ: ดัชนีสี (tintIndex) มีค่า 0-7 โดย 0 = ปกติ, 7 = ทอง (ต้องปลดล็อค)

---

สรุปฟังก์ชันใน Weapons

ฟังก์ชันต่อไปนี้เป็น method บน xPlayer

Function	Description
addWeapon(name, ammo, reason)	เพิ่มอาวุธให้ผู้เล่น
addWeaponSet(weapon, reason)	เพิ่มอาวุธแบบชุด (ammo/components/tint)
removeWeapon(name, reason)	ลบอาวุธรายชิ้น
removeWeapons(weapons, reason)	ลบอาวุธหลายชิ้น
hasWeapon(name)	ตรวจว่ามีอาวุธหรือไม่
getWeapon(name)	อ่านข้อมูลอาวุธรายชิ้น
getLoadout(minimal)	อ่านอาวุธทั้งหมด
clearLoadout(reason)	ลบอาวุธทั้งหมด
addWeaponComponent(name, componentName)	เพิ่ม component
removeWeaponComponent(name, componentName)	ลบ component
hasWeaponComponent(name, componentName)	ตรวจ component
addWeaponAmmo(name, ammo)	เพิ่มกระสุน
removeWeaponAmmo(name, ammo)	ลดกระสุน
updateWeaponAmmo(name, ammo)	sync กระสุน (internal)
getWeaponTint(name)	อ่านสีอาวุธ
setWeaponTint(name, tintIndex)	ตั้งสีอาวุธ

---

แนวทางสำหรับนักพัฒนา

1

ทำ allowlist ของอาวุธและ component

จำกัดชนิดอาวุธ/อุปกรณ์เสริมที่อนุญาตในเซิร์ฟเวอร์ และปฏิเสธทุกค่าที่มาจาก Client ที่อยู่นอก allowlist

2

ตรวจสิทธิ์ก่อนแจกอาวุธ

การแจกอาวุธควรถูกควบคุมโดย job/grade, group หรือ permission เท่านั้น อย่าให้ผู้เล่นเรียก event แล้วได้อาวุธทันที

3

ตรวจซ้ำก่อนเพิ่ม

ใช้ xPlayer.hasWeapon() เพื่อตรวจซ้ำก่อน addWeapon/addWeaponSet

4

ระบุ reason สำหรับรายการสำคัญ

ระบุ reason เมื่อแจก/ยึดอาวุธ เพื่อช่วยตรวจสอบ log และ debug