# BandwidthSaver-PE<\/p>\n
## Overview | \u6982\u8ff0<\/p>\n
**BandwidthSaver-PE** is a high-performance bandwidth throttling plugin built on the **PacketEvents** framework. Developed by the **Mangocraft Code Team**, it is a modernized fork of the legacy RIABandwidthSaver by **Ghost-chu**.<\/p>\n
BandwidthSaver-PE \u662f\u4e00\u4e2a\u57fa\u4e8e **PacketEvents** \u7684\u9ad8\u6027\u80fd\u8282\u6d41\u63d2\u4ef6\u3002\u7531 **\u8292\u679c\u65b9\u5757\u7684\u670d\u52a1\u5668\u5f00\u53d1\u5236\u4f5c\u7ec4** \u57fa\u4e8e Ghost-chu \u7684\u65e7\u7248\u63d2\u4ef6RIABandwidthSaver\u8fdb\u884c\u4fee\u6539\u4f18\u5316\uff0c\u65e8\u5728\u73a9\u5bb6\u5904\u4e8e AFK \u72b6\u6001\u671f\u95f4\u6291\u5236\u4e0d\u5fc5\u8981\u7684\u6570\u636e\u5305\u548c\u533a\u5757\u53d1\u9001\uff0c\u7f13\u89e3\u670d\u52a1\u5668\u5e26\u5bbd\u538b\u529b\u3002
\n
\n
\n\uff08All text within images can be modified in config.yml. Feel free to translate or customize the content.\u56fe\u7247\u5185\u6587\u5b57\u5747\u53ef\u5728config.yml\u4e2d\u4fee\u6539\uff0c\u53ef\u81ea\u884c\u7ffb\u8bd1\u6216\u81ea\u5b9a\u4e49\u5185\u5bb9\uff09<\/p>\n
### Improvements | \u6539\u8fdb\u70b9
\n* **Modern Framework:** Switched from ProtocolLib to **PacketEvents** for superior stability. (\u524d\u7f6e\u4ece ProtocolLib \u6539\u4e3a PacketEvents\uff0c\u66f4\u7a33\u5b9a\u517c\u5bb9)
\n* **Refined Logic:** Optimized filtering algorithms for higher precision. (\u4f18\u5316\u8fc7\u6ee4\u7b97\u6cd5\uff0c\u66f4\u51c6\u786e\u9ad8\u6548)
\n* **Folia Support:** Native compatibility with Folia. (\u589e\u52a0\u5bf9 Folia \u670d\u52a1\u5668\u7684\u652f\u6301)
\n* **AFK Fishing Fix:** Added detection and handling for AFK fishing machines. (\u589e\u52a0\u5bf9\u81ea\u52a8\u9493\u9c7c\u673a\u7684\u68c0\u6d4b\u548c\u5904\u7406)
\n* **Manual AFK Mode:** Added `\/afk` command for manual AFK mode that persists regardless of player movement. (\u65b0\u589e\/afk\u547d\u4ee4\uff0c\u63d0\u4f9b\u624b\u52a8AFK\u6a21\u5f0f\uff0c\u4e0d\u53d7\u73a9\u5bb6\u79fb\u52a8\u5f71\u54cd)<\/p>\n
—<\/p>\n
> [!IMPORTANT]
\n> * **Dependency:** You **must** install PacketEvents for this plugin to function. (\u5fc5\u987b\u5b89\u88c5 PacketEvents \u63d2\u4ef6)
\n> * **Note on Stats:** Traffic statistics represent **uncompressed** data. Actual billed bandwidth may differ due to server-side compression. (\u7edf\u8ba1\u4fe1\u606f\u4e3a\u672a\u538b\u7f29\u6d41\u91cf\uff0c\u5b9e\u9645\u6d41\u91cf\u56e0\u670d\u52a1\u5668\u538b\u7f29\u914d\u7f6e\u4f1a\u6709\u6240\u51fa\u5165)<\/p>\n
—<\/p>\n
## Features | \u529f\u80fd<\/p>\n
### 1. Dynamic View Distance | \u52a8\u6001\u89c6\u8ddd
\n* Lowers client-side view distance for AFK players without affecting server-side simulation distance.
\n* \u964d\u4f4e AFK \u73a9\u5bb6\u7684\u5ba2\u6237\u7aef\u89c6\u91ce\u8ddd\u79bb\uff0c\u4e0d\u5f71\u54cd\u670d\u52a1\u5668\u6a21\u62df\u8ddd\u79bb\uff0c\u51cf\u5c11\u533a\u5757\u6570\u636e\u4f20\u8f93\u3002<\/p>\n
### 2. AFK Detection | AFK \u68c0\u6d4b\u673a\u5236
\n* **Perspective-Based:** Monitors camera rotation (Default: 300s). \u57fa\u4e8e\u89c6\u89d2\u79fb\u52a8\u68c0\u6d4b\uff08\u9ed8\u8ba4 300 \u79d2\uff09\u3002
\n* **Auto-Exit:** Automatically restores traffic flow upon taking damage or using teleport commands (`\/tp`, `\/spawn`, `\/home`, etc.). \u53d7\u5230\u653b\u51fb\u6216\u4f7f\u7528\u4f20\u9001\u547d\u4ee4\u65f6\u81ea\u52a8\u9000\u51fa AFK \u6a21\u5f0f\u3002
\n* **Automation Friendly:** Compatible with AFK pools and auto-clickers. \u652f\u6301\u81ea\u52a8\u653b\u51fb\u548c AFK \u6c60\u3002
\n* **Manual AFK Mode:** Players can use `\/afk` command to enter manual AFK mode that persists regardless of player movement. Use `\/afk` again or rejoin the game to exit. \u624b\u52a8AFK\u6a21\u5f0f\uff1a\u73a9\u5bb6\u53ef\u4f7f\u7528\/afk\u547d\u4ee4\u8fdb\u5165\u624b\u52a8AFK\u6a21\u5f0f\uff0c\u4e0d\u53d7\u73a9\u5bb6\u79fb\u52a8\u5f71\u54cd\u3002\u518d\u6b21\u4f7f\u7528\/afk\u6216\u91cd\u65b0\u52a0\u5165\u6e38\u620f\u53ef\u9000\u51fa\u3002<\/p>\n
### 3. Packet Filtering | \u6570\u636e\u5305\u8fc7\u6ee4\u8be6\u60c5
\n* **Cancelled (100% Suppression) | \u53d6\u6d88\u53d1\u9001:**
\n * Animations, Block break, Sounds, Particles, Explosions, Time sync, Light updates, TAB list headers\/footers, World events, Potion effects, Map data, etc.
\n * \u52a8\u753b\u3001\u65b9\u5757\u7834\u574f\u3001\u58f0\u97f3\u3001\u7c92\u5b50\u3001\u7206\u70b8\u3001\u65f6\u95f4\u540c\u6b65\u3001\u5149\u7167\u66f4\u65b0\u3001TAB \u5217\u8868\u3001\u4e16\u754c\u4e8b\u4ef6\u3001\u836f\u6c34\u6548\u679c\u3001\u5730\u56fe\u6570\u636e\u7b49\u3002
\n* **Throttled (Reduced Rate) | \u9891\u7387\u524a\u51cf:**
\n * **2% Pass Rate:** Entity movement, Position, Velocity, Experience orbs. (\u5b9e\u4f53\u79fb\u52a8\/\u4f4d\u7f6e\/\u901f\u5ea6\u3001\u7ecf\u9a8c\u7403)
\n * **5% Pass Rate:** Entity metadata. (\u5b9e\u4f53\u5143\u6570\u636e)
\n * **20% Pass Rate:** Head orientation. (\u5b9e\u4f53\u5934\u90e8\u671d\u5411)
\n* **Special Handling for AFK Fishing | \u81ea\u52a8\u9493\u9c7c\u673a\u7279\u6b8a\u5904\u7406:**
\n * When a player holds a fishing rod, certain packets (sound effects, entity velocity\/movement) are allowed to pass through to support fishing activities.
\n * \u5f53\u73a9\u5bb6\u624b\u6301\u9493\u9c7c\u7aff\u65f6\uff0c\u67d0\u4e9b\u6570\u636e\u5305\uff08\u58f0\u97f3\u6548\u679c\u3001\u5b9e\u4f53\u901f\u5ea6\/\u79fb\u52a8\uff09\u4f1a\u88ab\u5141\u8bb8\u901a\u8fc7\uff0c\u4ee5\u652f\u6301\u9493\u9c7c\u6d3b\u52a8\u3002<\/p>\n
—<\/p>\n
## Commands & Permissions | \u547d\u4ee4\u4e0e\u6743\u9650<\/p>\n
| Command | Description |
\n| :— | :— |
\n| `\/bandwidthsaver` | View bandwidth saving stats (\u67e5\u770b\u6d41\u91cf\u8282\u7701\u7edf\u8ba1) |
\n| `\/bandwidthsaver unfiltered` | View raw consumption (\u67e5\u770b\u5b9e\u9645\u6d88\u8017\u7edf\u8ba1) |
\n| `\/bandwidthsaver reload` | Reload configuration (\u91cd\u8f7d\u914d\u7f6e) |
\n| `\/afk` | Toggle manual AFK mode (\u5207\u6362\u624b\u52a8AFK\u6a21\u5f0f) |<\/p>\n
| Permission | Description |
\n| :— | :— |
\n| `bandwidthsaver.bypass` | Bypass AFK detection (\u7ed5\u8fc7 AFK \u68c0\u6d4b) |
\n| `bandwidthsaver.admin` | Access admin commands (\u7ba1\u7406\u5458\u6743\u9650) |<\/p>\n
—<\/p>\n
## Configuration | \u914d\u7f6e\u6587\u4ef6<\/p>\n
“`yaml
\n# Calculate all packets (required for \/bandwidthsaver unfiltered)
\ncalcAllPackets: true<\/p>\n
# Dynamically modify player view distance when AFK
\nmodifyPlayerViewDistance: false<\/p>\n
# AFK threshold in seconds
\nafkPerspectiveThresholdSeconds: 300<\/p>\n
# Enable console logging for filtering details
\ndebug: false<\/p>\n
message: A server bandwidth throttling plugin based on PacketEvents.
\n playerEcoEnable: ‘\u00a7a\ud83c\udf43 ECO \u8282\u80fd\u6a21\u5f0f\u5df2\u542f\u7528\uff0c\u9650\u5236\u6570\u636e\u4f20\u8f93\uff0c\u53ef\u80fd\u4f1a\u770b\u7740\u5361\u987f\uff0c\u5b9e\u9645\u6b63\u5e38\uff0c\u4e0d\u4f1a\u5f71\u54cd\u673a\u5668\u8fd0\u884c’
\n playerEcoDisable: ‘\u00a78\ud83c\udf43 ECO \u8282\u80fd\u6a21\u5f0f\u5df2\u505c\u7528\uff0c\u6570\u636e\u4f20\u8f93\u5c06\u6062\u590d\u6b63\u5e38’
\nbossbar:
\n eco-enabled-title: “
\n eco-enabled-health: 1.0
\n eco-enabled-color: “YELLOW” # YELLOW, BLUE, RED, GREEN, PINK, WHITE, PURPLE, or ORANGE
\n eco-enabled-overlay: “PROGRESS” # PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, or NOTCHED_20<\/p>\n","protected":false},"excerpt":{"rendered":"
\n\u4e00\u4e2a\u57fa\u4e8e PacketEvents \u7684\u8282\u7701\u670d\u52a1\u5668\u5e26\u5bbd\u7684\u63d2\u4ef6\u3002<\/p>\n","protected":false},"featured_media":25362,"template":"","meta":{"_minecraft_slug":"bandwidthsaver-packetevents","_minecraft_project_id":"OEd6iTqW","_minecraft_author":"mangocraft","_minecraft_license":"MIT","_minecraft_downloads":114,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bandwidthsaver-packetevents.zip","_minecraft_size_bytes":396101,"_minecraft_version_count":19,"_minecraft_updated_at":"2026-05-15T19:31:20.554999Z","_minecraft_date_created":"2026-01-31T23:22:27.203193Z","_minecraft_date_modified":"2026-05-15T03:25:27.584039Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bandwidthsaver-packetevents","_minecraft_icon_attachment_id":25362,"_minecraft_imported_at":"2026-06-01T09:04:47+00:00","_minecraft_import_hash":"f36008d7fd7d6cb29a01d9b67700fe4a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,90,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-25361","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n