? 概述与工作原理
SimpleCrawling 以简洁直观的方式为你的服务器添加手动爬行机制。它完美适用于生存服、角色扮演服、冒险地图、潜行系统、小游戏,以及任何希望拥有手动爬行机制而不想引入复杂性的服务器。
它是如何工作的?
SimpleCrawling 监听快速的**双击潜行(Shift)**指令。当玩家触发爬行时,插件会将其置于爬行状态,并在其移动过程中保持该状态。如果玩家关闭爬行、断开连接或插件被禁用,爬行会话将安全停止。
无需繁琐的设置,没有不必要的复杂性,只有实用的爬行机制和有用的 API 支持。
✨ 插件特性
- 双击潜行激活: 快速双击 Shift 键开始爬行。
- 切换式系统: 玩家保持在爬行模式,直到有意停止。
- 高度可配置: 支持重载命令、自定义消息以及可配置的碰撞箱偏移量。
- 强大的开发者 API: 提供用于启动、停止和检查爬行状态的方法。
- 自定义事件: 可取消的事件,便于轻松集成。
- 优化性能: 轻量级且易于使用。
⚙️ 命令与权限
| 命令 |
权限 |
描述 |
/simplecrawling reload 或 /scrawl reload |
simplecrawling.reload |
重载插件配置和消息文件 (默认:OP) |
?️ 配置
配置非常简单,让你拥有完全的控制权:
- hitbox-offset: 控制爬行系统使用的垂直偏移量。
- Messages: 通过单独的消息文件完全自定义所有插件消息。
? 开发者 API
SimpleCrawling 包含一个强大的 API,供希望编程控制爬行或在特定区域限制爬行的插件开发者使用。
方法:
plugin.startCrawling(player);
plugin.stopCrawling(player);
plugin.isCrawling(player);
plugin.forceStartCrawling(player);
plugin.forceStopCrawling(player);
事件:
PlayerStartCrawlingEvent
PlayerStopCrawlingEvent
这两个事件都是可取消的,意味着其他插件可以在需要时轻松阻止玩家开始或停止爬行。
示例用法:
@EventHandler
public void onStart(PlayerStartCrawlingEvent event) {
if (event.getPlayer().hasPermission("crawl.blocked")) {
event.setCancelled(true);
}
}
? 链接与支持
如果遇到任何问题或需要 API 方面的帮助,欢迎随时联系!

支持该项目
PayPal: emsockz1@gmail.com
? 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:
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:
@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
评论 0
登录后参与评分
还没有评论,来抢沙发吧