Skip to the content
Docs
Admin Panel
Admin Panel docs: all pages

Script pageBuy (opens Tebex in a new tab)

Quick Menu & Places

Two distances of the quick menu (/adminmenu), and the list of saved places staff can jump to with one press. All keys are in config.lua.

Config.Quick

KeyDefaultAllowedWhat it changes in game
NearbyRadius30.0MetresHow far the Players tab looks for players around you. The heading of the list reads "Nearby · within 30 metres".
ClearRadius50.0MetresHow far Clear area reaches. It removes the empty vehicles and street NPCs in that distance around you.
lua
Config.Quick = {
    NearbyRadius = 30.0,
    ClearRadius  = 50.0,
}
  • The nearby list shows the eight nearest players. A bigger radius does not make the list longer.
  • Clear area asks first: "Remove the empty vehicles and NPCs within 50 metres of you? Parked cars count as empty. Players, and vehicles with someone inside, are not touched."
  • Clear area needs the Clear vehicles / area permission (world.clear).
  • A value that is missing or not a number counts as the default.

Config.Places

KeyDefaultAllowedWhat it changes in game
Config.PlacesThree placesA list of placesOne button per place in the quick menu: Me tab, under Teleport.

Each place has three fields:

FieldAllowedMeaning
idShort text, unique, not 'sitroom'The internal name of the place. Staff do not see it.
labelTextThe text on the button.
coordsA position vec4(x, y, z, heading)Where the staff member lands, and which way they face.

The places in the file:

idlabel
legionLegion Square
mrpdMission Row PD
paletoPaleto Bay

Add a place

  1. Stand on the spot in game. Look the way you want to face after the jump.
  2. Open the quick menu with /adminmenu.
  3. Open the Tools tab and press Copy my position. The menu answers "Copied vector4(...)".
  4. Open config.lua and add a line to Config.Places: a new id, a label, and the copied text as coords.
  5. Restart the resource. The new button is in the quick menu.
lua
Config.Places = {
    { id = 'legion',    label = 'Legion Square',  coords = vec4(195.17, -933.77, 29.7, 144.5) },
    { id = 'mrpd',      label = 'Mission Row PD', coords = vec4(428.23, -984.28, 29.76, 3.5) },
    { id = 'paleto',    label = 'Paleto Bay',     coords = vec4(80.35, 6424.12, 31.67, 45.5) },
    -- the new place: paste your own position as coords
    { id = 'staffroom', label = 'Staff room',     coords = vector4(-75.0, -818.6, 326.18, 0.0) },
}

vector4 (what the menu copies) and vec4 are the same thing.

Rules

RuleWhat happens otherwise
Every id is unique.Two places with the same id both lead to the first one.
No place has the id 'sitroom'.That place is left out.
Every place has id, label and coords.A place with a missing field is left out.
  • The buttons need the Teleport permission (self.teleport).
  • Go back in the same list returns the staff member to where they stood before the jump.
  • A staff member who drives is moved together with the vehicle.
  • The Sit room button is not in this list. It comes from Config.SitRoom and needs the Run sits permission (reports.sit). See Tickets & Sits.
  • Every jump to a saved place is written to the log with the tag /place.

Related: Quick Menu · Self Tools · Logs.