P7 · Network: OneSync & routing buckets · Quasar Academy

Make the resource folder

The server has one folder for this lesson.

Inside your server's resources folder, create this folder:

code

resources/qu_network_onesync

Create the files

Every file named in the manifest exists.

Create this exact file layout:

code

resources/qu_network_onesync/
fxmanifest.lua
server.lua

Write fxmanifest.lua

FiveM knows which files to load.

Open fxmanifest.lua and paste this:

code

fx_version 'cerulean'
game 'gta5'

server_script 'server.lua'

Older tutorials add a lua54 'yes' line here. As of June 2025 that setting is deprecated and ignored: Lua 5.4 is the only Lua runtime now, so you leave it out.

Write the lesson code

A real instance manager that partitions players exists.

Open server.lua and paste this:

code

-- Move yourself into a heist instance (its own routing bucket).
RegisterCommand('heist', function(src)
local bucket = 10

-- 1. Make this bucket a clean, locked-down instance.
SetRoutingBucketPopulationEnabled(bucket, false)
SetRoutingBucketEntityLockdownMode(bucket, 'strict')

-- 2. Move the player into it. They now share a world only with
--    other players in bucket 10.
SetPlayerRoutingBucket(src, bucket)

print(('[qu_network_onesync] moved %s (id %s) into heist bucket %d'):format(GetPlayerName(src), src, bucket))
end, false)

-- Send yourself back to the shared world (bucket 0).
RegisterCommand('leaveheist', function(src)
SetPlayerRoutingBucket(src, 0)
print(('[qu_network_onesync] returned %s (id %s) to bucket 0'):format(GetPlayerName(src), src))
end, false)

-- Read which bucket a player is currently in.
RegisterCommand('mybucket', function(src)
print(('[qu_network_onesync] %s is in bucket %d'):format(GetPlayerName(src), GetPlayerRoutingBucket(src)))
end, false)

Start and test it

The expected proof appears in the txAdmin Live Console.

Open server.cfg and add this line:

code

ensure qu_network_onesync

Save, then run:

code

restart qu_network_onesync

Join the server, then run this in the chat box (press T) or F8 console:

code

/heist then /mybucket

Prove the invisibility

Two players confirm a routing bucket really partitions the world.

A bucket number printing is not proof of anything. The whole point of this feature is that players in different buckets cannot see each other. So test that directly.

Get two players on the server (a friend, or a second FiveM client on another machine). Have both stand next to each other so you can see each other's character. Then on player one only, run:

code

/heist

Player one is now in bucket 10. Player two is still in bucket 0. Watch what happens: player one's character vanishes from player two's screen, and player two vanishes from player one's. You are standing on identical coordinates and you cannot see each other. Run /leaveheist on player one and you reappear to each other instantly. That disappearance is the routing bucket doing its only job.

OneSync & routing buckets

Build it

Make the resource folder

Create the files

Write fxmanifest.lua

Write the lesson code

Start and test it

Prove the invisibility

Keep reading the full lesson