Trader Namer 3.1.0

Do not ask when mod authors will update their mods or if they can upload older versions of their mods.
Bothering mod authors will lead to warnings and repeat offenses will lead to bans.
Due to an unusually high volume of traffic, our site may be experiencing intermittent slowdowns. If you notice any issues, log out of your account and browse anonymously so you can better utilize caching or try using forge.sp-tarkov.com to search for and download mods.

Change your traders' names and avatars.

After changing avatars, you must go to the launcher's settings and click "Clean Temp Files" at the top.


This mod will let you change traders' nicknames and avatars.


The novel difference from other avatar-swapping mods is that it uses trader nicknames instead of obscure avatar IDs that don't match the trader ID. By default the name should be in your system language but this can be changed in config/lang.json. You can find language codes in SPT_Data/Server/database/locales/; the value for English is en, Russian is ru, etc.

Instead of using a trader’s nickname you can use either their regular ID (for compatibility with Windows filename restrictions) or avatar ID (to easily switch from other avatar-switching mods).


Both features of the mod should work for custom traders as long as this mod loads after them.


I've set up a (very) basic configuration page for anyone who'd rather use it than edit the JSON by hand. When "uploading" a config, it is read in the browser and not actually sent anywhere.

Setting Trader Names

Edit config/names.json and add a new line between the {} in the format "Default Name": "New Name".

The key (left) should be the trader's default nickname/ID like Prapor or 54cb50c76803fa8b248b4571, the value (right) is what you want their new name to be.

Examples:

Code
{
  "Prapor": "Sidorovich"
}
Code
{
  "Prapor": "Sidorovich",
  "Fence": "Drebin"
}

You can also change the trader's information like Location and Description.

Valid keys for this extended syntax are "FullName", "FirstName", "Nickname", "Location", and "Description". All are case-sensitive.

Code
{
  "Prapor": {
    "Nickname": "Sidorovich",
    "Location": "Rookie Village in the Cordon",
    "Description": "A reliable source of equipment for stalkers."
  },
  "Fence": "Drebin"
}


Setting Trader Avatars

Name an image based on the trader's default nickname/ID like Prapor.jpg, 54cb50c76803fa8b248b4571.jpg, or 59b91ca086f77469a81232e4.jpg and put it in the mod's avatars folder.

Images should be JPEG or PNG and sizes around 500x500 work best.

Thumbs Up 2 Happy 1

  • Version 3.1.0

    Now supports using trader ID to get around Windows filename restrictions

    Because it wasn't much more effort, you can also use early traders' avatar ID to more easily transition from other avatar-switching mods

    These apply to both avatars and names.json


    Traders' original names are now grabbed from the system locale instead of English by default. This can be changed in the new lang.json config.

    This is mainly useful for anyone using Fika with players who use different system languages and don't have a dedicated server setup.

  • Version 3.0.0

    Updated to 3.11

  • Version 2.1.2

    Small update to fix a logging issue.

  • Version 2.1.0

    Now allows alternate syntax to edit other parts of the trader's locale values like Location and Description.


    To do this, use an object instead of nickname.

    Code
    {
  "Prapor": "Sidorovich",
  "Fence": "Drebin"
}

    changes to

    Code
    {
  "Prapor": {
    "Nickname": "Sidorovich",
    "Location": "Rookie Village in the Cordon",
    "Description": "A reliable source of equipment for stalkers."
  },
  "Fence": "Drebin"
}

    Valid keys are "FullName", "FirstName", "Nickname", "Location", and "Description". All are case-sensitive.

  • Version 2.0.1

    Fixes Lightkeeper, BTR Driver, and Ref

  • Version 2.0.0

    Currently the 3.9 launcher's "Clean Temp Files" option does not work correctly.

    Until this is fixed users can delete the user/sptappdata/files/trader folder.


    A 3.8.3 release is available in the Github releases.

  • the mod says Jaeger does not exist, so I cant chance His png

    • I'm able to change both his name and avatar. The most recent update uses your system language to get names by default, so you might need to either change names or the language used in lang.json. As an alternative, you can use his ID 5c0647fdd443bc2504c2d371 as you might with other mods.

  • Had a really good laugh with the thumbnail. Thank my man :D

  • What folder should this be extracted to?

    • The game folder, the "user" folder should merge with the existing one.

  • Thank youuuuu so much animelove

  • Hi,

    I cant seem to get this working.

    Installed latest files from the DL link. but i cant get it to update the trader names or avatars.

    Im using:
    SPT3.9.8
    Fika Beta 0.9.9015.15435

    • I had the same issue, but it was my fault.

      Did you clean temp files from your SPT launcher? You have to clean the temp files from the launcher to update the images in-game.

    • yes i cleaned up the temp files several times.

      but both renaming traders and changing avatars fail.

    • This has been reported a couple times now and I can't reproduce it. Maybe try manually deleting "sptappdata" from the "user" folder .

    • deleting the folder did nothing, i also tried cleaning after deleting it, and installing your mod before or after deleting the folder and it didnt do anything.

      manually replacing the avatars here: "user\sptappdata\files\trader\avatar" with the new ones and copying the names did work though (eg: fence is: 579dc571d53a0658a154fbec.jpg)

      Im not sure if im doing something wrong though

  • Mod doesnt work for me. I tried it on my main install and only Viper's avatar was successfully changed. Then I tested the mod on a clean install and no changes were made. I cleared temp files in the Settings, checked avatar names but nothing helped. In the server console it says



    Even though it says "Changing avatar" there are no changes of vanilla trader avatars.

    • This appears to be related to Halloween event trader images. Not entirely sure of the cause, but it should sort itself out when the event ends.

    • Sadly even after the event, it did not change them. :(
      So I had to go into tarkovs config and manually edit the photos file path.

  • Now how can I write descriptions or even locations after the names???

    • See the extended syntax example at the end of the mod description.

    • ?

    • Code
      {
  "Prapor": {
    "Nickname": "Sidorovich",
    "Location": "Rookie Village in the Cordon",
    "Description": "A reliable source of equipment for stalkers."
  },
  "Fence": "Drebin"
}

      The example from the description shows how you can change Prapor's name, location, and description.

    • Every time I try to do this it says "Expected ',' or '}' after property value in JSON (random position)"

    • Post your JSON here or use JSONLint to get more specific information.

  • I'd been hoping for a mod like this since 3.7.X ^^ Works very well, including with modded traders. Thank you!

  • is editing of the trader description possible

    • Updated. There's an example showing how to do it in the Versions tab.

  • Ha-ha, Brappor