Документация сервера

WorldPulse

Активный

Hytale • Version 0.3.0

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

Обзор мода CurseForge

Обзор

Охотьтесь в одной области каждый день, и её фауна станет редкой. Дайте ей отдохнуть, и популяции восстановятся с помощью подходящих соседних регионов. Здоровые животные могут размножаться, а детёныши постепенно взрослеют.

WorldPulse работает автоматически в одиночных мирах, мирах друзей и на выделенных серверах. Установите мод и играйте. Команды нужны для администрирования и диагностики.

Установка

Требуется Hytale 0.7.0+.
Скачайте WorldPulse-0.3.0.jar на вкладке Files в CurseForge.
Закройте мир или сервер. Замените прежний JAR WorldPulse в UserData/Mods/ или серверной папке mods/, оставив одну копию.
Запустите мир. Для игры команды не нужны. Настройки создаются в mods/durkz_WorldPulse/WorldPulse.json.

Регионы, охота и восстановление

Здоровье популяции является региональным индексом, а не подсчётом всех живых животных. Стандартный регион имеет размер 8 x 8 чанков, или 256 x 256 блоков. Каждый мир хранит независимые популяции видов. Убийство подходящего природного животного игроком уменьшает местный индекс на killImpact, до minHealth. Учитываются прямые удары и снаряды, принадлежащие игроку.

Восстановление использует календарь мира. Базовое значение recoveryDays составляет 4 дня для перехода от 10% до 90%; демография, среда, давление охоты и миграция меняют фактический темп. Подходящие соседние регионы помогают заселению. Существующие животные физически не перемещаются. Сон и пропуск времени могут ускорять восстановление; при остановленном календаре реальное время не старит животных.

Редкость уменьшает цели будущего природного спавна с учётом групп, региональных/глобальных квот и ожидающих спавнов. Существующие животные не уничтожаются. Подходящая природная фауна маркеров и маяков использует лимиты своего источника. Животные из команд, питомцы, монстры, сценарные и фракционные встречи по умолчанию исключены.

Обнаружение фауны и совместимость

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

extraRoles и excludedRoles являются необязательными ручными настройками. /wp inspect <role> показывает реальную причину включения или исключения, ограничения модели и жизненного цикла, пищевые свидетельства и активные штатные квоты. Роль может поддерживать учёт популяции без данных модели, необходимых для размножения. Совместимость не означает поддержку любого пакета ресурсов или любого зарегистрированного NPC.

Совместимость использует зарегистрированные данные без встроенных копий и отдельных патчей пакетов. WildTale 5.2 проверен вместе с WorldPulse, включая подходящую фауну и переходы захвата и приручения. Ошибочные сторонние роли и предметы спавна остаются ответственностью исходного мода. Поиск пищи поддерживает меньше ролей, чем учёт популяций: животное может участвовать в экологии без нового ИИ поиска.

Размножение и взросление

Для размножения нужны подходящие взрослые родители, пригодная среда, здоровье популяции не ниже 60%, давление охоты не выше 50%, соблюдение интервалов родителей и свободные штатные квоты. Стандартные сроки зависят от объёма модели и ограничены 1–4 игровыми днями. Рождение также учитывает свободное место для коллизии и лимиты резервирования.

Штатная юная роль выбирается только при однозначной связи со взрослой. Иначе исходная модель начинает с 60% масштаба. Детёныши получают 50% штатного здоровья и исходящего урона и постепенно растут, сохраняя исходный ИИ. Если взрослая область коллизии не помещается, сохраняется юная стадия до появления места. Идентичность и доля здоровья сохраняются при взрослении.

Жизненный цикл сохраняется с животным. Возврат в выгруженный чанк может продвинуть возраст по работающему календарю мира, но очередь рождений в выгруженных чанках не создаётся. Приручение снимает распознаваемые возрастные эффекты WorldPulse, сохраняя независимые изменения модели и характеристик.

Отменённое или неудачное рождение возвращает зарезервированную суточную квоту и интервалы родителей. Созданный детёныш сохраняет резерв даже при сбое последующей операции. Аварийное завершение с неизвестным результатом спавна сохраняет записанный резерв для защиты от дублирования; восстановление журнала никогда не создаёт животных.

Экологические сообщения

Игроки в затронутом регионе получают сообщения с нужным видом: спад от охоты, редкость, восстановление, давление, мешающее возвращению, завершённое рождение или взросление. Сообщения основаны на реальных изменениях состояния или завершённых событиях. Они не объявляют физическую миграцию.

Общий лимит составляет одно сообщение игроку за 10 секунд, а задержка для вида/события в данном контексте составляет две минуты с исключением для критического спада. Повторные проверки не засоряют чат. Имена используют данные и доступные переводы игры; предложения пока английские. Для отключения задайте enableEcologyMessages: false.

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

Голод и поиск пищи хищниками

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

Хищники используют штатную навигацию и бой. Они ищут пищу на ближайшей загруженной местности и в подходящих соседних областях с ограниченной работой и повторными попытками при заблокированных путях. WorldPulse не определяет расположение кроватей, домов и далёких игроков, не создаёт и не телепортирует хищников ради встреч. Обычная агрессия работает независимо от голода.

Стандартный список содержит 20 штатных ролей. Добавление животного другого мода в foragingRoles не гарантирует совместимость: необходимы поддерживаемый штатный шаблон, движение и пригодные метаданные. Приручённые животные выходят из системы. Голод и жизненный цикл сохраняются с животным; время вне игры не накапливает очередь охот или рождений.

Пищевая сеть

Связь хищника и добычи активируется после убийства трёх разных UUID добычи одной ролью хищника в этом мире. Свидетельства дают только смертельные взаимодействия, приписанные подходящим природным хищникам; страх или враждебность сами по себе не определяют рацион. После установления связи местная доступность добычи может уменьшать будущий спавн хищника с нижним пределом predatorMinFactor.

Это модель повторных смертельных взаимодействий, а не анимаций еды или полного биологического рациона. Неизвестный рацион нейтрален. Свидетельства сохраняются по мирам и видны в /wp inspect <role>.

Возможности

Региональные популяции: у каждого вида свой показатель здоровья в каждом регионе, по умолчанию 8 x 8 чанков. Охота игроков уменьшает последующий природный спавн этого вида.
Восстановление и давление охоты: популяции восстанавливаются за игровые дни. Среда обитания и давление влияют на темп, а здоровые соседи помогают повторному заселению.
Физическое размножение: подходящие природные животные могут давать потомство, если позволяют родители, здоровье популяции, среда обитания и штатные лимиты спавна.
Взросление детёнышей: они начинают меньше и слабее и постепенно растут. Штатная юная роль используется при надёжной связи со взрослой, иначе уменьшается исходная модель.
Сообщения о каждом затронутом виде: игроки в регионе получают сообщения о спаде, редкости, восстановлении, давлении охоты, реальных рождениях и взрослении с ограничением частоты.
Фауна игры и других модов: зарегистрированные метаданные ролей дают классификацию, модели и имена. Игроку не нужно настраивать или вручную регистрировать животных каждого мода.
Изучаемые связи хищников и добычи: повторные убийства хищником устанавливают связь с добычей. Её нехватка может уменьшать будущий спавн хищника; неизвестный рацион остаётся нейтральным.
Сохранение состояния: популяции, давление, интервалы размножения, состояние детёнышей и изученные пищевые связи переживают сохранения и перезапуски.
Голодные хищники: 20 настроенных штатных ролей могут искать пищу на ближайшей загруженной местности с помощью штатной навигации. Нехватка добычи ускоряет голод; обычная агрессия действует независимо.
Фауна маркеров и маяков: подходящие природные животные из этих источников участвуют в экологии и размножении в пределах собственных штатных лимитов. Исключения для питомцев, монстров и сценарных встреч сохраняются.

Команды

Команда администратора: /wp. Обычные игроки получают экологические сообщения без права на команды.

Команда	Описание
`/wp here`	Показать здоровье популяций фауны в текущем регионе.
`/wp set <species> <percent>`	Задать местное здоровье популяции от 0 до 100 для зарегистрированной роли спавна.
`/wp tick <days>`	Продвинуть восстановление популяций этого мира на указанное число игровых дней; это не полный пропуск времени мира.
`/wp reset`	Очистить региональные популяции, среду, давление и резервирования/интервалы размножения мира. Отдельный пищевой файл не удаляется.
`/wp stats`	Показать счётчики охоты, спавна, каталога и доступных возможностей.
`/wp inspect <role>`	Пояснить допуск, поддержку модели/жизненного цикла, свидетельства о добыче и активные штатные квоты.

Права доступа

durkz.worldpulse.command.wp: команды /wp и уведомления об обновлениях. У операторов есть по умолчанию.

Настройки

Файл: mods/durkz_WorldPulse/WorldPulse.json. Ниже указаны значения для новой конфигурации. Существующие корректные настройки сохраняются, поэтому старый мир может оставить прежнее восстановление. После редактирования нужен перезапуск. configVersion управляется модом.

Поле	По умолчанию	Описание
`configVersion`	`3`	Внутренний формат настроек.
`enabled`	`true`	Включить WorldPulse.
`regionSizeChunks`	`8`	Сторона региона в чанках, от 1 до 64.
`killImpact`	`0.1`	Потеря здоровья популяции за убийство игроком.
`killImpactByRole`	`{}`	Необязательные изменения воздействия для ролей.
`minHealth`	`0.02`	Минимальное здоровье популяции.
`recoveryDays`	`4.0`	Базовые игровые дни от 10% до 90%, с поправками экологии.
`enableDemography`	`true`	Применять демографические поправки восстановления.
`enableHuntingPressure`	`true`	Учитывать и применять давление охоты.
`enableBreeding`	`true`	Разрешить рождение и рост подходящей фауны.
`enableEcologyMessages`	`true`	Отправлять автоматические сообщения о видах в чат.
`autoDetectWildlife`	`true`	Обнаруживать фауну по разрешённым штатным категориям.
`enableMigration`	`true`	Разрешить статистическое региональное заселение.
`enableHabitat`	`true`	Учитывать наблюдаемую пригодность среды.
`enableFoodWeb`	`true`	Применять доступность изученных пищевых связей.
`migrationPerDay`	`0.04`	Максимальный прирост от миграции за игровой день.
`predatorMinFactor`	`0.4`	Минимальный множитель спавна хищников от доступности пищи.
`faunaFolders`	`["Creature", "Aquatic", "Avian"]`	Папки, принимаемые за фауну.
`excludedFolders`	`["Creature/Mythic", "Creature/Hunt"]`	Исключённые подпапки фауны.
`excludedRoles`	`[]`	Необязательные исключения ролей.
`extraRoles`	`[]`	Необязательные явные включения ролей.
`checkForUpdates`	`true`	Проверять сайт и уведомлять об обновлениях игроков с доступом к командам.
`debugLog`	`false`	Подробные решения спавна для диагностики.
`enableForaging`	`true`	Включить поиск пищи подходящими хищниками из настроенного списка.
`foragingRoles`	`20 штатных ролей`	Явный список ролей; стандартный список приведён ниже.
`forageHungerMinutes`	`40.0`	Реальные загруженные минуты от сытости до полного голода при обычной добыче.
`forageStartHunger`	`0.5`	Доля голода для начала поиска.
`forageStepBlocks`	`24`	Длина шага поиска в блоках.
`maxForagers`	`8`	Максимум одновременных поисков на мир; 0 отключает поиск.

Стандартные роли для поиска пищи

["Wolf_Black", "Wolf_White", "Fox", "Hyena", "Bear_Grizzly", "Bear_Polar", "Leopard_Snow", "Tiger_Sabertooth", "Raptor_Cave", "Crocodile", "Rex_Cave", "Toad_Rhino", "Toad_Rhino_Magma", "Snake_Cobra", "Snake_Marsh", "Snake_Rattle", "Spider", "Molerat", "Spider_Cave", "Spider_Cave_Ambush"]

Файлы данных и восстановление

Путь	Назначение
`populations.json`	Популяции, среда, давление и учёт размножения.
`populations.journal`	Подтверждённые последовательные обновления популяций.
`food-relations.json`	Контрольная точка изученных пищевых свидетельств.
`food-relations.json.journal`	Подтверждённые последовательные пищевые свидетельства.

Файлы находятся в <world save>/WorldPulse/. Компоненты жизненного цикла детёнышей хранятся вместе со штатными сущностями. Сохраняйте сущности и файлы WorldPulse вместе в резервных копиях.

Контрольные точки заменяются атомарно, журналы воспроизводят подтверждённые записи. Незавершённая последняя строка игнорируется. Повреждённые подтверждённые записи и неподдерживаемые будущие форматы сохраняют оригиналы и приостанавливают затронутую возможность вместо тихого сброса. Ошибка пищевых данных изолирована от сохранения популяций. Логи и /wp inspect показывают пищевые ошибки. Авария до подтверждения асинхронной записи всё ещё может потерять ожидающее наблюдение.

При ошибке сохранения остановите сервер и скопируйте файлы перед восстановлением исправной копии. Не удаляйте данные при обычном обновлении.

Проверка работы

Найдите WorldPulse и enabled=true в журнале запуска; для обычной игры команды не нужны.
Проверьте каталог через /wp stats, затем выполните /wp inspect <role> для реальной роли игры или установленного пакета.
Поохотьтесь на подходящую природную фауну и проверьте местный спад через /wp here. Вручную созданные животные не заменяют эту проверку.
Дайте миру работать несколько игровых дней. Наблюдайте восстановление, а при подходящих условиях рождение и рост. У сообщений есть задержки.
Сохраните, закройте и перезапустите мир. Проверьте истощённый регион и детёнышей, чтобы убедиться в сохранении состояния.

Состояние и известные ограничения

Активный проект. Автоматическое обнаружение требует пригодных метаданных и корректных моделей. Ошибочные сторонние ресурсы могут исключать отдельные роли. Региональная миграция меняет показатель популяции; совместимые голодные хищники отдельно перемещаются по загруженной местности со штатной навигацией. Поиск зависит от местности, добычи и штатного поведения и не гарантирует встречу. Существующие животные не уничтожаются. Текст экологических сообщений пока на английском; названия видов используют доступные переводы игры с читаемым запасным вариантом.