Balloons
Серверный мод/библиотека, позволяющая добавлять шары на ваш сервер!
- Загрузчики
- Fabric
- Скачиваний на Modrinth
- 807
- Подписчиков на Modrinth
- 2
- версий
- 6
- Обновлён
- 1 октября 20261 окт.
- Опубликован
- в 2025
Коротко о моде
Ставится только на сервер; игрокам ставить не нужно
Balloons
Небольшой серверный мод для Fabric, который позволяет прикреплять к игрокам кастомные модели шариков с помощью команд.
⚠️ Этот мод не включает никаких моделей шариков — вам нужно добавить свои!
Что он делает
Этот мод позволяет задавать шарики в конфиг-файле. Шарики могут быть постоянными (сохраняются после смерти, не требуют экипировки) или основанными на предметах с компонентом 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илиSQLITEdatabase: задаёт параметры подключения к базам данных
** 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 на сервере?
Ставится только на сервер; игрокам ставить не нужно
