Spectrum反作弊系统 - 权限文档

📋 目录

• 权限概述
• 基础权限
• 管理权限
• 检查权限
• 惩罚权限
• 配置权限
• 数据权限
• API权限
• 调试权限
• 特殊权限
• 权限节点列表

🔍 权限概述

Spectrum反作弊系统采用了细粒度的权限控制体系，允许服务器管理员精确控制玩家和 staff 可以使用的功能。所有权限节点均以 spectrum. 为前缀，并与 LuckPerms 等权限管理插件完全兼容。

🚀 基础权限

基础权限允许用户使用Spectrum的基本功能，如查看帮助信息、检查插件状态等。

权限节点	描述	默认	包含命令
spectrum.use	允许使用Spectrum的基本功能	所有玩家	/spectrum, /spectrum help
spectrum.help	允许查看帮助信息	所有玩家	/spectrum help
spectrum.version	允许查看插件版本信息	所有玩家	/spectrum version
spectrum.about	允许查看插件关于信息	所有玩家	/spectrum about

🔧 管理权限

管理权限用于控制服务器管理员可以执行的高级操作，如重新加载配置、管理检测模块等。

权限节点	描述	默认	包含命令
spectrum.admin	授予所有管理权限（包含以下所有权限）	OP	所有管理命令
spectrum.setup	允许设置和配置Spectrum	OP	/spectrum setup
spectrum.reload	允许重新加载Spectrum配置	OP	/spectrum reload
spectrum.restart	允许重启Spectrum插件	OP	/spectrum restart
spectrum.toggle	允许启用/禁用Spectrum	OP	/spectrum toggle
spectrum.debug	允许启用/禁用调试模式	OP	/spectrum debug
spectrum.check	允许管理检测模块	OP	/spectrum check <enable/disable/list>
spectrum.punish	允许管理惩罚设置	OP	/spectrum punish <type/list>
spectrum.whitelist	允许管理白名单	OP	/spectrum whitelist <add/remove/list>
spectrum.bypass	允许绕过所有检测	OP	无

🔍 检查权限

检查权限用于控制玩家和 staff 可以查看和管理的检测相关功能。

权限节点	描述	默认	包含命令
spectrum.check.use	允许使用检查功能	所有 staff	/spectrum check <player>
spectrum.check.violations	允许查看玩家的违规记录	所有 staff	/spectrum logs <player>
spectrum.check.details	允许查看详细的检测结果	高级 staff	/spectrum inspect <player>
spectrum.check.alert	接收检测警报通知	所有 staff	无
spectrum.check.exempt	豁免特定类型的检测	特定玩家	无
spectrum.check.movement	控制移动相关检测的权限	所有 staff	/spectrum check movement <player>
spectrum.check.combat	控制战斗相关检测的权限	所有 staff	/spectrum check combat <player>
spectrum.check.visual	控制视觉相关检测的权限	所有 staff	/spectrum check visual <player>
spectrum.check.inventory	控制物品栏相关检测的权限	所有 staff	/spectrum check inventory <player>
spectrum.check.world	控制世界相关检测的权限	所有 staff	/spectrum check world <player>

⚖️ 惩罚权限

惩罚权限用于控制 staff 可以执行的惩罚操作。

权限节点	描述	默认	包含命令
spectrum.punish.use	允许使用惩罚功能	所有 staff	/spectrum punish <player> <type>
spectrum.punish.warn	允许警告玩家	所有 staff	/spectrum warn <player> [reason]
spectrum.punish.kick	允许踢出玩家	高级 staff	/spectrum kick <player> [reason]
spectrum.punish.tempban	允许临时封禁玩家	高级 staff	/spectrum tempban <player> <time> [reason]
spectrum.punish.ban	允许永久封禁玩家	管理员	/spectrum ban <player> [reason]
spectrum.punish.unban	允许解除封禁	管理员	/spectrum unban <player>
spectrum.punish.mute	允许禁言玩家	所有 staff	/spectrum mute <player> [reason]
spectrum.punish.tempmute	允许临时禁言玩家	高级 staff	/spectrum tempmute <player> <time> [reason]
spectrum.punish.unmute	允许解除禁言	高级 staff	/spectrum unmute <player>
spectrum.punish.custom	允许执行自定义惩罚	管理员	/spectrum custompunish <player> <action>

⚙️ 配置权限

配置权限用于控制可以修改Spectrum配置的权限。

权限节点	描述	默认	包含命令
spectrum.config.use	允许使用配置相关命令	管理员	/spectrum config
spectrum.config.view	允许查看配置	所有 staff	/spectrum config view
spectrum.config.edit	允许编辑配置	管理员	/spectrum config edit <key> <value>
spectrum.config.reset	允许重置配置	管理员	/spectrum config reset
spectrum.config.import	允许导入配置	管理员	/spectrum config import <file>
spectrum.config.export	允许导出配置	管理员	/spectrum config export <file>
spectrum.config.check	允许编辑检测配置	管理员	/spectrum config check <name> <key> <value>
spectrum.config.punishment	允许编辑惩罚配置	管理员	/spectrum config punishment <type> <key> <value>
spectrum.config.message	允许编辑消息配置	管理员	/spectrum config message <key> <value>
spectrum.config.notification	允许编辑通知配置	管理员	/spectrum config notification <type> <setting>

📊 数据权限

数据权限用于控制可以访问和管理Spectrum收集的数据的权限。

权限节点	描述	默认	包含命令
spectrum.data.use	允许使用数据相关命令	所有 staff	/spectrum data
spectrum.data.view	允许查看数据统计	所有 staff	/spectrum data stats
spectrum.data.player	允许查看玩家数据	所有 staff	/spectrum data player <player>
spectrum.data.clear	允许清除数据	管理员	/spectrum data clear <player/all>
spectrum.data.export	允许导出数据	管理员	/spectrum data export <type> <file>
spectrum.data.import	允许导入数据	管理员	/spectrum data import <type> <file>
spectrum.data.purge	允许清理过期数据	管理员	/spectrum data purge <days>
spectrum.data.backup	允许备份数据	管理员	/spectrum data backup
spectrum.data.restore	允许恢复数据	管理员	/spectrum data restore <backup>
spectrum.data.logs	允许查看日志数据	所有 staff	/spectrum data logs <player/time>

📡 API权限

API权限用于控制第三方插件可以访问的Spectrum API功能。

权限节点	描述	默认	用途
spectrum.api.use	允许使用基础API功能	允许	基础插件集成
spectrum.api.check	允许使用检测API	允许	创建自定义检测
spectrum.api.punish	允许使用惩罚API	允许	创建自定义惩罚
spectrum.api.data	允许使用数据API	允许	访问反作弊数据
spectrum.api.config	允许使用配置API	允许	修改反作弊配置
spectrum.api.event	允许使用事件API	允许	监听反作弊事件
spectrum.api.admin	允许使用管理员API	拒绝	执行高级操作

🔧 调试权限

调试权限用于控制可以使用Spectrum调试功能的权限。

权限节点	描述	默认	包含命令
spectrum.debug.use	允许使用调试功能	OP	/spectrum debug <player>
spectrum.debug.info	允许查看调试信息	OP	/spectrum debug info
spectrum.debug.logs	允许查看调试日志	OP	/spectrum debug logs
spectrum.debug.trace	允许跟踪检测过程	OP	/spectrum debug trace <player>
spectrum.debug.profile	允许性能分析	OP	/spectrum debug profile
spectrum.debug.verbose	允许详细调试输出	OP	/spectrum debug verbose <on/off>
spectrum.debug.dump	允许导出调试数据	OP	/spectrum debug dump <file>
spectrum.debug.inspect	允许检查内部状态	OP	/spectrum debug inspect <module>

💎 特殊权限

特殊权限用于控制一些特殊的功能和豁免权。

权限节点	描述	默认	用途
spectrum.bypass.all	绕过所有检测	OP	完全豁免所有检测
spectrum.bypass.movement	绕过移动检测	OP	豁免移动相关检测
spectrum.bypass.combat	绕过战斗检测	OP	豁免战斗相关检测
spectrum.bypass.visual	绕过视觉检测	OP	豁免视觉相关检测
spectrum.bypass.inventory	绕过物品栏检测	OP	豁免物品栏相关检测
spectrum.bypass.world	绕过世界检测	OP	豁免世界相关检测
spectrum.override	覆盖其他权限限制	OP	忽略其他权限检查
spectrum.notify	接收Spectrum通知	所有 staff	接收警报和通知
spectrum.silent	静默执行操作	管理员	执行操作不显示消息

📝 权限节点列表

以下是Spectrum反作弊系统的所有权限节点的完整列表，按功能分类：

基础权限

• spectrum.use
• spectrum.help
• spectrum.version
• spectrum.about

管理权限

• spectrum.admin
• spectrum.setup
• spectrum.reload
• spectrum.restart
• spectrum.toggle
• spectrum.debug
• spectrum.check
• spectrum.punish
• spectrum.whitelist
• spectrum.bypass

检查权限

• spectrum.check.use
• spectrum.check.violations
• spectrum.check.details
• spectrum.check.alert
• spectrum.check.exempt
• spectrum.check.movement
• spectrum.check.combat
• spectrum.check.visual
• spectrum.check.inventory
• spectrum.check.world

惩罚权限

• spectrum.punish.use
• spectrum.punish.warn
• spectrum.punish.kick
• spectrum.punish.tempban
• spectrum.punish.ban
• spectrum.punish.unban
• spectrum.punish.mute
• spectrum.punish.tempmute
• spectrum.punish.unmute
• spectrum.punish.custom

配置权限

• spectrum.config.use
• spectrum.config.view
• spectrum.config.edit
• spectrum.config.reset
• spectrum.config.import
• spectrum.config.export
• spectrum.config.check
• spectrum.config.punishment
• spectrum.config.message
• spectrum.config.notification

数据权限

• spectrum.data.use
• spectrum.data.view
• spectrum.data.player
• spectrum.data.clear
• spectrum.data.export
• spectrum.data.import
• spectrum.data.purge
• spectrum.data.backup
• spectrum.data.restore
• spectrum.data.logs

API权限

• spectrum.api.use
• spectrum.api.check
• spectrum.api.punish
• spectrum.api.data
• spectrum.api.config
• spectrum.api.event
• spectrum.api.admin

调试权限

• spectrum.debug.use
• spectrum.debug.info
• spectrum.debug.logs
• spectrum.debug.trace
• spectrum.debug.profile
• spectrum.debug.verbose
• spectrum.debug.dump
• spectrum.debug.inspect

特殊权限

• spectrum.bypass.all
• spectrum.bypass.movement
• spectrum.bypass.combat
• spectrum.bypass.visual
• spectrum.bypass.inventory
• spectrum.bypass.world
• spectrum.override
• spectrum.notify
• spectrum.silent

🚀 权限组设置建议

为了方便服务器管理，我们建议按照以下方式设置权限组：

玩家组 (Default)

spectrum.use
spectrum.help
spectrum.version
spectrum.about

辅助组 (Helper)

spectrum.use
spectrum.help
spectrum.version
spectrum.about
spectrum.check.use
spectrum.check.violations
spectrum.punish.use
spectrum.punish.warn
spectrum.punish.mute
spectrum.notify

管理员组 (Moderator)

spectrum.use
spectrum.help
spectrum.version
spectrum.about
spectrum.check.*
spectrum.punish.*
spectrum.data.use
spectrum.data.view
spectrum.data.player
spectrum.notify

高级管理员组 (Admin)

spectrum.use
spectrum.help
spectrum.version
spectrum.about
spectrum.check.*
spectrum.punish.*
spectrum.config.*
spectrum.data.*
spectrum.notify

超级管理员组 (Owner)

spectrum.*
spectrum.bypass.all

❓ 常见问题

Q: 如何给玩家授予特定的权限？

A: 使用LuckPerms等权限管理插件可以轻松地给玩家或组授予权限。例如，使用LuckPerms命令：

/lp user <玩家名> permission set spectrum.check.use true
/lp group admin permission set spectrum.punish.* true

Q: 如何检查玩家拥有哪些Spectrum权限？

A: 使用LuckPerms的权限检查功能：

/lp user <玩家名> permission check spectrum.

Q: 如何临时禁用某个玩家的所有Spectrum权限？

A: 可以使用否定权限：

/lp user <玩家名> permission set spectrum.* false

Q: 权限节点之间有什么继承关系吗？

A: 是的，某些权限节点会自动包含其他权限节点。例如，spectrum.admin 权限会包含所有管理相关的权限。同时，使用通配符 * 可以授予某个分类下的所有权限，如 spectrum.check.* 会授予所有检查相关的权限。

Q: 如何创建自定义的权限组合？

A: 可以创建自定义的权限组，并在组中添加所需的权限节点组合。例如，创建一个只负责处理作弊举报的组，只授予检查和警告权限，而不授予踢出或封禁权限。