Configuration

oxide-shops is configured in-game, not by editing files. Nearly every setting on this page can be changed live with the /shop settings menu, and your changes are saved to your database.

How Configuration Works

This is the most important thing to understand about configuring oxide-shops:

• Your settings live in your database, not in the config files. The first time the resource starts, it reads the starting values from its config files and copies them into a database table called oxide_settings. From that point on, the database is the source of truth.
• To change a setting, open /shop settings in-game (admins only). Pick a setting, change it, and save. The change takes effect immediately and is remembered across restarts.
• Editing the config .lua files after the first start usually does nothing. Because the database already holds your values, hand-edited file changes are ignored — except for a brand-new setting added by a future update, which is copied in the first time it appears. Use /shop settings instead.
• Each setting has a "Reset to default" button in the menu, which restores that setting to the value the resource shipped with.

The /shop settings menu is organized into the same groups shown below, split into Basic (shown upfront) and Advanced (behind a toggle) tiers.

The tables below cover the settings you'll normally change, with each one's type, shipped default, and what it changes in-game. The Config. names are the internal keys; in the menu they appear with friendly labels.

Advanced sub-settings not in the menu

A handful of deeper tuning values are not in the /shop settings menu — for example the barber's seating scene (Config.BarberShop.scene), the tattoo shop's animations, seating scene, and clothing-strip amounts (Config.TattooShop.anims, .scene, .undress — the last one notes "adjust per your clothing pack"), the service display labels (serviceLabels), and the clothing slot definitions and icons (Config.ClothingShop.components / .props).

Because the database becomes the source of truth after the first start (see above), these values are effectively frozen at their first-boot values — they're not in the menu, and editing the config files later has no effect. If you genuinely need to change one of these, you must edit it in the config file and clear this resource's saved settings so the file values are re-imported on the next boot. That procedure is in Troubleshooting → I want to wipe all settings back to the file defaults. For almost every server, the shipped values are fine and you can ignore this section.

General

Economy

Rate Limits

Config.RateLimits sets a minimum wait (in milliseconds) between repeats of each action, per player — an anti-spam guard. Each key is one action. Raise a value to slow an action down; lower it to allow faster repeats. When an update adds a new action, it uses its default value from the next start; your existing values are kept.

Blips

Each shop style has a default map blip. A blip has a sprite (icon ID), color (color ID), scale (size), and label (name on the map). Individual shops can override or hide their blip in /shop admin.

Weapon Shop

An item is sold without a license when either its name is in the items list or its shelf category is in the categories list. Items placed with Add item in /shop admin, restocked from wholesale, or transferred from a player's inventory have no category, so exempt those by name. Clear both lists to require the license for everything in the shop.

A player without the license sees "You need a weapon license to buy this item" (shop_weapon_license_required in locales/en.json) and is not charged.

Weapon stats shown in the UI (damage/accuracy/range/fire-rate) ride on the individual template items inside Config.ShopTemplates. Like all top-level settings, the shop templates become database-backed after the first start — so editing shared/config/templates.lua later has no effect, and there is no stats field in the settings menu. In practice the stats are frozen at their first-boot values unless you change them the hard way: edit the template rows and re-import the settings using the wipe procedure in Troubleshooting.

Mask Shop

Barber Shop

Config.BarberShop.prices sets the default price charged per category the customer changes.

Tattoo Shop

Clothing Shop

Config.ClothingShop.components and Config.ClothingShop.props define the garment/prop slots and their default per-slot prices. A few examples:

Pawn Shop

Controls how the pawn shop's buy and sell prices are derived and how they move with demand. See Features → Pawn Shop for how these interact.

Auction House

Wholesale Catalog

Config.WholesaleCatalog is the list of items that player-owned shop owners can restock from wholesale. Each entry has:

You add, remove, and edit wholesale items in the Wholesale section of /shop settings using the item picker. The four service supply items (hair_product, tattoo_ink, mask_blank, fabric) are included so owners can restock service shops.

Shop Templates

Config.ShopTemplates is the list of ready-made shops that /shop admin can create from a picker. Each template carries a shop ID, name, ped model, style, location, optional chairs (for barber/tattoo), an optional purchase price, and an item list. The default templates place all the standard GTA stores at their familiar locations.

Templates are advanced and are edited in the Shop Templates section of /shop settings (including placing the location in-world). For everyday use you'll create and edit live shops directly in /shop admin rather than editing templates.

Tablet

These settings only do something when Oxide Tablet (oxide-tablet) is installed. Without it, or with Tablet apps switched off, the shop manager and auction house open in their own window at the shop exactly as they always have.

With it, an owner gets a Shop Manager tile and, if your server runs an auction house, an Auction House tile, plus a My Shops widget for the home screen showing each shop they own and its till.

The settings live in Config.Tablet (shared/config/tablet.lua) and appear in /shop settings as Tablet integration, under the Tablet group.

Why withdraw and deposit are off by default

Moving the till is the one shop action that puts cash straight in a player's pocket, and the shop counter has always been the thing that kept it local. Opening the manager from a tablet anywhere on the map would quietly turn that into withdraw-from-anywhere, which is a real change to your economy — so it is opt-in.

Everything else works remotely: price changes, auto-restock targets, wholesale orders, restocking from your own inventory, listing the shop for resale, and the transaction ledger. Those move shop balance and stock, never a player's cash.

Turn AllowCashActions on if you'd rather have the convenience. When it's off, the buttons are hidden while the panel is open on a tablet, and the server refuses the action either way, so nothing slips through.

Shared map mode

Config.MapMode picks how the shop map in /shop admin shows the mainland and Cayo Perico. The map itself comes from o-link, which owns the artwork and calibration, so this setting only chooses a mode.

Config.MapMode = 'inherit'

The value is saved in the oxide_settings table like every other setting: the config file only seeds it when nothing is saved yet. Change it live in either of these ways:

• Map mode under General in /shop settings.
• oxide-shops:mapmode <value> from the server console, or /oxide-shops:mapmode <value> in game as an admin. Run it without a value to print the current mode to the server console.

inherit follows the server-wide default, which you set once for every Oxide resource with olink:mapmode <value> (combined, separate or disabled; o-link ships with combined). Open maps pick up a new mode without a restart.

Next Steps

• Admin — using the /shop admin and /shop settings menus
• Features — how each setting plays out in-game
• Troubleshooting — if a change doesn't seem to apply