Живые метки
Живая метка появляется у объекта мира по его класснейму. Например, можно отметить все машины определённого класса, закопанные ящики или заражённые зоны. Вы задаёте одно правило оформления, а карта создаёт отдельную метку для каждого подходящего объекта и обновляет её положение.
При удалении объекта его метка исчезает. Само правило остаётся: при появлении нового подходящего объекта карта снова создаст метку. Устанавливать отдельную интеграцию для такого правила не нужно.
Как создать или изменить правило
Откройте серверные настройки карты
Включите режим администратора, откройте настройки и найдите вкладку «ЖИВЫЕ МЕТКИ» под разделителем «СЕРВЕРНЫЕ НАСТРОЙКИ». В режиме игрока этой вкладки нет.
Укажите объект
Нажмите «СОЗДАТЬ ЖИВУЮ МЕТКУ» и заполните «Classname объекта мира». Оформление, зона и анимации задаются в том же редакторе, что и у обычной метки.
Настройте условия показа
Выберите, нужно ли показывать предмет в инвентаре, уничтоженный или закопанный объект. Во вкладке «СЕРВЕРНЫЕ НАСТРОЙКИ» разрешите показ игрокам, на карте или в мире; при необходимости ограничьте радиус видимости.
Сохраните
Дождитесь ответа сервера. Сохранение и удаление применяются сразу, отдельно от кнопок основного окна настроек. Последующая отмена в основном окне не откатит уже сохранённое правило.
Для изменения нажмите «РЕДАКТИРОВАТЬ» у нужного класснейма. Также можно нажать ПКМ по его живой метке на карте и открыть редактор оттуда. Вы меняете правило для всех подходящих объектов, а не только для выбранного экземпляра. Удаление правила убирает его метки, но не удаляет сами предметы или постройки.
Класснеймы и наследование
Можно указать как конкретный класс, так и родительский. Например, правило CarScript охватывает транспорт на его основе, включая модовые дочерние классы. Если для конкретной машины есть собственное правило, применяется оно. Если подходят несколько родительских правил, используется ближайший родитель по наследованию. Несколько меток от этих правил на одном объекте не создаются.
Для одного класснейма допускается только одно правило, без учёта регистра букв. Если такой класс уже настроен, новое правило с тем же именем сохранить не получится. Это относится и к файлам в разных подпапках.
Настройки во вкладке «ОСНОВНОЕ»
| Настройка | По умолчанию | Что делает |
|---|---|---|
| Использовать имя объекта | ВКЛ. | Берёт название самого объекта и его перевод. У дочерних классов будут собственные названия. Поле «Название метки» скрывается. Выключите, чтобы задать общую подпись вручную. |
| Отображать, если находится в инвентаре | ВЫКЛ. | Разрешает показывать предмет внутри инвентаря. Положение берётся у самого верхнего владельца, например у персонажа, который несёт рюкзак с этим предметом. |
| Отображать, если объект уничтожен, но ещё не удалился | ВЫКЛ. | Оставляет метку у мёртвого или разрушенного объекта, пока он существует в мире. После удаления объекта метка всё равно исчезнет. |
| Показывать только пока закопано | ВЫКЛ. | Показывает объект только в ванильном закопанном тайнике. Положение берётся у тайника. Для этого не требуется включать показ в инвентаре. После раскапывания метка скрывается. |
Условия работают совместно. Например, включённый показ только закопанных предметов не отменяет запрет на показ разрушенного предмета. Модовая система тайников без ванильного закапывания не обязательно поддерживает это условие.
Зона объекта
Во вкладке «ЗОНА» есть переключатель «Синхронизовать зону объекта». По умолчанию он выключен. Включите саму зону и этот переключатель, чтобы брать её радиус у объекта. Поля вида зоны, радиуса, ширины и высоты скроются; цвет, обводка и остальные параметры оформления останутся доступны.
Поддерживаются области на основе EffectArea, в том числе ContaminatedArea_Static и ContaminatedArea_Dynamic. Они отображаются кругом, радиус проверяется раз в секунду. Если объект не предоставляет подходящий радиус, зона не рисуется. Размер модели здания или транспорта автоматически в радиус не преобразуется. Для таких объектов выключите синхронизацию и задайте размеры вручную.
Например, для заражённых областей создайте правило ContaminatedArea_Static, включите зону и синхронизацию, выберите цвет заливки и обводки. Для динамических областей создайте отдельное правило ContaminatedArea_Dynamic либо используйте их подходящий общий родительский класс.
Случайное смещение внутри зоны
Во вкладке «ЗОНА» включите «Случайно смещать метку в пределах зоны объекта». По умолчанию настройка выключена. Она смещает метку вместе с центром её зоны, чтобы показать область поиска, а не точное положение предмета. Сам объект при этом никуда не перемещается.
Для смещения нужна включённая зона. Используются её заданные размеры: радиус круга либо ширина и высота прямоугольника. Если включена «Синхронизовать зону объекта», используется радиус самого объекта. Случайный центр выбирается так, чтобы объект оставался внутри показанной области.
Центр не меняется при каждом обновлении положения. Пока объект находится внутри этой зоны, метка остаётся на месте. Когда он выходит за её пределы, выбирается новый случайный центр. Если изменить размеры зоны и объект окажется снаружи, центр также будет выбран заново. После рестарта или повторного создания объекта положение может отличаться: случайный центр не сохраняется в файле правила.
Смещение сочетается с показом в инвентаре, после уничтожения и только в закопанном состоянии. Сначала проверяются эти условия и определяется положение предмета, его владельца или тайника, затем применяется смещение. При приближении игрока метка не возвращается к точному положению объекта. Навигатор тоже ведёт к смещённой метке, а не к скрытому предмету.
Пример: область поиска закопанного ящика
Выберите предмет
Создайте правило для
WoodenCrateи включите «Показывать только пока закопано». Если нужна общая подпись «Тайник», выключите «Использовать имя объекта» и задайте её вручную.Задайте область поиска
Включите зону, выберите круг и укажите радиус, например 50 м. «Синхронизовать зону объекта» оставьте выключенной: у ящика нет собственного радиуса игровой области.
Включите смещение и сохраните
Включите «Случайно смещать метку в пределах зоны объекта» и разрешите показ игрокам на карте. Можно скрыть иконку и информацию, оставив только область поиска. После сохранения проверьте результат с выключенным админ-режимом.
У существующих правил без этой настройки смещение остаётся выключенным. Пересоздавать их или сбрасывать базу после обновления не нужно.
Видимость и движение
Правила показа игрокам, на карте, в мире и в заданном радиусе работают как у серверных меток. Требование GPS тоже применяется. Чтобы оставить только обозначение территории, можно отключить иконку и информацию, сохранив зону.
Без случайного смещения метки движутся вместе с объектами. Если объект уже синхронизирован игрой на клиенте, карта использует его локальное положение; для удалённого объекта используются обновления с сервера. Указывать координаты вручную или создавать правило заново после перемещения не нужно.
У живых меток нет ручного ID и настройки удаления после рестарта: экземплярами управляет само правило. Их нельзя перетаскивать для смены порядка в боковой панели.
Где сохраняются правила
profiles/RZXC/LuxelWorldMap/LiveMarkers/<Classname>.json
Каждое правило сохраняется отдельным JSON-файлом. Папка читается рекурсивно. Новое правило создаётся в корне; если существующий файл лежит в подпапке, редактор сохраняет изменения там же. При изменении класснейма имя файла тоже меняется.
Рекомендую редактировать правила в карте. Для ручного переноса или изменения файлов остановите сервер, сохраните копию папки и запустите сервер после правок. ServerMarkersSyncInterval относится к обычным серверным меткам, а не к перечитыванию правил живых меток. При дубликатах класснейма в разных файлах устраните конфликт; пути проблемных файлов выводятся в серверный лог.
Если другой администратор успел изменить правила, пока Ваш редактор был открыт, карта может отклонить сохранение. Обновите список и откройте правило заново, чтобы не перезаписать чужие изменения.