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