Skip to content

JSON configuration reference

All server configuration lives below $profile:\RaG_Core\Configs\RaG_Trader\. This map covers every editable field in the eight main files and category files. Follow the linked field tables for defaults, limits, examples, and gameplay behavior.

File structure and editing rules

File Root fields Detailed reference
Settings.json Version and global feature, economy, delivery, vehicle, and admin settings Every root setting
Trading/Catalog.json Version, DefaultCurrencyId, Currencies, Traders Catalog and listings, currencies
Trading/Categories/<name>.json DisplayName, CurrencyId, Listings Category and listing fields
Traders/Locations.json Version, Locations Locations and safe zones
Routes/Routes.json Version, Routes Route and stop fields
Banking/Settings.json Version, DepositFeePercent, WithdrawalFeePercent, Currencies Bank settings
P2P/Settings.json Version and market policy fields Every market setting
Vehicles/Attachments.json Version, Vehicles Vehicle attachment sets
Vehicles/Garages.json Version, MaxVehiclesPerPlayer, AllowVehicleKeyHolders, PlatformParkingHeight, PlatformSpawnClearance, RestrictRetrievalToStorageMeter, StandaloneMeters Garage settings

Keep Version: 1 in every main file. Missing, different, or malformed versions can reject loading. Category files omit Version. Startup copies missing bundled files; it does not overwrite existing customized files or automatically add every new setting to them.

Use JSON booleans (true/false), numbers for prices and coordinates, quoted strings for identifiers and classes, arrays ([]) for lists, and objects ({}) for maps. JSON permits neither comments nor trailing commas. An empty string generally means no override, but required IDs and classes cannot be empty. The -1 sentinel is field-specific: unlimited stock or disabled price, for example. It does not mean unlimited everywhere.

Distinguish bundled values from script initializers for omitted fields. The bundled AllowGroundFallback is true, while its script initializer is false. Route RandomStops is true in both. Prefer explicit values for policy that matters to your server. Use live reload rules; restart for structural features, static placement, currencies, banking, market policy, or garage policy.

Choose the features you need

Goal Settings and configuration
NPC or object shop EnableStaticTraders, catalog profile and categories, enabled location group and trader entry
Traveling or event merchant EnableRoutes, enabled route, catalog profile, stops, optional schedule and offer pools
Safe trading area EnableSafezones, enabled group or stop Safezone, chosen protections
Cash and change Catalog item currency and denominations; banking is optional for ordinary cash trades
Stored physical money and ATM EnableBanking, enabled bank currency, placed RaG_ATM
Transfers to other players Banking requirements plus EnableBankTransfers
Virtual credits Catalog account currency; starts at zero with the built-in account service
Player sale listings or wanted orders EnableP2P, market currency and permitted boards; BuyOrdersEnabled controls wanted orders separately
Finite or player-supplied shops Listing InitialStock, MaxStock, optional restock; stock-based prices need EnableDynamicPricing
Vehicle dealership Vehicle listings, dealer spawn points, Vehicles/Attachments.json, optional purchase keys and wheel locking
Garage storage EnableVirtualGarage, suitable meter or platform, Vehicles/Garages.json
Portable car storage EnableVehiclePacking, assigned car key; ownership policy uses RestrictVehicleStorageToOwner

Placing an ATM, market board, or garage meter does not enable its service. A location's Objects array places objects; garage StandaloneMeters defines matching areas and does not spawn meters.

Catalog objects

Currencies and Traders are arrays in Trading/Catalog.json. DefaultCurrencyId is the base currency reference. The bundled catalog uses euro; when omitted it is empty, with a single-valid-currency fallback. There is no editable catalog-level Categories array: profiles reference category filenames instead.

Currency definitions

Field Initializer Meaning
Id Empty Unique currency identifier, referenced by categories, locations, banking, routes, and P2P.
DisplayName Empty Currency label shown to players. Supply a readable name.
Type "item" "item" for physical denominations or "account" for virtual balances.
CurrencyItems [] Physical denomination definitions; leave empty for account currency.
CurrencyItems[].ClassName Empty Existing denomination item class.
CurrencyItems[].Value 0 Positive whole currency units per item or quantity unit. Values must be distinct within that currency.
CurrencyItems[].UseQuantity false true counts supported stack quantity; false counts each object once.

Item currencies require a value-1 denomination. See cash, change, account currency, and precedence.

Trader profiles and offer pools

Field Initializer Meaning
Id Empty Unique profile identifier used by locations and routes.
DisplayName Empty Shop title.
Categories [] Category filename stems, without .json; these determine the profile's listings.
OfferPools [] Optional availability groups; omitted pools leave listed classes unrestricted.
OfferPools[].Id Empty Pool identifier, unique within this profile.
OfferPools[].ClassNames [] Ordered offered classes whose availability this pool controls.
OfferPools[].ActiveOffers 1 Number of consecutive classes available in each rotation window.
OfferPools[].RotationHours 24 UTC hours per window.
OfferPools[].Months [] UTC months in which pooled offers can trade; empty allows all months.

See rotation, seasonal restrictions, and pool limits. These rules affect both buying and selling.

Category and listing objects

Each category's DisplayName labels its menu category, CurrencyId optionally overrides the base currency, and Listings contains its offers. Filename supplies category identity.

Every listing field is explained in the listing field table: ClassName, PersistenceId, BuyPrice, SellPrice, AllowDuplicate, RequiredItems, RequiredLiquidType, InitialStock, MaxStock, RestockAmount, RestockIntervalSeconds, MinimumHealthPercent, DeliveryMode, SpawnQuantity, SpawnFullQuantity, and Attachments.

See stock and pricing calculations, contents and liquids, and material-cost examples. Shop stock records counts; ordinary resale does not put the submitted item's condition or contents on the shelf. Use P2P to resell the actual stored item.

Static location objects

Locations is an array of groups in Traders/Locations.json.

Group field Initializer Meaning
Id Empty Unique location group identifier.
Enabled true Enables this group; global static-trader switch controls its shop entities and placed objects.
CurrencyId Empty Group currency override.
Traders [] Trader entities bound to catalog profiles.
Objects [] Placed props and terminals, separate from trader entries.
Safezone Disabled zone Group safe-zone policy, independent of each trader's opening hours.

The trader entry table explains TraderId, CurrencyId, EntityClassName, Enabled, OpeningHoursEnabled, OpeningHour, ClosingHour, Attachments, VehicleSpawnPoints, Position, and Orientation.

Entry initializers are OpeningHoursEnabled: false, OpeningHour: 0, ClosingHour: 24, empty attachments and vehicle points, empty class/profile/currency strings, and Enabled: true. Supply valid classes, profile references, and transforms. Opening hour accepts 0–23, closing hour 0–24; equal hours stay open. Loadout attachments apply to survivor traders. Static trader entities are made invulnerable; route traders use their route's Invulnerable switch.

Transforms and placed objects

Position is [x, y, z] in metres: east/west, elevation, north/south. Orientation is [yaw, pitch, roll] in degrees. Both arrays need exactly three numbers. Vehicle spawn points contain these two fields. Static and route Objects add ClassName to the transform.

Static objects must derive from House; route props use different class restrictions. See static objects and route stop limits. A route stop's Safezone.Center is absolute, not an offset from its NPC.

Safe zones

The same safe-zone object is used by groups and stops. The safe-zone field table explains all fields: Enabled, Center, Radius, BlockIncomingDamage, BlockOutgoingDamage, ProtectPlayerEquipment, DeleteAnimals, DeleteInfected, BlockWeaponFire, BlockExplosives, BlockBuilding, VehicleSpeedLimitKmh, ShowNotifications, ExitProtectionSeconds, PreserveHunger, PreserveThirst, PreserveDisease, PreserveTemperature, PreserveBleeding, and ExcludedEntityClasses.

Route objects

Routes is an array of traveling merchant definitions. Each definition has a Stops array. The route field table explains Id, Enabled, TraderId, EntityClassName, Attachments, RandomStops, RandomStartStop, Loop, DepartureGraceSeconds, Invulnerable, AnnounceArrival, AnnounceDeparture, AnnounceInChat, AnnouncementRadius, ShowNextStop, ShowMapMarker, RestockOnArrival, StockMode, DeliveryDelaySeconds, SpawnRetrySeconds, and MaxBlockedSpawnAttempts.

The schedule reference covers ScheduleEnabled, ScheduleUsesGameTime, ScheduleStartHour, ScheduleEndHour, ScheduleWeekdays, ScheduleMonths, ActiveFromDate, ActiveUntilDate, ScheduleStartMonth, ScheduleStartDay, ScheduleEndMonth, and ScheduleEndDay. Date bounds default to 0; annual bounds default to all four fields 0; weekdays and months default to all days and months. Windows combine: a date must pass every enabled filter.

The stop field table explains Id, Name, Position, Orientation, WaitMinutes, TravelMinutes, AllowBuying, AllowSelling, PurchaseCutoffSeconds, SellingCutoffSeconds, CurrencyId, StockLimits, Prices, SpawnClearanceRadius, AllowedCategories, NextStopIds, VehicleSpawnPoints, Objects, and Safezone.

Stops[].Prices[] contains ClassName, optional CurrencyId, BuyPrice, and SellPrice. Class must already be offered by the route's profile. Prices default to -1; specifying an override replaces both directions, so supply both deliberately. StockLimits is a class-to-integer object, not an array of price objects. VehicleSpawnPoints and Objects use the transforms above. Omitted Safezone is null; omitted stop filters, prices, stock limits, props, and vehicle points are empty.

Banking and player market

The bank settings table explains every field in Banking/Settings.json, including the nested Currencies[].CurrencyId, Enabled, MaxBankBalance, and InitialBalance entries. These entries refer to item currencies from the catalog; they do not define new currencies.

The market settings table explains every field in P2P/Settings.json: CurrencyId, MinimumPrice, MaximumPrice, MaxListingsPerPlayer, MaxActiveListings, BuyOrdersEnabled, MaxBuyOrdersPerPlayer, MaxActiveBuyOrders, ListingExpirySeconds, SettledRetentionSeconds, ListingFee, SalesCommissionPercent, MinimumSalesCommission, MinimumConditionPercent, InteractionRadius, AllowAttachments, AllowCargo, AllowedClassNames, DeniedClassNames, and MarketBoardClasses.

Wanted-order requirements are created through the player market menu and saved in listing journals. They are not extra keys for P2P/Settings.json. See wanted-order requirements for their meaning and limits.

Vehicle attachment sets

Vehicles/Attachments.json contains Version: 1 and Vehicles, an array of attachment sets. Each set contains ClassName (exact vehicle class) and Attachments (ordered part class names). Repeat a wheel class for each fitted wheel. Both strings and slot compatibility must match the actual installed vehicle mod. Empty or missing sets supply no configured parts.

Each set allows up to 500 attachment entries; the whole purchase still shares the 500-object work limit. The validator checks existing vehicle and part classes and attachment slots; incompatible parts can be skipped with a warning. Ordinary listing Attachments is a separate field; configure vehicle parts here. See vehicle purchases for fluids, keys, delivery, and placement.

Garage sites

The garage field table explains the root policy in Vehicles/Garages.json. The bundled file includes one example in StandaloneMeters; its script initializer is an empty array. Example coordinates are not a placed terminal.

Each StandaloneMeters[] entry has these fields:

Field Initializer Meaning
Id Empty Unique, stable site ID used by stored-vehicle records.
MeterPosition [] Expected world position of the placed standalone meter.
ZoneCenter [] World center of the oriented parking area.
ZoneSize [] Full width, height, and depth of that area in metres.
ZoneYaw 0 Area rotation in degrees; absolute value no greater than 360.
Spawn Unset Retrieval transform containing Position and Orientation.
AllowedVehicleTypes ["Land"] Accepted vehicle types: Land, Air, Water, or combined Land and Air.

All coordinate arrays contain three numbers within ±100000. Spawn must lie inside the parking zone; spawn yaw accepts ±360 and pitch/roll must be zero. See standalone site geometry, size limits, and meter matching.

Generated JSON is saved state

Stock.json, StockDelta.json, account files, transaction journals, bank directory and transfer files, route state, market records, garage records, receipts, and telemetry are generated state. Their versions and internal recovery fields are separate from configuration Version: 1. Treating them as settings can break ownership, balances, or interrupted-operation recovery.

Use the backup and recovery guide to preserve matching state. Client favorites and recent purchases are saved in the player's local game profile rather than server JSON.

Source verification

Checked against current files in I:\DayZ Mods\RaG_Trader on 8 November 2026, including local changes above source commit 079261d. Field coverage includes script configuration models, bundled JSON, validators, runtime services, and player UI. Local source changes include instant route travel, blocked-stop skipping, departure warnings, and map-marker updates; older releases may behave differently. This reference describes that source snapshot.