气球

气球

服务器端模组/库,可让你向服务器添加气球!

装饰

Balloons

一个小型 Fabric 服务端模组,让你可以通过命令将自定义气球模型附加到玩家身上。

⚠️ 本模组不包含任何气球模型——你需要自行添加!

patreon


功能说明

本模组允许你在配置文件中定义气球。 气球可以是永久的(死亡后仍保留,无需装备) 或基于带有 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 或 SQLITE
  • database:定义数据库连接详情

** 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 模型。 在这种情况下,请确保指定命名空间!

注意事项

  • 这是一个仅服务端的模组——它不会直接添加物品、配方或模型。
  • 你需要自行提供模型。
  • 适用于定制服务器、装饰品,或只是图个乐子。