Balloons

Этот компактный серверный мод для Fabric позволяет прикреплять к игрокам персонализированные модели воздушных шариков с помощью простых команд.

⚠️ Важное замечание: мод не включает готовые модели шариков — вам нужно добавить их самостоятельно!

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

Мод позволяет настраивать воздушные шарики через конфигурационный файл. Шарики могут быть постоянными (сохраняются после смерти игрока, не требуют экипировки) или привязаны к предметам с компонентом minecraft:equippable, а также работать с trinkets.

Вы можете добавить компонент balloons:balloon к любому предмету: /give @s minecraft:diamond_chestplate[balloons:balloon={"model":"flower_balloon","animation":"idle"] /give @s minecraft:diamond_chestplate[balloons:balloon={"model":"balloon_no_leash","animation":"idle","show_leash":false]

Каждый шарик с уникальным идентификатором определяется в конфигурационных файлах (подробнее ниже).

Каждый воздушный шарик связан с конкретным предметом, файлом модели и опциональной анимацией.

Клиентский мод не требуется — модели обрабатываются через файлы .bbmodel или .ajblueprint и отображаются с помощью item displays и автоматически созданного ресурспака.

Настройка

🪄 Добавление моделей шариков

Разместите файлы моделей в папке:

config/balloons/<model>.bbmodel

• Имя файла модели (без расширения) становится внутренним идентификатором модели, используемым в конфигурации.
• Поддерживаются форматы .bbmodel (Blockbench) и .ajblueprint (Animated Java).

⚙️ Конфигурационный файл

Мод считывает определения шариков из файла:

config/balloons.json

Вот минимальный пример конфигурации:

{
  "mongo_db": {
    "enabled": true,
    "host": "127.0.0.1",
    "port": 27017,
    "collection": "balloons",
    "username": "",
    "password": "",
    "database": "game",
    "authSource": "admin",
    "useSSL": false
  },
  "balloons": [
    {
      "id": "test:one",
      "item": {
        "count": 1,
        "id": "minecraft:cobblestone"
      },
      "data": {
        "model": "flower_balloon",
        "animation": "idle"
      }
    },
    {
      "id": "test:two",
      "item": {
        "count": 1,
        "id": "minecraft:stone"
      },
      "data": {
        "model": "frog_balloon",
        "animation": "idle"
      }
    }
  ]
}

Каждая запись о шарике включает:

• id: Внутренний идентификатор шарика
• item (опционально): Предмет, представляющий шарик
• data.model: Имя файла модели (без пути и расширения), например "mynamespace:balloon_model"
• data.animation (опционально): Название используемой анимации. По умолчанию "idle"
• data.show_leash (опционально): Показывать ли поводок. По умолчанию true
• data.tilt (опционально): Наклоняется ли шарик при следовании за сущностью. По умолчанию true
• data.rotate (опционально): Вращается ли шарик. По умолчанию true
• data.follow_speed (опционально): Скорость следования шарика за целью. По умолчанию 0.25
• data.drag (опционально): Коэффициент сопротивления, замедляющий движение шарика при остановке сущности. По умолчанию 0.2
• data.bob_frequency (опционально): Частота покачивания. По умолчанию 0.2
• data.bob_amplitude (опционально): Амплитуда (высота) покачивания. По умолчанию 0.2
• data.offset (опционально): Смещение позиции относительно прикрепленной сущности

🔧 MongoDB (опционально)

Если вы хотите, чтобы активный шарик игрока сохранялся на нескольких серверах (например, в сети), вы можете включить MongoDB в конфигурации.

Если параметр "enabled" установлен в true, мод будет синхронизировать состояние шариков игроков с использованием настроенной базы данных.
Если поля "username" и "password" пусты, соединение будет установлено без аутентификации.

Команды

Мод добавляет простые команды для постоянного прикрепления шариков к игрокам и их удаления:

/balloon show <id>
/balloon hide

Пример использования:

/balloon show test:one

Эта команда прикрепит шарик с идентификатором test:one (из вашей конфигурации) к игроку. Шарик будет автоматически восстанавливаться после возрождения игрока.

Хранение данных

• По умолчанию состояние шариков сохраняется в данных игрока в Оверворлде.
• Если включен MongoDB, мод использует его вместо локального хранения — это удобно для синхронизации между несколькими серверами.

Поддержка filament

Предметы на основе Filament с компонентом balloons:balloon автоматически добавляются как опции для команды /balloon show <id>, используя идентификаторы предметов. Мод также попытается загрузить модели Blockbench из датапаков filament, если он установлен и модель загружена. В этом случае обязательно укажите пространство имен!

Важные заметки

• Это исключительно серверный мод — он не добавляет предметы, рецепты или модели напрямую.
• Вам нужно предоставить собственные модели.
• Полезен для кастомизированных серверов, косметических элементов или просто для развлечения.