OneSync

Functions

GetPlayersInArea(source, maxDistance, ignore)

ค้นหาผู้เล่นทั้งหมดในรัศมีที่กำหนด

Parameter
Type
Description

source

number/vector3

ไอดีผู้เล่นหรือพิกัดที่จะค้นหา

maxDistance

number

ระยะทางสูงสุดที่จะค้นหา (หน่วยเป็นเมตร)

ignore

table

รายชื่อผู้เล่นที่จะไม่ค้นหา (key=playerId, value=true)

Returns: table รายการผู้เล่นที่พบ

-- ค้นหาจากไอดีผู้เล่น
local players = AFUCore.OneSync.GetPlayersInArea(1, 100)

-- ค้นหาจากพิกัด
local players = AFUCore.OneSync.GetPlayersInArea(vector3(100.0, 100.0, 30.0), 100)

GetClosestPlayer(source, maxDistance, ignore)

ค้นหาผู้เล่นที่ใกล้ที่สุด

Parameter
Type
Description

source

number/vector3

ไอดีผู้เล่นหรือพิกัดที่จะค้นหา

maxDistance

number

ระยะทางสูงสุดที่จะค้นหา

ignore

table

รายชื่อผู้เล่นที่จะไม่ค้นหา

Returns: table ข้อมูลผู้เล่นที่ใกล้ที่สุด

local player = AFUCore.OneSync.GetClosestPlayer(1, 100)
-- returns: { id = playerId, ped = pedNetId, coords = vector3, dist = distance }

SpawnVehicle(model, coords, heading, properties, cb)

สร้างยานพาหนะ

Parameter
Type
Description

model

string/number

ชื่อหรือแฮชของโมเดลรถ

coords

vector3/table

พิกัดที่จะสร้าง

heading

number

องศาการหันหน้า

properties

table

คุณสมบัติของรถ

cb

function

ฟังก์ชันที่จะเรียกหลังสร้างเสร็จ

AFUCore.OneSync.SpawnVehicle('adder', vector3(100.0, 100.0, 30.0), 90.0, {
    plate = 'TEST123'
}, function(netId)
    print('Vehicle spawned with netId: ' .. netId)
end)

SpawnPed(model, coords, heading, cb)

สร้างตัวละคร NPC

Parameter
Type
Description

model

string/number

ชื่อหรือแฮชของโมเดล Ped

coords

vector3/table

พิกัดที่จะสร้าง

heading

number

องศาการหันหน้า

cb

function

ฟังก์ชันที่จะเรียกหลังสร้างเสร็จ

AFUCore.OneSync.SpawnPed('a_m_m_bevhills_01', vector3(100.0, 100.0, 30.0), 90.0, function(netId)
    print('Ped spawned with netId: ' .. netId)
end)

SpawnObject(model, coords, heading, cb)

สร้างวัตถุ

Parameter
Type
Description

model

string/number

ชื่อหรือแฮชของโมเดลวัตถุ

coords

vector3/table

พิกัดที่จะสร้าง

heading

number

องศาการหันหน้า

cb

function

ฟังก์ชันที่จะเรียกหลังสร้างเสร็จ

AFUCore.OneSync.SpawnObject('prop_atm_01', vector3(100.0, 100.0, 30.0), 90.0, function(netId)
    print('Object spawned with netId: ' .. netId)
end)

GetPedsInArea(coords, maxDistance, modelFilter)

ค้นหา Ped ในรัศมีที่กำหนด

Parameter
Type
Description

coords

vector3

พิกัดที่จะค้นหา

maxDistance

number

ระยะทางสูงสุดที่จะค้นหา

modelFilter

table

ฟิลเตอร์โมเดล (key=hash, value=true)

Returns: table รายการ netId ของ Ped ที่พบ

local peds = AFUCore.OneSync.GetPedsInArea(vector3(100.0, 100.0, 30.0), 100)
--- [23412, 23413, 23414, ...]

GetObjectsInArea(coords, maxDistance, modelFilter)

ค้นหาวัตถุในรัศมีที่กำหนด

Parameter
Type
Description

coords

vector3

พิกัดที่จะค้นหา

maxDistance

number

ระยะทางสูงสุดที่จะค้นหา

modelFilter

table

ฟิลเตอร์โมเดล

Returns: table รายการ netId ของวัตถุที่พบ

local objects = AFUCore.OneSync.GetObjectsInArea(vector3(100.0, 100.0, 30.0), 100)
--- [23412, 23413, 23414, ...]

GetVehiclesInArea(coords, maxDistance, modelFilter)

ค้นหายานพาหนะในรัศมีที่กำหนด

Parameter
Type
Description

coords

vector3

พิกัดที่จะค้นหา

maxDistance

number

ระยะทางสูงสุดที่จะค้นหา

modelFilter

table

ฟิลเตอร์โมเดล

Returns: table รายการ netId ของยานพาหนะที่พบ

local vehicles = AFUCore.OneSync.GetVehiclesInArea(vector3(100.0, 100.0, 30.0), 100)
--- [23412, 23413, 23414, ...]

หมายเหตุ

  • ทุกฟังก์ชันทำงานเฉพาะเมื่อเปิดใช้งาน OneSync

  • มีระบบ Entity State Bag สำหรับเก็บข้อมูลเพิ่มเติม

  • รองรับการทำงานแบบ Async/Await

  • มีระบบ Entity Cleanup อัตโนมัติ

  • ใช้ Network ID ในการอ้างอิง Entity ระหว่าง Client/Server