BandwidthSaver-PE

插件

· 作者 mangocraft

一个基于 PacketEvents 的节省服务器带宽的插件。

0 本站下载 0 关注 更新于 4 个月前

最新 3.6.6 · 26.3 · Bukkit / Folia

一键开服(送7天)

BandwidthSaver-PE

概述 | Overview

BandwidthSaver-PE 是一个基于 PacketEvents 框架构建的高性能带宽节流插件。由 Mangocraft Code Team 开发,它是 Ghost-chu 的旧版 RIABandwidthSaver 的现代复刻分支。

BandwidthSaver-PE 是一个基于 PacketEvents 的高性能节流插件。由 芒果方块的服务器开发制作组 基于 Ghost-chu 的旧版插件 RIABandwidthSaver 进行修改优化,旨在玩家处于 AFK 状态期间抑制不必要的数据包和区块发送,缓解服务器带宽压力。 当进入ECO模式时会通过BOSSBAR提醒 减少数据包展示Limit packet display. 在挂有大量实体的机器的时候,AFK省流效果最佳 (图片内文字均可在 config.yml 中修改,可自行翻译或自定义内容。All text within images can be modified in config.yml. Feel free to translate or customize the content.)

改进点 | Improvements

  • 现代框架: 从 ProtocolLib 切换至 PacketEvents,以获得更卓越的稳定性。(前置从 ProtocolLib 改为 PacketEvents,更稳定兼容)
  • 逻辑优化: 优化了过滤算法,提高了精确度。(优化过滤算法,更准确高效)
  • 支持 Folia: 原生兼容 Folia。(增加对 Folia 服务器的支持)
  • 修复 AFK 钓鱼: 增加了对 AFK 钓鱼机的检测和处理。(增加对自动钓鱼机的检测和处理)
  • 手动 AFK 模式: 新增 /afk 命令用于手动 AFK 模式,该模式不受玩家移动影响而持续生效。(新增 /afk 命令,提供手动 AFK 模式,不受玩家移动影响)
  • 超级省流模式: 新增 /afk super 和 /afk super always,可完全冻结区块和实体以实现最大程度的带宽节省。(新增超级省流模式和默认超级省流挂机偏好,实现最极限的宽带节省)
  • 安全性完善: 在超级 AFK 模式下锁定背包使用、丢弃物品和交互操作以防止 UI 不同步。死亡时(PlayerDeathEvent)自动退出以防止重生锁死。(全面锁定背包、丢弃与物品交互防刷防错乱;死亡立刻解除挂机,防止幽灵生存卡死)
  • 高并发查找: 使用 O(1) HashSet 进行数据包白名单匹配,以最小化密集 Folia 区域上的 CPU 周期消耗。(采用 O(1) HashSet 极速匹配包白名单,降低密集型 Folia 服务器开销)

[!IMPORTANT]

  • 依赖项: 你必须安装 PacketEvents 才能使此插件正常运行。(必须安装 PacketEvents 插件)
  • 关于统计数据的说明: 流量统计数据代表的是未压缩数据。由于服务器端的压缩配置,实际计费的带宽可能会有所不同。(统计信息为未压缩流量,实际流量因服务器压缩配置会有所出入)

功能 | Features

1. 动态视距 | Dynamic View Distance

  • 降低 AFK 玩家的客户端视距,而不影响服务器端的模拟距离。
  • 降低 AFK 玩家的客户端视野距离,不影响服务器模拟距离,减少区块数据传输。

2. AFK 检测机制 | AFK Detection

  • 基于视角: 监控摄像机旋转(默认:300秒)。基于视角移动检测(默认 300 秒)。
  • 自动退出: 受到伤害或使用传送命令(/tp, /spawn, /home 等)时自动恢复流量传输。受到攻击或使用传送命令时自动退出 AFK 模式。
  • 自动化友好: 兼容 AFK 池和自动点击器。支持自动攻击和 AFK 池。
  • 手动 AFK 模式: 玩家可使用 /afk 命令进入手动 AFK 模式,该模式不受玩家移动影响。再次使用 /afk 或重新加入游戏即可退出。手动 AFK 模式:玩家可使用 /afk 命令进入手动 AFK 模式,不受玩家移动影响。再次使用 /afk 或重新加入游戏可退出。
  • 超级省流模式: 通过 /afk super 切换。限制几乎所有传入的数据包(除了心跳、BossBar、聊天、断连和插件消息)。强制客户端在静态、冻结的世界中运行。退出后,玩家需要重新连接以刷新地形区块。超级省流模式:使用 /afk super 开启。拦截白名单(核心心跳、聊天、通道和断连)外的几乎所有封包。退出后需重连服务器以刷新区块。
  • 默认超级省流偏好: 通过 /afk super always 切换。记录在 super-always.yml 中,以便玩家在闲置时自动进入超级省流模式而非普通的 ECO 模式。注意: 自动进入的超级省流允许玩家通过头部移动或受到伤害来唤醒,而手动激活的 /afk super 只能通过命令或重新连接退出。在任何情况下,退出超级省流都需要重新连接以正确重载地形区块。默认超级省流偏好:通过 /afk super always 切换,记录于 super-always.yml 中。闲置超时后直接进入超级省流而非普通挂机。注意:超时自动进入的超级省流模式允许玩家通过晃动视角或受到伤害自动唤醒,而手动输入的 /afk super 则必须通过再次输入指令或重新登入退出。无论以何种方式退出超级省流,均需重连服务器以重载区块。

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

  • 已取消(100% 抑制)| Cancelled (100% Suppression):
    • 动画、方块破坏、声音、粒子、爆炸、时间同步、光照更新、TAB 列表页眉/页脚、世界事件、药水效果、地图数据等。
    • 动画、方块破坏、声音、粒子、爆炸、时间同步、光照更新、TAB 列表、世界事件、药水效果、地图数据等。
  • 节流(降低频率)| Throttled (Reduced Rate):
    • 2% 通过率: 实体移动、位置、速度、经验球。(实体移动/位置/速度、经验球)
    • 5% 通过率: 实体元数据。(实体元数据)
    • 20% 通过率: 头部朝向。(实体头部朝向)
  • AFK 钓鱼特殊处理 | Special Handling for AFK Fishing:
    • 当玩家手持钓竿时,某些数据包(音效、实体速度/移动)会被允许通过,以支持钓鱼活动。
    • 当玩家手持钓鱼竿时,某些数据包(声音效果、实体速度/移动)会被允许通过,以支持钓鱼活动。

命令与权限 | Commands & Permissions

命令 描述
/bandwidthsaver 查看带宽节省统计(查看流量节省统计)
/bandwidthsaver unfiltered 查看原始消耗(查看实际消耗统计)
/bandwidthsaver reload 重载配置(重载配置)
/bandwidthsaver admin add/remove <player> 将玩家添加或移除到自动超级省流名单(将玩家加入或移出自动超级省流名单)
/afk 切换手动 AFK 模式(切换手动 AFK 模式)
/afk super 切换手动超级省流模式(切换手动超级省流模式)
/afk super always 切换首选自动超级省流模式(切换超时自动进入超级省流偏好)
权限 描述
bandwidthsaver.bypass 绕过 AFK 检测(绕过 AFK 检测)
bandwidthsaver.admin 访问管理员命令(管理员权限)

配置文件 | Configuration

# 计算所有数据包(即启用 /bandwidthsaver unfiltered 的统计信息)
calcAllPackets: false
# 是否在挂机时动态修改玩家视距
modifyPlayerViewDistance: false
# 视角检测 AFK 阈值(秒),默认为 300 秒(5 分钟)
afkPerspectiveThresholdSeconds: 300
# 是否拦截 TAB 列表相关数据包 (默认为 true)
# 如果发现 TAB 列表不刷新、延迟 (Ping) 不更新或头衔显示错误,请将其设为 false
intercept-tab-list: true
# 是否拦截区块和光照数据包 
# 开启后可极大幅度节省流量,但退出 AFK 时可能产生只能重进才能加载的虚空区块,比较影响玩家体验
intercept-chunk-packets: false
# 退出 AFK 强制刷新区块时,是否兼容 PVDC 等动态视距插件 (仅在开启上一项时有效)
# 开启后,会延迟 2 秒等待 PVDC 结算视距,然后再进行"+1"的视距拉扯刷新,防止视距被锁死
compatible-with-pvdc: false
# ==========================================
# 作用世界设置(白名单机制)
# ==========================================
# 只有在以下列表中的世界,玩家才会进入省流模式。
# 像大厅 (lobby)、小游戏 (minigames) 等未在列表里的世界,会自动禁用省流功能。
enabled-worlds:
  - "world"
  - "world_nether"
  - "world_the_end"
# 调试模式开关,开启后会在控制台输出智能过滤区域信息
debug: false
# ==========================================
# 语言与提示信息设置
# ==========================================
# 你可以在下方翻译或自定义所有发送给玩家的提示信息。
message:
  playerEcoEnable: '§a? ECO 节能模式已启用,限制数据传输,可能会看着卡顿,实际正常,不会影响机器运行'
  playerEcoDisable: '§8? ECO 节能模式已停用,数据传输将恢复正常'
  playerSuperEcoEnable: '§c⚠️ [超级省流模式已启用] 仅限挂机,不能进行任何操作/有视角要求的行为,退出后需重连以刷新区块。'
  playerSuperEcoDisable: '§c⚠️ 您已退出超级省流模式!为了恢复周围区块和实体的正常加载,请重新进入服务器。'
  superEcoDisable_special: '§e检测到特殊状态 (睡觉/飞行/世界切换),已自动退出超级省流模式。为了恢复地形加载,建议重新进入服务器!'
  ecoDisable_special: '§e检测到特殊状态 (睡觉/飞行),已自动关闭省流模式。'
  superEcoDisable_death: '§c您已在挂机期间死亡,超级省流模式已自动解除!为了重新加载周围区块,请重新连接服务器。'
  ecoDisable_death: '§e您已在挂机期间死亡,已为您自动退出手动 AFK 模式。'
  superEcoDisable_teleport: '§e检测到传送,已为您自动退出超级省流模式。为了恢复地形加载,建议重新进入服务器!'
  ecoDisable_teleport: '§e检测到传送,已为您自动退出手动 AFK 模式以加载地形。'
  superEcoDisable_glide: '§e检测到展开鞘翅,已自动退出超级省流模式。为了恢复地形加载,建议重新进入服务器!'
  ecoDisable_glide: '§e检测到展开鞘翅,已自动退出省流模式。'
  player_only: '§c此命令只能由玩家执行!'
  superAlways_disabled: '§e已关闭自动超级省流挂机状态!当您达到设定的挂机时间时,将进入普通挂机模式。'
  superAlways_enabled: '§a已开启自动超级省流挂机状态!当您达到设定的挂机时间时,将直接进入超级省流模式。'
  superAlways_confirm1: '§c⚠️ [进入确认] 您即将开启默认超级省流挂机偏好!'
  superAlways_confirm2: '§e在超级省流模式下,所有需要挂机玩家物理操作(如点击攻击、手动使用/放置方块等)的挂机机器均无法工作。'
  superAlways_confirm3: '§e此模式仅适用于纯被动型机器(如刷铁机、农作物机、全自动刷怪塔等)。'
  superAlways_confirm4: '§e且每次挂机唤醒均需重新登入服务器刷新区块。'
  superAlways_confirm5: '§b若您确认要默认启用该模式,请在 3 分钟内再次输入指令: §a/afk super always'
  superEco_exit: '§a您已退出超级省流模式!'
  superEco_confirm1: '§c⚠️ [进入确认] 您即将进入手动超级省流挂机模式!'
  superEco_confirm2: '§e在此模式下,任何需要您物理操作(如点击攻击、手动使用/放置方块等)的挂机机器均无法正常工作。'
  superEco_confirm3: '§e此模式仅适用于纯被动型机器(如刷铁机、农作物机、全自动刷怪塔等)。'
  superEco_confirm4: '§e且退出后必须重新进入服务器才能加载刷新周围地形区块。'
  superEco_confirm5: '§b若您确认要开启,请在 3 分钟内再次输入指令进行二次确认: §a/afk super'
  eco_exit: '§a您已退出手动 AFK 模式!'
  eco_enter: '§e您已进入手动 AFK 模式!再次输入/afk 退出此模式。'
  no_permission: '§cYou don''t have permission to use this command!'
  admin_player_not_found: '§c未找到玩家或该玩家从未进入过服务器:%player%'
  admin_already_in_list: '§e玩家 %player% 已经在自动超级省流挂机列表中了!'
  admin_added_to_list: '§a已将玩家 %player% 添加到自动超级省流挂机列表中!'
  admin_target_added: '§a管理员已将您添加到自动超级省流挂机列表中!'
  admin_not_in_list: '§e玩家 %player% 不在自动超级省流挂机列表中!'
  admin_removed_from_list: '§a已将玩家 %player% 从自动超级省流挂机列表中移除!'
  admin_target_removed: '§e管理员已将您从自动超级省流挂机列表中移除!'
  admin_usage: '§c未知操作,请使用 /bandwidthsaver admin add/remove <player>'
  stats_eco_title: '§a? ECO 节能模式 - 统计信息:'
  stats_eco_packets: '§e共减少发送数据包:§b%count% 个'
  stats_eco_bytes: '§e共减少发送数据包:§b%size% (不包含视距优化的增益数据)'
  stats_eco_top_types: '§e -- 数据包类型节约 TOP 15 --'
  stats_eco_top_players: '§e -- 玩家流量节约 TOP 5 --'
  stats_uneco_title: '§a? UN-ECO - 数据总计 - 统计信息:'
  stats_uneco_packets: '§e共发送数据包:§b%count% 个'
  stats_uneco_bytes: '§e共发送数据包:§b%size%'
  stats_uneco_top_types: '§e -- 数据包类型 TOP 15 --'
  stats_uneco_top_players: '§e -- 玩家流量 TOP 5 --'
  reload_success: '§a? ECO - 配置文件已重载'
  stats_eco_type_item: '§7%type% - %count% 个 (%size%)'
  stats_eco_player_item: '§7%player% - %count% 个 (%size%)§a [挂机时长: %time%]'
  stats_uneco_player_item: '§7%player% - %count% 个 (%size%)'
# ==========================================
# Boss栏设置
# ==========================================
# 你可以在下方自定义上方 Boss 栏的显示。
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
  super-eco-enabled-title: "<red><bold>⚡ SUPER ECO 超级省流模式</bold> <gray>|</gray> <yellow>? 数据拦截最大化</yellow> <gray>|</gray> <white>⚠️ 退出后需重连刷新区块</white>"
  super-eco-enabled-health: 1.0
  super-eco-enabled-color: "RED"
  super-eco-enabled-overlay: "PROGRESS"

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源