# 网络优化配置

位置：config/Network.yml（Kitin 体系 YAML，移植自 Kitin）。多数项可 /nekobackend reload，多端口监听需重启。

## network.chunk-lazy-loading — 区块惰加载（默认 true）

玩家在小范围反复横跳时不重复重发已加载的地形区块包，省地形带宽。

- network.chunk-lazy-loading（默认 true）：是否启用区块惰加载。

## network.reduce-high-frequency-entity-sync-packets — 高频实体同步包减量

某些实体（农场里的船/矿车、潜影贝）静止时也每 tick 强制同步，浪费带宽；此项改为按需同步。

- entitys（默认 $AbstractMinecart, $AbstractBoat, shulker）：要减量的实体列表。$AbstractMinecart=所有矿车，$AbstractBoat=所有船，其余写实体 id（支持 * 通配、# 标签）。

## network.particle — 粒子限流打包

领地特效/大量粒子刷屏时，先做视野/距离/遮挡剔除再打包发送。

- player-max-particles-per-packet（默认 250）：单包最多携带粒子数，超出拆包。
- player-min-optimize-threshold（默认 50）：单次粒子数超此值才启动优化。
- global-max-delay-ticks（默认 10）：粒子打包最大延迟 tick，攒一攒一起发。
- global-max-packet-particles-per-tick（默认 499）：每 tick 全局最多发送粒子总数。

## network.chunk-send — 区块发送限速 + QoS

控制区块包发送速率，并可按 IP/域名/线路分组限流。

- use-vanilla-chunk-sender（默认 false）：true=用原版区块发送器（关闭 Neko 限速与 ACK 发送器），排查兼容问题时可开。
- global-max-chunk-send-rate（默认 -1）：全局每秒最大区块发送数，-1=不限。
- global-chunk-send-burst-factor（默认 0.05）：突发因子，允许短时超速的比例。
- qos-groups（默认空）：分组限流。每个命名段一组，子选项：rate（该组每秒上限，-1不限）、bind-address（匹配本地绑定 IP）、upstream（上游线路标识）、virtual-host（匹配域名）。例：给 FRP 入口和直连分别限速。

## network.extra-listeners — 多端口监听（需重启）

额外监听端口，每个端口可单独配 PROXY Protocol v2，让 FRP 与直连共存。

- port（必填）：监听端口 0~65535。
- bind-address（默认 0.0.0.0）：绑定地址。
- proxy-protocol（默认 false）：该端口是否启用 PROXY Protocol v2（FRP 等需要）。
- 注意：启动时绑定 socket，不可热重载，改完需重启。

## 实时带宽监控

/nekobackend bandwidth 显示当前 Mbps、峰值、本次累计出站用量。
