Accounts

ฟังก์ชันฝั่ง Server สำหรับจัดการบัญชีเงินของผู้เล่น (money/bank/black_money และบัญชีที่กำหนดเอง)

Accounts (xPlayer)

กลุ่มฟังก์ชันสำหรับจัดการบัญชีเงินของผู้เล่น เช่น เงินสด, เงินธนาคาร, เงินมืด และบัญชีที่กำหนดเอง

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

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

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

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

local xPlayer = ESX.GetPlayerFromId(source)

ฟังก์ชันในหน้านี้ใช้ได้เฉพาะสคริปต์ฝั่ง Server เท่านั้น

ค่าที่ส่งมาจาก Client (เช่น amount) ต้องตรวจสอบความถูกต้อง (validate) ฝั่ง Server เสมอ

ประเภทบัญชีที่พบบ่อย

NC Core รองรับหลายบัญชี โดยบัญชีที่พบบ่อยมีดังนี้:

• money - เงินสดที่ถืออยู่ในมือ

• bank - เงินในบัญชีธนาคาร

• black_money - เงินมืด (ใช้ในเซิร์ฟเวอร์ Roleplay)

• บัญชีอื่น ๆ ที่กำหนดเอง (ขึ้นกับการตั้งค่าใน config.lua)

Accounts คือ “กระเป๋าเงินหลายใบ” ของผู้เล่น แต่ละใบมีชื่อ และยอดเงินแยกกัน

แนวทางที่แนะนำ

• ตรวจสอบยอดเงินก่อนทำธุรกรรมเสมอ โดยเฉพาะการหักเงิน

• ส่ง reason ทุกครั้งที่เป็นไปได้ เพื่อให้ง่ายต่อการตรวจสอบ log

• หลีกเลี่ยงการตั้งค่า “เขียนทับยอด” ถ้าไม่จำเป็น ให้ใช้ add/remove แทน

---

xPlayer.getMoney

ดึงยอดเงินสด (money) ของผู้เล่น

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

xPlayer.getMoney()

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

Type	Description
number	จำนวนเงินสดที่ผู้เล่นมี

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

local xPlayer = ESX.GetPlayerFromId(source)
local cash = xPlayer.getMoney()
print('เงินสดที่มี: $' .. cash)

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

RegisterNetEvent('shop:buyItem', function(itemName, price)
    local xPlayer = ESX.GetPlayerFromId(source)
    local playerCash = xPlayer.getMoney()
    
    if playerCash >= price then
        xPlayer.removeMoney(price, 'ซื้อสินค้า')
        xPlayer.addInventoryItem(itemName, 1)
    else
        print('เงินไม่พอ! มี: $' .. playerCash .. ' ต้องการ: $' .. price)
    end
end)

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

• ตรวจสอบว่าผู้เล่นมีเงินสดพอก่อนทำธุรกรรม

• แสดงจำนวนเงินสดใน UI/Menu

• บันทึก log การเงิน

ฟังก์ชันนี้อ่านเฉพาะบัญชี money เท่านั้น หากต้องการบัญชีอื่น ให้ใช้ xPlayer.getAccount('bank') หรือ xPlayer.getAccount('black_money')

---

xPlayer.setMoney

กำหนดยอดเงินสด (money) เป็นค่าที่ระบุ (เขียนทับยอดเดิมทั้งหมด)

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

xPlayer.setMoney(amount)

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

Name	Type	Description
amount	number	จำนวนเงินสดใหม่ที่ต้องการตั้ง

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

Type	Description
boolean	true หากสำเร็จ, false หากเกิดข้อผิดพลาด

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.setMoney(5000)

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

RegisterNetEvent('character:firstJoin', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    xPlayer.setMoney(5000)
    xPlayer.setAccountMoney('bank', 25000)
end)

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

• กำหนดเงินเริ่มต้นให้ตัวละครใหม่

• รีเซ็ตเงินของผู้เล่น

• แก้ไขปัญหาเงินผิดพลาด (คำสั่งแอดมิน)

ฟังก์ชันนี้จะ เขียนทับยอดเดิมทั้งหมด หากต้องการเพิ่ม/ลด ให้ใช้ xPlayer.addMoney() หรือ xPlayer.removeMoney() แทน

---

xPlayer.addMoney

เพิ่มเงินสดให้กับผู้เล่น

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

xPlayer.addMoney(amount, reason)

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

Name	Type	Description
amount	number	จำนวนเงินที่ต้องการเพิ่ม (ต้องเป็นบวก)
reason	string	(ไม่บังคับ) เหตุผลในการเพิ่มเงิน (สำหรับ log)

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

Type	Description
boolean	true หากสำเร็จ, false หาก amount ไม่ถูกต้อง

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addMoney(5000, 'เงินเดือนประจำวัน')

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

RegisterNetEvent('mission:complete', function(missionId)
    local xPlayer = ESX.GetPlayerFromId(source)
    local reward = 2500
    
    xPlayer.addMoney(reward, 'รางวัลจากภารกิจ #' .. missionId)
    
    TriggerClientEvent('esx:showNotification', source, 'คุณได้รับ $' .. reward)
end)

RegisterNetEvent('shop:sellItem', function(itemName, count)
    local xPlayer = ESX.GetPlayerFromId(source)
    local xItem = xPlayer.getInventoryItem(itemName)
    
    if xItem and xItem.count >= count then
        local sellPrice = 100
        local totalPrice = sellPrice * count
        
        xPlayer.removeInventoryItem(itemName, count)
        xPlayer.addMoney(totalPrice, 'ขาย ' .. xItem.label)
    end
end)

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

• จ่ายเงินเดือนให้ผู้เล่น

• ให้รางวัลจากภารกิจหรือกิจกรรม

• รับเงินจากการขายสินค้า

• ระบบ Paycheck อัตโนมัติ

แนะนำให้ระบุ reason เสมอ เพื่อช่วยตรวจสอบ log และ debug ภายหลัง

---

xPlayer.removeMoney

หักเงินสดจากผู้เล่น

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

xPlayer.removeMoney(amount, reason)

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

Name	Type	Description
amount	number	จำนวนเงินที่ต้องการหัก (ต้องเป็นบวก)
reason	string	(ไม่บังคับ) เหตุผลในการหักเงิน (สำหรับ log)

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

Type	Description
boolean	true หากสำเร็จ, false หาก amount ไม่ถูกต้อง

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

local xPlayer = ESX.GetPlayerFromId(source)
local price = 500

if xPlayer.getMoney() >= price then
    xPlayer.removeMoney(price, 'ซื้อน้ำ')
    xPlayer.addInventoryItem('water', 1)
else
    TriggerClientEvent('esx:showNotification', source, 'เงินไม่พอ!')
end

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

RegisterCommand('fine', function(source, args)
    if not IsPlayerAceAllowed(source, 'police') then return end
    
    local targetId = tonumber(args[1])
    local amount = tonumber(args[2])
    local reason = table.concat(args, ' ', 3)
    
    if targetId and amount then
        local xTarget = ESX.GetPlayerFromId(targetId)
        if xTarget then
            local success = xTarget.removeMoney(amount, 'ค่าปรับ: ' .. reason)
            if success then
                TriggerClientEvent('esx:showNotification', targetId, 'คุณถูกปรับ $' .. amount)
            end
        end
    end
end)

RegisterNetEvent('mechanic:repair', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    local repairCost = 1500
    
    if xPlayer.getMoney() >= repairCost then
        xPlayer.removeMoney(repairCost, 'ค่าซ่อมรถ')
        TriggerClientEvent('vehicle:doRepair', source)
    else
        TriggerClientEvent('esx:showNotification', source, 'เงินไม่พอ! ต้องการ $' .. repairCost)
    end
end)

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

• หักเงินเมื่อซื้อสินค้า

• หักค่าปรับหรือค่าใช้จ่าย

• หักค่าบริการต่างๆ (ซ่อมรถ, รักษาพยาบาล)

• หักเงินจากการเล่นพนัน

ควรตรวจสอบยอดเงินด้วย xPlayer.getMoney() ก่อนหักเสมอ เพื่อป้องกันยอดติดลบ

---

xPlayer.getAccount

ดึงข้อมูลบัญชีเงินตามชื่อที่ระบุ (เช่น bank, black_money)

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

xPlayer.getAccount(name)

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

Name	Type	Description
name	string	ชื่อบัญชี (เช่น 'money', 'bank', 'black_money')

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

Type	Description
table	ออบเจคต์ของบัญชี: { name, money, label } หรือ nil ถ้าไม่พบ

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

local xPlayer = ESX.GetPlayerFromId(source)
local bankAccount = xPlayer.getAccount('bank')

if bankAccount then
    print('เงินในธนาคาร: $' .. bankAccount.money)
    print('ชื่อบัญชี: ' .. bankAccount.name)
    print('ชื่อแสดง: ' .. bankAccount.label)
end

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

RegisterNetEvent('banking:transfer', function(targetId, amount)
    local xPlayer = ESX.GetPlayerFromId(source)
    local xTarget = ESX.GetPlayerFromId(targetId)
    
    if not xTarget then
        return TriggerClientEvent('esx:showNotification', source, 'ไม่พบผู้รับเงิน')
    end
    
    local bankAccount = xPlayer.getAccount('bank')
    if bankAccount.money >= amount then
        xPlayer.removeAccountMoney('bank', amount, 'โอนเงิน')
        xTarget.addAccountMoney('bank', amount, 'รับโอนเงิน')
        
        TriggerClientEvent('esx:showNotification', source, 'โอนสำเร็จ $' .. amount)
        TriggerClientEvent('esx:showNotification', targetId, 'ได้รับเงิน $' .. amount)
    else
        TriggerClientEvent('esx:showNotification', source, 'ยอดเงินไม่พอ')
    end
end)

local xPlayer = ESX.GetPlayerFromId(source)
local accounts = {'money', 'bank', 'black_money'}

for _, accountName in ipairs(accounts) do
    local account = xPlayer.getAccount(accountName)
    if account then
        print(account.label .. ': $' .. account.money)
    end
end

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

• ตรวจสอบยอดเงินก่อนทำธุรกรรม

• ดึงข้อมูลบัญชีเพื่อแสดงใน UI/Menu

• ระบบโอนเงินระหว่างผู้เล่น

บัญชีที่มีให้ใช้งานขึ้นกับการตั้งค่าใน config.database.lua และ config ของเซิร์ฟเวอร์

---

xPlayer.getAccounts

ดึงข้อมูลบัญชีเงินทั้งหมดของผู้เล่น

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

xPlayer.getAccounts(minimal)

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

Name	Type	Description
minimal	boolean	(ไม่บังคับ) ถ้าเป็น true จะคืนค่าในรูปแบบ {[name] = amount}

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

Type	Description
table	Array ของ Object บัญชี หรือตารางแบบย่อ {name = amount}

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

local xPlayer = ESX.GetPlayerFromId(source)
local accounts = xPlayer.getAccounts()

for i = 1, #accounts do
    print(accounts[i].label .. ': $' .. accounts[i].money)
end

local minimal = xPlayer.getAccounts(true)
print('เงินสด: $' .. (minimal.money or 0))
print('เงินธนาคาร: $' .. (minimal.bank or 0))
print('เงินมืด: $' .. (minimal.black_money or 0))

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

RegisterNetEvent('banking:openUI', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    local accounts = xPlayer.getAccounts(true)
    
    TriggerClientEvent('banking:showData', source, {
        money = accounts.money or 0,
        bank = accounts.bank or 0,
        black_money = accounts.black_money or 0
    })
end)

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

• ดึงข้อมูลบัญชีทั้งหมดเพื่อแสดงใน UI

• ตรวจสอบจำนวนเงินในบัญชีทั้งหมด

• สร้างรายงานทางการเงิน

• ส่งข้อมูลไปยัง Client-side

ใช้ minimal = true เมื่อต้องการใช้งานแบบสั้นและเบา (เช่น ส่งข้อมูลไป UI)

---

xPlayer.setAccountMoney

กำหนดจำนวนเงินในบัญชีที่ระบุเป็นค่าที่แน่นอน

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

xPlayer.setAccountMoney(name, amount, reason)

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

Name	Type	Description
name	string	ชื่อบัญชี
amount	number	จำนวนเงินใหม่ที่ต้องการตั้ง
reason	string	(ไม่บังคับ) เหตุผลในการเปลี่ยนแปลง

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

Type	Description
boolean	true หากสำเร็จ, false หากเกิดข้อผิดพลาด

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.setAccountMoney('bank', 50000)

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

RegisterCommand('setmoney', function(source, args)
    if not IsPlayerAceAllowed(source, 'admin') then return end
    
    local targetId = tonumber(args[1])
    local accountName = args[2]
    local amount = tonumber(args[3])
    
    if targetId and accountName and amount then
        local xTarget = ESX.GetPlayerFromId(targetId)
        if xTarget then
            xTarget.setAccountMoney(accountName, amount, 'Admin set money')
            TriggerClientEvent('esx:showNotification', source, 'ตั้งเงิน ' .. accountName .. ' เป็น $' .. amount)
        end
    end
end)

RegisterNetEvent('admin:resetBlackMoney', function(targetId)
    local xPlayer = ESX.GetPlayerFromId(source)
    if xPlayer.getGroup() ~= 'admin' then return end
    
    local xTarget = ESX.GetPlayerFromId(targetId)
    if xTarget then
        xTarget.setAccountMoney('black_money', 0, 'Admin reset black money')
    end
end)

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

• รีเซ็ตเงินในบัญชี

• แก้ไขปัญหาเงินผิดพลาด (Admin Tools)

• กำหนดค่าเริ่มต้นให้ตัวละครใหม่

ฟังก์ชันนี้จะ เขียนทับค่าเดิมทั้งหมด หากต้องการเพิ่ม/ลด ให้ใช้ xPlayer.addAccountMoney() หรือ xPlayer.removeAccountMoney() แทน

---

xPlayer.addAccountMoney

เพิ่มเงินเข้าบัญชีที่ระบุ

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

xPlayer.addAccountMoney(name, amount, reason)

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

Name	Type	Description
name	string	ชื่อบัญชี
amount	number	จำนวนเงินที่ต้องการเพิ่ม (ต้องเป็นบวก)
reason	string	(ไม่บังคับ) เหตุผลในการเพิ่มเงิน

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

Type	Description
boolean	true หากสำเร็จ, false หาก amount ไม่ถูกต้อง

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addAccountMoney('bank', 10000, 'เงินเดือน')

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

RegisterNetEvent('banking:deposit', function(amount)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    local moneyAccount = xPlayer.getAccount('money')
    if moneyAccount.money >= amount then
        xPlayer.removeAccountMoney('money', amount, 'ฝากเงินเข้าธนาคาร')
        xPlayer.addAccountMoney('bank', amount, 'ฝากเงินเข้าบัญชี')
        
        TriggerClientEvent('esx:showNotification', source, 'ฝากเงินสำเร็จ $' .. amount)
        
        pcall(function()
            exports.nc_discordlogs:Discord({
                webhook = 'bankDeposit',
                xPlayer = source,
                message = '丨`ฝากเงินธนาคาร`',
                description = string.format('```ฝากเงินเข้าบัญชีจำนวน $%s```', amount)
            })
        end)
    else
        TriggerClientEvent('esx:showNotification', source, 'เงินสดไม่พอ')
    end
end)

CreateThread(function()
    while true do
        Wait(1800000)
        local xPlayers = ESX.GetExtendedPlayers()
        
        for _, xPlayer in pairs(xPlayers) do
            if xPlayer.job.name ~= 'unemployed' then
                local salary = xPlayer.job.grade_salary
                if salary > 0 then
                    xPlayer.addAccountMoney('bank', salary, 'เงินเดือน')
                    TriggerClientEvent('esx:showNotification', xPlayer.source, 
                        'คุณได้รับเงินเดือน $' .. salary)
                end
            end
        end
    end
end)

RegisterNetEvent('vip:claimBonus', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    local vipLevel = xPlayer.getGroup()
    
    local bonus = {
        vip = 5000,
        vvip = 10000,
        mvp = 25000
    }
    
    if bonus[vipLevel] then
        xPlayer.addAccountMoney('bank', bonus[vipLevel], 'VIP Bonus')
        TriggerClientEvent('esx:showNotification', source, 
            'รับโบนัส VIP $' .. bonus[vipLevel])
    end
end)

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

• ฝากเงินเข้าธนาคาร

• จ่ายเงินเดือนอัตโนมัติ

• โอนเงินระหว่างผู้เล่น

• รับเงินจากการขายสินค้า (Society Money)

• ระบบโบนัสและรางวัล

ควรตรวจสอบบัญชีต้นทาง (เช่น เงินสด) ก่อนทำธุรกรรม และบันทึก log สำหรับรายการสำคัญ

---

xPlayer.removeAccountMoney

หักเงินออกจากบัญชีที่ระบุ

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

xPlayer.removeAccountMoney(name, amount, reason)

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

Name	Type	Description
name	string	ชื่อบัญชี
amount	number	จำนวนเงินที่ต้องการหัก (ต้องเป็นบวก)
reason	string	(ไม่บังคับ) เหตุผลในการหักเงิน

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

Type	Description
boolean	true หากสำเร็จ, false หาก amount ไม่ถูกต้อง

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.removeAccountMoney('bank', 500, 'ซื้อสินค้า')

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

RegisterNetEvent('banking:withdraw', function(amount)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    local bankAccount = xPlayer.getAccount('bank')
    if bankAccount.money >= amount then
        xPlayer.removeAccountMoney('bank', amount, 'ถอนเงินออกจากบัญชี')
        xPlayer.addAccountMoney('money', amount, 'ถอนเงินจากธนาคาร')
        
        TriggerClientEvent('esx:showNotification', source, 'ถอนเงินสำเร็จ $' .. amount)
        
        pcall(function()
            exports.nc_discordlogs:Discord({
                webhook = 'bankWithdraw',
                xPlayer = source,
                message = '丨`ถอนเงินธนาคาร`',
                description = string.format('```ถอนเงินออกบัญชีจำนวน $%s```', amount)
            })
        end)
    else
        TriggerClientEvent('esx:showNotification', source, 'ยอดเงินไม่พอ')
    end
end)

RegisterNetEvent('shop:buyWithBank', function(itemName, price)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    local vat = 0.07
    local totalPrice = math.ceil(price * (1 + vat))
    
    local bankAccount = xPlayer.getAccount('bank')
    if bankAccount.money >= totalPrice then
        xPlayer.removeAccountMoney('bank', totalPrice, 'ซื้อ ' .. itemName)
        xPlayer.addInventoryItem(itemName, 1)
        
        TriggerClientEvent('esx:showNotification', source, 
            'ซื้อสำเร็จ $' .. totalPrice .. ' (รวม VAT 7%)')
    else
        TriggerClientEvent('esx:showNotification', source, 
            'ยอดเงินธนาคารไม่พอ ต้องการ $' .. totalPrice)
    end
end)

RegisterNetEvent('banking:transfer', function(targetId, amount)
    local xPlayer = ESX.GetPlayerFromId(source)
    local xTarget = ESX.GetPlayerFromId(targetId)
    
    if not xTarget then
        return TriggerClientEvent('esx:showNotification', source, 'ไม่พบผู้รับเงิน')
    end
    
    local playerVIP = ESX.GetVip(source)
    local isVIP = playerVIP == 'vvip' or playerVIP == 'mvp'
    
    local fee = isVIP and 0 or math.ceil(amount * 0.07)
    local totalAmount = amount + fee
    
    local bankAccount = xPlayer.getAccount('bank')
    if bankAccount.money >= totalAmount then
        xPlayer.removeAccountMoney('bank', totalAmount, 'โอนเงินให้ ' .. xTarget.getName())
        xTarget.addAccountMoney('bank', amount, 'รับเงินจาก ' .. xPlayer.getName())
        
        TriggerClientEvent('esx:showNotification', source, 
            'โอนเงิน $' .. amount .. (fee > 0 and ' (ค่าธรรมเนียม $' .. fee .. ')' or ''))
        TriggerClientEvent('esx:showNotification', targetId, 
            'คุณได้รับเงิน $' .. amount)
    else
        TriggerClientEvent('esx:showNotification', source, 'ยอดเงินไม่พอ')
    end
end)

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

• ถอนเงินจากธนาคาร

• จ่ายเงินผ่านบัตรเครดิต

• โอนเงินระหว่างผู้เล่น

• ซื้อสินค้า/บริการด้วยเงินธนาคาร

• หักค่าธรรมเนียมต่างๆ

ควรตรวจสอบยอดเงินด้วย xPlayer.getAccount(name).money ก่อนหักเสมอ เพื่อป้องกันยอดติดลบ

---

xPlayer.clearAccounts

รีเซ็ตยอดเงินในบัญชีทั้งหมดให้เป็นศูนย์

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

xPlayer.clearAccounts(reason)

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

Name	Type	Description
reason	string	(ไม่บังคับ) เหตุผลในการรีเซ็ต

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

Type	Description
boolean	true หากสำเร็จ

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

local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.clearAccounts('Admin reset')

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

RegisterCommand('wipecharacter', function(source, args)
    if not IsPlayerAceAllowed(source, 'admin') then return end
    
    local targetId = tonumber(args[1])
    if targetId then
        local xTarget = ESX.GetPlayerFromId(targetId)
        if xTarget then
            xTarget.clearAccounts('Character wipe by admin')
            xTarget.clearInventory('Character wipe by admin')
            xTarget.clearLoadout('Character wipe by admin')
            xTarget.setJob('unemployed', 0)
            
            TriggerClientEvent('esx:showNotification', targetId, 
                'ตัวละครของคุณถูกรีเซ็ตโดยแอดมิน')
        end
    end
end)

RegisterNetEvent('admin:punish', function(targetId, reason)
    local xPlayer = ESX.GetPlayerFromId(source)
    if xPlayer.getGroup() ~= 'admin' then return end
    
    local xTarget = ESX.GetPlayerFromId(targetId)
    if xTarget then
        xTarget.clearAccounts('Punished: ' .. reason)
        
        TriggerClientEvent('esx:showNotification', targetId, 
            'คุณถูกลงโทษ: ' .. reason)
    end
end)

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

• รีเซ็ตตัวละครทั้งหมด (Character Wipe)

• ลงโทษผู้เล่น

• แก้ไขปัญหาเงินผิดพลาดร้ายแรง

• เตรียมตัวละครสำหรับระบบใหม่

ฟังก์ชันนี้จะ ลบเงินทั้งหมด ทุกบัญชีของผู้เล่น ควรใช้อย่างระมัดระวัง และควรมี confirmation ก่อนเรียกใช้

---

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

Function	Description	Use Case
getMoney()	ดึงเงินสด	ตรวจสอบยอดก่อนซื้อ
setMoney()	ตั้งค่าเงินสด	รีเซ็ตเงินเริ่มต้น
addMoney()	เพิ่มเงินสด	รับรางวัล, เงินเดือน
removeMoney()	หักเงินสด	ซื้อของ, จ่ายค่าบริการ
getAccount()	ดึงข้อมูลบัญชี	ตรวจสอบยอดธนาคาร
getAccounts()	ดึงบัญชีทั้งหมด	แสดงใน UI
setAccountMoney()	ตั้งค่าเงินในบัญชี	แก้ไขเงิน (Admin)
addAccountMoney()	เพิ่มเงินในบัญชี	ฝากเงิน, รับโอน
removeAccountMoney()	หักเงินในบัญชี	ถอนเงิน, จ่ายผ่านบัตร
clearAccounts()	รีเซ็ตทุกบัญชี	ลงโทษ, Wipe ตัวละคร

---

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

1

ตรวจสอบก่อนหัก

ใช้ xPlayer.getAccount() เช็คยอดก่อน xPlayer.removeAccountMoney()

2

ระบุ Reason เสมอ

ช่วยในการตรวจสอบ log และ debug

3

บันทึก Log

ใช้ discord logs หรือระบบ log ของคุณสำหรับธุรกรรมสำคัญ

4

ใช้ Transaction

ถ้าต้องทำหลายขั้นตอนในครั้งเดียว ให้ใช้ xPlayer.transaction() (ถ้ามีในเวอร์ชันของคุณ)

5

ป้องกันการโกง

ตรวจสอบและ validate input ทุกครั้งก่อนเปลี่ยนแปลงยอดเงิน