Tutorial / Tools > Economy

Store Maker

Turn NPCs and props into stores, banks or ATMs, or place new ones (with a preset).

What it does

The Store Maker creates stores, banks and ATMs. Left-click an NPC or a prop you spawned to turn it into one; it keeps its model, skin, color and spot. Left-click the ground to place a new one facing you.

Stores sell weapons, ammo, entities, props, vehicles, health, armor, boosts, food, chairs, licenses and the main money printer, each with a price. Banks and ATMs let players deposit, withdraw and send money. Players open any of them with E.

Presets save a whole store (type, model, items, look, character and voice). Place new stores from a preset, put a preset on an existing store, or push preset changes to every store on the map.

Where to find it

Q menu > KGX's Admin Toolbox > Economy > Store Maker.

Toolbox admins can use it on every store. Players can use it only if a superadmin ticks it in Settings > Player Access. They can then edit and remove only their own stores.

The store list in Economy > Economy also has Edit... for every store.

Given to a player (v3.6.11.3): Their own stores (no licenses, printers or vault spots for sale).

Controls

Key What it does
Left click Make the aimed NPC/prop a store, or place a new one where you aim (with the selected preset)
Right click Edit the aimed store: items, look, character, voice, access
E + right click Apply the selected preset to the aimed store
Reload Remove the aimed store (click twice within 3 seconds)

Options

Option What it does Default
Make a Store, Bank or ATM. Store
Model for new ones Default for the type (a store: a citizen; a bank: a vault-like fridge (v3.6.21.1); an ATM: the downtown ATM), or a list of citizens, characters, an ATM, a vending machine, a cash register, and (v3.6.21.1) a vault (fridge), servers, a receiver cart and two silo servers. Default for the type
Or any model Type any model path. empty
Use the model I am looking at Copies the aimed entity's model into the field. -

Default models: store and bank are citizens, ATM is the downtown ATM (a vending machine if that model is missing). Person models stand, idle, turn to players and talk. Other models are solid props.

Presets
Option What it does Default
Preset The preset for new stores and for E + right-click. (none: an empty store of the type above) uses no preset. (none)
Saved store presets (every map) List of presets. Double-click to select one. Right-click for Use this preset or Delete (admins). -
Refresh presets Reloads the list. -
Update all stores from their presets Puts each store's preset on it again (asks first). -
Reset to defaults Sets Make a and Model for new ones back to the defaults. -

Four presets come with the toolbox: Medic (health and armor), License Office (Property Licenses), Gun Shop and Black Market Dealer (Money Printers, printer upgrades and tools, Lockpick, Keypad Hacker).

The store editor

Right-click a store to open its editor. It has these tabs:

  • General: Name above it, Type, Welcome text (window), Model, Skin, Animated person, Updates from preset, three colors (accent, window background, text), Go to it and Move it to where I am looking (facing me).
  • Character & voice: hide the name, animation, Turn to face players nearby and whoever uses it, voice, and when it speaks (greets, on a purchase, goodbye). Test the voice plays a line.
  • Items: the item list (Type, Name, Class / model, Price, Amount). Pick a type, use Pick... to choose from a searchable list, set a price and amount, and an optional license the buyer needs. Buttons: Add as new item, Update selected, Remove selected, Move up, Move down.
  • Access: Everyone can use it, a whitelist or a blacklist of players and ranks, and a jobs list. Toolbox admins can always use it; jailed players never can.
  • Buy back: Players can sell weapons back to this store at a set percent of the price. An extra box also buys back licenses and things bought here that are near the player. A weapon is bought back for this store's price or the price paid for it, whichever is less. A store a player made buys back no licenses, and only weapons bought since v3.6.11.1.
  • Bank vault (admins, v3.6.21): A bank vault: it holds a share of every tax and fee, and can be robbed (banks and ATMs), Its share of the bank money (%, split with the other vaults) and The most it holds (the rest goes to the treasury). How much of every tax goes to the vaults is set in Settings > Taxes & Treasury > Bank vaults %. How the vault is robbed (Bypass, time, chance, cooldown, who may rob it): Economy > Money Generator on the bank. Turning it off, or removing the bank, gives its money back to the treasury.
  • Window: show only the categories the store sells, hover tips and warnings, and up to 8 extra lines of text under the welcome.
  • Screen (v3.6.21.5): a screen with the store's items. Screen: No screen, The store is a screen (drawn on its model's screen; on a model without one, on the front of its box) or A screen beside the store. Make the store a screen model picks a monitor, TV or cash register model (it sets Model on the General tab and turns off Animated person). Beside: where (right, left or above) and Beside: size. A HIDE / SHOW button at the bottom right (E on it hides the screen for everyone; only admins and whoever may edit the store; for others E there opens the store) and Hidden now. A store that turns to players keeps a screen beside it facing the way it was placed; a prop store's screen turns with it.

At the bottom: Save as preset... (admins), Load a preset..., Close without saving and Save.

How to use it

Turn an NPC into a gun store
  1. Set Make a to Store and the Preset to Gun Shop.
  2. Left-click the NPC. It becomes a store with the preset's items and keeps the NPC's model.
  3. Right-click it to change prices on the Items tab, then click Save.
Place an ATM
  1. Set Make a to ATM and Preset to (none).
  2. Leave Model for new ones on Default for the type.
  3. Left-click the ground. Players press E on it to open their bank.
Make a bank that can be robbed
  1. Settings > Taxes & Treasury: set Bank vaults: % of every tax and fee to, for example, 25, and click Apply the numbers above.
  2. Right-click a bank, open the Bank vault tab, tick A bank vault, set the most it holds (for example 50,000) and click Save.
  3. A quarter of every tax and fee now goes into the bank. Its window shows the money in it. Robbers with the right tool (by default the Bypass, both locks) take half of it; police and admins are alerted.
Make your own preset
  1. Right-click a finished store to open the editor.
  2. Click Save as preset... and type a name. An existing name is replaced.
  3. Select the preset in the tool panel and left-click to place copies.
Push preset changes to placed stores
  1. Change the store that the preset came from, and save it as the preset again.
  2. Click Update all stores from their presets and confirm.
  3. Stores keep their place, type, model, owner and player list. Edits made to them in the editor are replaced.

Settings and commands

Setting What it does Default Range
kgxat_limit_stores Most stores, banks and ATMs one non-admin player can make (0 = not allowed). 2 0-50
kgxat_store_owner_limits 1 = stores made by players only sell weapons, entities and vehicles that players may spawn. 1 0-1

Tips and limits

  • Players given this tool turn only their own props and NPCs into stores (not permanent or server-owned ones).

  • Making a store needs the economy on (kgxat_economy). Players cannot open a store while it is off.

  • You cannot turn players, vehicles, weapons or map-created entities into stores.
  • Stores are saved per map in data/kgx_admin_toolbox/stores_<map>.json. Presets are saved in storepresets.json and work on every map.
  • A store updates from the preset it was placed with, or the one put on it with E + right-click. Older stores update from the preset with the same name. Set Updates from preset to (none) to keep a store's own edits.
  • Players who are not admins update only their own stores with Update all stores from their presets.
  • Admins can move prop stores with the physgun; the new spot is saved. Players cannot move stores.
  • Other tools cannot change a store. The exceptions are the Money Generator and the Admin Remover, and superadmins with kgxat_superadmin_override on.
  • Only admins can save or delete presets.

Alt + E (admins, v3.6.21.5.1)

Alt + E on a store, bank or ATM opens a small window: Store editor, Open it (as a player) and Money Generator (robbery settings). E opens the store as before.

Store screens (v3.6.21.5)

A store screen shows the store's name, its welcome text and every item with the price players pay (sales tax included). When the items do not fit, it shows them a page at a time (a new page every 6 seconds, "Page 1 of 3"). Banks and ATMs show the welcome and the extra lines of the Window tab; a vault-only bank says it only holds the bank's money. Players who may not use the store see Closed to you with the reason. E on the store (not on the button) opens it as before.

A gun store on a monitor
  1. Right-click the store, open the Screen tab.
  2. Make the store a screen model: White CRT monitor. Screen switches to The store is a screen.
  3. Save. The monitor shows the guns and prices.
A menu board beside an NPC
  1. On the Screen tab pick A screen beside the store, To the right, size 1.5.
  2. Save. A board stands next to the NPC, facing the way the store was placed (it does not turn with the NPC).

Bank vaults and E (v3.6.21.3)

With Settings > Taxes & Treasury > Bank vaults only hold money on, E on a bank or ATM set as a bank vault opens a small window: the vault's name, the money inside (unless its sign hides the amount), and whether it can be robbed now (or when it is safe again, or that its mechanical lock is open). Nobody deposits or withdraws there. Admins also get Admins: change this vault (Money Generator).

Back to Tools

Type to search every tool, panel, setting, FAQ answer and release.