<div align="center"> <h1>🧎 SimpleCrawling</h1> <b>A lightweight crawling plugin with double-shift activation, reload support, and API hooks for developers.</b><br><br> <img src="https://i.ibb.co/pBG4GR3c/Screenshot-2026-03-28-at-01-07-19.png" alt="SimpleCrawling Screenshot" style="max-width: 100%; border-radius: 8px;" /><br><br> <img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/bukkit.svg" alt="Bukkit" /> <img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/spigot.svg" alt="Spigot" /> <img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/paper.svg" alt="Paper" /> <img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/purpur.svg" alt="Purpur" /> <img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/folia.svg" alt="Folia" /> </div> --- <h3 align="center">📖 OVERVIEW & HOW IT WORKS</h3> **SimpleCrawling** adds manual crawling to your server in a clean and intuitive way. It works perfectly for survival, roleplay, adventure maps, stealth systems, minigames, and any server that wants a manual crawling mechanic without unnecessary complexity. **How Does It Work?** SimpleCrawling listens for a quick **double sneak (shift)** input. When a player triggers crawling, the plugin places them into a crawl state and keeps that state active while they move. If the player toggles crawling off, disconnects, or the plugin is disabled, the crawling session is stopped safely. *No bloated setup, no unnecessary complexity, just a practical crawling mechanic with useful API support.* --- <h3 align="center">✨ PLUGIN FEATURES</h3> * **Double-Shift Activation:** Quick double-shift to start crawling. * **Toggle-Based System:** Players remain in crawl mode until intentionally stopped. * **Highly Configurable:** Reload command, customizable messages, and configurable hitbox offsets. * **Robust Developer API:** Methods for starting, stopping, and checking crawl state. * **Custom Events:** Cancellable events for easy integration. * **Optimized:** Lightweight and simple to use. --- <h3 align="center">⚙️ COMMANDS & PERMISSIONS</h3> | Command | Permission | Description | | :--- | :--- | :--- | | `/simplecrawling reload` *or* `/scrawl reload` | `simplecrawling.reload` | Reloads the plugin config and message file *(Default: OP)* | --- <h3 align="center">🛠️ CONFIGURATION</h3> The configuration is straightforward and gives you full control: * **hitbox-offset:** Controls the vertical offset used by the crawling system. * **Messages:** Fully customize all plugin messages through a separate messages file. --- <h3 align="center">💻 DEVELOPER API</h3> SimpleCrawling includes a robust API for plugin developers who want to control crawling through code or restrict it in certain areas. **Methods:** ```java plugin.startCrawling(player); plugin.stopCrawling(player); plugin.isCrawling(player); plugin.forceStartCrawling(player); plugin.forceStopCrawling(player); ``` **Events:** * `PlayerStartCrawlingEvent` * `PlayerStopCrawlingEvent` Both events are **cancellable**, meaning other plugins can easily prevent a player from starting or stopping a crawl when needed. **Example Usage:** ```java @EventHandler public void onStart(PlayerStartCrawlingEvent event) { if (event.getPlayer().hasPermission("crawl.blocked")) { event.setCancelled(true); } } ``` --- <h3 align="center">🔗 LINKS & SUPPORT</h3> <div align="center"> <p>If you encounter any issues or need help with the API, feel free to reach out!</p> <a href="https://discord.gg/EzXaxQCFQR"><img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/discord.svg" alt="Discord" /></a> &nbsp;&nbsp;&nbsp; <a href="https://github.com/ladakx/SimpleCrawling/wiki"><img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/doc.svg" alt="Documentation" /></a> <br><br> <h4 style="color:#E53935"><b>SUPPORT THE PROJECT</b></h4> <a href="https://ko-fi.com/ladakx"><img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/kofi.svg" alt="Ko-fi" /></a> &nbsp;&nbsp;&nbsp; <a href="https://www.patreon.com/posts/155880131"><img src="https://raw.githubusercontent.com/ladakx/Ladakx/main/patreon.svg" alt="Patreon" /></a> <p><b>PayPal:</b> emsockz1@gmail.com</p> </div> --- <div align="center"> <b><a href="https://bstats.org/plugin/bukkit/SimpleCrawling/30436">Plugin Statistics</a></b><br><br> <a href="https://bstats.org/plugin/bukkit/SimpleCrawling/30436"> <img src="https://bstats.org/signatures/bukkit/SimpleCrawling.svg" alt="bStats" /> </a> </div>

🧎 SimpleCrawling

A lightweight crawling plugin with double-shift activation, reload support, and API hooks for developers.

📖 OVERVIEW & HOW IT WORKS

SimpleCrawling adds manual crawling to your server in a clean and intuitive way. It works perfectly for survival, roleplay, adventure maps, stealth systems, minigames, and any server that wants a manual crawling mechanic without unnecessary complexity.

How Does It Work? SimpleCrawling listens for a quick double sneak (shift) input. When a player triggers crawling, the plugin places them into a crawl state and keeps that state active while they move. If the player toggles crawling off, disconnects, or the plugin is disabled, the crawling session is stopped safely.

No bloated setup, no unnecessary complexity, just a practical crawling mechanic with useful API support.

✨ PLUGIN FEATURES

Double-Shift Activation: Quick double-shift to start crawling. Toggle-Based System: Players remain in crawl mode until intentionally stopped. Highly Configurable: Reload command, customizable messages, and configurable hitbox offsets. Robust Developer API: Methods for starting, stopping, and checking crawl state. Custom Events: Cancellable events for easy integration. Optimized: Lightweight and simple to use.

⚙️ COMMANDS & PERMISSIONS

| Command | Permission | Description | | :--- | :--- | :--- | | `/simplecrawling reload` or `/scrawl reload` | `simplecrawling.reload` | Reloads the plugin config and message file (Default: OP) |

🛠️ CONFIGURATION

The configuration is straightforward and gives you full control: hitbox-offset: Controls the vertical offset used by the crawling system. Messages: Fully customize all plugin messages through a separate messages file.

💻 DEVELOPER API

SimpleCrawling includes a robust API for plugin developers who want to control crawling through code or restrict it in certain areas.

Methods: ```java plugin.startCrawling(player); plugin.stopCrawling(player); plugin.isCrawling(player);

plugin.forceStartCrawling(player); plugin.forceStopCrawling(player); ```

Events: `PlayerStartCrawlingEvent` `PlayerStopCrawlingEvent`

Both events are cancellable, meaning other plugins can easily prevent a player from starting or stopping a crawl when needed.

Example Usage: ```java @EventHandler public void onStart(PlayerStartCrawlingEvent event) { if (event.getPlayer().hasPermission("crawl.blocked")) { event.setCancelled(true); } } ```

🔗 LINKS & SUPPORT

If you encounter any issues or need help with the API, feel free to reach out!

   

SUPPORT THE PROJECT

   

PayPal: emsockz1@gmail.com

Plugin Statistics

🤖 AI-enhanced — based on mod data