Grappling Hook - 简易抓钩插件

简介

Grappling Hook 是一款功能强大的抓钩插件，允许你创建多种自定义抓钩。它支持 WorldGuard 区域、自定义合成配方、权限控制，几乎所有设置都可通过游戏内命令实时调整，为服务器带来丰富的移动与探索体验。

💡核心特性

• 创建任意数量的自定义抓钩变体。
• 支持 WorldGuard 区域，可使用自定义标志进行控制。
• 可将任意钓鱼竿用作抓钩。
• 支持通过工作台合成抓钩。
• 提供完整的控制台支持与简易的命令补全。
• 几乎所有配置（除物品描述与合成配方外）均可通过游戏内命令更改。

抓钩自定义功能

以下所有特性均可为每个抓钩单独设置

• 是否允许钩中空气
• 自定义物品显示名称
• 自定义冷却时间
• 自定义物品描述（Lore）
• 自定义重力参数
• 自定义距离/速度倍率
• 自定义合成配方（需重载或重启服务器生效）
• 启用/禁用合成功能
• 赋予抓钩附魔光效外观
• 设置有限或无限使用次数
• 设置使用权限
• 设置抓取与断裂音效
• 落地时免除摔落伤害
• 是否使用浮空方块作为抓取点
• 设置抓钩在所有世界生效，或仅限特定世界使用

🔧WorldGuard 集成

为区域添加 `gh-pl` 标志以控制抓钩使用

• 设置为 allow：允许在该区域内使用任何抓钩。
• 设置为 deny：禁止在该区域内使用抓钩。

🎮命令与权限

所有命令均以 /grapplinghook 或 /gh 开头。拥有 grapplinghook.cmds.* 权限或是 OP 的玩家可以使用所有命令。

命令列表

• /gh help - [grapplinghook.cmd.help] 显示可用命令。
• /gh reload - [grapplinghook.cmd.reload] 重载插件数据。
• /gh allRods - [grapplinghook.cmd.allRods] 将所有钓鱼竿设为抓钩。
• /gh list <页码> - [grapplinghook.cmd.list] 显示已存在的抓钩列表。
• /gh info <抓钩名称> - [grapplinghook.cmd.info] 显示指定抓钩的信息。
• /gh get <抓钩名称> - [grapplinghook.cmd.get] 给予自己一个抓钩。
• /gh give <抓钩名称> <玩家名> - [grapplinghook.cmd.give] 给予指定玩家一个抓钩。
• /gh create <抓钩名称> - [grapplinghook.cmd.create] 创建一个新抓钩。
• /gh remove <抓钩名称> - [grapplinghook.cmd.remove] 移除一个抓钩。
• /gh allWorlds <抓钩名称> <true/false> - [grapplinghook.cmd.allWorlds] 设置抓钩是否在所有世界生效。
• /gh addWorld <抓钩名称> <世界名> - [grapplinghook.cmd.addWorld] 为抓钩添加一个生效世界。
• /gh addWorld <抓钩名称> - [grapplinghook.cmd.addWorld] 将玩家当前所在世界添加到抓钩生效列表。
• /gh rmWorld <抓钩名称> <世界名> - [grapplinghook.cmd.removeWorld] 从抓钩生效列表中移除一个世界。
• /gh rmWorld <抓钩名称> - [grapplinghook.cmd.removeWorld] 将玩家当前所在世界从抓钩生效列表中移除。
• /gh breakSound <抓钩名称> <断裂音效> - [grapplinghook.cmd.setSound] 设置断裂音效。
• /gh pullSound <抓钩名称> <抓取音效> - [grapplinghook.cmd.setSound] 设置抓取音效。
• /gh cooldown <抓钩名称> <秒数> - [grapplinghook.cmd.cooldown] 设置冷却时间。
• /gh useAir <抓钩名称> <true/false> - [grapplinghook.cmd.useAir] 设置是否允许钩中空气。
• /gh crafting <抓钩名称> <true/false> - [grapplinghook.cmd.crafting] 设置是否允许合成此抓钩。
• /gh glow <抓钩名称> <true/false> - [grapplinghook.cmd.glow] 设置是否显示附魔光效。
• /gh unbreakable <抓钩名称> <true/false> - [grapplinghook.cmd.unbreakable] 设置抓钩是否不可破坏。
• /gh noFallDamage <抓钩名称> <true/false> - [grapplinghook.cmd.noFallDamage] 设置玩家落地时是否免除摔落伤害。
• /gh useFloatingBlocks <抓钩名称> <true/false> - [grapplinghook.cmd.useFloatingBlocks] 设置是否使用浮空方块作为抓取点。
• /gh cancelEntityCatch <抓钩名称> <true/false> - [grapplinghook.cmd.cancelOnEntityCatch] 设置抓钩在钓鱼或钩中实体时是否生效。
• /gh destroyNoUses <抓钩名称> <true/false> - [grapplinghook.cmd.destroyWhenNoMoreUses] 设置抓钩在用尽次数后是否被销毁。
• /gh maxUses <抓钩名称> <最大次数> - [grapplinghook.cmd.maxUses] 设置抓钩的最大使用次数。
• /gh destroyDelay <抓钩名称> <游戏刻> - [grapplinghook.cmd.destroyDelay] 设置销毁延迟。
• /gh gravity <抓钩名称> <重力值> - [grapplinghook.cmd.gravity] 设置重力（值越高，玩家飞得越低）。
• /gh multiplier <抓钩名称> <倍率> - [grapplinghook.cmd.multiplier] 设置距离/速度倍率。
• /gh permission <抓钩名称> <权限> - [grapplinghook.cmd.permission] 设置使用和合成此抓钩所需的权限。
• /gh displayName <抓钩名称> <显示名称> - [grapplinghook.cmd.displayName] 设置抓钩的显示名称。
• /gh unlimitedName <抓钩名称> <无限名称> - [grapplinghook.cmd.unlimitedName] 设置无限使用时的占位符名称（在描述中会替换 %uses%）。
• /gh unlimited <抓钩名称> <true/false> - [grapplinghook.cmd.unlimited] 设置抓钩是否有无限使用次数。

权限列表

OP 玩家自动拥有所有权限。

• grapplinghook.cmds.* - 可以使用所有命令并享受命令补全。
• grapplinghook.player.default - 玩家可以合成抓钩并在所有世界使用它们。
• grapplinghook.tab.complete - 可以使用命令补全功能。
• grapplinghook.craft - 玩家可以合成抓钩。
• grapplinghook.worlds.* - 玩家可以在所有世界使用抓钩。
• grapplinghook.world.[世界名] - 玩家可以在指定世界 [世界名] 使用抓钩。
• grapplinghook.removeWorld.[世界名] - 玩家不能在指定世界 [世界名] 使用抓钩。

抓钩权限说明

当抓钩设置了专属权限时，玩家需要该权限才能合成和使用此抓钩。但要合成任何抓钩，玩家仍需拥有 grapplinghook.craft 或 grapplinghook.player.default 权限。使用抓钩时同理，玩家仍需拥有在当前世界使用的权限（grapplinghook.world.[世界名]）或在所有世界使用的权限（grapplinghook.worlds.*）。

示例：一个抓钩的权限是 gh.unlimited，玩家拥有此权限，但没有 grapplinghook.craft 权限，则该玩家无法合成此抓钩。

世界移除权限说明

权限 grapplinghook.removeWorld.[世界名] 的优先级高于 grapplinghook.world.[世界名] 或 grapplinghook.worlds.*。

示例：玩家所在的组拥有 grapplinghook.worlds.* 权限，但玩家个人拥有 grapplinghook.removeWorld.lobby 权限，则该玩家将无法在 lobby 世界使用抓钩。

✨配置文件

主配置文件

config-version: 1 # 请勿修改
prefix: '&7[ &6GrapplingHook&7 ] ' # 插件消息前缀
fallDamageRemove: 10 # 玩家落地后，若未触发摔落伤害事件，将在多少服务器刻后从免伤列表中移除
allFishingRods: false # 是否将所有钓鱼竿都视为抓钩

抓钩配置文件

# 示例配置结构
# <抓钩名称>:
#   选项...
#
# 创建新抓钩：使用游戏内命令 /gh create <名称>，或复制下方示例，
# 将 <抓钩名称> 替换为唯一名称（仅允许 a-z 0-9 _ -，最长10字符，小写），取消注释所有行并按需修改设置。
# 若希望所有玩家无需额外权限即可使用抓钩，请将 permission 设为 'none'。
#
# 如果启用了“所有钓鱼竿作为抓钩”，你可以在已存在的 `allrods` 配置项下修改其设置。
#
# !!警告!!
# - 合成配方 (CRAFTING):
#   配方必须是唯一的。更改配方、名称、描述或附魔光效后，必须重载或重启（推荐）服务器。
# - 更改名称/描述 (CHANGING NAME/LORE):
#   更改显示名称或描述后，游戏中已存在的该抓钩物品将停止工作。
#
## 真实示例
# <抓钩名称>:
#   permission: 'none'
#   displayName: '&6Grappling Hook'
#   unlimitedUsesName: '&cunlimited'
#   unlimitedUses: false
#   glow: true
#   useAir: false
#   crafting: true
#   allWorlds: true
#   unbreakable: true
#   noFallDamage: true
#   useFloatingBlocks: true
#   cancelOnEntityCatch: true
#   destroyWhenNoMoreUses: false
#   maxUses: 10
#   destroyDelay: 10
#   cooldown: 2
#   gravity: 0.35
#   throw_speed_multiplier: 0.25
#   pullSound: ENTITY_ENDERMAN_TELEPORT
#   breakSound: ENTITY_ITEM_BREAK
#   recipe:
#     slot1: ''
#     slot2: ''
#     slot3: Stick
#     slot4: ''
#     slot5: Stick
#     slot6: String
#     slot7: Stick
#     slot8: ''
#     slot9: Iron_Ingot
#   lore:
#     - ' '
#     - '&7You have &6%uses% &7uses left'
#   worlds: []

allrods:
  permission: 'none'
  useAir: false
  allWorlds: true
  unbreakable: false
  noFallDamage: true
  useFloatingBlocks: true
  cancelOnEntityCatch: true
  cooldown: 2
  gravity: 0.35
  throw_speed_multiplier: 0.25
  worlds: []

消息配置文件

config-version: 1 # 请勿修改
reload: '%prefix% &7Config reloaded!'
noperm: '%prefix% &4You have no permissions to do that.'
# ... (其他消息配置，可根据需要自定义)

❓支持与兼容性

支持

如需支持，请在 Spigot 讨论区发帖或直接联系开发者。请不要在评论中寻求支持。

版本信息

• 版本 3.0 及以上：支持 MC 1.8 - 1.19（已测试）
• 版本 2.4.1 至 2.6：支持 MC 1.8 - 1.16（已测试）
• 版本 2.3 及以上：支持 MC 1.8 - 1.15（已测试）
• 版本 2.2.1 及以下：支持 MC 1.8（已测试，1.9-1.12 应可运行）

视频教程

开发者提供了以下版本的使用视频

• 版本 2.6 视频教程
• 版本 2.3 视频教程
• 版本 2.0 视频教程

⭐后续计划

如果你有任何好点子，欢迎告知开发者！感谢超过 8.5k 次下载。