Paper、Folia 与热加载

Bukkit 原生实现

插件使用实体原生 SCALE 属性，不依赖仅用于视觉伪装的展示实体，也不需要客户端资源包。

Folia / Luminol

实体操作必须在实体所属区域线程执行。插件会按服务器类型选择对应调度方式，批量处理时也不会把全部实体修改塞进不安全的全局异步线程。

已加载实体扫描

apply-loaded-on-enable 会在插件启用后处理当前已加载动物。实体数量大的服务器可以关闭该选项，改用分批或明确时机执行的管理操作。

配置重载

/animalscale reload 只重载 config.yml 和 messages.yml：

• 新的自动倍率会用于之后的处理。
• 已经修改过的动物不会自动回滚。
• 白名单、黑名单变化不会自动扫描所有历史实体。

插件停用

停用监听器不会抹除实体已经保存的原生倍率。需要恢复时应主动执行 reset 或批量命令，并处理尚未加载的区块。

兼容验证

升级服务端后至少测试一只新生成动物、一只旧存档动物、单体命令、批量命令和区块重新加载。