从安装到排错，
都在这里。

安装与目录

Core JAR 放入服务器 plugins 目录；免费模块和已购买的付费扩展放入 SkyPVPCore/plugins。更新 JAR 后请完整重启，不要使用 Bukkit 全局 /reload。

plugins/
├─ SkyPVP-Core-2.4.0.jar
└─ SkyPVPCore/plugins/
   ├─ SkyPVPKits.jar
   ├─ SkyPVPLuckyBlock.jar
   ├─ SkyPVPProgression.jar
   ├─ SkyPVPWorldGuard.jar
   ├─ SkyPVP-Explosives.jar  # 付费可选
   └─ SkyPVP-CombatFX.jar    # 付费可选

授权与账户

邮箱就是账户 ID。登录后为产品绑定服务器公网 IPv4，并复制 SKV2 授权码。Core、Explosives 与 CombatFX 分别授权；需要换 IP 时联系管理员重置。已生效授权支持游戏内热更换。

/skypvp license apply SKV2.你的授权码

Dialog 与物品栏界面

执行 /skypvp 打开管理中心。状态、数值和文本优先使用 Paper 原生 Dialog；需要浏览或拖放物品的内容使用传统箱子菜单。

物品包 / Kits

在游戏内保存玩家穿戴和背包内容，支持预览、发放与 MythicMobs 物品。背包空间不足时，多余物品会掉落在玩家脚下。

幸运方块

每种方块可以配置奖池、权重、经验、彩色标题、倒计时、左旋或右旋、旋转速度和刷新点。空奖池或抽取未命中时，按配置执行掉落逻辑。

经验与成长 2.2.0

每个等级区间可独立配置颜色、名称、格式和符号；经验获得、升级和阶段提升分别使用可试听音效。连续奖励会合并提示，玩家也能关闭自己的音效或 ActionBar。

/skypvp admin
/skypvp exp sound
/skypvp exp sound exp off
/skypvp exp reload

主要变量：%skypvp_level_display%、%skypvp_level_tier_colored%、%skypvp_progress_bar%。完整示例请查看成长模块教程。

世界与保护

通过世界白名单或黑名单决定模块生效范围。编辑地图时启用管理员编辑模式，结束后及时关闭并检查玩家是否仍被正确保护。

Explosives

TNT 与火焰弹不会破坏方块。可分别设置自身与他人的伤害、水平/垂直击退、半径、冷却、粒子、音效和权限配置档。

CombatFX：云墨战迹

CombatFX 是战斗表现扩展。它监听最终有效攻击与玩家击败事件，播放主题特效并显示可配置的击败消息，但不修改伤害、击退、攻击冷却、无敌帧或死亡判定。玩家使用 Dialog 查看方案与可见性设置，再通过箱子菜单浏览、预览和装备收藏；管理员可以编辑主题、频道、消息、效果步骤、权限、世界与性能预算。

/skypvp combatfx
/skypvp combatfx admin
/skypvp combatfx preview <主题ID>
/skypvp combatfx reload
/skypvp combatfx license apply <授权码>

玩家入口使用 skypvp.combatfx.use，管理员入口使用 skypvp.combatfx.admin。运行中应用新授权码无需重启服务器。

CombatFX：主题、频道与权限

首发包含经典火花、烈焰余烬、霜华凝结、雷霆裁决、灵魂回响、虚空裂隙、樱落之刃和黄金胜者。六个频道分别是命中、暴击、终结、连胜、弹道和伤害读数。使用主题或频道级权限完成解锁，可接入 LuckPerms、商城、等级奖励或任务奖励。

skypvp.combatfx.theme.<主题ID>
skypvp.combatfx.hit.<特效ID>
skypvp.combatfx.kill.<特效ID>
skypvp.combatfx.trail.<特效ID>

CombatFX：击败消息 1.1

按近战、弹射物、爆炸、火焰、岩浆、摔落、虚空、魔法、窒息、自杀和其他共 11 类分别配置。每类支持多条消息随机展示，也可以单独关闭；自定义消息只改变聊天展示，不干预服务器死亡判定。

defeat-messages:
  enabled: true
  causes:
    melee:
      - "&e%victim% &7被 &c%killer% &7击败"
    projectile:
      - "&e%victim% &7没能躲开 &c%killer% &7的远程攻击"
    void:
      - "&e%victim% &7被 &c%killer% &7击落虚空"
    suicide:
      - "&e%victim% &7结束了自己的战斗"

变量包括 %killer%、%victim%、%weapon%、%world%、%distance%、%killer_health%、%killer_level% 和 %victim_level%。管理员可以在 Dialog 中直接编辑和预览消息池。

CombatFX：性能与兼容

集中式调度器统一推进动画；默认只向 32 格内玩家发送，并执行玩家、单 tick、全服三级预算。玩家可以只看自己的特效、减少粒子或关闭音效。OCM 与 Grim 继续负责战斗计算和检查；WorldGuard 可控制启用区域；隐身和旁观玩家不会因特效暴露位置。

performance:
  view-distance: 32
  per-player-budget: 120
  per-tick-budget: 1200
  server-budget: 6000
  hit-cooldown-ticks: 2

YAML 编辑规则

修改前先备份。只使用空格缩进，不要使用 Tab；字符串含冒号、# 或颜色符号时建议加引号。保存后使用对应模块的重载命令；更换 JAR 则完整重启。

故障排查

先执行 /skypvp 查看核心、附属、授权与远程服务状态，再检查控制台第一段异常。若提示授权无效，核对产品、绑定 IP、到期时间和授权码是否完整。