Mob Limiter

Mob Limiter позволяет контролировать популяцию мобов, устанавливая ограничения на количество сущностей в отдельных чанках и во всем мире.

Мод предназначен для предотвращения переполнения ферм и избыточного спавна мобов, которые могут негативно влиять на производительность сервера. Он предоставляет гибкие инструменты для настройки плотности населения в игре.

Основные возможности

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

• Лимиты чанков: ограничение количества мобов в пределах одного чанка для предотвращения скопления сущностей в одной точке.
• Мировые лимиты: установка глобальных порогов для общей популяции мобов в мире.
• Таргетированные ограничения: возможность применять лимиты к конкретным типам мобов, категориям или пространствам имен (namespaces).
• Поддержка модов: корректно работает с мобами, зарегистрированными в Forge.
• Обработка излишков: автоматическое удаление лишних мобов через бесшумный деспаун или уничтожение с выпадением лута и опыта.
• Контроль деспауна: выбор между стандартными правилами ванилы, пользовательскими диапазонами дистанции или полным отключением деспауна (персистентные мобы).
• Система приоритетов: лимиты применяются в порядке приоритетности — сначала к конкретным мобам, затем к категориям, пространствам имен и, наконец, к значениям по умолчанию.
• Оптимизация: асинхронная обработка данных гарантирует плавную работу сервера при обработке ограничений.

Настройка конфигурации

Параметры лимитов и поведения деспауна настраиваются в файле config/moblimiter.json5. В конфигурации можно определить режимы деспауна (vanilla, custom или disabled), а также задать конкретные числовые значения для различных типов сущностей.

{
  // Vanilla despawn settings
  // mode: "vanilla" (default rules), "custom" (set min/max distance), "disabled" (persistent mobs)
  "vanilla_despawn": {
    "mode": "custom",
    "min_distance": 32.0, // Min distance (blocks) to despawn (for "custom" mode)
    "max_distance": 128.0 // Max distance (blocks) to despawn (for "custom" mode)
  },
  
  // World-wide mob limits
  // enabled: true/false to toggle world limits
  // total: Max mobs in the world (-1 for unlimited)
  // removal_type: "despawn" (silent) or "kill" (drops loot)
  "world_limits": {
    "enabled": true,
    "total": 500, // Total mobs allowed in the world
    "removal_type": "despawn",
    "mobs": {
      "minecraft:cow": 100, // Max 100 cows in the world
      "minecraft:pig": 100, // Max 100 pigs in the world
      "minecraft:zombie": 50 // Max 50 zombies in the world
    }
  },
  
  // Per-chunk mob limits
  // enabled: true/false to toggle chunk limits
  // default.limit: Default mob cap per chunk (-1 for unlimited)
  // removal_type: "despawn" (silent) or "kill" (drops loot)
  "chunk_limits": {
    "enabled": true,
    "removal_type": "despawn",
    "default": { "limit": 20 }, // Default limit for unspecified mobs
    "mobs": {
      "minecraft:cow": 10, // Max 10 cows per chunk
      "minecraft:pig": 10, // Max 10 pigs per chunk
      "minecraft:chicken": 10, // Max 10 chickens per chunk
      "minecraft:creatures": 15, // Max 15 creatures (animals) per chunk
      "minecraft:*": 8 // Max 8 of any other Minecraft mob per chunk
    }
  }
}

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

Для начала работы с Mob Limiter выполните следующие действия:

1. Установка: добавьте файл мода в директорию сервера. Мод работает на стороне сервера и не требует обязательной установки клиентами.
2. Конфигурация: после запуска сервера откройте config/moblimiter.json5 и отредактируйте лимиты. Сохраните изменения после редактирования.
3. Применение: используйте команду /moblimiter reload в игре или консоли сервера, чтобы обновить настройки без перезагрузки.
4. Проверка: используйте команду /moblimiter info для просмотра текущих активных настроек, включая режимы деспауна и лимиты.

Как обновить конфиг без перезагрузки?
Используйте команду /moblimiter reload.

Что произойдет с лишними мобами?
Они либо бесшумно исчезнут (despawn), либо погибнут с выпадением лута (kill), в зависимости от настройки в конфиге.