# WorldPreventer \u2013 Advanced Anti-Exploit & World Protection<\/p>\n
\u26a0\ufe0f **Early Development Notice**
\nWorldPreventer is still in a very early stage of development. Many systems are functional, but the **machine learning (ML) detection system does not ship with a trained model**.<\/p>\n
* Do **not enable ML detection** unless you have trained your own model.
\n* If you see the notification `REQUEST_STATS observed (WorldTools signature)`, this likely indicates that a client is attempting to download your world.<\/p>\n
—<\/p>\n
## Overview<\/p>\n
WorldPreventer is a **high-performance anti-exploit and world protection plugin** designed to safeguard your server from a wide range of threats, including:<\/p>\n
* **World downloads**
\n* **Chunk exploitation**
\n* **Suspicious client behavior**<\/p>\n
It combines **packet-level monitoring**, **behavioral analysis**, and **adaptive responses** to protect your server from malicious activity.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Core Protection Systems<\/p>\n
1. **Chunk Exploit Prevention**<\/p>\n
* Detects & prevents rapid chunk loading\/unloading
\n * Monitors chunk interaction patterns
\n * Stops chunk boundary exploits<\/p>\n
2. **WorldTools Blocker**<\/p>\n
* Blocks WorldTools client functionality
\n * Prevents unauthorized world downloads
\n * Detects & blocks rapid join\/leave patterns<\/p>\n
3. **Deep Packet Inspection**<\/p>\n
* Analyzes network traffic for suspicious patterns
\n * Detects & blocks malicious packet sequences
\n * Monitors data volume & timing anomalies<\/p>\n
4. **Adaptive Response System**<\/p>\n
* Dynamic threat-level scoring
\n * Escalating responses (warn \u2192 kick \u2192 ban)
\n * Fully configurable actions<\/p>\n
—<\/p>\n
### Machine Learning Detection (Optional)<\/p>\n
**Important:** The ML system is disabled by default and ships **without a trained model**. Do not enable it unless you train your own.<\/p>\n
When configured properly, the ML system provides:<\/p>\n
* **Anomaly Detection** \u2013 Spotting unusual player behavior
\n* **Behavioral Analysis** \u2013 Learning normal server patterns
\n* **Real-time Scoring** \u2013 Constantly evaluating actions
\n* **Adaptive Thresholds** \u2013 Adjusting to server conditions<\/p>\n
**Tracked Features (12 total):**
\nChunk transitions, container interactions, movement volume, entity spawn rates, packet bursts, systematic movement, join surges, client brand, timing precision, data volume variance, interaction patterns, movement entropy.<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
### Admin Commands<\/p>\n
* `\/worldpreventer reload` \u2013 Reload configuration ### Permissions<\/p>\n * `worldpreventer.admin` \u2013 Full access & bypass —<\/p>\n ## Configuration<\/p>\n Example `config.yml`:<\/p>\n “`yaml # Escalation actions # Suspicion scoring # Machine Learning (disabled by default) # ProtocolLib-based packet blocking —<\/p>\n ## Integration<\/p>\n ### Dependencies<\/p>\n * **Required:** ProtocolLib ### API Example<\/p>\n “`java \/\/ Get suspicion score \/\/ Add custom detection points —<\/p>\n ## Staff Notifications<\/p>\n Staff with permission receive alerts for:<\/p>\n * Suspicious activity —<\/p>\n ## Bypass Options<\/p>\n Players excluded from detection:<\/p>\n * `worldpreventer.bypass` permission holders —<\/p>\n ## Support<\/p>\n For bug reports, feature requests, or support, please visit the GitHub repository.<\/p>\n","protected":false},"excerpt":{"rendered":" Prevents your Worlds from being downloaded<\/p>\n","protected":false},"featured_media":171588,"template":"","meta":{"_minecraft_slug":"worldpreventer","_minecraft_project_id":"PxdDGZkP","_minecraft_author":"Bobcat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":71,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"worldpreventer.zip","_minecraft_size_bytes":130627,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:26:30.263544Z","_minecraft_date_created":"2025-08-28T08:31:20.948500Z","_minecraft_date_modified":"2025-08-28T05:05:18.974534Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/worldpreventer","_minecraft_icon_attachment_id":171588,"_minecraft_imported_at":"2026-06-09T21:31:53+00:00","_minecraft_import_hash":"ad4e1f436fe800affe6b862212fdc5f8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,90,127,92,159],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-171587","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-utility","mod_category-worldgen","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","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"],"yoast_head":"\n
\n* `\/worldpreventer status` \u2013 View protection status
\n* `\/worldpreventer simulate
\n* `\/worldpreventer ml [enable|disable|status]` \u2013 Manage ML system<\/p>\n
\n* `worldpreventer.staff` \u2013 Receive suspicious activity alerts
\n* `worldpreventer.bypass` \u2013 Exclude player from detection<\/p>\n
\n# Grace period after join
\njoin_grace_period_seconds: 120<\/p>\n
\nactions:
\n on_exceed: WARN # WARN, KICK, BAN<\/p>\n
\nscoring:
\n enabled: true
\n decay_per_minute: 10.0
\n thresholds:
\n warn: 100.0
\n kick: 500.0<\/p>\n
\nml:
\n enabled: false
\n direct_kicks: false
\n score_threshold: 3.0
\n points_on_exceed: 20.0
\n kick_message: “\u00a7cKicked by ML anti-cheat system”
\n window_seconds: 60
\n autosave_minutes: 5
\n decay: 0.98<\/p>\n
\npacket_blocking:
\n enabled: true
\n block_stats_request: false
\n block_statistics: false
\n block_map_data: false
\n corrupt_block_entities: false
\n inject_fake_data: false
\n“`<\/p>\n
\n* **Recommended:** Vault<\/p>\n
\nWorldPreventer plugin = (WorldPreventer) Bukkit.getPluginManager().getPlugin(“WorldPreventer”);<\/p>\n
\ndouble score = plugin.getSuspicionScorer().getScore(player.getUniqueId());<\/p>\n
\nplugin.getSuspicionScorer().addScore(player.getUniqueId(), 10.0, “CUSTOM_EVENT”);
\n“`<\/p>\n
\n* ML system detections
\n* Config changes
\n* Warnings & errors<\/p>\n
\n* Players in Creative mode
\n* Players in Spectator mode<\/p>\n