Группы спавна

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

Что дают группы

Переиспользование: одна группа (@zombies) подключается в десятках точек; правите её в одном месте - меняется везде.
Условный состав: две группы @dayAnimals и @nightAnimals в одном spawnList точки - днём спавнятся одни существа, ночью другие.
Погодные существа: волки в туман, особые зомби в грозу.
Редкие появления: группа с chance: 0.15 попадает в спавн не каждый цикл (редкий патруль/босс).

Как это работает

Точка по-прежнему сама триггерит спавн (вход игрока, cooldown, triggerWorkingTime). Группа не спавнит сама - она лишь определяет состав пула класснеймов, из которого точка выбирает случайный элемент при каждом срабатывании.

В момент спавна точка строит «эффективный пул»: разворачивает все @group-ссылки из своего spawnList с учётом условий группы и смешивает их с обычными класснеймами. Обычные точки (без @) ведут себя ровно как раньше - эффективный пул идентичен spawnList.

Ссылка на группу в spawnList точки

На группу ссылаются из spawnList точки префиксом @:

"spawnList": [
  "Animal_UrsusArctos",
  "@dayAnimals",
  "@nightAnimals"
]

В этом примере эффективный пул = медведь + элементы группы @dayAnimals (если её условия пройдены) + элементы группы @nightAnimals (если её условия пройдены). Из получившегося пула точка выбирает случайный элемент, как и для обычного spawnList.

Префикс @

Префикс @ выбран потому, что ни один classname DayZ не начинается с этого символа - коллизий нет. Не ставьте пробелы вокруг @: @dayAnimals - правильно, @ dayAnimals - нет (мод почистит пробелы, но лучше писать сразу чисто).

Файлы групп

Группы хранятся в папке $profile:MPG_Spawner/Groups/. Каждый файл - массив групп (как точки в Points/):

$profile:MPG_Spawner/
├── Config.json
├── Points/
│   └── ...точки...
└── Groups/                  ← папка групп спавна
    ├── Animals.json
    ├── Weather.json
    └── ...

Автоскан папки

Папка Groups/ сканируется целиком при запуске сервера - все *.json грузятся автоматически. Список файлов в Config.json (как pointsConfigs для точек) не нужен: просто положите .json-файл в папку, и мод его подхватит.

Группа с дублирующимся groupName (в том же или другом файле) - ошибка: в лог пишется ERROR, загружается первая встретившаяся группа с этим именем, дубликат пропускается. Имена чувствительны к регистру.

Поля группы

json

{
  "groupName": "dayAnimals",
  "isDisabled": false,
  "spawnTime": "6-18",
  "chance": 1.0,
  "weather": ["clear", "cloudy"],
  "spawnList": ["Animal_UrsusArctos", "Animal_CanisLupus_Grey|0.5"]
}

groupName

groupName - уникальное имя группы. По нему на группу ссылаются из spawnList точки (@groupName). Не должно повторяться (дубликат → ERROR в лог).

Пример: "groupName": "dayAnimals",

isDisabled

isDisabled - отключить группу. Отключённая группа не разворачивается в пул ни в одной точке, но остаётся в файлах (удобно временно выключить набор существ, не удаляя конфиг).

Значение по умолчанию: 0 (включена). Старые конфиги без поля работают как раньше.

Пример: "isDisabled": 1,

spawnTime

spawnTime - окно игрового времени, в которое группа попадает в пул. Формат идентичен timing.workingTime точки:

всегда (значение по умолчанию): "0-24"
днём (с 6 до 18):               "6-18"
ночью (с 18 до 6):              "18-6"   ← перенос через полночь

Поддерживается перенос через полночь ("18-6" = с 18:00 до 06:00). Значение по умолчанию "0-24" - группа доступна круглосуточно.

Это игровое время

spawnTime - это игровое время (как triggerWorkingTime), а не реальное. Учитывайте настройки скорости течения игрового времени на вашем сервере.

chance

chance - групповой шанс доступа, число от 0 до 1. Бросается один раз за цикл спавна для группы: прошла → все её элементы попадают в пул; не прошла → группы в пуле нет.

Значение по умолчанию: 1.0 (всегда доступна).

Слой доступа, а не множитель

chance группы и chance отдельных элементов внутри её spawnList - разные слои:

chance группы отвечает за доступ (будет ли группа в пуле вообще);
chance элемента (через |, см. spawn.list) отвечает за выбор (выпадет ли именно этот элемент из пула).

Они не перемножаются. Пример: группа с chance: 0.15 и одним элементом Animal_UrsusArctos → в ~85% циклов спавна медведя в пуле не будет вовсе, в ~15% - он в пуле (с элементным chance 1.0, т.е. точно выпадет при выборе).

Как полностью отключить группу

Чтобы группа никогда не попадала в пул, используйте isDisabled: 1. chance: 0 тоже сработает как «никогда», но isDisabled - каноничный способ (и chance <= 0 трактуется как «поле не задано → 1.0»).

weather

weather - массив типов погоды (логика ИЛИ), при которых группа попадает в пул. Пусто/отсутствует → группа доступна при любой погоде.

Допустимые значения:

Тип	Условие (фиксированные пороги)
`clear`	облачность < 40%
`cloudy`	облачность ≥ 40% и нет дождя/снега/тумана
`rain`	сила дождя ≥ 30%
`fog`	сила тумана ≥ 40%
`snow`	сила снегопада ≥ 30%
`storm`	сила дождя ≥ 30% и скорость ветра ≥ 10 м/с

Как это читается

["fog", "storm"] = группа в пуле, если сейчас туман ИЛИ гроза. ["rain"] = только в дождь. Пороги фиксированы и подобраны так, чтобы погода была визуально выражена - их нельзя менять из конфига намеренно (проще диагностировать). Невалидный тип (напр. "tornado") → WARN в лог, поле игнорируется, группа проверяется по остальным типам.

Пример:

доступна в дождь или грозу:
"weather": ["rain", "storm"],

доступна при любой погоде:
"weather": [],

spawnOnce

spawnOnce - группа появляется один раз за сессию. После того как её контент реально заспавнился, группа больше не разворачивается в пул до рестарта сервера или перезагрузки конфига.

Значение по умолчанию: 0 (группа доступна каждый цикл спавна). Старые конфиги без поля работают как раньше.

Флаг ставится по факту реального спавна

Группа считается «заспавнившейся» только когда из неё создан объект, а не когда она попала в пул. Это значит:

Если группа в пуле, но её элемент не выпал в выборке (точка выбрала другой элемент) - попытка не потрачена: при следующем цикле группа снова в пуле.
Комбо с chance группы ниже 1: пока chance не пропустит группу в пул, флаг не ставится.

Флаг НЕ снимается после смерти

spawnOnce означает «один раз за сессию», а не «один раз живой». Когда все объекты группы умрут, флаг не снимается - группа остаётся «израсходованной» до рестарта сервера или config-reload. Если нужно повторное появление после смерти - не используйте spawnOnce.

Сброс происходит при: рестарте сервера (in-memory состояние живёт только в RAM) и перезагрузке конфигурации (ResetTriggers).

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

json

{
  "groupName": "alphaWolf",
  "isDisabled": false,
  "spawnTime": "18-6",
  "chance": 0.3,
  "weather": ["fog", "storm"],
  "spawnOnce": true,
  "notificationTextSpawn": "⚠️ Появился Альфа-волк!",
  "spawnList": ["Animal_CanisLupus_Grey"]
}

notificationTextSpawn

notificationTextSpawn - собственная нотификация группы при реальном спавне её контента. Формат идентичен notifications.textSpawn точки: %1 = количество, %2..%5 = склонения через ; (см. GetDeclensionText).

Значение по умолчанию: "" (групповой нотификации нет).

Дополнительно к точечной

Групповая нотификация срабатывает в дополнение к точечной (если точечная задана). Игрок может получить обе за один цикл спавна: общую точечную и тематическую групповую. Они независимы - если у точки notificationTextSpawn пуст, групповая всё равно сработает.

%1 - это счётчик группы, а не общий

%1 в групповой нотификации = количество объектов именно этой группы, заспавненных в текущем цикле (а не общий queuedCount точки). Это чтобы «Появился 1 Альфа» было корректнее «Появилось 5 Альфа». Заголовок, иконка и время нотификации берутся из настроек точки - у группы их нет.

Пример:

группа-«волна» с тематическим текстом и склонением:
"notificationTextSpawn": "Накатило %1 %2.;заражённ|ый|ых|ых;"

→ при спавне 3 объектов группы: «Накатило 3 заражённых»
→ при спавне 1 объекта группы:  «Накатило 1 заражённый»

spawnList

Вложенные группы

В spawnList группы можно ссылаться на другие группы через @ - они развернутся рекурсивно. Циклы (@a→@b→@a) детектируются и пресекаются (в лог пишется WARN, повторное вхождение пропускается).

isAiBandits

isAiBandits - группа ботов из стороннего мода AI_Bandits. При true группа не разворачивается в пул выбора класснеймов - вместо этого триггер запрашивает спавн целой группы AI_Bandits по имени (через bridge-мод MPG_Spawner_AIBandits).

groupName такой группы должно совпадать с GroupLocations[].name в DynamicAIB.json. Состав ботов (лут, одежду, оружие) настраивают в DynamicAIB.json, а не в spawnList этой группы - spawnList у isAiBandits-группы игнорируется (мод напишет WARN, если он задан).

Условия (spawnTime/weather/chance/isDisabled/spawnOnce) применяются к бандитской группе как к обычной. Несколько бандитских групп в одной точке спавнятся независимо: все прошедшие условия группы заспавнятся целиком в одном цикле.

Значение по умолчанию: 0 (обычная группа спавна). Подробности - в AI_Bandits интеграция.

Пример группы бандитов:

json

{
  "groupName": "nightBandits",
  "isAiBandits": true,
  "isDisabled": false,
  "spawnTime": "18-6",
  "chance": 0.8,
  "weather": [],
  "spawnList": []
}

spawnCountLimit уважается

Повторный спавн бандитской группы блокируется, пока живы боты точки (spawnCountLimit). spawnMin/spawnMax для ботов игнорируются - группа спавнится целиком, кол-во берётся из DynamicAIB.json.

Полный пример

Groups/Animals.json

json

[
  {
    "groupName": "dayAnimals",
    "isDisabled": false,
    "spawnTime": "6-18",
    "chance": 1.0,
    "weather": ["clear", "cloudy"],
    "spawnList": ["Animal_UrsusArctos", "Animal_CanisLupus_Grey|0.5"]
  },
  {
    "groupName": "nightPredators",
    "isDisabled": false,
    "spawnTime": "18-6",
    "chance": 0.8,
    "weather": ["fog", "storm"],
    "spawnList": ["Animal_CanisLupus_Grey", "Animal_UrsusArctos|0.3"]
  }
]

Использование в точке (Points/MyPoint.json)

json

{
  "pointId": 100,
  "shape": {
    "position": "4246.0 0.0 5586.7",
    "radius": "40.0"
  },
  "spawn": {
    "positions": ["4246.0 0.0 5586.7"],
    "min": 2,
    "max": 5,
    "list": [
      "Animal_UrsusArctos",
      "@dayAnimals",
      "@nightPredators"
    ]
  }
}

Что делает эта точка:

Днём (@dayAnimals → spawnTime 6-18) + в ясную/облачную погоду → в пуле медведи и волки (50%).
Ночью (@nightPredators → spawnTime 18-6) + в туман/грозу → в пуле ночные хищники, и сама группа появляется лишь в 80% циклов спавна (chance 0.8).
Медведь Animal_UrsusArctos из прямого spawn.list точки - в пуле всегда, независимо от групп.
Из итогового пула точка выбирает случайный элемент, как обычно.

Крайние случаи

Несуществующая группа (@ghost, а такой группы нет ни в одном файле Groups/) → ERROR в лог при старте и в рантайме; элемент выбрасывается из пула; точка продолжает работу.
Отключённая группа (isDisabled: 1) → молча пропускается (как выключенный триггер).
Все группы отфильтрованы условиями (не то время/погода/chance), а прямых класснеймов в spawnList нет → эффективный пул пуст → спавна нет (без ошибок, легальное «сейчас нечего спавнить»).
Цикл групп (@a→@b→@a) → WARN в лог, второе вхождение пропускается, бесконечной рекурсии нет.
spawnOnce-группа в пуле, но элемент не выпал в выборке → объект не создан → флаг не поставлен → попытка не потрачена, при следующем цикле группа снова в пуле.
Все объекты spawnOnce-группы умерли → флаг не снимается до рестарта/config-reload. Группа остаётся «израсходованной». См. spawnOnce.
Несколько групп с notificationTextSpawn в одном цикле → по одной нотификации на каждую группу (дополнительно к точечной). Порядок не гарантирован (флейвор-нотификации).
Вложенные группы и нотификация/spawnOnce → относятся к группе, указанной в точке (@boss), а не к вложенной (@minions внутри boss). Origin = ближайшая группа по ссылке точки.

Группы спавна ​

Как это работает ​

Ссылка на группу в spawnList точки ​

Файлы групп ​

Поля группы ​

groupName ​

isDisabled ​

spawnTime ​

chance ​

weather ​

spawnOnce ​

notificationTextSpawn ​

spawnList ​

isAiBandits ​

Полный пример ​

Groups/Animals.json ​

Использование в точке (Points/MyPoint.json) ​

Крайние случаи ​

Группы спавна

Как это работает

Ссылка на группу в spawnList точки

Файлы групп

Поля группы

groupName

isDisabled

spawnTime

chance

weather

spawnOnce

notificationTextSpawn

spawnList

isAiBandits

Полный пример

Groups/Animals.json

Использование в точке (Points/MyPoint.json)

Крайние случаи