**LeafGrapple** is a configurable virtual grappling hook plugin for **Paper \/ Folia 1.21.4+**.<\/p>\n
It supports block grappling, optional entity grappling, custom grapple types, durability, cooldowns, modern item models, legacy CustomModelData, and visible hook-chain effects.<\/p>\n
## Features<\/p>\n
– Virtual grappling hook flight system
\n– Right-click to launch a grapple
\n– Right-click again to pull yourself after the hook attaches to a block
\n– Left-click to cancel the current grapple
\n– Main-hand and off-hand support
\n– Configurable grapple types
\n– Configurable launch distance, pull distance, speed, acceleration, cooldown, and durability
\n– Improved pull movement with arc-like motion, upward assistance, edge step assistance, and finish hop
\n– Optional entity grappling system
\n– Periodic damage for hooked entities
\n– Visible particle chain and hook anchor display for entity hooks
\n– Supports modern `item_model`,legacy `CustomModelData`,PDC-based item recognition
\n– Supports ItemsAdder Modern graphics model paths<\/p>\n
## Commands<\/p>\n
– `\/leafgrapple give ## Permissions<\/p>\n – `leafgrapple.admin` – `leafgrapple.entityhook.bypass` ## Notes<\/p>\n – Requires **Paper \/ Folia 1.21.4+** ### Resource Pack \/ ItemsAdder Models(https:\/\/modrinth.com\/resourcepack\/leafgrapple-resourcepack\/version\/1.0.x)<\/p>\n LeafGrapple supports two model methods. Choose **one** method for each grapple type.<\/p>\n #### CustomModelData Resource Pack(Demo-CMD pack)<\/p>\n Use this if you are using a normal Minecraft resource pack. Use this if your server uses ItemsAdder. —<\/p>\n ## \u4e2d\u6587\u7248<\/p>\n **LeafGrapple\uff08\u53f6\u5b50\u94a9\u722a\uff09** \u662f\u4e00\u4e2a\u9762\u5411 **Paper \/ Folia 1.21.4+** \u7684\u53ef\u914d\u7f6e\u865a\u62df\u94a9\u722a\u63d2\u4ef6\u3002<\/p>\n \u5b83\u652f\u6301\u65b9\u5757\u94a9\u722a\u3001\u53ef\u9009\u7684\u5b9e\u4f53\u94a9\u722a\u3001\u81ea\u5b9a\u4e49\u94a9\u722a\u7c7b\u578b\u3001\u8010\u4e45\u3001\u51b7\u5374\u3001\u73b0\u4ee3\u7269\u54c1\u6a21\u578b\u3001\u65e7\u7248 CustomModelData\uff0c\u4ee5\u53ca\u53ef\u89c6\u5316\u7684\u94a9\u722a\u94fe\u8def\u6548\u679c\u3002<\/p>\n ## \u529f\u80fd<\/p>\n – \u865a\u62df\u94a9\u722a\u98de\u884c\u7cfb\u7edf ## \u547d\u4ee4<\/p>\n – `\/leafgrapple give <\u7c7b\u578b>` – \u83b7\u53d6\u6307\u5b9a\u7c7b\u578b\u7684\u94a9\u722a ## \u6743\u9650<\/p>\n – `leafgrapple.admin` – `leafgrapple.entityhook.bypass` ## \u6ce8\u610f\u4e8b\u9879<\/p>\n – \u9700\u8981 **Paper \/ Folia 1.21.4+** Fully customizable grappling hooks for Paper\/Folia.<\/p>\n","protected":false},"featured_media":92361,"template":"","meta":{"_minecraft_slug":"leafgrapple","_minecraft_project_id":"RhztfbB5","_minecraft_author":"LeafPixel","_minecraft_license":"MIT","_minecraft_downloads":15,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"leafgrapple.zip","_minecraft_size_bytes":122408,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T22:48:19.124923Z","_minecraft_date_created":"2026-05-11T02:27:39.982565Z","_minecraft_date_modified":"2026-05-11T04:49:04.919932Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/leafgrapple","_minecraft_icon_attachment_id":92361,"_minecraft_imported_at":"2026-06-05T06:43:47+00:00","_minecraft_import_hash":"f48448bac79d5375a2a627c5bc3cc09e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,125,89,127,128,869,92],"mod_loader":[131,132,133],"minecraft_version":[40,41,38,78,79,80,81,82],"class_list":["post-92360","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-transportation","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/leafgrapple list` – List available grapple types
\n– `\/leafgrapple reload` – Reload the plugin configuration
\n– `\/grapple` – Alias of `\/leafgrapple`
\n– `\/lg` – Alias of `\/leafgrapple`<\/p>\n
\n – Allows access to admin commands such as giving grapples and reloading the configuration.<\/p>\n
\n – Prevents the player from being bound by entity grapple effects.<\/p>\n
\n– ItemsAdder Modern support requires **ItemsAdder 4.0.13+**
\n– Entity grappling can be enabled or disabled per grapple type
\n– Player hooking is configurable and can be disabled for safer gameplay
\n– Entity hook damage uses the normal server damage system instead of true damage
\n– Configuration can be reloaded with `\/lg reload`<\/p>\n
\n“`yaml
\nhooks:
\n wood:
\n item: PAPER:50000
\n display-item: PAPER:50001
\n“`
\n#### ItemsAdder Modern Graphics(Demo-itemsadder pack)<\/p>\n
\n“`yaml
\nhooks:
\n wood:
\n item-material: PAPER
\n item-model: “leafgrapple:wood_grapple”
\n display-item-material: PAPER
\n display-item-model: “leafgrapple:wood_grapple_head”
\n “`<\/p>\n
\n– \u53f3\u952e\u53d1\u5c04\u94a9\u722a
\n– \u94a9\u722a\u547d\u4e2d\u65b9\u5757\u540e\uff0c\u518d\u6b21\u53f3\u952e\u5c06\u81ea\u5df1\u62c9\u5411\u94a9\u70b9
\n– \u5de6\u952e\u53d6\u6d88\u5f53\u524d\u94a9\u722a
\n– \u652f\u6301\u4e3b\u624b\u548c\u526f\u624b\u4f7f\u7528
\n– \u652f\u6301\u81ea\u5b9a\u4e49\u94a9\u722a\u7c7b\u578b
\n– \u53ef\u914d\u7f6e\u53d1\u5c04\u8ddd\u79bb\u3001\u62c9\u56de\u8ddd\u79bb\u3001\u901f\u5ea6\u3001\u52a0\u901f\u5ea6\u3001\u51b7\u5374\u548c\u8010\u4e45
\n– \u6539\u8fdb\u578b\u62c9\u626f\u79fb\u52a8\uff0c\u652f\u6301\u8f7b\u5fae\u5f27\u7ebf\u3001\u4e0a\u5347\u8f85\u52a9\u3001\u8fb9\u7f18\u8d8a\u969c\u8f85\u52a9\u548c\u7ec8\u70b9\u4e0a\u5f39
\n– \u53ef\u9009\u7684\u5b9e\u4f53\u94a9\u722a\u7cfb\u7edf
\n– \u652f\u6301\u5bf9\u88ab\u94a9\u4f4f\u7684\u5b9e\u4f53\u9020\u6210\u5468\u671f\u4f24\u5bb3
\n– \u5b9e\u4f53\u94a9\u722a\u652f\u6301\u53ef\u89c6\u5316\u7c92\u5b50\u94fe\u8def\u548c\u94a9\u70b9\u663e\u793a\u7269
\n– \u652f\u6301\u73b0\u4ee3 `item_model`\u3001\u65e7\u7248 `CustomModelData` \u548c PDC \u7269\u54c1\u8bc6\u522b
\n– \u652f\u6301 ItemsAdder Modern graphics \u6a21\u578b\u8def\u5f84<\/p>\n
\n– `\/leafgrapple list` – \u67e5\u770b\u53ef\u7528\u94a9\u722a\u7c7b\u578b
\n– `\/leafgrapple reload` – \u91cd\u8f7d\u63d2\u4ef6\u914d\u7f6e
\n– `\/grapple` – `\/leafgrapple` \u7684\u522b\u540d
\n– `\/lg` – `\/leafgrapple` \u7684\u522b\u540d<\/p>\n
\n – \u5141\u8bb8\u4f7f\u7528\u7ba1\u7406\u5458\u547d\u4ee4\uff0c\u4f8b\u5982\u83b7\u53d6\u94a9\u722a\u548c\u91cd\u8f7d\u914d\u7f6e\u3002<\/p>\n
\n – \u62e5\u6709\u8be5\u6743\u9650\u7684\u73a9\u5bb6\u4e0d\u4f1a\u88ab\u5b9e\u4f53\u94a9\u722a\u675f\u7f1a\u3002<\/p>\n
\n– ItemsAdder Modern \u652f\u6301\u9700\u8981 **ItemsAdder 4.0.13+**
\n– \u5b9e\u4f53\u94a9\u722a\u53ef\u4ee5\u4e3a\u6bcf\u79cd\u94a9\u722a\u5355\u72ec\u5f00\u542f\u6216\u5173\u95ed
\n– \u662f\u5426\u5141\u8bb8\u94a9\u4f4f\u73a9\u5bb6\u53ef\u4ee5\u5355\u72ec\u914d\u7f6e\uff0c\u9002\u5408\u9700\u8981\u66f4\u5b89\u5168\u73a9\u6cd5\u7684\u670d\u52a1\u5668
\n– \u5b9e\u4f53\u94a9\u722a\u4f24\u5bb3\u4e0d\u662f\u201c\u771f\u4f24\u201d\uff0c\u800c\u662f\u8d70\u670d\u52a1\u5668\u6b63\u5e38\u4f24\u5bb3\u6d41\u7a0b
\n– \u53ef\u4ee5\u4f7f\u7528 `\/lg reload` \u91cd\u8f7d\u914d\u7f6e<\/p>\n","protected":false},"excerpt":{"rendered":"