SpawnFlow —— 基于TPS的动态实体生成调控插件
SpawnFlow 是一款专为 Minecraft 基岩版服务器设计的 LLSE 插件，它能根据服务器当前的 TPS（每秒游戏刻） 实时调整非玩家实体（生物）的生成概率。在服务器负载较高时自动减少实体数量，缓解卡顿；在负载恢复正常时恢复生成，保证游戏内容不受影响。一切都平滑、自动、无需人工干预。
为什么需要 SpawnFlow？
- 实体数量过多是导致服务器卡顿的主要原因之一。
- 传统的“限制总数”或“硬性阈值”要么过于僵化，要么无法应对瞬时负载变化。
- SpawnFlow 通过 动态概率拦截 实现 按需减负：越卡顿，拦截率越高；越流畅，拦截率越低。
主要特性
- 实时TPS监测：每 100 tick 采样一次，计算平滑的TPS平均值，避免瞬时波动干扰。
- TPS = 0 时拦截率接近 100%
- TPS = 10 时拦截率 50%
- TPS = 20 时拦截率接近 0%
- 白名单保护：村民、流浪商人、铁傀儡等关键 NPC 始终允许生成，保障基础游戏机制。
- 零配置，即装即用：无需任何命令或配置文件，加载后自动开始工作。
- 极致轻量：每次 tick 仅计数，每次生物生成仅做一次集合查询和随机判断，几乎不影响性能。
工作原理
- 每 tick 记录一次，累计 100 tick 后计算一次平均 TPS。
- 检查实体类型是否在白名单内，是则直接放行。
- 否则获取当前 TPS，通过 sigmoid 函数计算本次拦截的概率。
- 生成随机数，若小于概率则返回
false阻止本次生成。
修改这些参数后需要重启服务器或重载插件。
常见问题
Q：TPS 为 null 时会发生什么？A：插件刚加载的第一个采样周期内，TPS 暂为 null，此时默认使用 20（即不拦截），避免启动时误拦。首个周期结束后立即正常调节。
Q：支持哪些实体类型？
A：所有非玩家实体（包括怪物、动物、Boss等）均受调节，只有白名单内的三种 NPC 不受影响。若需添加更多白名单实体，可在源码的
SPAWN_WHITELIST 集合中自行添加。Q：拦截概率曲线可以自定义吗？
A：可以，通过修改
center 和 k 参数即可调整曲线形态。例如，若希望 TPS 低于 15 时就开始明显拦截，可将 center 改为 15。
开源与协议
- 本插件完全开源，遵循 MIT 协议。
- 欢迎二次开发，提交 PR 或 issue。
