Koja Scripts

Admin panel

Every tab of /invadmin: items, players, quick actions, locations (create stashes, shops and benches in game) and live settings.

Admin panel

Open it with /invadmin. Access: the ACE command.koja-inventory-v2 or a framework group from Config.AdminGroups. Every action is logged to the admin webhook. The left column keeps a history of what you did in this session.

Items

Browse every item with search and category filters. Pick a target player at the top, choose an amount (presets 1, 5, 10, 50, 100) and press Give or Take. Optional metadata can be entered as JSON, for example {"label":"Fine #2041","amount":500}.

Players

Lists online players with their job and carry weight. Select a player to see everything they carry, remove single stacks, clear the whole inventory or open it as a second inventory to move items yourself.

Actions

ActionWhat it does
Save allWrites every changed inventory to the database now.
Clear nearby dropsRemoves drops within 25 m of you.
Clear all dropsRemoves every drop on the map.
Restock shopsResets stock of every shop.
Open stash / Open shopOpens any stash or shop from anywhere.

Locations

A list of every stash, shop, crafting bench and drop on the server. Each row shows where it comes from (config, ox, admin or world for drops) and how far it is from you; the list is sorted by distance and can be filtered by type or searched by name.

Select a row to:

  • Teleport to it (closes the panel),
  • set a Waypoint on the map,
  • Open it from where you stand,
  • Edit or Delete it (locations created in the panel),
  • Delete a drop.

Locations from config files and ox data are read only. Change them in their files, or create a new one here.

Creating a location

Press New location, pick the type and fill in the form. Use my position fills the coordinates from where you stand.

FieldTypesDescription
LabelallName on the sign and the blip.
Name (id)allOptional. Lowercase letters, digits and _. Used by exports and as the stash name. Generated when empty.
Position, RadiusallWhere it is and how close players must be.
Jobsalljob:grade pairs, comma separated, e.g. police:0, ambulance:2. Empty means everyone.
Map blipallShows a blip on the map.
Width, Height, Max weightstashGrid size and weight limit.
SharedstashOff gives every player their own stash at this spot.
ItemsshopSearch an item and add it with a price and optional stock (empty means unlimited).
RecipescraftingPick the recipes the bench offers.

Saved locations work right away for every player, without a restart, and survive restarts. Other resources can create them too with CreateLocation. See Server exports.

Settings

Edits runtime-safe config values without a restart, grouped by topic: player inventory size and weight, drops, throwing, trunk and glovebox sizes (default and per vehicle class), cash, item notifications, trunk props, weapons, shop prices and stock, durability and clothing.

  • Every value is checked against its type and range on the server; an invalid value rejects the whole save.
  • Values are stored separately from config.lua and win over it. Every field (or a whole group) can be reset to its config.lua value.
  • Settings marked restart are saved right away but take effect after a restart. Trunks and gloveboxes that already exist keep their size.
  • Every change is logged with the old and new value.

Item definitions

Inside Settings, Item definitions lists, creates, edits and removes runtime items, including the use block. These are the same items other resources create with RegisterItem. See Runtime items.