MatrixLight Docs

Appearance

Spectrum反作弊系统 - 安装指南 ​

本文档编写人员：QHBSSrl

📋 目录 ​

🛠️ 系统要求 ​

在安装Spectrum反作弊系统之前，请确保您的服务器满足以下要求：

基本要求 ​

  • Minecraft版本：1.17 - 1.21.8
  • 服务器平台：Bukkit/Spigot/Paper/Folia/Purpur/Pufferfish
  • Java版本：Java 17或更高版本
  • 服务器内存：至少2GB（推荐4GB以上）

推荐配置 ​

  • Minecraft版本：1.20+（获取最佳性能和功能）
  • 服务器平台：Paper或其分支（如Purpur、Pufferfish）
  • Java版本：Java 17或更高版本
  • 服务器内存：根据玩家数量和其他插件情况调整，推荐4GB以上

📥 标准安装 ​

标准安装适用于大多数服务器环境，是最简便的安装方式。

步骤1：下载插件 ​

从GitHub Releases页面下载最新的Spectrum.jar文件。

步骤2：安装插件 ​

  1. 将下载的Spectrum.jar文件复制到您的服务器的plugins文件夹中
  2. 如果是首次安装，无需进行额外操作
  3. 如果是从旧版本升级，请确保在升级前备份配置文件和数据

步骤3：启动服务器 ​

启动您的Minecraft服务器，Spectrum会自动加载并生成默认配置文件。

步骤4：验证安装 ​

服务器启动后，可以使用以下命令验证Spectrum是否成功安装：

/spectrum

如果安装成功，您将看到Spectrum的版本信息和基本命令列表。

🚀 高级安装 ​

高级安装适用于需要更多定制化配置的服务器环境。

步骤1：下载必要文件 ​

  1. 下载最新的Spectrum.jar文件
  2. 下载推荐的依赖插件（ProtocolLib、PacketEvents、Vault等）

步骤2：安装所有插件 ​

将Spectrum.jar和所有依赖插件复制到服务器的plugins文件夹中。

步骤3：启动服务器 ​

启动服务器，等待所有插件加载完成。

步骤4：运行设置向导 ​

使用以下命令启动交互式设置向导：

/spectrum setup

设置向导会引导您完成以下配置：

  • 语言设置
  • 性能模式选择
  • 数据库设置
  • 惩罚系统配置
  • 通知设置
  • 检查模块配置

步骤5：测试反作弊功能 ​

使用以下命令测试反作弊系统的功能：

/spectrum test

此命令会执行一系列测试，验证反作弊系统的各项功能是否正常工作。

⚙️ 首次配置 ​

Spectrum安装完成后，您可能需要进行一些基本配置以适应您的服务器环境。

配置文件位置 ​

Spectrum的配置文件位于服务器的plugins/Spectrum/目录下。主要配置文件包括：

  • config.yml：主配置文件，包含所有基本设置
  • checks.yml：检测模块配置文件
  • punishments.yml：惩罚系统配置文件
  • messages.yml：消息和语言配置文件
  • database.yml：数据库配置文件
  • performance.yml：性能优化配置文件

基本配置步骤 ​

  1. 查看当前配置：使用/spectrum reload命令重新加载配置
  2. 编辑配置文件：使用文本编辑器打开相应的配置文件进行修改
  3. 应用配置更改：保存文件后，使用/spectrum reload命令使更改生效

推荐初始配置 ​

对于新安装的Spectrum，我们建议进行以下初始配置：

  1. 设置语言：在messages.yml中选择适合您服务器的语言
  2. 调整性能设置：在performance.yml中根据服务器硬件配置调整性能参数
  3. 配置惩罚系统：在punishments.yml中设置适合您服务器规则的惩罚措施
  4. 启用/禁用检测模块：在checks.yml中根据服务器需求启用或禁用特定的检测模块

📦 依赖项管理 ​

Spectrum可能需要一些外部依赖来实现特定功能。以下是主要的依赖项及其用途：

可选依赖 ​

  • ProtocolLib：提供数据包处理能力，增强移动检测和战斗检测功能
  • PacketEvents：替代ProtocolLib的数据包处理库，在某些环境下性能更好
  • Vault：提供权限和经济系统集成，支持更多自定义惩罚选项
  • PlaceholderAPI：提供变量占位符支持，增强消息系统的灵活性
  • DiscordSRV：提供Discord集成，支持将违规通知发送到Discord频道

安装依赖项 ​

  1. 从官方网站或Spigot资源页面下载所需的依赖插件
  2. 将下载的jar文件复制到服务器的plugins文件夹中
  3. 重启服务器以加载依赖插件
  4. 使用/spectrum info命令检查依赖插件的状态

🔄 更新插件 ​

定期更新Spectrum反作弊系统可以获取最新的功能和安全更新。

自动更新 ​

Spectrum提供了内置的自动更新功能：

  1. 运行命令：/spectrum update check 检查是否有新版本
  2. 如果有新版本，运行：/spectrum update install 下载并安装新版本
  3. 重启服务器以完成更新

手动更新 ​

如果您更倾向于手动更新：

  1. 从GitHub Releases下载最新版本
  2. 备份现有的配置文件和数据
  3. 替换plugins文件夹中的Spectrum.jar文件
  4. 重启服务器
  5. 使用/spectrum version命令验证更新是否成功

更新注意事项 ​

  • 始终在更新前备份配置文件和数据
  • 某些版本更新可能需要重新配置某些功能
  • 查看更新日志了解版本变更内容

🗑️ 卸载插件 ​

如果您需要卸载Spectrum反作弊系统，请按照以下步骤进行：

标准卸载 ​

  1. 停止Minecraft服务器
  2. 从plugins文件夹中删除Spectrum.jar文件
  3. （可选）删除plugins/Spectrum/文件夹以清除所有配置和数据
  4. 重启服务器

保留数据的卸载 ​

如果您希望保留配置和数据以便将来重新安装：

  1. 停止Minecraft服务器
  2. 从plugins文件夹中删除Spectrum.jar文件
  3. 保留plugins/Spectrum/文件夹
  4. 重启服务器

数据清理 ​

如果您想完全清除Spectrum的所有痕迹：

  1. 卸载插件（如上文所述）
  2. 删除plugins/Spectrum/文件夹
  3. 如果使用了外部数据库，删除相应的数据库表或数据库

❓ 安装常见问题 ​

Q: 安装后使用/spectrum命令没有反应怎么办？ A: 请检查以下几点：

  • 服务器是否满足系统要求
  • 插件是否正确放置在plugins文件夹中
  • 服务器启动日志中是否有关于Spectrum的错误信息
  • 是否有其他插件与Spectrum冲突

Q: 为什么某些功能无法使用？ A: 一些高级功能可能需要安装相应的依赖插件，请确保已安装所需的所有依赖项。

Q: 安装后服务器性能下降怎么办？ A: 您可以在performance.yml中调整性能设置，如降低检测频率、禁用不必要的检测模块等。

Q: 如何确认所有检测模块都正常工作？ A: 使用/spectrum test命令运行自检，或使用/spectrum stats checks查看各检测模块的统计信息。

📞 获取支持 ​

如果您在安装过程中遇到任何问题，可以通过以下方式获取支持：

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

文档编写信息 ​

编写人员：QHBSSrl

Copyright © 2025-Shanghai MatrixLight Technology Co., Ltd. All rights reserved.