The Two Windows#

Starter Pack has two interfaces, and it helps to know which is which from the start.

Window	Opened with	What it is for
The picker	`/starterpack`, a keybind, the starter-pack item or a world ped	What players see: choose a character, browse the packs, claim one.
The creator	`/starteradmin`

Route	Set in	Notes
Command	`Config.Player.Command`	`/starterpack` by default.
Keybind	`Config.Player.OpenKey`	No key by default, but Open Starter Pack is always listed in Settings → Key Bindings → FiveM for players to bind themselves. Set a key name such as `'F7'` to give everyone a default.
Item	`Config.Player.Item`	Using the item opens the picker; it is removed only after a successful claim. See Installation.
World peds	`Config.Player.PedOpen`	NPCs you place in the creator. Talking to one opens the picker. `false` stops them spawning at all.
Your scripts	Exports and events	See Commands and Exports.

Column	What is there
Left	The Female / Male switch, that side's pack list, and General Settings for everything server-wide.
Centre	The editor for whatever is selected on the left.
Right	A live preview of the card exactly as players will see it.

Action	What it does
Add Pack	Creates an empty pack. Up to four packs per side.
Duplicate	Copies a pack with all its items and vehicles, right below the original.
Set as featured	Gives the pack the MOST POPULAR ribbon. One per side; press it again to unfeature.
Drag	Reorders the packs; players see them in this order. Dropping an item from the editor onto another pack moves it there.
Delete	Click twice to confirm. Past claims of that pack stay in the claim history.

Field	What it does
Visible / Hidden	A hidden pack disappears from the picker and the server refuses to hand it out, but it is kept for later.
Display Name	The card's title, up to 17 characters — POLICE, MEDIC, GANG…
Accent Color	The card's border, claim button, glow and item highlights.
Background Image	Paste an image URL. CROP zooms and positions it inside the card frame; RESET goes back to the bundled photo.

Setting	What it does
Tag	The category shown on the card: WEAPON, AMMO, ARMOR, RADIO, TOOL, PHONE, MAP, ID, MONEY, DRUGS, FOOD or MISC. Only `MONEY` changes what happens on claim — see Money below.
Tier	Common (grey), Standard (blue) or Rare (gold) — the colour the item is highlighted in.
Quantity	How many are given. For a MONEY row, the amount paid.

Usage

Setting	What it does
Theme Color	Colours the whole picker and creator — borders, glow, the claim button, the active tab. Seven presets (Quasar Cyan, Violet, Pink, Crimson, Amber, Emerald, Teal) or any colour from the picker.
Server Logo	Replaces the Quasar mark in the top-right corner of the picker. A square PNG of at least 256×256 works best; leave it empty for the default.
Sound Effects	Soft ticks when hovering cards, items and the character select. Off keeps the interface silent.
World Peds	Up to three NPCs in the world that open the picker. See below.

Field	What to enter
Ped Model	Any GTA or addon ped model, such as `a_m_y_business_01`. Empty uses `a_m_y_business_03`.
Animation / Scenario	A scenario starting with `WORLD_`, `PROP_` or `CODE_` — `WORLD_HUMAN_GUARD_STAND`, say — or an animation written as `dictionary.name`. Empty leaves the ped standing.
Position	Set with PLACE — never typed.

Key	Does
Mouse	Aim where the ped should stand, up to 50 metres away. You can still walk.
`←` / `→`	Turn the ped.
`↑` / `↓`	Raise or lower it — onto a counter, a podium or a balcony.
Left click	Confirm the position and return to the panel.
`ESC`	Cancel.

Field	Meaning
`account`	Tried first: the framework account to pay into. `''` skips straight to the item. On ESX, `cash` is paid as wallet money.
`itemId`	The fallback when there is no account, or the account refused — money as an inventory item. `''` means no fallback.
`metadata`	`true` gives one item carrying `worth = amount` — the QBCore marked-bills style. `false` gives the amount as that many items.

Option	What it does
`DefaultGarage`	Where the car is parked, per framework. On QBCore and Qbox, boats go to `sea`, planes and helicopters to `air` and everything else to `car`, using the class in the shared vehicle list. ESX has no such list, so every vehicle uses the `car` garage. A single string works for all classes.
`DefaultState`	`1` marks it as stored and ready to take out.
`GiveKeys`	Hands the keys over on claim through the first keys script found.
`PlatePrefix`	Plates are eight characters, checked against the vehicle table so they never repeat.
`ImageUrl` / `ImageOverrides`	The vehicle pictures in the picker and creator. `{model}` is replaced by the spawn code; addon cars that have no picture there get a placeholder unless you give them one in `ImageOverrides`.

Mode	What players get
`lifetime`	One claim, ever. Afterwards the picker does not open and a notification says the starter pack is a one-time reward. The default.
`weekly`	One claim every seven days. The picker still opens; after a claim, or when trying too soon, a countdown shows the days, hours, minutes and seconds left.
`monthly`	The same, every thirty days.

Scope	Meaning
`character`	Each character claims on its own — the citizen id on QBCore and Qbox, the character identifier on ESX with multicharacter. The default.
`account`	One claim for the whole Rockstar licence, however many characters it has. Stops players farming packs with new characters.

Option	Default	What it does
`Config.Locale`	`'en'`	The language.
`Config.Debug`	`false`	Detailed console output: what was delivered, which garage, why an item was missing.
`Config.BrandName`	`'QUASAR STARTER PACK'`	The name in the interface header and the title of notifications.
`Config.Interaction`	`'auto'`	How peds are used: `'auto'`, `'textui'` or `'target'`.
`Config.Notification`	`'original'`	Which notification system shows messages.
`Config.NotificationDuration`	`5000`	How long a notification stays, in milliseconds.
`Config.NotificationPosition`	`'top'`	`'top'`, `'top-right'` or `'middle-right'`.
`Config.Cooldown`	`'lifetime'`	`'lifetime'`, `'weekly'` or `'monthly'`.
`Config.CooldownScope`	`'character'`	`'character'` or `'account'`.
`Config.Money`	Four tags	How each money tag is paid.
`Config.IdentityItems`	Four items	Items stamped with the player's identity.
`Config.Admin`	—	`AceGroup`, the admin `Command` and the `Identifiers` whitelist.
`Config.Player`	—	`Command`, `OpenKey`, `PedOpen` and `Item` — the ways in.
`Config.Vehicles`	—	Garages, state, keys, plates and pictures for starter vehicles.