Skufy Trader

What it does

Installation

1. Copy the @Skufy_Trader folder to the server and add it to the -mod= launch parameter (clients the same way, or via the Steam Workshop).
2. Put the Skufy.bikey key from @Skufy_Trader/Keys into the server's keys folder.
3. No other mods are needed: Community Framework is not required. With Skufy Garage installed, bought vehicles can go straight into the garage.
4. Start the server once — the mod creates the profiles/Skufy_Trader folder with all files.
5. Add your SteamID64 to AdminSteamIds (see Admins), restart the server, join and press Num 8.

First start

On the first start the mod writes one file per trader kind into Traders/ — with the full assortment and prices, but without any places on the map. That is why there are no traders in the world right after installation: you place them.

1. Open the admin panel (Num 8) → tab ТОРГОВЦЫ (Traders) and pick a trader.
2. In ТОЧКИ НА КАРТЕ (places on the map) press + ТЕРМИНАЛ (terminal) or + NPC and place the hologram: LMB — place, Q/E — rotate, PageUp/PageDown — up/down, RMB — cancel.
3. For the car dealer add a МЕСТО ВЫДАЧИ (delivery spot) — bought vehicles appear there.
4. Press СОХРАНИТЬ (Save): the server writes the files and respawns the traders right away.

Admins

The admin panel opens only for players whose SteamID64 (17 digits, starts with 7656119) is in the AdminSteamIds list of Settings.json. Find yours on steamid.io or in your Steam profile URL.

"AdminSteamIds": [
    "76561198000000001",
    "76561198000000002"
],

• It is easier to add admins in the panel itself: НАСТРОЙКИ → АДМИНЫ И NPC (Settings → Admins and NPC). You cannot remove yourself — the panel never locks you out.
• In single player (offline) every player is an admin — handy for testing.

Config files

Editing by hand

1. The easiest way is the admin panel or the web editor: no way to break commas and quotes.
2. Edit by hand while the server is stopped: saving from the panel overwrites the files. On a running server press ПЕРЕЧИТАТЬ ФАЙЛЫ (reload files) (Settings tab) after editing.
3. It is JSON: strings in double quotes, commas between elements, no comma after the last one. // comments are not allowed in JSON — except inside a product line.
4. Switches can be written as 1/0 or true/false. The Help field is just a hint.
5. If a file cannot be read, the server log shows a line [Skufy_Trader] ERROR with the reason.

Product line

Each product is one string in the category's Items list. Fields are separated by commas, everything after // is a comment (the panel writes the item name there):

Examples

"AKM, 8000, 4000 // AKM"                  sells for 8000, buys for 4000
"AKM, 8000"                               buys for 8000 × DefaultSellRatio = 4000
"AKM, -1, 3000"                           only buys
"NVGoggles, 15000, 7000, 3"               at most 3 in stock
"Ammo_762x39, 300, 150, 0, 20"            endless, 20 rounds per purchase

Settings.json

Common mod settings. Under each default value is the allowed range: anything outside it is corrected by the mod on load.

Currency

"Currencies": [
    {
        "Name": "Rubles",
        "Sign": "rub.",
        "Items": [
            { "ClassName": "Skufy_TR_Coin1", "Value": 1 },
            { "ClassName": "Skufy_TR_Ruble100", "Value": 100 },
            { "ClassName": "Skufy_TR_Ruble5000", "Value": 5000 }
        ]
    }
],

Trading & stock

Bank, phone, clans, pay day

Safe zones

SafeZonesOn switches all zones at once. Each zone in the SafeZones list is a circle on the map (height is ignored). Zones can be nested — e.g. a safe square inside a large no-signal area.

Trader file

The file Traders/<id>.json. There can be any number of traders — e.g. two gun shops in different towns with different prices. File name = trader ID (Latin letters, no spaces).

Trader kinds (Kind)

Place on the map (Places)

Category icons (Icon)

Vehicles

Vehicles are sold like any product (the vehicles kind is the car dealer). Vehicles.json sets the parts they come with. A vehicle not listed there gets its parts picked automatically by slots.

{
    "Presets": [
        {
            "Vehicle": "OffroadHatchback",
            "Parts": ["CarBattery", "CarRadiator", "SparkPlug", "HatchbackWheel", "HatchbackWheel", "HatchbackWheel", "HatchbackWheel"]
        }
    ]
}

• Delivery spot — at the trader's place (the МЕСТО ВЫДАЧИ (delivery spot) button in the panel). Without it a vehicle can only go to the garage.
• Garage — when Skufy Garage is installed and GarageLink is on. The mode is set per trader in VehicleDelivery.
• Fluids on delivery — VehicleFluids in the settings.

Accounts, clans, promo codes

These files are written by the server. Balances and promo codes are easier to change in the admin panel (tabs БАНК (Bank), КЛАНОВЫЕ СЧЕТА (Clan accounts), ПРОМОКОДЫ (Promo codes)).

Admin panel (Num 8)

All edits stay in the panel until you press СОХРАНИТЬ (Save): then the server writes the files and respawns the traders. ОТМЕНИТЬ ИЗМЕНЕНИЯ (discard changes) brings everything back.

How players trade

Trade window

• At a terminal — the “Trade” action, at an NPC — “Talk to the trader”.
• КУПИТЬ (buy): categories and search on the left, cards with 3D previews, amount and the buy button on the right. Tabs ХАРАКТЕРИСТИКИ (stats: damage, rate of fire, slots, protection, calories…) and КОМПЛЕКТ (kit: what fits the item). Mouse wheel click on a card — full-screen view.
• ПРОДАТЬ (sell): everything the trader buys, priced by condition. Tick rows and sell — or sell everything from bags and pockets. Items inside an item are sold with it.
• The СЧЁТ (account) toggle in the header — pay from the SKUFY BANK account; sales also go onto the account.

ATM

The “Use the ATM” action: withdraw (paid out in notes and coins), deposit (a sum or all the cash), transfer to a player online, clan (create a clan, pay in, withdraw, members and rights), history. It also shows the salary and the time to the next one.

Phone

The Skufy_TR_Phone phone with a SKUFY POWER battery (Skufy_TR_PhoneBattery). In hands — “Open SKUFY BANK”, in a vehicle — the “SKUFY BANK (phone)” action. Balance, history, transfers and promo codes. Each opening costs PhoneCharge% of the battery; it does not work in a no-signal zone.

Laptop & flash drives

The Skufy_TR_Laptop laptop has 6 USB ports. Plug in trader flash drives (Skufy_TR_Usb_weapons, …_food etc.) and choose “Open the laptop”: each drive opens its trader from anywhere on the map. All of this is sold by the general trader by default.

Troubleshooting

The admin panel does not open on Num 8

Check that your SteamID64 (17 digits) is in AdminSteamIds and restart the server. Check the key in Settings → Controls → Trader admin panel.

No traders on the map after installation

That is expected: the first start creates files with goods but without places. Place the traders in the panel: ТОРГОВЦЫ → + ТЕРМИНАЛ / + NPC → СОХРАНИТЬ.

I changed the JSON but nothing changed in game

Edit files with the server stopped, or press ПЕРЕЧИТАТЬ ФАЙЛЫ (reload files) after editing. Saving from the panel overwrites the files — an unsaved manual edit is lost. A broken file shows [Skufy_Trader] ERROR in the server log.

A trader does not sell or buy an item

Check the class (a typo → no such item in the game) and the price: -1 as buy — not sold, as sell — not bought. The stock may have run out. Money is never sold to a trader.

I need the money of another mod

TraderPlus, MoneyRuble and Expansion are picked up on first start. For any other mod put its classes and values into ВАЛЮТА И ЦЕНЫ (or Currencies).

A bought vehicle did not appear

The trader's place needs a delivery spot (modes 0 and 2); for the garage Skufy Garage must be installed and have room (modes 0 and 1).

The laptop or the phone does not work

Check OnlineTrade / PhoneBank, the phone battery, and whether the player stands in a no-signal zone. A drive does not open a trader with Usb: "-".

I deleted a trader by mistake

A copy is in Backups/. Move the file back to Traders/ (removing the date from its name) and press ПЕРЕЧИТАТЬ ФАЙЛЫ.