技能检定

Skill Check

一个功能完整的PVP竞技场系统，包含会话管理、装备配置、怪物波次、数据统计和完整的游戏内管理界面。该系统基于独立空间运作，您将被传送至竞技场。无需担心物品栏清理或忘记原位置，每场比赛结束后您将被安全送回原位置并恢复物品栏。

快速上手

1. 将文件复制到您的mods文件夹——以下文件：
   • 主JAR — skillcheck-x.x.x.jar
   • 资源包 — SkillCheckAssetPack.zip 点击此处
   • HUD — 您还需要这个 — MultipleHUD by BuuZ135
2. 确保它们在你进入世界时加载（进入前右键编辑世界并勾选这些mod）。保存。
3. 游戏中输入 /skillcheck play
4. 选择快速会话（左侧）
5. 选择玩家数量
6. 点击姓名旁的"准备"（中上方）
7. 开始会话（右下角）
8. ？？？
9. 开始游戏。

功能

PVP竞技场模式

玩家们在自定义竞技场中进行结构化1v1或团队对抗赛。会话流程包括邀请、队伍分配、赛前倒计时、实时战斗和结果展示。

怪物模式

队伍需应对可配置的敌方波次，难度逐步提升。每波增加怪物生命值和伤害，并通过粒子光环效果直观显示威胁等级。波次模板可通过管理界面完全自定义。

装备配置

管理员可定义全局装备，包含特定物品、工具和武器。玩家在赛前选择装备。消耗品会在波次间补充，不会覆盖游戏中拾取的物品。支持锁定装备，用于预设玩家无法修改的固定配置。

会话管理

完整的会话生命周期：邀请、接受/拒绝、倒计时、实时战斗和结果展示。会话所有者可提前结束会话。结果区分胜利、失败和手动终止。断线宽限期保护进行中的会话。

数据统计

比赛结果持久化存储至数据库。玩家可查看生涯数据和最近会话历史。插件追踪击杀、死亡、伤害输出与承受、移动距离以及胜/负记录。

游戏内管理界面

所有配置通过自定义游戏内界面完成，输入 /skillcheck admin 即可使用——创建竞技场、配置出生点、定义战利品表、设置怪物波次、管理装备以及控制活跃会话。无需编辑配置文件。

管理控制

竞技场创建、装备设置、宝箱战利品、天气循环。可通过 config.json 全局禁用本地世界的权限。可选的管理员检查HUD可在持有管理工具时显示方块和竞技场元数据。

UI页面

玩家页面

竞技场浏览器 — /skillcheck play

玩家的主要集散地。顶部标签页可切换视图。

• 大厅 — 若处于活跃会话中，将在此显示。
• 快速会话 — 以最少设置直接进入比赛。
• 创建会话 — 完整构建一个游戏会话。
• 会话预设 — 从已保存配置开始会话。
• 查看个人资料 — 查看当前会话大厅和队伍分配。
• 排行榜 — 查看按击杀、胜利等排名的顶级玩家。
• 命令 — Skill Check的完整命令列表。
• 管理 — 仅管理员。管理Skill Check中的一切。

会话大厅

显示所有受邀玩家及其队伍分配。会话所有者可在所有人都准备好后开始比赛。

• 开始会话 — 开始比赛（仅限会话所有者）。
• 离开 — 退出大厅并拒绝会话。

结果

会话结束后显示最终计分板，包括击杀、死亡和结果。PVP和怪物模式均适用。

管理页面

管理枢纽 — /skillcheck admin

服务器管理员的核心面板。所有竞技场和插件管理从此处开始。

• 竞技场 — 创建、编辑和删除竞技场。
• 装备 — 管理玩家可用的全局装备配置。
• 宝箱战利品表 — 定义竞技场内宝箱生成的物品池。
• 怪物模板 — 定义竞技场内宝箱生成的物品池。
• 天气循环 — 配置竞技场的动态天气。
• 会话预设 — 所有之前玩过的会话配置在此。
• 设置 — 调整插件配置，包括数据库设置。
• 调试 — 查看诊断信息和会话状态。

竞技场配置

单个竞技场的配置中心。所有出生点、宝箱放置和游戏模式设置均在此管理。

• 玩家出生点 — 添加、编辑或移除玩家出生点。
• 怪物出生点 — 添加、编辑或移除怪物出生点。
• 宝箱位置 — 添加、编辑或移除宝箱生成位置。
• 删除竞技场 — 永久移除该竞技场（需确认）。

装备编辑器

基于槽位的物品栏编辑器，用于构建装备配置。每个槽位直接对应玩家物品栏中的一个位置。

• 保存 — 保存对装备的更改。
• 删除 — 移除该装备（需确认）。

战利品表编辑器

配置竞技场内宝箱可能出现的物品。每个条目都有可配置的掉落权重。

• 添加条目 — 向物品池添加新物品。
• 删除 — 移除此战利品表（需确认）。

波次模板编辑器

构建多波怪物遭遇战。每波可独立配置怪物类型、数量和规模。

• 添加波次 — 向模板追加新波次。
• 编辑波次 — 打开指定波次的配置编辑器。
• 移除波次 — 从模板中删除一波。
• 导出 — 导出此模板以分享或备份。
• 删除 — 移除此模板（需确认）。

设置

配置插件全局选项，包括数据库连接、权限开关和日志记录。

• 待恢复物品 — 查看和清除因崩溃或意外断线而排队的玩家物品栏恢复请求。

命令

命令前缀为 /skillcheck（别名：/sck）。

用户命令

命令	描述
/skillcheck play	打开主竞技场浏览器，开始或加入会话。
/skillcheck list	列出所有可用竞技场。
/skillcheck join	接受待处理的会话邀请。
/skillcheck decline	拒绝待处理的会话邀请。
/skillcheck last	重新打开上次查看的UI页面。

管理命令

命令	描述
/skillcheck admin	打开竞技场和会话管理界面。
/skillcheck create <名称>	在当前位置创建新竞技场。
/skillcheck remove <名称>	按名称删除现有竞技场。
/skillcheck kits	管理全局装备配置。
/skillcheck settings	打开插件设置面板。

权限

权限可在 config.json 中完全禁用，将 permissions.enabled 设为 false 即可。禁用后，所有命令对所有玩家可用。

玩家权限

权限	描述
wolv21.skillcheck.play	访问主竞技场浏览器，开始或加入会话。
wolv21.skillcheck.list	列出所有可用竞技场。
wolv21.skillcheck.join	接受待处理的会话邀请。
wolv21.skillcheck.decline	拒绝待处理的会话邀请。
wolv21.skillcheck.last	重新打开上次查看的UI页面。

管理权限

权限	描述
wolv21.skillcheck.admin.*	授予所有管理权限。
wolv21.skillcheck.admin.manage	打开竞技场和会话管理界面。
wolv21.skillcheck.admin.create	创建新竞技场。
wolv21.skillcheck.admin.remove	删除现有竞技场。
wolv21.skillcheck.admin.kits	管理全局装备配置。
wolv21.skillcheck.admin.settings	打开插件设置面板。

数据库

Skill Check支持两种数据库后端用于数据统计和会话历史。后端在 config.json 的 database 部分选择。所有写入操作均为异步非阻塞。

H2（嵌入式）— 默认

无需外部数据库或设置。数据库文件在首次运行时自动创建。适用于单服务器设置和本地开发。

文件位置：<服务器根目录>/mods/Wolv21_SkillCheck/database/skillcheck.mv.db

MariaDB（外部）

适用于生产服务器或多实例设置。在 config.json 中配置连接。也可通过 /skillcheck settings 更新设置——任何数据库配置更改后需重启服务器。

"database": {
  "type":     "MARIADB",
  "host":     "localhost",
  "port":     3306,
  "database": "skillcheck",
  "username": "root",
  "password": "",
  "pool": {
    "minimumIdle":       2,
    "maximumPoolSize":   10,
    "connectionTimeout": 30000
  }
}