SimpleCrawling
A lightweight crawling plugin with double-shift activation, reload support, configurable messages, and API hooks for developers.
Overview
SimpleCrawling adds manual crawling to your server in a clean and intuitive way.
Players can start crawling by pressing shift twice, keep moving in a forced crawl state, and stop crawling when needed. The plugin is designed to be lightweight, easy to configure, and simple to integrate into other plugins through its API.
It works well for survival, roleplay, adventure maps, stealth systems, minigames, and any server that wants a manual crawling mechanic without unnecessary complexity.
Features
- Double-shift to start crawling
- Simple toggle-based crawling system
- Players remain in crawl mode until it is intentionally stopped
- Reload command for configuration and messages
- Customizable messages through a separate messages file
- Developer API for starting, stopping, and checking crawl state
- Custom cancellable events for crawl start and stop
- Lightweight and easy to use
How It Works
SimpleCrawling listens for a quick double sneak 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.
In practice, this gives players a consistent manual crawling mechanic that feels straightforward to use, while also giving server owners and developers full control over when crawling should start or stop.
Commands
- /simplecrawling reload - Reloads the plugin config and message file
- /scrawl reload - Alias for the reload command
Permissions
- simplecrawling.reload - Allows use of the reload command (default: op)
Configuration
- hitbox-offset - Controls the vertical offset used by the crawling system
Developer API
SimpleCrawling includes an API for plugin developers who want to control crawling through code.
Methods
Code (Java):
plugin. startCrawling (player ) ;
plugin. stopCrawling (player ) ;
plugin. isCrawling (player ) ;
plugin. forceStartCrawling (player ) ;
plugin. forceStopCrawling (player ) ;
- PlayerStartCrawlingEvent
- PlayerStopCrawlingEvent
Example
Code (Java):
@EventHandler
public void onStart (PlayerStartCrawlingEvent event ) {
if (event. getPlayer ( ). hasPermission ( "crawl.blocked" ) ) {
event. setCancelled ( true ) ;
}
}
Why SimpleCrawling?
SimpleCrawling focuses on one thing: giving your server a clean manual crawling system that is easy for players to understand and easy for developers to extend.
No bloated setup, no unnecessary complexity, just a practical crawling mechanic with useful API support.
Need help, customization, or extra features?
Feel free to expand the plugin further through the included API and events.
![[IMG]](//proxy.spigotmc.org/fe9fb642266b0c3e03c0f0db7c864713bc9279cf/68747470733a2f2f6273746174732e6f72672f7369676e6174757265732f62756b6b69742f53696d706c65437261776c696e672e737667)
Feel free to expand the plugin further through the included API and events.
Комментарии 0
Пока нет комментариев. Будь первым, кто поделится мнением.