Job

ฟังก์ชันฝั่ง Server สำหรับอ่าน/เปลี่ยนอาชีพ (Job) และยศ (grade) ของผู้เล่น ผ่าน xPlayer

Job (xPlayer)

กลุ่มฟังก์ชันสำหรับอ่านและจัดการ “อาชีพ” (Job) และ “ยศ” (grade) ของผู้เล่น

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

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

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

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

local xPlayer = ESX.GetPlayerFromId(source)

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

ห้ามเชื่อข้อมูลที่ส่งมาจาก Client เช่น jobName หรือ grade ให้ตรวจสอบสิทธิ์และตรวจสอบความถูกต้อง (validate) ฝั่ง Server เสมอ

Job คืออาชีพของผู้เล่น เช่น ตำรวจ/หมอ และแต่ละอาชีพมีหลายยศ (grade) โดยทั่วไปยศที่สูงกว่า จะมีเงินเดือน (grade_salary) สูงกว่า

---

xPlayer.getJob

คืนค่าข้อมูลงานปัจจุบันของผู้เล่น

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

xPlayer.getJob()

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

ประเภท	คำอธิบาย
table	Job data object (ดูรายละเอียดด้านล่าง)

โครงสร้าง Job object

ฟิลด์	ประเภท	คำอธิบาย
id	number	Job database ID
name	string	ชื่องาน (เช่น 'police', 'ambulance')
label	string	ชื่อแสดง (เช่น 'ตำรวจ', 'หมอ')
grade	number	เลขยศ (0, 1, 2, ...)
grade_name	string	ชื่อยศภาษาอังกฤษ
grade_label	string	ชื่อยศที่แสดง
grade_salary	number	เงินเดือนตามยศ
skin_male	table	ชุดสำหรับผู้ชาย (ถ้ามี)
skin_female	table	ชุดสำหรับผู้หญิง (ถ้ามี)

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

local xPlayer = ESX.GetPlayerFromId(source)
local job = xPlayer.getJob()

print('งาน: ' .. job.label)
print('ยศ: ' .. job.grade_label)
print('เงินเดือน: $' .. job.grade_salary)

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

{#xplayer-getjob-more-examples}

-- ตรวจสอบว่าเป็นตำรวจหรือไม่
RegisterCommand('duty', function(source, args)
    local xPlayer = ESX.GetPlayerFromId(source)
    local job = xPlayer.getJob()
    
    if job.name == 'police' then
        -- เริ่มเข้าเวร
        TriggerClientEvent('police:onDuty', source)
        xPlayer.showNotification('~g~เข้าเวรตำรวจแล้ว')
    else
        xPlayer.showNotification('~r~คุณไม่ใช่ตำรวจ')
    end
end)

-- ตรวจสอบยศก่อนอนุญาต
RegisterNetEvent('police:openArmory')
AddEventHandler('police:openArmory', function()
    local xPlayer = ESX.GetPlayerFromId(source)
    local job = xPlayer.getJob()
    
    if job.name == 'police' then
        if job.grade >= 3 then
            -- ยศ 3 ขึ้นไปเท่านั้น
            TriggerClientEvent('police:showArmoryMenu', source)
        else
            xPlayer.showNotification('~r~ยศของคุณไม่สูงพอ (ต้องยศ 3 ขึ้นไป)')
        end
    end
end)

-- นับจำนวนตำรวจออนไลน์
RegisterCommand('countpolice', function(source, args)
    local xPlayers = ESX.GetExtendedPlayers()
    local policeCount = 0
    
    for i=1, #xPlayers do
        local job = xPlayers[i].getJob()
        if job.name == 'police' then
            policeCount = policeCount + 1
        end
    end
    
    TriggerClientEvent('esx:showNotification', source, 
        'ตำรวจออนไลน์: ' .. policeCount .. ' คน')
end)

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

• ตรวจสอบสิทธิ์ตามอาชีพ (เช่น เปิดเมนูเฉพาะตำรวจ)

• ตรวจสอบยศก่อนอนุญาตเข้าถึงระบบสำคัญ (คลังอาวุธ/บอสเมนู)

• นับจำนวนผู้เล่นในอาชีพ เพื่อทำเงื่อนไขกิจกรรม

---

xPlayer.setJob

เปลี่ยนงานและยศของผู้เล่น

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

xPlayer.setJob(job, grade)

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

ชื่อ	ประเภท	คำอธิบาย
job	string	ชื่องาน (เช่น 'police', 'ambulance')
grade	string|number	เลขยศ (0, 1, 2, ...)

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

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

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

local xPlayer = ESX.GetPlayerFromId(source)
local success = xPlayer.setJob('police', 0)

if success then
    xPlayer.showNotification('~g~คุณได้เป็นตำรวจแล้ว')
else
    xPlayer.showNotification('~r~ไม่สามารถเปลี่ยนงานได้')
end

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

{#xplayer-setjob-more-examples}

-- Admin เปลี่ยนงานผู้เล่น
RegisterCommand('setjob', function(source, args)
    local xPlayer = ESX.GetPlayerFromId(source)
    
    if xPlayer.getGroup() == 'admin' then
        local targetId = tonumber(args[1])
        local jobName = args[2]
        local jobGrade = tonumber(args[3]) or 0
        
        local xTarget = ESX.GetPlayerFromId(targetId)
        
        if xTarget then
            -- ตรวจสอบว่างานมีอยู่จริง
            ESX.TriggerServerCallback('esx:jobExists', function(exists)
                if exists then
                    xTarget.setJob(jobName, jobGrade)
                    xPlayer.showNotification('~g~เปลี่ยนงานสำเร็จ')
                    xTarget.showNotification('~g~คุณได้เป็น ' .. jobName)
                else
                    xPlayer.showNotification('~r~งานนี้ไม่มีอยู่')
                end
            end, jobName, jobGrade)
        end
    end
end, true)

-- ระบบสมัครงาน (Job Center)
RegisterNetEvent('jobcenter:hire')
AddEventHandler('jobcenter:hire', function(jobName)
    local xPlayer = ESX.GetPlayerFromId(source)
    local currentJob = xPlayer.getJob()
    
    -- ป้องกันการสมัครงานซ้ำ
    if currentJob.name == jobName then
        xPlayer.showNotification('~y~คุณทำงานนี้อยู่แล้ว')
        return
    end
    
    -- ตรวจสอบว่าไม่มีงาน (unemployed) เท่านั้นถึงสมัครได้
    if currentJob.name ~= 'unemployed' then
        xPlayer.showNotification('~r~คุณต้องลาออกจากงานเก่าก่อน')
        return
    end
    
    -- สมัครงานใหม่
    ESX.TriggerServerCallback('esx:jobExists', function(exists)
        if exists then
            xPlayer.setJob(jobName, 0) -- เริ่มที่ยศ 0
            xPlayer.showNotification('~g~สมัครงานสำเร็จ!')
        end
    end, jobName, 0)
end)

-- ระบบเลื่อนยศ (Boss action)
RegisterNetEvent('boss:promoteEmployee')
AddEventHandler('boss:promoteEmployee', function(targetId)
    local xPlayer = ESX.GetPlayerFromId(source)
    local xTarget = ESX.GetPlayerFromId(targetId)
    
    if xTarget then
        local bossJob = xPlayer.getJob()
        local employeeJob = xTarget.getJob()
        
        -- ต้องเป็นบอสของบริษัทเดียวกัน
        if bossJob.name == employeeJob.name and bossJob.grade >= 3 then
            local newGrade = employeeJob.grade + 1
            
            -- ตรวจสอบว่ามียศนี้อยู่
            ESX.TriggerServerCallback('esx:jobExists', function(exists)
                if exists then
                    xTarget.setJob(employeeJob.name, newGrade)
                    xPlayer.showNotification('~g~เลื่อนยศพนักงานสำเร็จ')
                    xTarget.showNotification('~g~คุณได้เลื่อนยศ!')
                else
                    xPlayer.showNotification('~r~ไม่มียศนี้')
                end
            end, employeeJob.name, newGrade)
        else
            xPlayer.showNotification('~r~คุณไม่มีสิทธิ์เลื่อนยศ')
        end
    end
end)

-- ระบบไล่ออก/ลาออก
-- ลาออกจากงาน
RegisterCommand('quitjob', function(source, args)
    local xPlayer = ESX.GetPlayerFromId(source)
    local job = xPlayer.getJob()
    
    if job.name ~= 'unemployed' then
        xPlayer.setJob('unemployed', 0)
        xPlayer.showNotification('~y~คุณลาออกจาก ' .. job.label .. ' แล้ว')
    else
        xPlayer.showNotification('~r~คุณไม่มีงาน')
    end
end)

-- บอสไล่พนักงานออก
RegisterNetEvent('boss:fireEmployee')
AddEventHandler('boss:fireEmployee', function(targetId, reason)
    local xPlayer = ESX.GetPlayerFromId(source)
    local xTarget = ESX.GetPlayerFromId(targetId)
    
    if xTarget then
        local bossJob = xPlayer.getJob()
        local employeeJob = xTarget.getJob()
        
        -- ต้องเป็นบอส (ยศสูงสุด)
        if bossJob.name == employeeJob.name and bossJob.grade >= 3 then
            xTarget.setJob('unemployed', 0)
            xPlayer.showNotification('~g~ไล่พนักงานออกแล้ว')
            xTarget.showNotification('~r~คุณถูกไล่ออก: ' .. reason)
        end
    end
end)

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

• ระบบสมัครงาน (Job Center)

• แอดมินจัดการอาชีพของผู้เล่น

• Boss action (เลื่อนยศ/ไล่ออก)

• ตรวจสอบ job ก่อนอนุญาตเข้าถึงพื้นที่/เมนู/กิจกรรม (white/blacklist)

งานและยศต้องมีอยู่จริงใน database แนะนำให้ตรวจด้วย ESX.DoesJobExist(job, grade) ก่อนเรียก xPlayer.setJob()

ถ้าโปรเจกต์ของคุณมี callback ตรวจสอบงาน (เช่น esx:jobExists) ให้เรียกตรวจสอบก่อนเปลี่ยนงาน/ยศทุกครั้ง

Events ที่ถูก trigger

Event	Parameters
esx:setJob (client)	newJob
esx:onSetJob (server)	source, newJob, lastJob

Event NCCore:setJob จะถูก trigger ไปยัง client ทุกครั้งที่มีการเปลี่ยนงาน เหมาะสำหรับอัปเดต UI, รีโหลดสิทธิ์, หรือเริ่ม/หยุดระบบตามอาชีพ