Command Items - 指令物品生成器

💡简介

Command Items 是一款允许你创建特殊物品的插件。使用这些物品时，可以触发一系列动作，例如执行命令、发送消息，甚至是包含延迟和循环的复杂事件链。本插件适用于希望为玩家提供互动物品或自动化管理流程的服务器。

🎮快速开始

要快速上手，你可以直接参考插件生成的默认配置文件中的示例物品。配置文件位于 plugins/CommandItems/config.yml。

配置文件示例

以下是配置文件中几个物品的示例，展示了其基本结构：

items:
  fly:
    item:
      type: FEATHER
      name: "&a&lFlight token"
      lore:
        - "&1Click for 10 seconds of flight!"
        - "&kRandom second line"
      glow: true
      consumed: true
      cooldown: 20
      sneaking: true
    actions:
      - { action: COMMAND, by: CONSOLE, command: "fly {player} on" }
      - { action: MESSAGE, to: PLAYER, message: "&aFlight has been enabled!" }
      - { action: REPEAT, from: 9, to: 1, increment: -1, delay: 20, period: 20, actions: [ { action: MESSAGE, to: PLAYER, message: "&a{i}s to go" } ] }
      - { action: WAIT, duration: 200, actions: [ { action: COMMAND, by: CONSOLE, command: "fly {player} off" }, { action: MESSAGE, to: PLAYER, message: "&cFlight has been disabled!" } ] }

  helpstick:
    item:
      type: STICK
      name: "&a&lHelp Stick"
      lore:
        - "&1Click to send a help request to moderators!"
      glow: true
      consumed: false
      cooldown: 60
    actions:
      - { action: MESSAGE, to: PERMISSION, perm: group.moderator, message: "&6{player} &arequested help!" }
      - { action: MESSAGE, to: PLAYER, message: "&aModerators have been notified!" }

  xpparty:
    item:
      type: EXP_BOTTLE
      name: "&a&lEXP PARTY"
      consumed: true
    actions:
      - { action: REPEAT, period: 1, delay: 0, from: 0, to: 99, actions: [ { action: ITER, what: ONLINE_PLAYERS, actions: [ { action: CALC, a: "{iter_locY}", b: "4", op: ADD, target: "y", actions: [ { action: COMMAND, by: CONSOLE, command: "minecraft:summon minecraft:xp_bottle {iter_locX} {y} {iter_locZ}" } ] } ] } ] }
      - { action: MESSAGE, to: EVERYBODY, message: "&a&l{player} has started an XP party!" }

给予物品

配置好物品后，你可以使用以下命令将其给予玩家

• /cmdi give <target> <item>

✨功能特性

• 自定义物品：可定义物品类型、名称、描述、发光效果等。
• 触发动作：物品使用时可执行命令、发送消息、等待、循环等复杂动作链。
• 条件限制：支持消耗物品、冷却时间、潜行使用等条件。
• 变量支持：动作中可使用如 {player} 等变量。
• 权限控制：每个物品的使用都可设置独立权限。

🔧命令与权限

以下是插件的主要命令及其对应权限

命令列表

• /cmdi reload - 重载插件配置。
• /cmdi help - 显示帮助信息。
• /cmdi give <target> <item> - 将指定物品给予目标玩家。

权限节点

• cmdi.reload - 允许使用 /cmdi reload 命令。
• cmdi.help - 允许使用 /cmdi help 命令。
• cmdi.give - 允许使用 /cmdi give 命令。
• cmdi.item.<name> - 允许玩家使用名为 <name> 的物品。例如，要使用示例中的飞行物品，需要权限 cmdi.item.fly。

❓注意事项与支持

• 详细文档：完整的配置说明和动作类型详解，请查阅 GitHub 上的 README.md。
• 版本兼容性：如需支持 Minecraft 1.8 至 1.12 版本，请下载插件的 2.0.5 版本。
• 权限分配：请务必记得为玩家分配对应的 cmdi.item.<物品名> 权限，否则他们将无法使用自定义物品。