Skufy Trader

Что умеет мод

Установка

1. Скопируйте папку @Skufy_Trader на сервер и добавьте её в параметр запуска -mod= (клиентам — так же, или через Мастерскую Steam).
2. Ключ Skufy.bikey из папки @Skufy_Trader/Keys положите в папку keys сервера.
3. Других модов не нужно: Community Framework не требуется. Если стоит Skufy Garage, купленный транспорт может сразу уходить в гараж.
4. Запустите сервер один раз — мод создаст папку profiles/Skufy_Trader со всеми файлами.
5. Впишите свой SteamID64 в AdminSteamIds (см. Администраторы), перезапустите сервер, зайдите в игру и нажмите Num 8.

Первый запуск

При первом старте мод записывает в Traders/ по файлу на каждый из 15 видов торговцев — с полным ассортиментом и ценами, но без мест на карте. Поэтому сразу после установки торговцев в мире нет: их нужно расставить.

1. Откройте админ-панель (Num 8) → вкладка ТОРГОВЦЫ, выберите торговца.
2. В блоке ТОЧКИ НА КАРТЕ нажмите + ТЕРМИНАЛ или + NPC и поставьте голограмму: ЛКМ — поставить, Q/E — поворот, PageUp/PageDown — выше/ниже, ПКМ — отмена.
3. Для автосалона добавьте МЕСТО ВЫДАЧИ — там будет появляться купленный транспорт.
4. Нажмите СОХРАНИТЬ: сервер запишет файлы и сразу пересоздаст торговцев.

Администраторы

Админ-панель открывается только тем, чей SteamID64 (17 цифр, начинается с 7656119) есть в списке AdminSteamIds файла Settings.json. Узнать свой можно на steamid.io или в адресе профиля Steam.

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

• Добавлять админов удобнее в самой панели: НАСТРОЙКИ → АДМИНЫ И NPC. Себя удалить не получится — панель не даст запереть себя снаружи.
• В одиночной игре (оффлайн) админ — любой игрок: удобно для тестов.

Файлы конфига

Правила ручной правки

1. Проще всего — в админ-панели или в веб-редакторе: там не ошибиться с запятыми и кавычками.
2. Правите вручную — делайте это на выключенном сервере: при сохранении из панели сервер перезаписывает файлы. На работающем сервере после правки нажмите ПЕРЕЧИТАТЬ ФАЙЛЫ (вкладка НАСТРОЙКИ).
3. Это JSON: строки в двойных кавычках, между элементами запятые, после последнего элемента запятой нет. Комментарии // в JSON нельзя — кроме как внутри строки товара.
4. Переключатели можно писать как 1/0 или true/false. Поле Help — просто подсказка, его можно не трогать.
5. Если файл не читается, в логе сервера будет строка [Skufy_Trader] ERROR с причиной.

Строка товара

Каждый товар — одна строка в списке Items категории. Поля через запятую, всё после // — комментарий (панель пишет туда название предмета):

Примеры

"AKM, 8000, 4000 // АКМ"                  продаёт за 8000, скупает за 4000
"AKM, 8000"                               скупает за 8000 × DefaultSellRatio = 4000
"AKM, -1, 3000"                           только скупает
"NVGoggles, 15000, 7000, 3"               не больше 3 штук на складе
"Ammo_762x39, 300, 150, 0, 20"            бесконечно, 20 патронов за покупку

Settings.json

Общие настройки мода. В скобках под значением по умолчанию — допустимый диапазон: всё, что выходит за него, мод при загрузке поправит сам.

Валюта

"Currencies": [
    {
        "Name": "Рубли",
        "Sign": "руб.",
        "Items": [
            { "ClassName": "Skufy_TR_Coin1", "Value": 1 },
            { "ClassName": "Skufy_TR_Ruble100", "Value": 100 },
            { "ClassName": "Skufy_TR_Ruble5000", "Value": 5000 }
        ]
    }
],

Торговля и запас

Банк, телефон, кланы, зарплата

Безопасные зоны

SafeZonesOn включает все зоны сразу. Каждая зона в списке SafeZones — круг на карте (высота не учитывается). Зоны можно вкладывать: например, безопасная площадь внутри большой зоны без связи.

Файл торговца

Файл Traders/<id>.json. Торговцев может быть сколько угодно — например, два оружейника в разных городах с разными ценами. Имя файла = ID торговца (латиница, без пробелов).

Виды торговцев (Kind)

Точка на карте (Places)

Иконки категорий (Icon)

Транспорт

Транспорт продаётся как обычный товар (у вида vehicles — «Автосалон»). С какими деталями он выдаётся, задаёт Vehicles.json. Если машины в нём нет, мод сам подберёт детали по слотам.

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

• Место выдачи — у точки торговца (кнопка МЕСТО ВЫДАЧИ в панели). Без него машина может уйти только в гараж.
• Гараж — если установлен Skufy Garage и включён GarageLink. Режим выбирается у торговца в VehicleDelivery.
• Заправка при выдаче — VehicleFluids в настройках.

Счета, кланы, промокоды

Эти файлы пишет сервер. Менять балансы и промокоды удобнее в админ-панели (вкладки БАНК, КЛАНОВЫЕ СЧЕТА, ПРОМОКОДЫ).

Админ-панель (Num 8)

Все изменения остаются в панели, пока не нажата СОХРАНИТЬ: тогда сервер записывает файлы и сразу пересоздаёт торговцев. ОТМЕНИТЬ ИЗМЕНЕНИЯ возвращает всё как было.

Как торгуют игроки

Окно торговли

• У терминала — действие «Торговать», у NPC — «Поговорить с торговцем».
• КУПИТЬ: категории и поиск слева, карточки с 3D-превью, справа — количество и кнопка покупки. Вкладки ХАРАКТЕРИСТИКИ (урон, скорострельность, слоты, защита, калории…) и КОМПЛЕКТ (что подходит к предмету). Колесо мыши на карточке — предмет на весь экран.
• ПРОДАТЬ: всё, что торговец скупает, с ценой по состоянию. Отметьте строки и продайте — или продайте всё из рюкзака и карманов. Вещи внутри предмета продаются вместе с ним.
• Переключатель СЧЁТ в шапке — оплата со счёта SKUFY БАНК, выручка тоже идёт на счёт.

Банкомат

Действие «Банкомат»: СНЯТЬ (выдаётся купюрами и монетами), ВНЕСТИ (сумму или все наличные), ПЕРЕВОД игроку онлайн, КЛАН (создать клан, взнос, снятие, участники и их права), ИСТОРИЯ. Там же видно зарплату и время до следующей.

Телефон

Телефон Skufy_TR_Phone с батареей SKUFY POWER (Skufy_TR_PhoneBattery). В руках — «Открыть SKUFY БАНК», в машине — действие «SKUFY БАНК (телефон)». Баланс, история, переводы и промокоды. Каждое открытие тратит PhoneCharge% батареи; в зоне без связи не работает.

Ноутбук и флешки

Ноутбук Skufy_TR_Laptop на 6 USB-портов. Вставьте флешки торговцев (Skufy_TR_Usb_weapons, …_food и т.д.) и выберите «Открыть ноутбук»: каждая флешка открывает своего торговца из любой точки карты. Всё это по умолчанию продаётся у торговца вида general.

Если что-то не работает

Не открывается админ-панель на Num 8

Проверьте, что ваш SteamID64 (17 цифр) есть в AdminSteamIds, и перезапустите сервер. Проверьте клавишу в «Настройки → Управление → Панель торговцев (админ)».

После установки торговцев нет на карте

Так и должно быть: при первом запуске создаются файлы с товарами, но без мест. Расставьте торговцев в панели: ТОРГОВЦЫ → + ТЕРМИНАЛ / + NPC → СОХРАНИТЬ.

Поменял JSON, а в игре всё по-старому

Правьте файлы на выключенном сервере или после правки нажмите ПЕРЕЧИТАТЬ ФАЙЛЫ. Сохранение из панели перезаписывает файлы — несохранённая ручная правка потеряется. Если файл с ошибкой, в логе сервера будет [Skufy_Trader] ERROR.

Торговец не продаёт или не скупает предмет

Проверьте класс (опечатка → предмета нет в игре), цену: -1 в покупке — не продаётся, в продаже — не скупается. Запас мог закончиться. Деньги торговцу не продаются никогда.

Нужны деньги другого мода

TraderPlus, MoneyRuble и Expansion подхватываются при первом запуске. Любые другие — впишите их классы и номиналы в ВАЛЮТА И ЦЕНЫ (или в Currencies).

Купленная машина не появилась

У точки торговца должно быть МЕСТО ВЫДАЧИ (режимы 0 и 2), а для гаража — установлен Skufy Garage и есть свободное место (режимы 0 и 1).

Ноутбук или телефон не работают

Проверьте OnlineTrade / PhoneBank, заряд батареи телефона и не стоит ли игрок в зоне без связи. Флешка не откроет торговца с Usb: "-".

Удалил торговца по ошибке

Копия лежит в Backups/. Верните файл в Traders/ (убрав дату из имени) и нажмите ПЕРЕЧИТАТЬ ФАЙЛЫ.