
气球
服务器端模组/库,可让你向服务器添加气球!
Balloons
一个小型 Fabric 服务端模组,让你可以通过命令将自定义气球模型附加到玩家身上。
⚠️ 本模组不包含任何气球模型——你需要自行添加!
功能说明
本模组允许你在配置文件中定义气球。
气球可以是永久的(死亡后仍保留,无需装备)
或基于带有 minecraft:equippable 组件的物品,或使用 trinkets。
你可以将 balloons:balloon 组件添加到任何物品上。
每个气球都关联到一个特定物品、一个模型文件以及一个可选动画。
无需客户端模组——模型通过 .bbmodel 或 .ajblueprint 文件处理,并使用物品展示和生成的资源包进行显示。
设置
🪄 添加气球模型
将你的模型文件放入:
config/balloons/<model>.bbmodel
- 模型文件名(不含扩展名)将成为配置中使用的内部模型 ID。
- 同时支持
.bbmodel(Blockbench)和.ajblueprint(Animated Java)格式。
配置文件
模组从以下位置读取气球定义:
config/balloons.json
存储选项:
storage-type:可为LPMETA、MONGODB、MARIADB、POSTGRESQL或SQLITEdatabase:定义数据库连接详情
** gui:**
- 通过配置自定义按钮位置
- 调整菜单高度和标题
** permissions:**
允许为 luckperm 节点分配原版权限等级。
** 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:模型文件名(不含扩展名或路径),例如config/ballons/中的气球使用"balloon_model",或针对由 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 <id>
/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 的物品,如果带有 balloons:balloon,将自动作为选项添加到 /balloon show <id> 命令中,使用物品的 id。
如果已安装 Filament 且已加载模型,模组还会尝试从 filament 数据包中加载 blockbench 模型。
在这种情况下,请确保指定命名空间!
注意事项
- 这是一个仅服务端的模组——它不会直接添加物品、配方或模型。
- 你需要自行提供模型。
- 适用于定制服务器、装饰品,或只是图个乐子。
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。