跳到主要内容

物品配置指南

BellCommand 的核心在于自定义命令物品。通过简单的 YAML 配置，你可以创建具有特殊功能、权限和冷却时间的物品。

1. 基础结构​

从版本 1.4.0 开始，物品定义建议放在独立的文件夹（默认为 Default_config/）中的 .yml 文件内。文件夹名称必须以 _config 结尾。

items:
  example_sword:           # 物品唯一标识 ID
    item-id: DIAMOND_SWORD # 物品材质 (使用 Bukkit Material 名称)
    name: "&6传奇之剑"      # 物品显示名称 (支持颜色代码)
    lore:                  # 物品描述
      - "&7这是一把被诅咒的剑"
      - "&e右键点击触发神力"
    permission: "sword.use" # 使用该物品所需的权限 (可选)
    cooldown: 5            # 冷却时间 (秒)

2. 交互动作 (Commands)​

你可以为不同的交互方式配置不同的命令序列：

动作类型说明
right-click右键点击
left-click左键点击
shift-right-clickShift + 右键
shift-left-clickShift + 左键
bedrock-right-click基岩版专用右键 (Floodgate)
bedrock-left-click基岩版专用左键 (Floodgate)
bedrock-shift-right-click基岩版专用潜行 + 右键
bedrock-shift-left-click基岩版专用潜行 + 左键
提示

从 v1.4.0-beta.2 开始，如果你没有为基岩版配置特定的动作（如 bedrock-right-click），插件会自动回退并尝试执行对应的通用动作（如 right-click）。

命令配置示例​

    commands:
      right-click:
        1:
          command: "heal %player%" # 执行的命令
          as-console: true         # 是否以控制台身份执行
        2:
          command: "say 我被治愈了！"
          as-op: true              # 是否以管理员 (OP) 权限执行
          delay: 1.5               # 延迟 1.5 秒执行

命令参数说明​

  • command: 字符串。要执行的命令。
  • as-console: 布尔值。为 true 时由控制台执行，为 false 时由玩家执行。
  • as-op: 布尔值。为 true 时玩家将临时获得 OP 权限执行该命令（执行后立即恢复）。
  • delay: 数字。执行命令前的延迟时间（秒）。

占位符支持​

在 command 字段中可以使用以下占位符：

  • %player%: 玩家名称。
  • %uuid%: 玩家 UUID。
  • %world%: 玩家所在世界名称。
  • %x%, %y%, %z%: 玩家当前的坐标（整数）。

3. 自动功能​

自动给予 (Auto-Give)​

配置玩家在特定事件发生时是否自动获得该物品。

    auto-give:
      join: true       # 玩家加入服务器时给予 (不论是否是首次)
      first-join: true # 仅在玩家首次加入服务器时给予
      respawn: true    # 玩家重生时给予

自动清理 (Auto-Cleanup)​

配置物品在玩家背包中的存在策略。当玩家拥有此物品时，插件会尝试在指定延迟后清理它。

    auto-cleanup:
      enabled: true # 是否开启自动清理
      delay: 30     # 玩家获得物品后多少秒执行清理

4. 进阶配置​

关于次数性消耗物品（Consumables）的详细配置，请参考 次数性物品文档。