安装后快速配置向导

📋 目录

• 配置流程概述
• 基础配置（必做）
• 核心检测配置（推荐）
• 惩罚系统配置（推荐）
• 消息系统配置（可选）
• 数据库配置（可选）
• 兼容性配置（可选）
• 配置完成后的测试
• 常见问题处理

🚀 配置流程概述

本向导将帮助您在安装Spectrum反作弊系统后，快速完成基础配置，使其能够正常工作并提供有效的反作弊保护。本向导适用于大多数服务器环境，如果您需要更详细的配置信息，请参考完整配置文档。

配置流程分为以下几个步骤：

1. 基础配置（必做）
2. 核心检测配置（推荐）
3. 惩罚系统配置（推荐）
4. 消息系统配置（可选）
5. 数据库配置（可选）
6. 兼容性配置（可选）
7. 配置完成后的测试

⚙️ 基础配置（必做）

基础配置是确保Spectrum能够正常运行的必要步骤，包括语言、性能模式等基本设置。

1. 语言设置

编辑plugins/Spectrum/config.yml文件，设置适合您服务器的语言：

# 基本设置
settings:
  # 语言设置 (可用: en, zh_CN, ru, es, fr, de)
  language: zh_CN

2. 性能模式设置

根据您的服务器性能情况，选择合适的性能模式：

# 性能设置 (低, 中, 高)
performance-mode: 中

• 低：适合性能较低的服务器，检测频率较低，资源占用较少
• 中：适合大多数服务器，平衡性能和检测效果
• 高：适合高性能服务器，检测频率较高，资源占用较多

3. 调试模式设置

在正常使用时，建议关闭调试模式：

# 是否启用调试模式
debug: false

4. 自动更新设置

如果您希望Spectrum能够自动检查更新，可以启用自动更新功能：

# 是否自动更新
auto-update: true

5. 控制台通知设置

设置是否在控制台显示违规通知：

# 控制台通知开关
console-notifications: true

🔍 核心检测配置（推荐）

核心检测配置将帮助您设置最重要的检测模块，提供基础的反作弊保护。

1. 移动检测配置

编辑plugins/Spectrum/checks.yml文件，配置移动检测模块：

# 移动检测配置
movement:
  # 飞行检测
  flight:
    enabled: true
    threshold: 0.7
    allow-elytra: true
    allow-creative: true
  # 速度检测
  speed:
    enabled: true
    walking-speed: 5.0
    sprinting-speed: 7.0
    ice-bonus: 0.3
  # 攀爬检测
  climb:
    enabled: true
    max-climb-speed: 1.5
    allow-ladders: true
    allow-vines: true

2. 战斗检测配置

配置战斗检测模块：

# 战斗检测配置
combat:
  # 自动攻击检测
  killaura:
    enabled: true
    threshold: 0.8
    max-angle: 45
  # 攻击距离检测
  reach:
    enabled: true
    max-reach: 3.1
    threshold: 0.5
  # 自动瞄准检测
  aimbot:
    enabled: true
    threshold: 0.8
    max-angle-deviation: 30

3. 数据包检测配置

配置数据包检测模块：

# 数据包检测配置
packets:
  # 异常数据包检测
  badpackets:
    enabled: true
    threshold: 5
  # 快速使用检测
  fastuse:
    enabled: true
    threshold: 10
    cooldown: 200

⚖️ 惩罚系统配置（推荐）

惩罚系统配置将帮助您设置违规行为的惩罚措施。

1. 全局惩罚设置

编辑plugins/Spectrum/punishments.yml文件，设置全局惩罚参数：

# 全局惩罚设置
global:
  # 违规阈值（达到此值将执行惩罚）
  threshold: 5
  # 惩罚冷却时间（秒）
  cooldown: 300
  # 是否异步执行惩罚
  execute-async: true

2. 具体惩罚设置

为不同类型的违规设置具体的惩罚措施：

# 具体惩罚设置
punishments:
  # 警告惩罚
  warning:
    enabled: true
    message: "&c[警告] 您的行为疑似作弊，请遵守服务器规则！"
  # 踢出惩罚
  kick:
    enabled: true
    message: "&c您因疑似作弊行为被踢出服务器！"
    # 达到此阈值执行踢出
    threshold: 5
  # 临时封禁惩罚
  tempban:
    enabled: true
    message: "&c您因作弊行为被临时封禁 {duration} 分钟！"
    duration: 30
    # 达到此阈值执行临时封禁
    threshold: 10
  # 永久封禁惩罚
  ban:
    enabled: true
    message: "&c您因严重作弊行为被永久封禁！"
    # 达到此阈值执行永久封禁
    threshold: 20

💬 消息系统配置（可选）

消息系统配置将帮助您自定义Spectrum发送的各种消息。

1. 游戏内通知设置

编辑plugins/Spectrum/messages.yml文件，设置游戏内通知参数：

# 游戏内通知设置
in-game:
  # 是否启用游戏内通知
  enabled: true
  # 通知前缀
  prefix: "&b[Spectrum] &r"
  # 通知颜色
  color: "&7"
  # 消息格式
  format: "{prefix}{color}{message}"

2. 管理通知设置

设置管理通知参数：

# 管理通知设置
admin:
  # 违规通知
  violation-alert:
    enabled: true
    message: "&c[Spectrum] &r玩家 {player} 在 {check} 检测中违规，VL: {vl}"
  # 惩罚通知
  punishment-alert:
    enabled: true
    message: "&c[Spectrum] &r玩家 {player} 因 {reason} 被 {punishment}！"

💾 数据库配置（可选）

数据库配置将帮助您设置Spectrum的数据存储方式。

1. 数据库类型选择

编辑plugins/Spectrum/config.yml文件，选择合适的数据库类型：

# 数据库设置
database:
  # 数据库类型 (sqlite, mysql, mongodb)
  type: sqlite

对于小型服务器，SQLite已经足够；对于中型或大型服务器，推荐使用MySQL或MongoDB。

2. SQLite配置（默认）

如果选择SQLite数据库，可以设置自动清理过期数据：

# SQLite 设置
sqlite:
  file: Spectrum.db
  # 自动清理过期数据（天）
  auto-purge-days: 30

3. MySQL配置（可选）

如果选择MySQL数据库，需要设置数据库连接信息：

# MySQL 设置
mysql:
  host: localhost
  port: 3306
  database: Spectrum
  username: root
  password: password
  ssl: false
  # 连接池设置
  pool:
    max-connections: 10
    min-connections: 2
    max-idle-time: 300

🔌 兼容性配置（可选）

兼容性配置将帮助您设置Spectrum与其他插件的兼容性。

1. 其他反作弊插件兼容

编辑plugins/Spectrum/compatibility.yml文件，设置与其他反作弊插件的兼容性：

# 其他反作弊插件兼容
other-anticheat:
  # 列出其他已安装的反作弊插件
  installed: []
  # 是否自动调整检测以避免冲突
  auto-adjust: true

2. 特殊服务器功能兼容

设置与特殊服务器功能的兼容性：

# 特殊服务器功能兼容
special-features:
  # 允许的飞行插件
  allowed-fly-plugins: []
  # 允许的速度插件
  allowed-speed-plugins: []
  # 允许的PvP增强插件
  allowed-pvp-plugins: []

3. 世界黑名单

设置不需要进行反作弊检测的世界：

# 世界黑名单
world-blacklist:
  enabled: false
  worlds: []

✅ 配置完成后的测试

配置完成后，您应该进行一些测试，确保Spectrum能够正常工作。

1. 重载配置

使用以下命令重载Spectrum的配置文件：

/Spectrum reload

2. 查看插件信息

使用以下命令查看Spectrum的基本信息，确认插件正常加载：

/Spectrum info

3. 运行自检

使用以下命令运行Spectrum的自检功能，检查插件是否正常工作：

/Spectrum test

4. 检查权限设置

确保服务器管理员拥有适当的权限，可以使用以下命令查看权限信息：

/Spectrum perms

5. 监控日志

观察服务器日志，确保没有与Spectrum相关的错误信息。

❓ 常见问题处理

服务器启动时出现错误

• 问题：服务器启动时出现"Cannot find main class"错误
• 解决方案：确保您的服务器使用Java 17或更高版本

插件无法正常加载

• 问题：插件无法正常加载或生成配置文件
• 解决方案：检查服务器日志，查看是否有错误信息；确保服务器有写入权限；尝试重新下载插件

检测模块出现误报

• 问题：某些检测模块频繁出现误报
• 解决方案：调整检测阈值（增加值可以降低检测严格程度）；考虑为特定玩家设置白名单；检查服务器延迟情况

服务器性能下降

• 问题：安装Spectrum后，服务器性能明显下降
• 解决方案：降低性能模式（将"高"改为"中"或"低"）；减少启用的检测模块数量；调整检测间隔；确保服务器有足够的资源

---

最后更新时间：2025年10月2日