Table of Contents
Type: Server Mod
Disclaimer: This mod is provided as-is with no guarantee of support.
Description:
Replaces the server method that displays the trader avatars with a custom method that uses custom image files for the trader avatars. These can be changed out to any avatars(images) desired, provided that you follow the steps to ensure that they all match filetypes and are of equal or very similar size.
Example Image:
| Frameworks/Libraries | Name | Link |
|---|---|---|
 |
TypeScript |
TypeScript Website |
 |
Batch |
Batch Documentation |
| IDEs | Name | Link |
|---|---|---|
 |
VSCodium |
VSCodium Website |
This section will explain how to install and use this mod.
EFT and SPT are required to use this mod.
For the purpose of these directions, "[SPT]" represents your SPT folder path.
Start by downloading the mod from the Releases page.
Follow these steps to install and configure the mod:
- Extract the contents of the zip file into the root of your [SPT] folder.
- That's the same location as "SPT.Server.exe" and "SPT.Launcher.exe".
- Edit the Config to adjust the values to your liking.
- Start SPT.Server.exe and wait until it fully loads.
- Start SPT.Launcher.exe but do not launch the game.
- Run the cache cleaner found in the launcher's settings menu.
- Now you can launch the game and profit.
You can specify which images you want to change and leave the rest as their defaults. Default is to change all supported trader images (default traders and mod traders). To change this, set the line 'updateAllTraders' to false and then enable or disable the trader(s) of your choice in the options below by setting them to true. 'updateAllTraders' will override other options when set to true.
{
// ======================================================================================
// Sets the extension of the image files. (Only one supported extension at a time.)
// Default = "jpg"
// It is recommended that you do not change this setting.
// ======================================================================================
"extension": "jpg",
// ======================================================================================
// Update all supported traders (including any potentially supported mod traders).
// 'BTR Driver' is considered WIP and may not work yet.
// Default = true
// ======================================================================================
"updateAllTraders": true,
// ======================================================================================
// Choose which traders you want to update.
// The setting 'updateAllTraders' must be set to false for these options to work.
// ======================================================================================
//*_____DEFAULT TRADERS_____*/
"updatePrapor": false,
"updateTherapist": false,
"updateFence": false,
"updateSkier": false,
"updatePeacekeeper": false,
"updateMechanic": false,
"updateRagman": false,
"updateJaeger": false,
"updateLightKeeper": false,
"updateBTRDriver": false,
"updateRef": false,
//*_____MOD TRADERS_____*/
"AIOTrader": false,
"AKGuy": false,
"AnastasiaSvetlana": false,
"ARSHoppe": false,
"Bootlegger": false,
"DRIP": false,
"GearGal": false,
"GoblinKing": false,
"Gunsmith": false,
"IProject": false,
"KatarinaBlack": false,
"KeyMaster": false,
"MFACShop": false,
"Priscilu": false,
"Questor": false,
"TheBroker": false
}You can customize it too! You can replace the traders with whatever pictures you like.
Follow these guidelines to make sure the new pictures fit the item frames within the game.
- Recommended shape = square, but round images can also be used.
- Transparency is ok.
- Recommended photo size = 512x for best compatibility.
- Pictures can be larger (1024x, 2048, etc.), but it requires more memory to store the larger file sizes while the game is running. Do so at your own risk.
- It can take longer for the game to load the images if there are a lot of large file sizes.
- Recommended filetypes = jpg or png (pick one; default is jpg).
- Do not use both jpg and png at the same time. While it can be done, it is recommended to stick to one filetype at a time.
EXAMPLE: PRAPOR --> .\res\59b91ca086f77469a81232e4.JPG (IMAGE SIZE 512X512)
- If you would like to replace this picture, rename the picture of your choosing to include the same string "59b91ca086f77469a81232e4" and copy it to the .\res folder.
- If a file of the same name exists, click on "Yes" or "OK" to overwrite it.
- To change to png from jpg, and vice versa, you will need to edit the ./src/config.js file.
Q: Why aren't the trader images changing?
A: The cached default images can override custom images if they are currently present when first using this mod. To get around this, you can use the included batch script in the mod's main folder to backup the default images so that custom images will load. The script name is "Rename-Cached_Images.bat". Just double-click it to launch and follow the on-screen prompts. (Note: This script also lets you restore your default images, should you ever want to uninstall this mod. Just run it again and follow the prompts.)
Q: Do you plan on supporting other trader mods?
A: Short answer: yes.
A: Long answer: I plan to update this mod to support as many trader mods as possible, however, I cannot guarantee any sort of an ETA for those updates.
- Add new trader avatars.
- Add support for more mod trader avatars.
- Add option to select from different types of avatars:
- Anime avatars.
- Realistic avatars.
- New Custom Halloween avatars.
- New Custom Christmas avatars.
- Furry avatars?
- Cat avatars?
- Update Readme, license, and change log files.
- Add new logo and banner images.
Suggest changes or view/report issues here.
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
You can also buy me a coffee! (This is not required, but I greatly appreciate any support provided.)
Distributed under the MIT License. See LICENSE.txt for more information.
Contributors:
- revingly
- Code optimizations.
- Artist Credit for image sources.