Grappling Hook - 抓钩插件

💡简介

Grappling Hook 是一款功能强大的自定义抓钩插件，允许你创建具有不同属性、名称和描述的抓钩。你可以通过配置文件或游戏内命令轻松定制抓钩的使用次数、距离、特效等，为你的服务器增添独特的移动与探索体验。

🎮核心特性

• 易于使用：简单的命令和配置即可创建抓钩。
• 高度自定义：可完全自定义抓钩的以下属性：
• 名称 (Name)
• 描述文本 (Lore)
• 使用次数（设为 0 表示无限）
• 最大距离（设为 0 表示无限）
• 发光效果 (Glowing)
• 自动速降 (Auto rappel)
• 自动收回 (Auto retract)
• 拉拽生物 (Pull mobs)
• 速降到生物 (Rappel to mobs)
• 允许交互的生物列表 (Mobs to allow)
• 允许交互的方块列表 (Blocks to allow)
• 描述文本变量：可在 Lore 中使用以下变量：
• USES：总使用次数
• USES_LEFT：剩余使用次数
• USE_COUNT：当前已使用次数
• DISTANCE：最大距离
• 配方与权限：支持可配置的合成配方及对应的权限（需要重启服务器）。
• 独立配置文件：每个抓钩的配置可保存在独立的 YAML 文件中 (plugins/GrapplingHook/hooks/<hook-name>.yaml)。
• 平滑动画：内置稳定化功能，确保动画流畅。
• 可配置拉力：可调整抓钩的拉拽强度。
• WorldGuard 支持：提供 WorldGuard 区域标志。

🔧命令

• /grapplinghook give <玩家名> <抓钩名称|json> - 给予玩家一个抓钩。
• 使用 JSON 格式直接定义属性：

    /gh give Notch {"name": "&7&oThe Ultimate Hook", "uses":25, "distance": 0, "pull_mob": false, "rappel_mob": true, "mobs":["SHEEP"], "blocks": ["OAK_LEAVES"], "auto_retract": true, "auto_activate": true, "glowing": true, "lore": ["&r&e<Epic Collectible>", "", "&7&oRight-click to use"]}

• 使用预设的抓钩名称（需确保对应配置文件存在，如 plugins/GrapplingHook/hooks/boss_hook.yaml）：

    /gh give Notch boss_hook

• /grapplinghook debug - 在控制台切换调试日志的开关。
• /grapplinghook reload - 重新加载插件配置。

✨权限

• grapplinghook.give - 默认 OP 拥有。允许使用给予命令。
• grapplinghook.debug - 默认 OP 拥有。允许使用调试命令。
• grapplinghook.reload - 默认 OP 拥有。允许使用重载命令。
• grapplinghook.use - 默认所有玩家拥有。允许使用抓钩。
• grapplinghook.craft - 默认所有玩家拥有。允许合成所有在配置中定义的抓钩配方。
• grapplinghook.craft.<配方名称> - 允许合成指定的单个配方。默认不授予。注意：当授予此单项权限时，请移除用户的 grapplinghook.craft 权限。

⭐配置示例

主配置文件 (`plugins/GrapplingHook/config.yaml`)

# 调试模式开关
debug: true

# 默认抓钩配置
name: '&bGrappling Hook'
lore:
  - '&r&e<Collector''s Item>'
  - ''
  - '&r&7&o{USES_LEFT} use(s) left'
  - '&r&7&o{DISTANCE} block distance'
  - ''
  - 'Found at the bottom of a'
  - 'cliff..'
  - ''
  - '&r&7&oRight-click to throw'
uses: 0
distance: 0
auto_retract: true
auto_activate: true
pull_mob: false
rappel_mob: false
glowing: true

# 全局配置
rappel_cooldown: 500
rappel_sound: ENTITY_MAGMA_CUBE_JUMP
latch_sound: ENTITY_SHEEP_SHEAR
break_sound: ENTITY_ITEM_BREAK
throw_speed_multiplier: 2.8
throw_cooldown: 1000
nofall: true
nofall_delay: 3500
auto_retract_cooldown: 1000
stabilize: true
stabilize_distance: 5
pull_multiplier: 1

# 合成配方
recipes:
  treetop_hook:
    hook:
      name: "&r&2&lTree Top Climber"
      uses: 25
      distance: 0
      auto_activate: true
      auto_retract: true
      glowing: true
      lore:
        - "&r&e<Collector's Item>"
        - ''
        - '&r&7&oRight-click to throw'
      blocks:
        - OAK_LEAVES
        - AZALEA_LEAVES
        - ACACIA_LEAVES
        - BIRCH_LEAVES
        - DARK_OAK_LEAVES
        - FLOWERING_AZALEA_LEAVES
        - JUNGLE_LEAVES
        - SPRUCE_LEAVES
    recipe:
      slot1: NETHERITE_INGOT
      slot2: NETHERITE_INGOT
      slot3: NETHERITE_INGOT
      slot4: STRING
      slot7: STRING

# 消息提示
messages:
  permissionDenied: '&cYou do not have permission!'
  playerNotFound: '&cPlayer not found!'
  reload: '&e[GrapplingHook] Config reloaded!'
  give: '&ePlayer was given a grappling hook!'
  debugOn: '&e[GrapplingHook] Debug on!'
  debugOff: '&e[GrapplingHook] Debug off!'
  invalidInput: '&cInvalid input. Check your input and try again.'

独立抓钩配置文件 (`plugins/GrapplingHook/hooks/boss_hook.yaml`)

name: '&7&lThe Boss Hook'
lore:
  - '&r&e<Unique Item>'
  - ''
  - '&r&7&o{USES_LEFT} use(s) left'
  - ''
  - '&r&7&oRight-click to throw'
uses: 0
distance: 0
auto_retract: true
auto_activate: true
blocks:
  - GRASS
  - OAK_LEAVES
pull_mob: false
rappel_mob: false
glowing: true

❓注意事项

• 请勿在插件评论中请求支持或报告错误。请使用讨论区或通过 Discord (Crit#6408) 联系开发者。
• 修改默认抓钩的 name 属性可能会使已存在的抓钩物品失效。
• 授予玩家 grapplinghook.craft.<配方名称> 权限时，请记得移除其 grapplinghook.craft 权限，以避免权限冲突。
• 添加或修改合成配方后，需要重启服务器才能生效。