SpeedCheck速度检测插件

SpeedCheck 是一款专为 Minecraft 服务器设计的移动速度检测与动态减速插件，能够智能识别玩家异常移动行为，并通过渐进式减速机制替代传统的警告 / 踢出惩罚，提供更友好的反作弊体验。插件支持 Paper/Spigot 服务器，兼容 Minecraft 1.16-1.20 版本，通过配置文件可灵活调整检测灵敏度和惩罚力度。

核心功能特点
智能速度检测

实时计算玩家移动速度，精准识别加速作弊行为
支持忽略飞行玩家、创造模式玩家等特殊场景
可配置检测间隔（默认 1 秒）和最大允许速度（默认 5 方块 / 秒）
动态减速惩罚

首次超速自动施加轻度减速（可配置），多次违规逐步增加惩罚力度
采用药水效果实现减速，不影响玩家正常操作体验
支持惩罚自动恢复机制，玩家停止违规后速度逐步回升
灵活配置系统

全功能配置文件，支持自定义减速比例、恢复速率等参数
可排除特定玩家或世界免受检测
支持多语言消息提示（通过颜色代码实现）
管理命令

/speedcheck reload - 重新加载配置文件
/speedcheck status - 查看插件状态和被减速玩家
/speedcheck reset <玩家> - 手动清除玩家减速惩罚
安装与部署
环境要求

Paper/Spigot 服务器（1.20 版本）
Java 21 + 运行环境
Maven 构建工具（用于编译插件）
部署步骤

bash

# 1. 下载插件JAR包（或自行编译）
# 2. 将插件放入服务器plugins目录
# 3. 重启服务器自动加载
# 4. 配置文件生成于plugins/SpeedCheck/config.yml
AI写代码
编译指南
如需自定义插件功能，可通过 Maven 编译：

xml

<!-- pom.xml关键配置 -->
<dependencies>
    <dependency>
        <groupId>io.papermc.paper</groupId>
        <artifactId>paper-api</artifactId>
        <version>1.20.6-R0.1-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
</dependencies>
<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
</build>
AI写代码


编译命令：mvn clean package

配置文件详解
yaml

# 核心检测配置
check-interval: 20          # 检测间隔(1秒)
max-speed: 5.0              # 最大允许速度(5方块/秒)

# 速度惩罚配置
penalty:
  base-reduction: 0.1         # 首次减速比例(10%)
  max-reduction: 0.5          # 最大减速比例(50%)
  increase-step: 0.1          # 每次违规增加的减速比例
  recovery-delay: 15          # 开始恢复的延迟时间(15秒)
  recovery-rate: 0.03         # 每秒恢复的减速比例

# 消息配置
warning-message: "&c你移动速度过快，已被减速！"
AI写代码

插件优势对比
特性        SpeedCheck 插件        传统反作弊插件
惩罚机制        动态减速，逐步恢复        警告 + 踢出 / 封禁
玩家体验        平滑过渡，减少误判影响        可能导致突然断开连接
配置灵活性        全参数可调整        配置复杂，新手难上手
服务器性能影响        低负载，仅监控移动事件        高负载，全行为追踪
使用场景建议
PVP 服务器：建议将max-speed设为 4.5，base-reduction设为 0.15，平衡竞技性与反作弊需求
生存服务器：max-speed设为 5.5，recovery-delay设为 30 秒，减少正常跑图误判
公益服管理：启用excluded-players配置，允许管理员测试时不受检测
常见问题与解决方案
玩家反馈移动卡顿

检查penalty.max-reduction是否过高（建议不超过 0.7）
增加recovery-rate值（如从 0.03 调整为 0.05）加快恢复速度
插件无法加载

确认服务器为 Paper/Spigot 类型
检查 Java 版本是否为 21+（使用java -version命令）
查看服务器日志中是否有类缺失错误，确保依赖正确打包
减速效果未生效

执行/speedcheck status查看被减速玩家列表
检查配置文件中penalty.base-reduction是否大于 0
确认玩家未处于创造模式或飞行状态
插件命令与权限
命令格式        功能描述        所需权限
/speedcheck        显示帮助菜单        speedcheck.admin
/speedcheck reload        重新加载配置文件        speedcheck.admin
/speedcheck status        查看插件状态        speedcheck.admin
/speedcheck reset <玩家>        清除玩家减速惩罚        speedcheck.reset

感谢楼主分享