> For the complete documentation index, see [llms.txt](https://fmt-mods.gitbook.io/mods/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fmt-mods.gitbook.io/mods/promocodes-v2/codes-promokody.md).

# Codes \[промокоды]

### Описание

Папка, в которой находятся файлы настроек каждого промокода.\
Имя файла должно совпадать с текстом промокода.

{% hint style="info" %}
Для Windows - систем имя файла может быть в любом регистре.
{% endhint %}

> Например, мы хотим создать промокод START. Для этого нам нужно создать файл START.json. А если система на Windows - то можно и StaRT.json и start.json и так далее.

***

### Пример файла

{% code title="START.json" expandable="true" %}

```json
{
    "exactText": "START",
    "validFrom": "2025-01-01 10:00:00",
    "validTo": "2026-12-31 23:59:59",
    "playtimeNeeded": 0,
    "maxUsages": 10,
    "currentUsages": 0,
    "steamIDListMode": 1,
    "steamIDList": [
        "76561198073201212"
    ],
    "rewards": [
        {
            "spawnType": 1,
            "classname": "Pear",
            "setQuantityMode": 2,
            "setQuantityValue": 50,
            "setHealthMode": 2,
            "setHealthValue": 50,
            "attachments": []
        },
        {
            "spawnType": 2,
            "classname": "CivilianSedan_Black",
            "setQuantityMode": 1,
            "setQuantityValue": -1,
            "setHealthMode": 1,
            "setHealthValue": -1,
            "attachments": [
                "CivSedanDoors_Driver_Black",
                "CivSedanDoors_BackLeft_Black",
                "CivSedanDoors_BackRight_Black",
                "CivSedanDoors_CoDriver_Black",
                "CivSedanHood_Black",
                "CivSedanTrunk_Black",
                "CarRadiator",
                "SparkPlug",
                "HeadlightH7",
                "HeadlightH7",
                "CivSedanWheel",
                "CivSedanWheel",
                "CivSedanWheel",
                "CivSedanWheel",
                "CivSedanWheel",
                "CarBattery"
            ]
        },
        {
            "spawnType": 0,
            "classname": "AKM",
            "setQuantityMode": 1,
            "setQuantityValue": -1,
            "setHealthMode": 1,
            "setHealthValue": -1,
            "attachments": [
                "AK_FoldingBttstck_Black",
                "Mag_AKM_Drum75Rnd",
                "KobraOptic",
                "Battery9V"
            ]
        },
        {
            "spawnType": 1,
            "classname": "Apple",
            "setQuantityMode": 1,
            "setQuantityValue": 10,
            "setHealthMode": 1,
            "setHealthValue": 1,
            "attachments": []
        }
    ]
}
```

{% endcode %}

***

### Описание параметров

`"exactText": "START"`\ <sup>Тип данных: String.</sup> \ <mark style="color:$warning;">**Точный**</mark> текст промокода, с учётом регистра.&#x20;

`"validFrom": "2025-01-01 10:00:00"` \ <sup>Тип данных: String формата YYYY-MM-DD HH:MM:SS.</sup> \
Дата и время <mark style="color:$warning;">старта</mark> работы промокода. \
Оставьте значение пустым ( `"validFrom": ""` ), чтобы отключить проверку по дате старта.

`"validTo": "2026-12-31 23:59:59"` \ <sup>Тип данных: String формата YYYY-MM-DD HH:MM:SS.</sup> \
Дата и время <mark style="color:$warning;">окончания</mark> работы промокода. \
Оставьте значение пустым ( `"validTo": ""` ), чтобы отключить проверку по дате окончания.

`"playtimeNeeded": 0`\ <sup>Тип данных: Int.</sup>\ <mark style="color:$warning;">Время в минутах</mark>, которое игрок должен отыграть на сервере, прежде чем сможет использовать этот промокод.\
Установите нулевое значение ( `"playtimeNeeded": 0` ), чтобы отключить данный функционал у этого промокода

`"maxUsages": 10`\ <sup>Тип данных: Int.</sup>\ <mark style="color:$warning;">Максимальное</mark> количество использований промокода.\
Установите отрицательное значение ( `"maxUsages": -1` ) чтобы отключить ограничение использований промокодов.

`"currentUsages": 0`\ <sup>Тип данных: Int.</sup>\ <mark style="color:$warning;">Текущее</mark> количество использований промокода.

`"steamIDListMode": 1`\ <sup>Тип данных: Int.</sup>\
Режим работы списка SteamID:\
• 1 : режим чёрного списка: промокод могут использовать <mark style="color:$warning;">все, кроме игроков со SteamID</mark> из списка\
• 2 : режим белого списка: промокод могут использовать <mark style="color:$warning;">только игроки со SteamID</mark> из списка

`"steamIDList": ["76561198073201212"]`\ <sup>Тип данных: массив String.</sup>\
Список SteamID. Используется для параметра `steamIDListMode`

`"rewards": []`\ <sup>Тип данных: массив объектов.</sup>\
Массив предметов для спавна.

`"spawnType": 1`\ <sup>Тип данных: Int</sup>\
Режим спавна предмета:\
• 0 : спавн предмета <mark style="color:$warning;">на землю под ноги игрока</mark>\
• 1 : спавн предмета <mark style="color:$warning;">в инвентарь игрока.</mark> <mark style="color:orange;">Если в инвентаре игрока нет места - предмет будет заспавнен ему под ноги.</mark>\
• 2 : спавн <mark style="color:$warning;">на свободной позиции рядом с игроком</mark> <mark style="color:orange;">- используется для спавна транспорта.</mark>

`"classname": "Pear"`\ <sup>Тип данных: String.</sup> \
Класснейм предмета для спавна.

`"setQuantityMode": 2`\ <sup>Тип данных: Int.</sup>\
Режим настройки наполненности предмета:\
• 1 : режим процентов: параметр `setQuantityValue` будет означать <mark style="color:$warning;">процентную наполненность</mark> предмета\
• 2 :  режим точных чисел: параметр `setQuantityValue` будет означать <mark style="color:$warning;">числовую наполненность</mark> предмета

`"setQuantityValue": 50`\ <sup>Тип данных: Int.</sup>\
Значение наполненности предмета. <mark style="color:$warning;">Режим работы параметра описан выше.</mark>\
Установите отрицательное значение ( `"setQuantityValue": -1` ) чтобы наполненность предмета была максимальной.

`"setHealthMode": 2`\ <sup>Тип данных: Int.</sup>\
Режим настройки здоровья предмета:\
• 1 : режим процентов: параметр `setHealthValue` будет означать <mark style="color:$warning;">процентное здоровье</mark> предмета\
• 2 :  режим точных чисел: параметр `setHealthValue` будет означать <mark style="color:$warning;">числовое здоровье</mark> предмета

`"setHealthValue": 50`\ <sup>Тип данных: Int.</sup>\
Значение здоровья предмета. <mark style="color:$warning;">Режим работы параметра описан выше.</mark>\
Установите отрицательное значение ( `"setHealthValue": -1` ) чтобы здоровье предмета было максимальным.

> Например, мы хотим получить яблоко с наполненностью 50% и здоровьем 50%.\
> \
> Для наполненности: устанавливаем setQuantityMode в процентный режим (2) и значение setQuantityValue = 50\
> Для здоровья: устанавливаем setHealthMode в процентный режим (2) и значение setHealthValue = 50\
> В итоге получаем яблоко со здоровьем и наполненностью в 50% от его максимальных значений.

`"attachments": []`\ <sup>Тип данных: массив String.</sup>\
Класснеймы аттачментов, которые будут прикреплены к предмету.\ <mark style="color:$warning;">В случае невозможности прикрепления аттача, он будет заспавнен игроку под ноги.</mark>
