Перейти к содержимому

Balloons

Серверный мод/библиотека, позволяющая добавлять шары на ваш сервер!

Fabric
Загрузчики
Fabric
Скачиваний на Modrinth
807
Подписчиков на Modrinth
2
версий
6
Обновлён
1 октября 20261 окт.
Опубликован
в 2025

Коротко о моде

Работает на Fabric
Для Minecraft 1.21.11, 26.3 …
Ставится только на сервер; игрокам ставить не нужно
Последняя версия — 2.1.1+26.3 от 1 октября 2026
Нужен Polymer и DB-Bundle
Лицензия AGPL-3.0-or-later — бесплатно
Где нужен
В игрене нуженНа сервереобязателен

Ставится только на сервер; игрокам ставить не нужно

Версии игры1.21.5–1.21.8, 1.21.11, 26.3
Описание переведено автоматическиПоказать оригинал (EN)

Balloons

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

⚠️ Этот мод не включает никаких моделей шариков — вам нужно добавить свои!

patreon


Что он делает

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

Вы можете добавить компонент balloons:balloon к любому предмету.

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

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


Настройка

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

Поместите файлы моделей в:

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

Конфиг-файл

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

config/balloons.json

Параметры хранилища:

  • storage-type: может быть LPMETA, MONGODB, MARIADB, POSTGRESQL или SQLITE
  • database: задаёт параметры подключения к базам данных

** gui: **

  • Настройка позиций кнопок через конфиг
  • Настройка высоты и заголовков меню

** permissions: **

Позволяет назначить ванильные уровни прав для нод luckperms.

** messages: **

Сообщения / строки, отображаемые игроку

Вот минимальный пример:

{
  "permissions": {
    "balloons.reload": 2,
    "balloons.list": 2,
    "balloons.command": 2,
    "balloons.direct": 2,
    "balloons.give": 2,
    "balloons.remove": 2
  },
  "messages": {
    "player-not-found": "Player not found",
    "back": "Back",
    "browse": "Browse All",
    "prev": "Previous Page",
    "next": "Next Page",
    "confirm": "Confirm",
    "cancel": "Cancel",
    "component-tooltip": "Balloon: %s",
    "already-owning": "<green>You own this balloon</green>",
    "added": "%s was added to your balloons!",
    "equip-tooltip": "<green>🎈</green> Press <keybind:key.attack> to equip",
    "unequip-tooltip": "<color:#800080>↔</color> Press <keybind:key.use> to unequip",
    "get-item-tooltip": "<color:#802080>↔</color> Press <keybind:key.use> to get item"
  },
  "gui": {
    "add-back-button": true,
    "back-button-item": "minecraft:arrow",
    "back-button-location": [
      1,
      1
    ],
    "selection-menu-height": 6,
    "selection-menu-title": "Select Balloon",
    "prev-button-item": "minecraft:arrow",
    "next-button-item": "minecraft:arrow",
    "prev-button-location": [
      8,
      6
    ],
    "next-button-location": [
      9,
      6
    ],
    "browse-menu-height": 6,
    "browse-menu-title": "Browse Balloons",
    "confirmation-menu-height": 1,
    "confirmation-menu-title": "Confirm",
    "add-browse-button": true,
    "browse-button-item": "minecraft:chest",
    "browse-button-location": [
      1,
      6
    ],
    "confirm-button-item": "minecraft:emerald",
    "confirm-button-location": [
      7,
      1
    ],
    "cancel-button-location": [
      3,
      1
    ]
  },
  "storage-type": "SQLITE",
  "database": {
    "host": "localhost",
    "port": 3306,
    "user": "username",
    "password": "secret",
    "filepath": "cosmetic.sqlite",
    "max-pool-size": 10,
    "ssl-enabled": false,
    "database-name": "balloon_db",
    "connection-timeout": 30000,
    "idle-timeout": 600000,
    "keepalive-time": 300000,
    "validation-timeout": 5000,
    "use-srv": false
  },
  "balloons": [
    {
      "id": "test:one",
      "item": {
        "id": "minecraft:cobblestone",
        "count": 1
      },
      "data": {
        "model": "flower_balloon"
      },
      "glint": false,
      "lore": [],
      "permission-level": 0
    },
    {
      "id": "test:two",
      "item": {
        "id": "minecraft:stone",
        "count": 1
      },
      "data": {
        "model": "satyr_balloon"
      },
      "glint": false,
      "lore": [],
      "permission-level": 0
    },
    {
      "id": "test:three",
      "item": {
        "id": "minecraft:stone",
        "count": 1
      },
      "data": {
        "model": "apple_balloon",
        "glint": true
      },
      "glint": false,
      "lore": [],
      "permission-level": 0
    },
    {
      "id": "test:segments",
      "item": {
        "id": "minecraft:stone",
        "count": 1
      },
      "data": {
        "segments": [
          {
            "model": "dragon1",
            "distance": 0.5
          },
          {
            "model": "dragon2",
            "distance": 0.5
          },
          {
            "model": "dragon3",
            "distance": 0.5
          }
        ],
        "tilt": false,
        "model": "dragon_root"
      },
      "glint": false,
      "permission-level": 0
    }
  ]
}

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

- `id`: Внутренний идентификатор шара.
- `item` (необязательно): Предмет, используемый для отображения шара. Поддерживает компоненты
- `title` (необязательно): Форматированный заголовок
- `lore` (необязательно): Список форматированных строк описания
- `glint` (необязательно): Флаг, указывающий, имеет ли шар блеск зачарования
- `data.model`: Имя файла модели (без расширения или пути), например, `"balloon_model"` для шаров из `config/ballons/` или для моделей, управляемых filament, с пространством имён: `"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` (необязательно): Смещение позиции относительно привязанной сущности.
- `data.segments` (необязательно): Список дополнительных сегментов для шара

Формат сегмента:
- `model`: Имя файла модели, такое же, как модель для основного сегмента шара
- `animation`: Имя воспроизводимой анимации
- `distance`: Расстояние до предыдущего сегмента

---

# Команды

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

/balloon show /balloon hide


Пример:

/balloon show test:one


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

Чтобы добавить шары в доступный выбор игрока, используйте `/balloon give <player> <id or *>`
Чтобы убрать шары из доступного выбора игрока, используйте `/balloon remove <player> <id or *>`

`/balloon` отобразит интерфейс выбора

`/balloon <id>`, запущенная игроком, сделает шар с указанным id активным

`/balloon reload` для перезагрузки конфига и подключения к базе данных

---

# Компоненты

- `balloons:token`: Для предметов-ваучеров, которые можно активировать, использовав предмет (предмет не будет потрачен, если у игрока уже есть этот шар в доступе)

- `balloons:balloon`: Для предметов, которые должны отображать шар, если надеть их как экипировку или аксессуар. Имеет те же поля, что и объект "data" в конфиге, например "model", "animation", "show_leash" и т.д.

---

# Поддержка filament

Предметы на основе [Filament](https://modrinth.com/mod/filament) с `balloons:balloon` будут автоматически добавлены как вариант в команду `/balloon show <id>`, используя id предметов.
Мод также попытается загрузить модели blockbench из датапаков filament, если он установлен и модель загружена.
В этом случае обязательно указывайте пространство имён!

# Примечания

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

Частые вопросы

Как установить Balloons?

Установите Fabric под свою версию Minecraft, скачайте Balloons под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.

Для каких версий Minecraft есть Balloons?

У Balloons есть сборки для Minecraft 1.21.5–1.21.8, 1.21.11, 26.3.

Нужен ли Balloons на сервере?

Ставится только на сервер; игрокам ставить не нужно

Лицензия и источник
GNU Affero General Public License v3.0 or laterможно использовать и распространять; изменённые версии — под той же лицензией и с исходным кодом
Оригинал — Modrinth↗Файлы — без изменений, проверены по SHA-512Это ваш мод? Правообладателям

Сайт использует cookie: необходимые — для входа и темы, а также счётчики посещений Яндекс Метрика и LiveInternet — по ним мы видим, как пользуются сайтом. Рекламных cookie у нас нет. Подробнее