Trader Configuration
Reference for managing trader sellers, currencies, categories, prices, and generated TraderConfig exports in DZconfig.
Overview
DZconfig models trader data around sellers, currencies, categories, and items so you can edit prices without hand-editing a long TraderConfig file.
Use this area when you need to import an existing trader economy, rebalance buy and sell prices, define money items, or export a clean trader config for your server.
Quick Facts
| Primary file | TraderConfig.txt or trader JSON, depending on the trader mod workflow |
|---|---|
| Best for | Trader sellers, currency values, stock quantity, buy prices, and sell prices |
| DZconfig routes | /instance/{instance}/trader/items, /trader/sellers, and /trader/currencies |
Main Concepts
A healthy trader setup keeps sellers focused, currencies simple, and prices consistent with your loot rarity. Avoid using traders as a replacement for the Central Economy unless your server is intentionally market-driven.
Sellers
NPC or store definitions that group related categories such as weapons, medical gear, or vehicles.
Currencies
Classnames accepted as money, each with a value multiplier used by generated prices.
Items
Tradeable classnames with quantity, buy price, sell price, seller, and category assignments.
Categories
Logical shelves inside a seller. Keep them narrow so exported files remain readable.
Pricing Guidance
Set sell prices below buy prices to prevent money loops. High-tier weapons, rare tools, vehicles, and base-building supplies should reflect the same scarcity you use in types.xml.
When importing a large config, audit outliers first: zero-price items, negative quantities that were not intentional, duplicate classnames, and items assigned to the wrong seller.
| Area | Check |
|---|---|
| Buy price | Should match item rarity, utility, and server progression. |
| Sell price | Usually 25-60% of buy price unless the item is intentionally farmable. |
| Quantity | -1 is commonly used for unlimited stock; finite stock should be used for progression gates. |
| Currency | Keep money items easy to identify and avoid using common loot as currency. |
DZconfig Workflow
Import the existing trader file, normalize sellers and currencies, use filters to review item groups, then generate the export after checking price ranges.
For AI-assisted pricing, give clear goals such as hardcore survival, PvE progression, or high-pop PvP. The better the economy goal, the more useful the suggestions.