[Server Hosting] Setting up Trader Entities and NPCs - salutesh/DayZ-Expansion-Scripts GitHub Wiki

Return to the overview "The Market System"

All trader entities/NPCs need to be configured using .map files in the following directory:

mpmissions/dayzoffline.<MapName>/expansion/traders/MyTrader.map

If you want to use the DayZ-Expansion-AI for trader NPCs, be aware that AI traders have a higher performance impact than static NPCs.

• The file is a simple text file that needs to follow our .map file format (see below).
• The file name can be what ever you want.

Every trader entity/NPC needs an entry (one line per trader entity) in one or several .map files in the following format:

<TraderEntityClassName>.<TraderFileName>|<Position>|<Orientation>|<Gear>

Example:

ExpansionTraderDenis.Weapons|11833.576 140.605 12469.492|110 0 0|Jeans_Blue,TSHirt_Blue

TraderEntityClassName

This is the entity/NPC classname (in this example ExpansionTraderDenis).

Scroll down to see a list of all the default expansion trader npc's we provide.

TraderFileName

This is the trader configuration file name (in this example Weapons), without the JSON extension, that controls what the trader sells/buys. It is separated from the trader entity class name with a dot (.), much like a file extensions, but is the trader file's base name instead. The TraderFileName parameter here needs to be the same as one of the configured trader JSON files from the trader settings folder (ExpansionMod\Traders). For further information, please take a look at our Wiki page about the trader settings: https://github.com/salutesh/DayZ-Expansion-Scripts/wiki/%5BServer-Hosting%5D-Trader-Settings

Position

Either a single position vector or a list of vectors (delimited by commas ,) aka waypoints. Waypoints will only work if the entity is an AI trader.

Reminder, dayz 3d world use the Y axis as the height/elevation axis. Use tools such as dayz editor, community online tools, vanilla plus plus admin tools to get this 3d positions.

Orientation

Single vector.

The direction the trader entity/NPC will be facing.

Gear

List of items that should be in the trader entity's inventory (i.e. clothes), delimited by comma (,). Attachments on items are possible by separating them from the main item with plus signs +. E.g.

ExpansionTraderDenis.Weapons|11833.576 140.605 12469.492|110 0 0|Jeans_Blue,TSHirt_Blue,AKM+Mag_AKM_30Rnd+KobraOptic

You can use special keywords instead of or in addition to gear to influence some properties of a trader. Example to set trader name to "Mark" and use the loadout "MyTraderLoadout":

ExpansionTraderDenis.Weapons|11833.576 140.605 12469.492|110 0 0|name:Mark,loadout:MyTraderLoadout

For AI traders, you can also assign a different faction:

ExpansionTraderAIDenis.Weapons|11833.576 140.605 12469.492|110 0 0|name:Mark,loadout:MyTraderLoadout,faction:Guards

List of default static trader entities:

ExpansionTraderPumpkin
ExpansionTraderZucchini
ExpansionExchangeMachine
ExpansionTraderLockerClosedBlueV1
ExpansionTraderLockerClosedBlueV2
ExpansionTraderLockerClosedBlueV3
ExpansionTraderLockerClosedV1
ExpansionTraderLockerClosedV2
ExpansionTraderLockerClosedV3

List of default static trader NPCs:

ExpansionTraderMirek
ExpansionTraderDenis
ExpansionTraderBoris
ExpansionTraderCyril
ExpansionTraderElias
ExpansionTraderFrancis
ExpansionTraderGuo
ExpansionTraderHassan
ExpansionTraderIndar
ExpansionTraderJose
ExpansionTraderKaito
ExpansionTraderLewis
ExpansionTraderManua
ExpansionTraderNiki
ExpansionTraderOliver
ExpansionTraderPeter
ExpansionTraderQuinn
ExpansionTraderRolf
ExpansionTraderSeth
ExpansionTraderTaiki
ExpansionTraderLinda
ExpansionTraderMaria
ExpansionTraderFrida
ExpansionTraderGabi
ExpansionTraderHelga
ExpansionTraderIrena
ExpansionTraderJudy
ExpansionTraderKeiko
ExpansionTraderEva
ExpansionTraderNaomi
ExpansionTraderBaty

List of default AI trader NPCs:

ExpansionTraderAIMirek
ExpansionTraderAIDenis
ExpansionTraderAIBoris
ExpansionTraderAICyril
ExpansionTraderAIElias
ExpansionTraderAIFrancis
ExpansionTraderAIGuo
ExpansionTraderAIHassan
ExpansionTraderAIIndar
ExpansionTraderAIJose
ExpansionTraderAIKaito
ExpansionTraderAILewis
ExpansionTraderAIManua
ExpansionTraderAINiki
ExpansionTraderAIOliver
ExpansionTraderAIPeter
ExpansionTraderAIQuinn
ExpansionTraderAIRolf
ExpansionTraderAISeth
ExpansionTraderAITaiki
ExpansionTraderAILinda
ExpansionTraderAIMaria
ExpansionTraderAIFrida
ExpansionTraderAIGabi
ExpansionTraderAIHelga
ExpansionTraderAIIrena
ExpansionTraderAIJudy
ExpansionTraderAIKeiko
ExpansionTraderAIEva
ExpansionTraderAINaomi
ExpansionTraderAIBaty