Server (OneSync)

ฟังก์ชันฝั่ง Server ที่เรียกผ่าน ESX.OneSync.* สำหรับค้นหา/จัดการเอนทิตี และสปอว์นแบบเน็ตเวิร์ก (ต้องเปิด OneSync)

Server (OneSync)

ฟังก์ชันฝั่ง Server (OneSync)

หน้านี้รวบรวมฟังก์ชันหลักฝั่ง Server-side ที่เรียกผ่าน ESX.OneSync.*

ใช้สำหรับค้นหา/จัดการเอนทิตี (player / ped / vehicle / object) ในพื้นที่

รองรับการสปอว์นเอนทิตีแบบเน็ตเวิร์กจากฝั่ง Server

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

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

• เปิด OneSync บนเซิร์ฟเวอร์ FiveM ก่อนใช้งาน ESX.OneSync.*

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

หากไม่เปิด OneSync ฟังก์ชัน ESX.OneSync.* จะใช้งานไม่ได้

รูปแบบพารามิเตอร์ที่พบบ่อย

• source: รับได้ทั้ง playerId (server id) หรือ vector3

• coords: vector3 หรือ table ที่มี x, y, z

• ignore: ใช้ table แบบ {[id] = true} เพื่อข้าม player บางคนในการค้นหา

• modelFilter: ใช้ table แบบ {[hash] = true} เพื่อจำกัดโมเดลที่ต้องการค้นหา

---

ESX.OneSync.GetClosestPlayer

ค้นหาผู้เล่นที่อยู่ใกล้ที่สุด โดยอ้างอิงจาก source หรือพิกัดที่ระบุ

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

ESX.OneSync.GetClosestPlayer(source, maxDistance, ignore)

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

Name	Type	Description
source	number|vector3	Server ID ของผู้เล่น หรือพิกัด
maxDistance	number	(ไม่บังคับ) ระยะค้นหาสูงสุด (ค่าเริ่มต้น: 100)
ignore	table	(ไม่บังคับ) ตาราง player id ที่ต้องการข้าม {[id] = true}

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

Type	Description
table	ตารางที่มี id, ped (network id), coords, dist ของผู้เล่นที่ใกล้สุด หรือเป็น table ว่าง

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

local closest = ESX.OneSync.GetClosestPlayer(source, 50)
if closest.id then
    print('Closest player: ' .. closest.id .. ' at distance: ' .. closest.dist)
end

---

ESX.OneSync.GetPlayersInArea

ค้นหาผู้เล่นทั้งหมดภายในระยะที่กำหนด จาก source หรือพิกัดที่ระบุ

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

ESX.OneSync.GetPlayersInArea(source, maxDistance, ignore)

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

Name	Type	Description
source	number|vector3	Server ID ของผู้เล่น หรือพิกัด
maxDistance	number	(ไม่บังคับ) ระยะค้นหาสูงสุด (ค่าเริ่มต้น: 100)
ignore	table	(ไม่บังคับ) ตาราง player id ที่ต้องการข้าม

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

Type	Description
table	Array ของตารางที่มี id, ped (network id), coords, dist

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

local nearbyPlayers = ESX.OneSync.GetPlayersInArea(source, 30)
for i = 1, #nearbyPlayers do
    print('Nearby: ' .. nearbyPlayers[i].id)
end

---

ESX.OneSync.GetNearbyPlayers

ฟังก์ชันภายในที่ใช้เป็นแกนให้ GetClosestPlayer และ GetPlayersInArea

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

ESX.OneSync.GetNearbyPlayers(source, closest, distance, ignore)

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

Name	Type	Description
source	number|vector3	Server ID ของผู้เล่น หรือพิกัด
closest	boolean	ใส่ true เพื่อคืนค่าเฉพาะผู้เล่นที่ใกล้ที่สุด
distance	number	(ไม่บังคับ) ระยะค้นหาสูงสุด (ค่าเริ่มต้น: 100)
ignore	table	(ไม่บังคับ) ตาราง player id ที่ต้องการข้าม

---

ESX.OneSync.GetClosestEntity

ค้นหา entity ที่อยู่ใกล้ที่สุดจากรายการ entities โดยอ้างอิงจากพิกัดที่ระบุ

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

ESX.OneSync.GetClosestEntity(entities, coords, modelFilter, isPed)

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

Name	Type	Description
entities	table	อาร์เรย์ของ entity handle
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
modelFilter	table	(ไม่บังคับ) ตาราง model hash {[hash] = true}
isPed	boolean	(ไม่บังคับ) ถ้า true จะไม่รวม ped ของผู้เล่น

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

Type	Description
number	Network ID ของเอนทิตีที่ใกล้ที่สุด
number	ระยะห่างไปยังเอนทิตีที่ใกล้ที่สุด
vector3	พิกัดของเอนทิตีที่ใกล้ที่สุด

---

ESX.OneSync.GetClosestObject

ค้นหา object ที่อยู่ใกล้ที่สุดจากพิกัดที่ระบุ

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

ESX.OneSync.GetClosestObject(coords, modelFilter)

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

Name	Type	Description
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
modelFilter	table	(ไม่บังคับ) ตาราง model hash ที่ต้องการกรอง

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

Type	Description
number	Network ID ของ object ที่ใกล้ที่สุด
number	ระยะห่าง
vector3	พิกัด

---

ESX.OneSync.GetClosestPed

ค้นหา ped ที่ไม่ใช่ผู้เล่น ที่อยู่ใกล้ที่สุดจากพิกัดที่ระบุ

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

ESX.OneSync.GetClosestPed(coords, modelFilter)

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

Name	Type	Description
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
modelFilter	table	(ไม่บังคับ) ตาราง model hash ที่ต้องการกรอง

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

Type	Description
number	Network ID ของ ped ที่ใกล้ที่สุด
number	ระยะห่าง
vector3	พิกัด

---

ESX.OneSync.GetClosestVehicle

ค้นหายานพาหนะที่อยู่ใกล้ที่สุดจากพิกัดที่ระบุ

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

ESX.OneSync.GetClosestVehicle(coords, modelFilter)

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

Name	Type	Description
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
modelFilter	table	(ไม่บังคับ) ตาราง model hash ที่ต้องการกรอง

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

Type	Description
number	Network ID ของยานพาหนะที่ใกล้ที่สุด
number	ระยะห่าง
vector3	พิกัด

---

ESX.OneSync.GetNearbyEntities

ค้นหา entity ทั้งหมดภายในระยะที่กำหนด จากพิกัดที่ระบุ

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

ESX.OneSync.GetNearbyEntities(entities, coords, modelFilter, maxDistance, isPed)

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

Name	Type	Description
entities	table	Array ของ entity handle
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
modelFilter	table	(ไม่บังคับ) ตาราง model hash ที่ต้องการกรอง
maxDistance	number	(ไม่บังคับ) ระยะสูงสุด
isPed	boolean	(ไม่บังคับ) ถ้า true จะไม่รวม ped ของผู้เล่น

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

Type	Description
table	Array ของ network id ของเอนทิตีในระยะ

---

ESX.OneSync.GetObjectsInArea

ค้นหา object ทั้งหมดภายในระยะที่กำหนด จากพิกัดที่ระบุ

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

ESX.OneSync.GetObjectsInArea(coords, maxDistance, modelFilter)

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

Name	Type	Description
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
maxDistance	number	ระยะค้นหาสูงสุด
modelFilter	table	(ไม่บังคับ) ตาราง model hash ที่ต้องการกรอง

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

Type	Description
table	Array ของ network id ของ object

---

ESX.OneSync.GetPedsInArea

ค้นหา ped ที่ไม่ใช่ผู้เล่นทั้งหมดภายในระยะที่กำหนด จากพิกัดที่ระบุ

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

ESX.OneSync.GetPedsInArea(coords, maxDistance, modelFilter)

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

Name	Type	Description
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
maxDistance	number	ระยะค้นหาสูงสุด
modelFilter	table	(ไม่บังคับ) ตาราง model hash ที่ต้องการกรอง

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

Type	Description
table	Array ของ network id ของ ped

---

ESX.OneSync.GetVehiclesInArea

ค้นหายานพาหนะทั้งหมดภายในระยะที่กำหนด จากพิกัดที่ระบุ

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

ESX.OneSync.GetVehiclesInArea(coords, maxDistance, modelFilter)

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

Name	Type	Description
coords	number|vector3	Server ID ของผู้เล่น หรือพิกัด
maxDistance	number	ระยะค้นหาสูงสุด
modelFilter	table	(ไม่บังคับ) ตาราง model hash ที่ต้องการกรอง

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

Type	Description
table	Array ของ network id ของยานพาหนะ

---

ESX.OneSync.GetVehicleType

ดึงประเภทของยานพาหนะจากโมเดล (ชื่อหรือ hash) โดยใช้ client callback เพื่อระบุ type

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

ESX.OneSync.GetVehicleType(model, playerId, cb)

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

Name	Type	Description
model	string|number	ชื่อโมเดลยานพาหนะ หรือ hash
playerId	number	Server ID ของผู้เล่น (ใช้สำหรับ client callback)
cb	function	Callback function(vehicleType)

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

ESX.OneSync.GetVehicleType('adder', source, function(vehicleType)
    print('Vehicle type: ' .. vehicleType) -- "automobile"
end)

---

ESX.OneSync.SpawnVehicle

Spawn ยานพาหนะแบบ networked จากฝั่ง Server ด้วย OneSync

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

ESX.OneSync.SpawnVehicle(model, coords, heading, properties, cb)

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

Name	Type	Description
model	string|number	ชื่อโมเดลยานพาหนะ หรือ hash
coords	vector3|table	พิกัดสำหรับสปอว์น
heading	number	มุมหัน (heading)
properties	table	(ไม่บังคับ) properties ของรถที่ต้องการใส่
cb	function	Callback function(networkId)

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

ESX.OneSync.SpawnVehicle('adder', vector3(100.0, 200.0, 30.0), 90.0, {}, function(netId)
    print('Vehicle spawned with network ID: ' .. netId)
end)

พารามิเตอร์ cb เป็น ค่าบังคับ หากไม่ส่งมา ฟังก์ชันจะหยุดทันที และจะไม่ spawn entity

---

ESX.OneSync.SpawnPed

Spawn ped แบบ networked จากฝั่ง Server

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

ESX.OneSync.SpawnPed(model, coords, heading, cb)

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

Name	Type	Description
model	string|number	ชื่อโมเดล ped หรือ hash
coords	vector3|table	พิกัดสำหรับสปอว์น (ต้องมี x, y, z)
heading	number	มุมหัน (heading)
cb	function	Callback function(networkId)

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

ESX.OneSync.SpawnPed('a_m_m_business_01', vector3(100.0, 200.0, 30.0), 180.0, function(netId)
    print('Ped spawned with network ID: ' .. netId)
end)

---

ESX.OneSync.SpawnPedInVehicle

Spawn ped เข้าไปในยานพาหนะตามตำแหน่งที่นั่งที่ระบุ

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

ESX.OneSync.SpawnPedInVehicle(model, vehicle, seat, cb)

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

Name	Type	Description
model	string|number	ชื่อโมเดล ped หรือ hash
vehicle	number	Vehicle entity handle
seat	number	ตำแหน่งที่นั่ง (-1 = คนขับ, 0+ = ผู้โดยสาร)
cb	function	Callback function(networkId)

---

ESX.OneSync.SpawnObject

Spawn object แบบ networked จากฝั่ง Server

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

ESX.OneSync.SpawnObject(model, coords, heading, cb)

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

Name	Type	Description
model	string|number	ชื่อโมเดล object หรือ hash
coords	vector3|table	พิกัดสำหรับสปอว์น
heading	number	มุมหัน (heading)
cb	function	Callback function(networkId)

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

ESX.OneSync.SpawnObject('prop_barrel_01a', vector3(100.0, 200.0, 30.0), 0.0, function(netId)
    print('Object spawned with network ID: ' .. netId)
end)