原创 工具 MTKeyExecute - 按键绑定插件 | 简单实用 通过配置文件自定义按键执行命令！ 1.0.0

# MTKeyExecute 配置文件
# 作者: 馒头（QQ33731789）

# 插件设置
settings:
  # 是否启用调试模式
  debug: false
  # 语言设置 (zh_CN / en_US)
  language: zh_CN
  # 是否在玩家加入时发送提示信息
  join-message: true
  # 是否记录按键执行日志到控制台
  log-key-actions: false

# 按键绑定配置
# 支持的按键列表:
# DROP          - 丢弃物品键 (Q)
# SWAP_OFFHAND  - 切换副手键 (F) [仅1.13+]
# SNEAK         - 潜行键 (Shift) - 通过蹲下事件触发
# SPRINT        - 疾跑键 - 通过疾跑事件触发
# INVENTORY     - 背包键 (E) - 通过打开背包触发
# LEFT_CLICK    - 左键点击 (攻击/挖掘)
# RIGHT_CLICK   - 右键点击 (使用/放置)
# SNEAK_DROP    - 潜行+丢弃 (Shift+Q)
# SNEAK_LEFT    - 潜行+左键
# SNEAK_RIGHT   - 潜行+右键

key-bindings:
  # 示例1: 按Q键执行命令
  drop-key:
    key: DROP
    enabled: true
    # 冷却时间(秒), 0表示无冷却
    cooldown: 2
    # 所需权限 (留空则所有人可用)
    permission: ""
    # 是否需要手持指定物品才能触发 (留空则任意物品)
    required-item: ""
    # 触发时是否取消默认行为(比如阻止物品丢弃)
    cancel-event: false
    # 执行的命令列表
    # 使用 %player% 代替玩家名称
    # 使用 [player] 前缀表示以玩家身份执行
    # 使用 [console] 前缀表示以控制台身份执行
    # 使用 [op] 前缀表示临时给予OP权限执行
    commands:
      - "[player] say 我按下了Q键!"

  # 示例2: 按F键(副手切换, 仅1.13+)
  swap-offhand:
    key: SWAP_OFFHAND
    enabled: true
    cooldown: 1
    permission: ""
    required-item: ""
    cancel-event: false
    commands:
      - "[player] say 我切换了副手!"

  # 示例3: 潜行+左键
  sneak-left-click:
    key: SNEAK_LEFT
    enabled: false
    cooldown: 0
    permission: "mtkeyexecute.use"
    required-item: ""
    cancel-event: true
    commands:
      - "[console] give %player% diamond 1"
      - "[player] say 我获得了一颗钻石!"

  # 示例4: 右键点击触发传送
  right-click-tp:
    key: RIGHT_CLICK
    enabled: false
    cooldown: 5
    permission: "mtkeyexecute.use"
    # 手持特定物品才触发 (材质名称, 例如: COMPASS)
    required-item: "COMPASS"
    cancel-event: true
    commands:
      - "[player] spawn"

# 消息配置
messages:
  prefix: "&8[&6MTKeyExecute&8] &r"
  cooldown: "&c技能冷却中，还需等待 &e%time% &c秒！"
  no-permission: "&c你没有权限执行此操作！"
  reload-success: "&a配置文件已成功重载！"
  reload-fail: "&c配置文件重载失败，请检查格式！"
  join-hint: "&7按键绑定插件已加载，输入 &e/mtke &7查看帮助"
  key-executed: "&7已触发按键绑定: &e%key%"