Зоны получения

Зоны позволяют ограничить места получения товаров. Например, можно оставить получение автомобилей только на специальной площадке или запретить его на территории торговца.

Настройки находятся в файле:

profiles/RZXC/LuxelAutoDonate/MainSettings.json

Как работают ограничения

При включённом EnableReceivingZones игрок должен находиться хотя бы в одной активной разрешающей зоне для нужной категории товара. За пределами таких зон получение недоступно.

При включённом EnableRestrictedReceivingZones получение блокируется внутри активных запретных зон для выбранных категорий. Если разрешающие зоны выключены, вне запретных зон это ограничение не действует.

Запрет имеет приоритет. Если разрешающая и запретная зоны пересекаются, то в области пересечения нельзя получить товар той категории, для которой установлен запрет.

Если оба переключателя выключены, общие зоны сервера не ограничивают получение. При этом продолжают действовать индивидуальные ограничения места получения, если они заданы самому товару.

EnableReceivingZones

Настройка: EnableReceivingZones

Описание: Разрешать получение товаров только в активных зонах из ReceivingZones.

Тип данных: bool

По умолчанию: false

Использование:

"EnableReceivingZones": false

ReceivingZones

Настройка: ReceivingZones

Описание: Массив разрешающих зон. В каждой зоне отдельно задаются доступные категории товаров.

Тип данных: массив объектов.

Использование:

"ReceivingZones": [
    {
        "Name": "Площадка получения",
        "Position": [
            5500,
            0,
            3000
        ],
        "Radius": 50,
        "AllowReceiveTransport": true,
        "AllowReceiveItems": true,
        "AllowReceiveWeapons": true,
        "Enable": true
    }
]

В примере все три категории доступны в радиусе 50 метров от указанной точки. Чтобы включить ограничение, выставите EnableReceivingZones в true. Координаты являются примером, замените их на подходящие для Вашей карты.

Name

Описание: Название зоны для удобства работы с настройками.

Тип данных: string

Пример: "Площадка получения"

Position

Описание: Координаты центра в порядке X, Y, Z. Первое и третье значения задают положение на карте, второе необходимо оставить равным 0. Проверка зоны рассчитана на нулевую высоту центра.

Тип данных: vector

Пример: [5500,0,3000]

Radius

Описание: Радиус зоны в метрах. Указывайте положительное значение. Например, радиус 50 означает площадку диаметром 100 метров.

Тип данных: float

Пример: 50

AllowReceiveTransport

Описание: Разрешить получение автомобилей и лодок в этой зоне.

Тип данных: bool

Пример: true

AllowReceiveItems

Описание: Разрешить получение обычных предметов: одежды, еды, инструментов и т.п.

Тип данных: bool

Пример: true

AllowReceiveWeapons

Описание: Разрешить получение оружия в этой зоне.

Тип данных: bool

Пример: true

Enable

Описание: Включить эту зону. При false она не учитывается, но остаётся в списке настроек.

Тип данных: bool

Пример: true

EnableRestrictedReceivingZones

Настройка: EnableRestrictedReceivingZones

Описание: Запретить получение выбранных категорий товаров внутри активных зон из RestrictedReceivingZones.

Тип данных: bool

По умолчанию: false

Использование:

"EnableRestrictedReceivingZones": false

RestrictedReceivingZones

Настройка: RestrictedReceivingZones

Описание: Массив запретных зон. Каждая зона может ограничивать отдельные категории товаров.

Тип данных: массив объектов.

Использование:

"RestrictedReceivingZones": [
    {
        "Name": "Торговая зона",
        "Position": [
            6500,
            0,
            4000
        ],
        "Radius": 100,
        "RestrictReceiveTransport": true,
        "RestrictReceiveItems": false,
        "RestrictReceiveWeapons": false,
        "Enable": true
    }
]

В примере запрещён только транспорт в радиусе 100 метров от торговой зоны. Обычные предметы и оружие эта зона не запрещает. Для её работы выставите EnableRestrictedReceivingZones в true.

Name

Описание: Название зоны для удобства работы с настройками.

Тип данных: string

Пример: "Торговая зона"

Position

Описание: Координаты центра в порядке X, Y, Z. Второе значение оставьте равным 0, как и у разрешающих зон.

Тип данных: vector

Пример: [6500,0,4000]

Radius

Описание: Радиус запретной зоны в метрах. Указывайте положительное значение.

Тип данных: float

Пример: 100

RestrictReceiveTransport

Описание: Запретить получение автомобилей и лодок внутри зоны.

Тип данных: bool

Пример: true

RestrictReceiveItems

Описание: Запретить получение обычных предметов внутри зоны.

Тип данных: bool

Пример: false

RestrictReceiveWeapons

Описание: Запретить получение оружия внутри зоны.

Тип данных: bool

Пример: false

Enable

Описание: Включить эту зону. При false запреты данной зоны не действуют.

Тип данных: bool

Пример: true

На что обратить внимание

Зоны проверяются по положению персонажа в момент запроса на получение. Они не задают отдельную точку появления товара.
Ограничения применяются как к получению в инвентарь, так и к созданию товара рядом с игроком.
У комплекта категория определяется по основному предмету товара. Содержимое комплекта не проверяется как несколько самостоятельных категорий.
Для отключения ограничений используйте общие переключатели. Не требуется очищать массивы зон: при загрузке пустого массива мод пытается заполнить его примерными зонами.
Не включайте оба вида зон, не проверив их координаты. В автоматически добавляемых примерах разрешающие и запретные зоны располагаются в одних и тех же местах.

После настройки проверьте получение нужных категорий внутри зоны, за её пределами и в месте пересечения с другой зоной.