bubble.yml

发送者和查看者的要求:

• 发送者要求: 要发送气泡，玩家必须满足sender-requirements下定义的条件。在这种情况下:

  • 玩家需要bubbles.send权限。

  • 玩家还必须具有指定的potion-effect，在本例中为"INVISIBILITY<0"，这意味着玩家没有隐身药水效果

• 查看者要求: 要查看气泡，玩家必须具有viewer-requirements下定义的bubbles.see权限。

sender-requirements:
  permission: bubbles.send
  potion-effect: "INVISIBILITY<0"

viewer-requirements:
  permission: bubbles.see

黑名单频道:

• blacklist-channels 部分允许您指定哪些频道不会显示气泡。在此示例中:

  • "Private"和"Admin"频道被列入黑名单，这意味着这些频道中不会显示气泡。

  blacklist-channels:
    - Private
    - Admin

频道模式:

• channel-mode 选项控制谁可以看到频道内的气泡:

  • ALL: 所有玩家都可以看到气泡。

  • JOINED: 只有同一频道内的玩家才能看到彼此的气泡。

  • CAN_JOIN: 有权加入特定频道的玩家将在这些频道中看到气泡。在此配置中，channel-mode设置为ALL，这意味着所有玩家都可以看到气泡。

channel-mode: ALL

默认气泡:

• 如果玩家没有指定特定的气泡，则 default-bubble 设置定义应显示哪个气泡。此处，它设置为 'chat'。

default-bubble: 'chat'

显示设置:

• Y-Offset: y-offset 调整气泡相对于最高铭牌的位置。在本例中，它设置为 0.1，这意味着它将显示在铭牌略上方。

• 查看范围: view-range 定义玩家在多远的距离内仍能看到气泡。这里，它设置为0.5。（0.5 * 视距）

y-offset: 0.1
view-range: 0.5

气泡显示时间:

• 停留时间: stay-duration 指定气泡保持可见的时间（以刻为单位）。在本例中，它设置为 150 刻，相当于 7.5 秒。

• 淡入和淡出时间: appear-duration 和 disappear-duration 控制气泡淡入和淡出所需的时间。在这里，气泡需要 4 刻（0.2 秒）才完全出现，2 刻（0.1 秒）才完全消失。

stay-duration: 150
appear-duration: 4
disappear-duration: 2

气泡设置:

• 在bubble-settings下，您可以配置单个气泡：

  • 显示名称: display-name 是气泡的名称，在本例中，它被称为"白色气泡"。

  • 最大行数: max-lines 设置决定可以显示多少行文本。对于"chat"气泡，最多允许显示 3 行。

  • 行: 每行对应一个特定的聊天气泡（例如，chat_1、chat_2、chat_3）。

  • 行宽: line-width 定义每行的最大宽度，这里设置为 150。

  • 背景颜色: background-color 指定气泡背景的 ARGB 值（alpha、红色、绿色、蓝色）。在本例中，它设置为 0,0,0,0（完全透明）。

  • 文本前缀和后缀: 这些字段允许您为文本添加格式。此处的text-prefix使用<black>颜色标签和名为"nameplates"的自定义字体，并带有移位效果（shift_0）。text-suffix关闭字体和颜色标签。

  bubble-settings:
    chat:
      display-name: "白色气泡"
      max-lines: 3
      lines:
        1: chat_1
        2: chat_2
        3: chat_3
      line-width: 150
      background-color: 0,0,0,0
      text-prefix: "<black><font:nameplates:shift_0>"
      text-suffix: "</font></black>"