ผู้เล่น (Players)

ภาพรวม

ไฟล์นี้เป็นการตั้งค่าพื้นฐานของระบบผู้เล่น ควบคุมการทำงานต่างๆ ที่เกี่ยวข้องกับผู้เล่นในเกม

ที่อยู่ไฟล์

config/global/player.config.lua

โครงสร้างข้อมูล

PlayerIntegration

ตัวแปร	ประเภท	คำอธิบาย
primary	string	ตัวแทนหลักที่ใช้เพื่อระบุตัวตนของผู้เล่น
synced	table	รายการข้อมูลที่ต้องการซิงโครไนซ์ระหว่างตัวแทนต่างๆ
synced.discord	boolean|nil	การซิงโครไนซ์กับ Discord
synced.xbl	boolean|nil	การซิงโครไนซ์กับ Xbox Live

NewPlayerData

ตัวแปร	ประเภท	คำอธิบาย
spawnCoords	vec4	พิกัดที่เกิดของผู้เล่นใหม่
group	string	กลุ่มของผู้เล่นใหม่
exp	number	ประสบการณ์ของผู้เล่นใหม่
job	table	ข้อมูลงานของผู้เล่นใหม่
loadout	table	อาวุธที่ผู้เล่นใหม่จะได้รับเมื่อเริ่มเกม
maxWeight	number	น้ำหนักรวมสูงสุดที่ผู้เล่นสามารถพกได้
inventory	table	รายการสิ่งของในกระเป๋าของผู้เล่นใหม่

AccountConfig

ตัวแปร	ประเภท	คำอธิบาย
label	string	ป้ายกำกับ
decimals	boolean	จำนวนทศนิยม
default	number	ค่าเริ่มต้น

PlayerGroup

ตัวแปร	ประเภท	คำอธิบาย
label	string	ป้ายกำกับ

JobConfig

ตัวแปร	ประเภท	คำอธิบาย
name	string	ชื่องานอาชีพ
grade	number	ระดับอาชีพ
grade_name	string	ชื่อระดับอาชีพ
grade_label	string	ป้ายกำกับระดับอาชีพ
grade_salary	number	เงินเดือนของระดับอาชีพ
skin_male	table	ข้อมูลเกี่ยวกับสเกินของตัวละครชาย
skin_female	table	ข้อมูลเกี่ยวกับสเกินของตัวละครหญิง

TPlayerMultipleConnections

ตัวแปร	ประเภท	คำอธิบาย
kick	boolean	ถ้าเป็นจริงจะถูกเตะออกจากเซิฟเวอร์หากมีการเชื่อมต่อจากหลายเครื่องโดยใช้ identifier เดียวกัน
message	string	ข้อความที่จะแสดงถ้ามีการเชื่อมต่อจากอุปกรณ์อื่น

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

-- ตั้งค่าการเชื่อมต่อหลายเครื่อง (เผื่อเทส)
Config.PlayerMultipleConnections = {
    kick = false, -- ปิดการเตะออกจากเซิฟเวอร์หากมีการเชื่อมต่อจากหลายเครื่องโดยใช้ identifier เดียวกัน
    message = "steam นี้มีการเชื่อมต่ออยู่แล้ว" -- ข้อความที่จะแสดงถ้ามีการเชื่อมต่อจากหลายเครื่องโดยใช้ identifier เดียวกัน
}

-- ตั้งค่าการระบุตัวตน
Config.Players.IdentifierIntegration = {
    primary = 'steam', -- ตัวแทนหลักที่ใช้เพื่อระบุตัวตนของผู้เล่น
    synced = {
        discord = true, -- การซิงโครไนซ์กับ Discord
        xbl = true -- การซิงโครไนซ์กับ Xbox Live
    }
}
--- หลังจากการเข้าครั้งแรกไปแล้ว และ การเชื่อมต่อถัดๆไป ไม่ใช้ steam และ discord และ xbl ที่เคยเข้าครั้งแรกจะไม่สามารถเชื่อมต่อได้

-- ตั้งค่าข้อมูลผู้เล่นใหม่
Config.Players.NewPlayerData = {
    spawnCoords = vec4(-32.2, -0.88, 71.24, 0.0), --- พิกัดที่ผู้เล่นจะเกิด
    group = "user", --- กลุ่มของผู้เล่น
    sex = "m", --- เพศของผู้เล่น
    exp = 0, --- ประสบการณ์ของผู้เล่น
    job = {
        name = 'unemployed', --- เป็นประชาชนทั่วไป
        grade = 0, --- ระดับ 0
    },
    loadout = {
        ['WEAPON_SNOWBALL'] = { --- แจก snowball 100 อันเอาไว้ปาเล่นกัน
            tintIndex = 0,
            components = {},
            ammo = 100
        },
    },
    maxWeight = 100000, --- น้ำหนักสูงสุดที่ผู้เล่นสามารถพกได้ 
    inventory = {
        ['bread'] = 1000, --- ได้ขนมปัง 1000 ชิ้นเมื่อเข้าครั้งแรก
    },
}

-- ตั้งค่าบัญชีของผู้เล่นที่มีในเซิฟเวอร์
Config.Players.Accounts = {
    ['money'] = {
        label = "เงินสด",
        decimals = false,
        default = 5000, --- ค่าเริ่มต้นของบัญชีเงินสดสำหรับผู้เล่นใหม่
    },
    ['bank'] = {
        label = "ธนาคาร",
        decimals = false,
        default = 30000, --- ค่าเริ่มต้นของบัญชีธนาคารสำหรับผู้เล่นใหม่
    },
    ['black_money'] = {
        label = "เงินดำ",
        decimals = false,
        default = 0, --- ค่าเริ่มต้นของบัญชีเงินดำสำหรับผู้เล่นใหม่
    },
    
    ---@comments ตัวอย่างการเพิ่ม บัญชีอื่น ๆ ใส่ได้ไม่จำกัด
    ['atc'] = {
        label = "Aitcoin",
        decimals = true,
        default = 1.5, --- ค่าเริ่มต้นของบัญชี Aitcoin สำหรับผู้เล่นใหม่
    },

    ---@comments ตัวอย่างการเพิ่ม บัญชีอื่น ๆ ใส่ได้ไม่จำกัด
    ['credit'] = {
        label = "บัตรเครดิต",
        decimals = true,
        default = 0, --- ค่าเริ่มต้นของบัญชีบัตรเครดิตสำหรับผู้เล่นใหม่ (สมมุติว่าเป็นเงินเติมจากเงินจริงๆ)
    },
}

---@comments ตัวอย่างการใช้บัญชีที่เพิ่มมาใหม่
local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addAccount('atc', 1000.23) -- เพิ่มบัญชี Aitcoin 1000.23

---@comments ตัวอย่างการเพิ่มบัญชีที่เพิ่มมาใหม่ credit เป็นบัตรเครดิต
local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addAccount('credit', 999.99) -- เพิ่มบัญชี credit 999.99 ผู้เล่นเติมเงินมาว่ะะะ!!!

---@comments ตัวอย่างการตั้งค่ากลุ่มผู้เล่น
Config.Players.Groups = {
    ['user'] = {
        label = "ผู้เล่น",
    },
    ['admin'] = {
        label = "ผู้ดูแล",
    },
    ['superadmin'] = {
        label = "ผู้ดูแลระบบ",
    }
}