BandwidthSaver-PE

BandwidthSaver-PE

Overview | 概述

Ghost-chu is a high-performance bandwidth throttling plugin built on the Ghost-chu framework. Developed by the Ghost-chu, it is a modernized fork of the legacy Ghost-chu by Ghost-chu.

BandwidthSaver-PE 是一个基于 芒果方块的服务器开发制作组 的高性能节流插件。由 芒果方块的服务器开发制作组 基于 Ghost-chu 的旧版插件RIABandwidthSaver进行修改优化，旨在玩家处于 AFK 状态期间抑制不必要的数据包和区块发送，缓解服务器带宽压力。

（All text within images can be modified in config.yml. Feel free to translate or customize the content.图片内文字均可在config.yml中修改，可自行翻译或自定义内容）

Improvements | 改进点

* Manual AFK Mode: Switched from ProtocolLib to Manual AFK Mode: for superior stability. (前置从 ProtocolLib 改为 PacketEvents，更稳定兼容) * Manual AFK Mode: Optimized filtering algorithms for higher precision. (优化过滤算法，更准确高效) * Manual AFK Mode: Native compatibility with Folia. (增加对 Folia 服务器的支持) * Manual AFK Mode: Added detection and handling for AFK fishing machines. (增加对自动钓鱼机的检测和处理) * Manual AFK Mode: Added `/afk` command for manual AFK mode that persists regardless of player movement. (新增/afk命令，提供手动AFK模式，不受玩家移动影响)

---

> [!IMPORTANT] > * uncompressed You uncompressed install uncompressed for this plugin to function. (必须安装 PacketEvents 插件) > * uncompressed Traffic statistics represent uncompressed data. Actual billed bandwidth may differ due to server-side compression. (统计信息为未压缩流量，实际流量因服务器压缩配置会有所出入)

---

Features | 功能

1. Dynamic View Distance | 动态视距

* Lowers client-side view distance for AFK players without affecting server-side simulation distance. * 降低 AFK 玩家的客户端视野距离，不影响服务器模拟距离，减少区块数据传输。

2. AFK Detection | AFK 检测机制

* Manual AFK Mode: Monitors camera rotation (Default: 300s). 基于视角移动检测（默认 300 秒）。 * Manual AFK Mode: Automatically restores traffic flow upon taking damage or using teleport commands (`/tp`, `/spawn`, `/home`, etc.). 受到攻击或使用传送命令时自动退出 AFK 模式。 * Manual AFK Mode: Compatible with AFK pools and auto-clickers. 支持自动攻击和 AFK 池。 * 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. 手动AFK模式：玩家可使用/afk命令进入手动AFK模式，不受玩家移动影响。再次使用/afk或重新加入游戏可退出。

3. Packet Filtering | 数据包过滤详情

* Special Handling for AFK Fishing | 自动钓鱼机特殊处理: * Animations, Block break, Sounds, Particles, Explosions, Time sync, Light updates, TAB list headers/footers, World events, Potion effects, Map data, etc. * 动画、方块破坏、声音、粒子、爆炸、时间同步、光照更新、TAB 列表、世界事件、药水效果、地图数据等。 * Special Handling for AFK Fishing | 自动钓鱼机特殊处理: * Special Handling for AFK Fishing | 自动钓鱼机特殊处理: Entity movement, Position, Velocity, Experience orbs. (实体移动/位置/速度、经验球) * Special Handling for AFK Fishing | 自动钓鱼机特殊处理: Entity metadata. (实体元数据) * Special Handling for AFK Fishing | 自动钓鱼机特殊处理: Head orientation. (实体头部朝向) * Special Handling for AFK Fishing | 自动钓鱼机特殊处理: * When a player holds a fishing rod, certain packets (sound effects, entity velocity/movement) are allowed to pass through to support fishing activities. * 当玩家手持钓鱼竿时，某些数据包（声音效果、实体速度/移动）会被允许通过，以支持钓鱼活动。

---

Commands & Permissions | 命令与权限

| Command | Description | | :--- | :--- | | `/bandwidthsaver` | View bandwidth saving stats (查看流量节省统计) | | `/bandwidthsaver unfiltered` | View raw consumption (查看实际消耗统计) | | `/bandwidthsaver reload` | Reload configuration (重载配置) | | `/afk` | Toggle manual AFK mode (切换手动AFK模式) |

| Permission | Description | | :--- | :--- | | `bandwidthsaver.bypass` | Bypass AFK detection (绕过 AFK 检测) | | `bandwidthsaver.admin` | Access admin commands (管理员权限) |

---

Configuration | 配置文件

```yaml

Calculate all packets (required for /bandwidthsaver unfiltered)

calcAllPackets: true

Dynamically modify player view distance when AFK

modifyPlayerViewDistance: false

AFK threshold in seconds

afkPerspectiveThresholdSeconds: 300

Enable console logging for filtering details

debug: false

message: playerEcoEnable: '§a🍃 ECO 节能模式已启用，限制数据传输，可能会看着卡顿，实际正常，不会影响机器运行' playerEcoDisable: '§8🍃 ECO 节能模式已停用，数据传输将恢复正常' bossbar: eco-enabled-title: "<green><bold>🍃 ECO 节能模式</bold> <gray>|</gray> <yellow>⬇ 已暂停高频数据传输</yellow> <gray>|</gray> <white>↔ 轻晃视角以恢复</white>" eco-enabled-health: 1.0 eco-enabled-color: "YELLOW" # YELLOW, BLUE, RED, GREEN, PINK, WHITE, PURPLE, or ORANGE eco-enabled-overlay: "PROGRESS" # PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, or NOTCHED_20