Территории

Настройки территорий находятся в том же файле, что и основные настройки:

profiles/RZXC/LuxelRaidSettings/RaidSettings.json

В моде есть два вида территорий:

NoRaidTerritories: территории, на которых запрещён рейд защищаемых объектов.
RaidRulesTerritories: территории, на которых работают обычные правила рейда.

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

Все примеры отдельных настроек на этой странице являются фрагментами RaidSettings.json.

ItemsToDisableDamageForNoRaidTerritories

Настройка: ItemsToDisableDamageForNoRaidTerritories

Описание: Массив с класснеймами объектов, для которых будет отключён урон на территориях, где запрещён рейд (NoRaidTerritories).

Тип данных: array<string>

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

"ItemsToDisableDamageForNoRaidTerritories": [
    "Fence",
    "Watchtower",
    "tR_Stockade",
    "tR_StockadeWinter"
]

Класснеймы указываются отдельно для каждого варианта постройки. В стандартном списке находятся Fence и варианты построек Tierro из ItemsToDisableDamageWithoutWire. Если нужно защищать также Watchtower, добавьте его в этот массив, как в примере выше.

NoRaidTerritories

Настройка: NoRaidTerritories

Описание: Территории, на которых запрещён рейд объектов из ItemsToDisableDamageForNoRaidTerritories. Эти территории приоритетнее территорий, где работают правила рейда (RaidRulesTerritories), поэтому если одна будет внутри другой, то сработает территория, где запрещён рейд.

Тип данных: array<RZXC_NoRaidTerritory>

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

"NoRaidTerritories": [
    {
        "Position": [
            1500,
            0,
            2000
        ],
        "Radius": 200,
        "Enable": 1,
        "WhiteListSteamIDs": [
            "7656119XXXXXXXXXX"
        ]
    }
]

В примере задана включённая территория радиусом 200 метров. Значение 7656119XXXXXXXXXX является примером; замените его на настоящий SteamID64 игрока.

Для каждой территории указываются следующие настройки:

Position

Позиция центра территории. Территория обозначается в двумерном пространстве, поэтому значение высоты не учитывается.

Тип данных: vector. Координаты задаются в порядке X, Y, Z; второе значение можно оставить равным 0.

Radius

Радиус действия территории в метрах.

Тип данных: float.

Enable

Включить территорию.

Тип данных: bool. 0: выключить, 1: включить.

WhiteListSteamIDs

Список SteamID64 игроков, для которых разрешено строительство наборами из Building_BuildingKit на данной территории.

Тип данных: array<string>.

Чтобы разрешить строительство всем, необходимо вписать "EVERYONE":

"WhiteListSteamIDs": [
    "EVERYONE"
]

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

Этот список разрешает строительство, а не рейд. Игрок из WhiteList не получает возможность наносить урон защищённой постройке.

Если несколько территорий без рейда пересекаются, для разрешения строительства используется WhiteList первой подходящей включённой территории в массиве NoRaidTerritories.

RaidRulesTerritories

Настройка: RaidRulesTerritories

Описание: Территории, на которых работают правила рейда. На объекты вне этих территорий не распространяются обычные правила LuxelRaidSettings (кроме объектов из ItemsToDisableDamageAnyway и защиты в NoRaidTerritories).

Тип данных: array<RZXC_RaidRulesTerritory>

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

"RaidRulesTerritories": [
    {
        "Position": [
            1500,
            0,
            2000
        ],
        "Radius": 200,
        "Enable": 1
    }
]

Эти территории менее приоритетны, чем территории, где запрещён урон (NoRaidTerritories). Поэтому если одна будет внутри другой, то сработает территория, где запрещён рейд.

Для каждой территории указываются:

Position

Тип данных: vector, координаты X, Y, Z.

Radius

Радиус действия территории в метрах.

Тип данных: float.

Enable

Включить территорию.

Тип данных: bool. 0: выключить, 1: включить.

Если включено несколько территорий, достаточно находиться внутри любой из них. WhiteList у этого вида территорий отсутствует.

Отключение территорий

В новом RaidSettings.json создаются примеры территорий с Enable: 0. Они не влияют на рейд, пока Вы их не включите.

Для отключения территории выставьте ей Enable: 0. Если удалить все элементы из NoRaidTerritories или RaidRulesTerritories, при загрузке настроек мод снова добавит выключенные примеры. Это не включает территории автоматически.

Building_BuildingKit

Настройка: Building_BuildingKit

Описание: Список соответствий объектов стройки и их наборов для возведения. Он необходим для корректной работы территорий, где запрещён рейд (NoRaidTerritories), и территорий, где работают правила рейда (RaidRulesTerritories). Без этого списка не будет ни уведомлений о территории при установке, ни запрета стройки для игроков не в WhiteList.

Тип данных: map<string, string>

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

"Building_BuildingKit": {
    "Fence": "FenceKit",
    "Watchtower": "WatchtowerKit",
    "tR_Stockade": "tR_StockadeKit",
    "tR_NarrowDoor": "tR_NarrowDoorKit",
    "tR_Shed": "tR_ShedKit",
    "tR_Fortification": "tR_FortificationKit"
}

Слева следует указать возводимый объект (например, Fence), справа набор для его сооружения (например, FenceKit).

Если объект ставится без набора, например деревянный ящик WoodenCrate, укажите его класснейм с обеих сторон:

"Building_BuildingKit": {
    "WoodenCrate": "WoodenCrate"
}

Это отдельный пример записи. Добавьте её к остальным соответствиям в своём файле, если Вам нужна проверка размещения ящика.

Для запрета строительства в NoRaidTerritories объект должен быть указан в ItemsToDisableDamageForNoRaidTerritories. Для предупреждения о строительстве вне RaidRulesTerritories используется принадлежность к обычным спискам защиты или списку рейд-тайма.

Сам Building_BuildingKit не запрещает урон: он связывает устанавливаемый набор с объектом, настройки которого нужно проверить.

При пустом Building_BuildingKit мод восстанавливает стандартные соответствия. Для поддерживаемых построек Tierro часть соответствий добавляется автоматически при загрузке. Пустой массив территорий или пустой список соответствий не следует использовать как выключатель функции.

Уведомления о территории

Тексты задаются в RaidSettings.json и описаны в разделе Уведомления:

MessageForNoRaidTerritories: попытка рейда в территории без рейда.
MessageForDeployingOnNoRaidTerritories: установка постройки в территории без рейда, если строительство разрешено.
MessageForDeployingRestrict: игроку не разрешено строительство в этой территории.
MessageForDeployingOutRaidRulesTerritories: установка постройки вне территории действия правил.