Grappling Hook - 抓钩

独立抓钩插件

Grappling Hook 是一款独立的抓钩插件，无需依赖其他插件即可运行。它允许玩家制作和使用不同材质的抓钩，将自己拉向目标点，或将实体和物品拉向自己。所有功能均可通过配置文件自定义，开箱即用。

💡核心特性

• 无需命令：默认即可使用，无需输入命令。
• 多种牵引模式：
• 将自己拉向目标位置。
• 将生物拉向自己。
• 将地面上的物品拉向自己。
• 高度可定制：
• 可配置每个抓钩的使用次数。
• 可自定义抓钩的ID、名称和描述。
• 支持每个抓钩的自定义模型数据。
• 可为每个抓钩设置方块或实体的黑名单/白名单。
• 可独立设置投掷和拉回的速度倍率。
• 可设置每次使用之间的冷却时间。
• 可控制使用后是否承受摔落伤害。
• 可控制是否启用缓降或速降效果。
• 可控制鱼线断裂时是否重置玩家速度。
• 可设置抓钩是否具有粘性（可附着在墙壁或天花板上）。
• 权限支持：默认无需权限，但提供了完整的权限节点供服务器管理。
• 即装即用：无需复杂配置，安装后即可获得预设的多种抓钩。

🎮默认合成配方

插件内置了多种抓钩的合成配方，所有配方均可在 recipes.yml 文件中进行自定义。

以下是预设的抓钩类型及其基础材料

• 木制抓钩：钓鱼竿 + 橡木木板
• 石制抓钩：钓鱼竿 + 圆石
• 铁制抓钩：钓鱼竿 + 铁锭
• 金制抓钩：钓鱼竿 + 金锭
• 绿宝石抓钩：钓鱼竿 + 绿宝石
• 钻石抓钩：钓鱼竿 + 钻石
• 空气抓钩：钓鱼竿 + 羽毛（仅能钩住空气）
• 水抓钩：钓鱼竿 + 水桶（仅能钩住水）

🔧配置文件详解

所有抓钩的属性和合成配方都在 recipes.yml 文件中配置。每个抓钩都是一个独立的配置项，包含以下主要参数：

基础属性

• id: 抓钩的唯一标识符（如 wood_hook）。
• name: 抓钩在游戏中显示的名称（支持颜色代码）。
• lore: 抓钩的描述文本，可使用 [uses] 变量显示剩余使用次数。
• customModelData: 自定义模型数据值。
• uses: 抓钩的最大使用次数。
• enabled: 是否启用此抓钩。

行为参数

• velocityThrow: 投掷抓钩时的速度倍率。
• velocityPull: 拉回抓钩时的速度倍率。
• timeBetweenGrapples: 使用冷却时间（秒）。
• fallDamage: 使用后是否承受摔落伤害。
• slowFall: 是否启用缓降效果。
• lineBreak: 鱼线断裂时是否重置玩家速度。
• stickyHook: 抓钩是否具有粘性（可附着在方块上）。

目标过滤

• entity: 设置可钩取的实体列表。
• listType: 列表类型，可选 BLACKLIST（黑名单）或 WHITELIST（白名单）。
• list: 实体类型列表（如 ITEM_FRAME, ARMOR_STAND）。
• material: 设置可钩取的方块列表。
• listType: 列表类型，可选 BLACKLIST（黑名单）或 WHITELIST（白名单）。
• list: 方块类型列表（如 WATER, AIR）。

合成配方

• recipe: 合成配方设置。
• materials: 定义配方中使用的材料字母及其对应的物品。
• shape: 定义合成表的形状，使用 [] 代表空位，字母代表材料。

✨命令与权限

命令

• /gh give <hook_id> – 将指定ID的抓钩放入自己背包。
• /gh give <hook_id> <player> – 将指定ID的抓钩放入目标玩家背包。

权限节点

• grapplinghook.pull.self – 允许玩家使用抓钩拉自己。
• grapplinghook.pull.mobs – 允许玩家使用抓钩拉生物。
• grapplinghook.pull.players – 允许玩家使用抓钩拉其他玩家。
• grapplinghook.pull.items – 允许玩家使用抓钩拉物品。
• grapplinghook.craft.<hook_id> – 允许玩家合成指定ID的抓钩。
• grapplinghook.operator – 允许玩家使用插件命令。
• grapplinghook.player.nopull – 使玩家不能被其他玩家的抓钩拉动。
• grapplinghook.player.nocooldown – 使玩家无视抓钩的冷却时间。

❓变量说明

• velocityThrow：当玩家抛出抓钩时，此值作为速度的倍率。
• velocityPull：当玩家拉回抓钩时，此值作为速度的倍率。
• timeBetweenGrapples：设置抓钩每次使用之间的冷却时间（秒）。
• fallDamage：若为 false，则玩家使用抓钩后不会受到摔落伤害。
• lineBreak：若为 true，当钓鱼线断裂时，玩家的速度将被重置。
• stickyHook：若为 true，抓钩在击中墙壁或天花板时会粘附在上面。

⭐支持作者

如果您喜欢这个插件，可以考虑通过捐赠支持作者。您也可以查看作者的其他插件或加入Discord社区。