Hexa Framework ​

hexa_core เวอร์ชัน 3.0.0 คือฐานที่ resource อื่นของ Hexa ทั้งหมดวางอยู่บน ต้องการแค่ oxmysql ตัวเดียวเป็น dependency

เวอร์ชัน 3.0.0 แบน API สาธารณะทั้งชุด ถ้าเคยเขียนกับเฟรมเวิร์กนี้มาก่อน สรุปสั้นที่สุดคือ ลบ .Functions ออกจากทุกจุดที่เรียก

core object เป็นชั้นเดียว ​

local Core = exports['hexa_core']:GetCoreObject()

RegisterCommand('bonus', function(source)
    local Player = Core.GetPlayer(source)
    if not Player then return end
    Player.AddMoney('cash', 100, 'daily bonus')
end, false)

ชื่อเดิมอย่าง Core.Functions.GetPlayer(source) และ Player.Functions.AddMoney(...) ยังเรียกได้อีกหนึ่งรุ่น เวลาถูกเรียกจะเตือน หนึ่งครั้งต่อชื่อ พร้อมบอกว่า resource ไหนเป็นคนเรียก แล้วส่งต่อไปชื่อใหม่ให้

ลงทะเบียนไอเทม กับ ให้ไอเทม เป็นคนละเรื่อง ​

เมื่อก่อนสองคำกริยานี้ใช้ชื่อเดียวกันทั้งที่ความหมายตรงข้ามกัน ตอนนี้แยกขาดแล้ว และนี่คือเรื่องที่ต้องเข้าใจก่อนเรื่องอื่นทั้งหมด

-- นิยามไอเทม "ชนิดใหม่" ให้ทั้งเซิร์ฟรู้จัก
Core.RegisterItem('canteen', {
    name = 'canteen',
    label = 'Canteen',
    weight = 2,
    type = 'item',
    image = 'canteen.png',
    unique = false,
    useable = true,
    shouldClose = true,
})

-- ใส่ของลงกระเป๋าผู้เล่น "คนเดียว"
local Player = Core.GetPlayer(source)
Player.AddItem('canteen', 1, false, false, 'shop purchase')

ฝั่งแคตตาล็อกคือ Core.RegisterItem, Core.UnregisterItem, Core.RegisterItems และ Core.UpdateItemDefinition อาชีพก็ใช้รูปเดียวกันคือ Core.RegisterJob, Core.UnregisterJob, Core.RegisterJobs และ Core.UpdateJobDefinition ส่วนฝั่งผู้เล่นคือ Player.AddItem กับ Player.RemoveItem เท่านั้น

Callback สองทาง ​

-- server
Core.CreateCallback('bank:getBalance', function(source, cb)
    local Player = Core.GetPlayer(source)
    cb(Player and Player.GetMoney('bank') or 0)
end)

-- client
Core.TriggerCallback('bank:getBalance', function(balance)
    print(('balance: %s'):format(balance))
end)

การเซฟเป็นหน้าที่ของ server ​

เดิมรอบเซฟเดินอยู่ฝั่ง client ซึ่งแปลว่า client ไม่ยิงเข้ามาก็ไม่มีใครถูกเซฟ ตอนนี้ server เป็นเจ้าของรอบเวลาทั้งหมด

-- ถ้าไปแก้ข้อมูลผู้เล่นเองนอกเส้นทางปกติ ให้บังคับเข้าคิวรอบถัดไปแบบนี้
local Player = Core.GetPlayer(source)
Player.MarkDirty()

Core.SaveAllPlayers() เขียนทุกคนทันทีและคืนจำนวนคนที่เขียนไป เป็นตัวเดียวกับที่ onResourceStop เรียกตอน Config.Save.OnResourceStop เปิดอยู่ ส่วนคนที่หลุดจะถูก playerDropped เซฟโดยไม่มีเงื่อนไข คีย์ Config.Save.OnDrop ยังคงอยู่แต่โค้ดปัจจุบันไม่ได้อ่าน

ระบบ log ​

ตัวพิมพ์ชุดเดียว signature เหมือนกันเป๊ะทั้งสองฝั่ง ใช้รูปแบบ printf

Core.Log('spawned %d wagons', 4)
Core.Warn('no grade %s on job %s', grade, job)
Core.Error('save failed for %s', citizenid)
Core.PrintDebug('bucket now %d', bucket)
Core.DumpTable(Player.PlayerData)

Core.PrintDebug ผูกกับ Config.Debug และเช็กสวิตช์ก่อนจะฟอร์แมตสตริง ทิ้งโค้ด debug ไว้ในของจริงจึงไม่เสียค่าอะไรเลยตอนปิดอยู่ นอกจากนี้ hexa_core รับ event hexa_log:server:CreateLog เองแล้ว และส่งต่อเข้า Discord ให้ถ้าตั้ง URL ไว้ใน Config.Log.Webhooks

อ่านต่อที่ไหน ​

• เริ่มต้นใช้งาน สำหรับการติดตั้งและ resource แรก
• การตั้งค่า สำหรับคีย์คอนฟิกทุกตัว
• Player object สำหรับรายชื่อเมธอดทั้งหมด
• Server functions และ client functions สำหรับ API reference
• Compatibility bridge สำหรับการย้าย resource ของ RSG Core และ VORP Core