Рейд-тайм

Установка дополнения

Для работы дополнения необходим установленный LuxelRaidSettings. Мод LuxelRaidSettings_RaidTime_Server.pbo должен быть установлен на серверную часть.

Дополнение входит в общий комплект LuxelRaidSettings и не требует отдельной покупки. Установка клиентской части основного мода и RZXC.CORE описана в разделе Установка LuxelRaidSettings.

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

Файл настроек рейд-тайма создаётся автоматически после первого запуска сервера с дополнением.

profiles/RZXC/LuxelRaidSettings/RaidTime.json

Примеры отдельных настроек ниже являются фрагментами JSON, а не полным содержимым файла. У настроек типа bool значение 0 выключает функцию, 1 включает её.

Как работает расписание

Рейд-тайм определяется по реальному времени компьютера, на котором запущен сервер, а не по игровому времени DayZ. Учитывается часовой пояс серверной операционной системы.

Расписание проверяется при запуске и затем раз в минуту. Поэтому начало и завершение рейд-тайма может примениться с задержкой до минуты.

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

ItemsRaidedOnlyAtRaidTime

Настройка: ItemsRaidedOnlyAtRaidTime

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

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

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

"ItemsRaidedOnlyAtRaidTime": [
    "Fence",
    "Watchtower",
    "tR_Stockade",
    "tR_StockadeWinter",
    "tR_NarrowDoor",
    "tR_Shed",
    "tR_Fortification"
]

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

Если объект также включён в ItemsToDisableDamageWithoutWire, во время рейд-тайма он всё равно должен быть дверью или воротами. Запреты отдельных видов урона, защита в территориях без рейда и ItemsToDisableDamageAnyway тоже сохраняются.

MessageForItemsRaidedOnlyAtRaidTime

Настройка: MessageForItemsRaidedOnlyAtRaidTime

Описание: Сообщение для объектов из массива ItemsRaidedOnlyAtRaidTime при попытке рейда вне разрешённого времени.

Тип данных: string

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

"MessageForItemsRaidedOnlyAtRaidTime": "#RZXC_AFR_RAIDDISABLED_RT"

Стандартное сообщение: «СЕЙЧАС РЕЙД ОТКЛЮЧЁН, ДОЖДИТЕСЬ РЕЙД-ТАЙМА».

Можно оставить строку перевода или указать свой текст.

RaidDays

Настройка: RaidDays

Описание: Дни и интервалы рейд-тайма.

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

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

"RaidDays": [
    {
        "DayOfWeek": "WEDNESDAY",
        "RaidStart": "00:00",
        "RaidEnd": "18:20",
        "Enable": 1
    }
]

В примере рейд-тайм включён в среду с 00:00 до 18:20. Для каждого интервала указываются следующие настройки:

DayOfWeek

День недели. Можно использовать как русский, так и английский язык.

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

Русский	Английский
`ПОНЕДЕЛЬНИК`	`MONDAY`
`ВТОРНИК`	`TUESDAY`
`СРЕДА`	`WEDNESDAY`
`ЧЕТВЕРГ`	`THURSDAY`
`ПЯТНИЦА`	`FRIDAY`
`СУББОТА`	`SATURDAY`
`ВОСКРЕСЕНЬЕ`	`SUNDAY`

RaidStart

Время начала рейд-тайма.

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

RaidEnd

Время завершения рейд-тайма.

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

Время должно быть чётко в формате ЧЧ:ММ (примеры: 08:00, 12:30, 22:00, 23:59). Не устанавливайте время начала рейд-тайма позже или равным времени завершения: такой интервал не включится.

Время рейд-тайма не может выходить за пределы одного дня. Например, нельзя поставить один интервал с 22:00 до 02:00. Правильно будет поставить, к примеру: понедельник с 22:00 до 23:59 и вторник с 00:00 до 02:00.

Вместо времени завершения 00:00 указывайте 23:59. В текущем коде 00:00 при проверке окончания также заменяется на 23:59.

Enable

Включить этот интервал рейд-тайма.

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

Если для одного дня задано несколько интервалов, выключение одного не отключает остальные. Пустой RaidDays или все интервалы с Enable: 0 оставляют рейд-тайм выключенным.

Несколько интервалов в один день

Например, чтобы по воскресеньям рейд был разрешён утром и вечером, задайте два элемента с одним днём недели:

"RaidDays": [
    {
        "DayOfWeek": "SUNDAY",
        "RaidStart": "08:00",
        "RaidEnd": "12:00",
        "Enable": 1
    },
    {
        "DayOfWeek": "SUNDAY",
        "RaidStart": "18:00",
        "RaidEnd": "22:00",
        "Enable": 1
    }
]

В этом примере между 12:00 и 18:00 рейд запрещён. Если интервалы пересекаются, достаточно одного включённого подходящего интервала, чтобы рейд-тайм был включён.

EnableRaidTimeNotifications

Настройка: EnableRaidTimeNotifications

Описание: Включение оповещения игроков о начале и завершении рейд-тайма.

Тип данных: bool

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

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

"EnableRaidTimeNotifications": 1

0: выключить оповещения.

1: включить оповещения.

Отключение оповещений не отключает сам рейд-тайм. Сообщения отправляются при изменении его состояния.

RaidTimeStartNotificationHeader

Настройка: RaidTimeStartNotificationHeader

Описание: Заголовок оповещения о начале рейд-тайма.

Тип данных: string

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

"RaidTimeStartNotificationHeader": "#RZXC_AFR_RAIDTIMESTARTED_HEADER"

Стандартный заголовок: «Начался Рейд-Тайм!».

RaidTimeStartNotificationDescription

Настройка: RaidTimeStartNotificationDescription

Описание: Текст оповещения о начале рейд-тайма.

Тип данных: string

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

"RaidTimeStartNotificationDescription": "#RZXC_AFR_RAIDTIMESTARTED_DESCR"

Стандартный текст: «Урон по постройкам включён.»

RaidTimeStartNotificationImage

Настройка: RaidTimeStartNotificationImage

Описание: Иконка оповещения о начале рейд-тайма.

Тип данных: string

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

"RaidTimeStartNotificationImage": "LuxelRaidSettings/Assets/TimeSquare_Red.edds"

Путь до картинки в формате .edds или .paa. Своя картинка должна находиться в клиентском моде, установленном у игроков.

RaidTimeEndNotificationHeader

Настройка: RaidTimeEndNotificationHeader

Описание: Заголовок оповещения о завершении рейд-тайма.

Тип данных: string

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

"RaidTimeEndNotificationHeader": "#RZXC_AFR_RAIDTIMEEND_HEADER"

Стандартный заголовок: «Рейд-Тайм Окончен!».

RaidTimeEndNotificationDescription

Настройка: RaidTimeEndNotificationDescription

Описание: Текст оповещения о завершении рейд-тайма.

Тип данных: string

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

"RaidTimeEndNotificationDescription": "#RZXC_AFR_RAIDTIMEEND_DESCR"

Стандартный текст: «Урон по постройкам выключен.»

RaidTimeEndNotificationImage

Настройка: RaidTimeEndNotificationImage

Описание: Иконка оповещения о завершении рейд-тайма.

Тип данных: string

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

"RaidTimeEndNotificationImage": "LuxelRaidSettings/Assets/TimeSquare_Green.edds"

RaidTimeNotificationsDuration

Настройка: RaidTimeNotificationsDuration

Описание: Время отображения оповещения о начале или завершении рейд-тайма.

Тип данных: int

По умолчанию: 8 секунд

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

"RaidTimeNotificationsDuration": 8

Значение указывается в секундах. Это длительность оповещения, а не длительность рейд-тайма.