Jixryo Police

Jixryo Police takes over cuffing, escorting and searching from qbx_police, which keeps everything else. Cuffs go on as GTA's own paired arrest scenes, the restraint decides how the person can move, searches are worked zone by zone through a camera on the spot, and the server checks every item, distance, position and hold before anything changes. It works with Evidence, Prison and MDT.

#What players get

• Restraints that change how you move. Cuffs behind let you walk, but jogging can trip you face down, and sprinting, jumping and doors are out. Cuffs in front let you jog and open doors. Zip ties move like cuffs behind. Leg shackles make you shuffle. Cuffs plus shackles are a transport shuffle with no doors. With your hands restrained you have no weapons, phone, inventory or third eye, you are never the driver, and deep water pulls you under.
• The struggle. Standing and not complying while cuffs go on, you get a skill check during the first part of the hold. Win it and you pull free. Once a minute.
• Ways out. A cuff key takes cuffs and shackles off, anything sharp cuts zip ties, someone else can pick your cuffs with a lockpick (and may snap it), and single-locked cuffs can be slipped yourself with G on a hard skill check, every two minutes. Double-locked cuffs give nothing.
• A card on your screen says what you wear, who put it on and what you can still do.
• Everyone sees the cuffs. Worn cuffs and leg cuffs are networked props. Zip ties do not show.
• Escort. You are held in front of the officer and to their right, where their hand holds your arm, and you walk GTA's cuffed walk at their pace. H pushes you ahead a step; G lets you go, standing upright on the ground.
• Held down. On the floor (tackled, ragdolled, prone, in last stand) anyone with free hands can hold you down. SPACE and a skill check gets you up, harder when cuffed, once every six seconds. The one holding you has about a second to press E and shove you back down.
• Searches you can see coming. A pat-down by anyone who is not on-duty police asks you first, Accept or Decline on your screen, unless you are restrained or down. A pat-down names only hard or sharp things; soft things are only felt. Hidden things need a second, longer hold. A search left open ends on its own after three minutes.
• Hiding things. /conceal hides up to two small stacks on your body: under an insole, in the waistband lining or in your hair. The third eye on an unlocked vehicle hides a stack behind a door panel (a screwdriver), in the spare tire well or the engine bay.
• Big items. A TV, a statue or a photocopier in your inventory is carried in both hands for everyone to see. No sprint, jump, fight or driving, and one at a time. Load it into a trunk and it stands there for everyone; G puts it down as a drop with its prop.

#What staff get

Officers work through the third eye on a person or a vehicle, and through the search page.

• Scenes, not teleports. For cuffs, shackles and the uncuff the officer walks into place with collision on, then both play their side of GTA's paired clip at one origin, so the hands meet the wrists however the person stands. The cuffs click onto the wrists, then a second click tightens them. If the officer cannot get there the server says "Get closer." and nothing happens.
• The hold is the server's. Each scene's length is the minimum hold, counted from the moment the officer is in place. Finishing early is refused.
• Using the item works too. Using handcuffs, zip ties or leg shackles from the inventory starts it on the nearest person, behind or in front by where you stand.
• The search page. One panel on the right holds the zones and their results, the finds (weapons first, felt items as "?"), your free pocket slots and the keys. A marker sits on the spot and a line sweeps it while E is held. Each find flies into the list, and when a person's search is done the camera pulls back with a pin where each zone held something. Only a full search, or a search by on-duty police, takes things; a taken item lands in your pockets tagged as evidence with who, when and from whom.
• Vehicle searches open what they need. The driver door for its pocket, the passenger door for the glovebox, the rear door, the trunk and the hood, with the vehicle's network control so everyone sees it, and everything shuts when the search ends.
• The radial menu keeps working: with the included patch, qbx_radialmenu's Cuff, Escort, Put In Vehicle, Take Out and Search buttons come here.
• /unrestrain takes every restraint off a player, for staff with the ACE in Config.staffAce.
• An audit trail. Restraining, unlocking, a won struggle, a picked or slipped cuff, holding someone down and their escape, seating, every search started, every item taken, hiding something in a vehicle and the staff command all go to Core's audit log.

#Install

Police replaces qbx_police's cuffing and searching through a patch; qbx_police itself keeps running.

1. Items. Add two to ox_inventory's items, with pictures named after them in web/images:

   ['leg_shackles'] = { label = 'Leg Shackles', weight = 900, stack = true, description = 'Steel around the ankles. Walk slow.' },
   ['cuff_key'] = { label = 'Cuff Key', weight = 10, stack = true, description = 'Opens handcuffs and shackles.' },

   Copy

   Police also uses handcuffs, zipties, lockpick and screwdriver, and the big items small_tv, x_pantherstatue and photocopier. Add any your inventory does not have, or change the names in config.lua.

2. Patch qbx_police and qbx_radialmenu. Patched copies of both come with Police; every changed line in them is marked with a comment. Either make the same edits in your own copies (23 lines in qbx_police, 7 event names in the radial menu's config/client.lua), or upload the patched copies after copying your own config/ folders over them. The patch only acts while Police runs, so stopping Police brings stock behaviour back.

3. Upload jixryo_police as it is. Its page is already built.

4. Start it after Core and the two patched resources:

   ensure jixryo_core
   ensure qbx_police
   ensure qbx_radialmenu
   ensure jixryo_police

   Copy

   It needs ox_lib, qbx_core, ox_inventory, ox_target and jixryo_core. Three resources are optional and found when they run: interact-sound plays the cuff clicks, scully_emotemenu is held while someone is restrained, held down or searched, and a qbx_tackle tackle counts as being on the floor.

5. No database. Police keeps no tables. A restraint survives a reconnect in the character's qbx_core metadata.

6. Restart the whole server.

#How other scripts' calls behave

Police answers as no other resource. The patch and a few hooks make the scripts around it behave.

#Its own API

Server exports, called as exports.jixryo_police:Name(...).

Client exports (display only, the server's exports decide): exports.jixryo_police:IsRestrained() and GetRestraint().

State bags. The server owns the first five; a write from a player's game is put back.

Client events another resource may raise: the five jixryo_police:radial:* events above (they answer only to qbx_radialmenu), and jixryo_police:search:start with a server id, which opens a pat-down, or a full search when that person is restrained.

#Commands and keybinds

Every key is rebindable in the game's settings.

On the search page: hold E to search the zone under the marker; W / S or a click picks a vehicle zone; Up / Down picks a find, R takes it, Shift + R takes everything found; F turns a pat-down into a full search once they are restrained; Esc stops.

#Configuration

Everything is in config.lua. The main settings and their defaults:

#Security

• The server decides everything. A player's game only asks. The server checks the item, the distance, where the officer stands, who may do what, and that every hold really took its time, counted from when the officer was in place. The item is checked again at the end, in case it left their pockets.
• The record is the server's. jxRestraint, jxEscort, jxEscorting, jxPinned and jxPinning are written by the server alone; a write from a player's game is put back.
• Searches read the real inventory on the server. The page receives only what a zone has given up so far. What is still hidden never leaves the server, not even as a count. Taking an item checks that the officer can carry it, removes it, adds it, and puts it back if the add fails. Only a full search, or on-duty police, take things.
• Vehicles must be unlocked and in reach for a search, a hidden stack, a load or an unload.
• Holding someone down needs them really down: in last stand or dead by qbx_core's metadata, tackled in the last eight seconds by a tackle the server heard from within two metres, or their own game asked. Where they lie comes only from their own game, and only within 2.5 metres of where the server has them.
• Skill checks run in the player's game, so the server limits them: the struggle once a minute and only in the first part of the hold, slipping every two minutes, a try to get up every six seconds, and the server's own odds on picks and slips.
• Everything is rate-limited on the server: beginning an action, escorting, seating, pushing, holding down, helping up, starting a search, taking an item and hiding a stack.
• Big items are kept to one in your hands and none in a glovebox by inventory hooks. ox_inventory itself is not modified.
• Movement limits run in the restrained player's game, as in every FiveM script. What others can do to that player is checked on the server.
• Every action is audited through Core's log.

#Tests

Three suites run the real script in real Lua 5.4 on a stand-in server with stand-in players' games, 59 tests in all, every one passing on 2026-10-31:

• 15 on the restraint scenes and searches: which scene the server picks from behind, in front, on the floor, for shackles and the uncuff; that both players are told it and that the scene's length is the minimum hold counted from when the officer is in place; the pat-down telling the person who searches them; asking first and who is spared; only a full search or police taking things; a search left open ending on its own.
• 13 on the ground: a hold only on someone really on the floor; the anchor only from them and only near them; only the holder cuffing them there; every outcome of a try to get up; helping up into the escort; holds ending on their own; the server's state bags written once and a player's own write put back once.
• 31 in the players' games: the escort on the officer's body root with the cuffed walk at their pace; the floor arrest for the holder's side at one origin; the standing pairs solved from where the person stands; a blocked walk saying "Get closer." and nothing done; the push; the cuffed movement set; the search camera's framing, holds, glides, pins, vehicle doors and shut-down; the consent question and the search that times out.

#Check it in game

1. Hands up, A cuffs B from behind: A walks into place, both play the paired arrest, the cuffs click onto B's wrists and tighten, and C sees them. B's card says what B can still do; jogging trips B.
2. B not complying gets the struggle. A win frees B; a loss cuffs B. Double-lock the cuffs: B's G does nothing.
3. A tackles B, holds B down, then cuffs B on the floor. B presses SPACE and wins: A gets "Put them back down" and presses E in time. Then H: B gets up cuffed into A's escort.
4. A pats B down: B's hands go up, the camera frames B's head over A's shoulder and the marker sits on it. A knife shows at the chest, soft things only as "?". F after cuffing: everything shows, and the insole stack needs the longer hold. R moves the pistol into A's pockets as evidence.
5. A searches a car: the driver door opens, W / S moves to the glovebox, rear seats, trunk and hood as each opens; Esc shuts them all.
6. B picks up a small_tv: everyone sees it carried, B cannot sprint or drive, and "Load into the trunk" stands it in a trunk for everyone. resmon 1 reads 0.00 ms when nothing is happening near you.