速度效果功能文档
功能概述
速度效果是 EsbpmPlugin 提供的自动增益功能，为所有玩家提供可配置的移动速度加成。此功能特别适用于需要加快玩家移动速度的服务器，如大型探索服务器或竞速服务器。
配置项
速度效果的配置位于插件配置文件 plugins/EsbpmPlugin/config.yml 中的 speed-effect 部分：
yaml
# 速度效果设置
speed-effect:
# 是否启用速度效果
enabled: true
# 速度等级 (1-5)
level: 2配置说明
- speed-effect.enabled：设置为
true时，启用自动速度效果；设置为false时，禁用此功能 - speed-effect.level：设置速度效果的等级，范围为 1-5，数值越大，速度加成越高
速度等级效果对照表
| 等级 | 速度加成 | 实际移动速度（相对默认） |
|---|---|---|
| 1 | 20% | 1.2x |
| 2 | 40% | 1.4x |
| 3 | 60% | 1.6x |
| 4 | 80% | 1.8x |
| 5 | 100% | 2.0x |
效果应用机制
自动应用时机
速度效果会在以下时机自动应用：
- 玩家加入服务器时：玩家首次连接到服务器时，系统会立即为其应用配置的速度效果
- 玩家切换世界时：当玩家从一个世界移动到另一个世界时，系统会重新应用速度效果
- 插件重载时：如果通过插件管理器重载插件，所有在线玩家的速度效果会被重新应用
效果持续时间
- 速度效果的持续时间为 999999 秒（约 11.5 天），实际上等同于永久效果
- 效果会在玩家离开服务器时自动移除
- 玩家重新加入服务器时，系统会再次应用效果
技术实现细节
效果应用方法
- 插件使用 Minecraft 的
PotionEffect机制实现速度加成 - 具体效果为
PotionEffectType.SPEED，持续时间为 999999 秒 - 效果的等级由配置文件中的
speed-effect.level决定
事件处理
- 玩家加入事件 (
PlayerJoinEvent)：当玩家加入服务器时，系统会检查速度效果是否启用，如启用则为玩家应用效果 - 世界切换事件 (
PlayerChangedWorldEvent)：当玩家在世界间移动时，系统会重新应用速度效果以确保效果持续存在
最佳实践
根据服务器类型调整：
- 对于大型探索服务器，可以设置较高的速度等级（3-4级）
- 对于普通生存服务器，建议使用中等速度等级（2级）
- 对于PvP服务器，可根据平衡需求调整或禁用此功能
性能考虑：虽然速度效果对服务器性能影响较小，但在有大量玩家的服务器上，建议谨慎设置等级
玩家体验：过高的速度等级可能导致玩家体验不佳，特别是在建造或精细操作时
常见问题
Q: 如何临时禁用某个玩家的速度效果？ A: 当前版本不支持为特定玩家禁用速度效果。如需此功能，需要修改插件源代码或在未来版本中实现。
Q: 速度效果的最高等级是多少？ A: 配置文件中限制为5级，但实际上Minecraft支持更高等级，如需更高等级可修改插件源代码。
Q: 为什么我切换世界后需要重新应用速度效果？ A: 这是因为Minecraft在世界切换时可能会清除某些状态效果，插件通过重新应用来确保效果持续存在。