SSkyPVP

PAPER 1.21.8 · JAVA 21

SkyPVP 2.3.0
完整使用教程

从首次安装、获取本地授权，到四个扩展的命令与日常维护。尖括号中的内容需要替换，方括号表示可选参数。

01 · DEPLOY

首次安装

  1. 安装 Java 21，准备干净的 Paper 1.21.8 服务端。
  2. 停止服务器，把 SkyPVP-Core.jar 放入 plugins/。
  3. 把四个扩展 JAR 放入 plugins/SkyPVPCore/plugins/；没有该目录时可先启动一次核心再停止服务器。
  4. 需要幸运方块自定义头颅时安装 HeadDatabase；需要变量时安装 PlaceholderAPI。
  5. 启动服务器并执行 /skypvp，确认 Core 2.3.0 与附属状态正常。
plugins/
├─ SkyPVP-Core.jar
└─ SkyPVPCore/
   ├─ config.yml
   ├─ addons/
   └─ plugins/
      ├─ SkyPVPKits.jar
      ├─ SkyPVPLuckyBlock.jar
      ├─ SkyPVPProgression.jar
      └─ SkyPVPWorldGuard.jar

02 · UPGRADE

升级到 2.3.0

  1. 执行 save-all flush，再执行 stop。
  2. 完整备份 plugins/SkyPVPCore/。
  3. 替换 plugins/SkyPVP-Core.jar 和扩展目录中的四个 JAR。
  4. 移走遗留的 *.jar1、*.jar2 或嵌套的 Addon.zip，避免重复加载。
  5. 不要覆盖现有 config.yml、addons/ 与玩家数据。
  6. 完整启动服务器并逐项验证状态页、职业、幸运方块、等级和世界保护。
2.3.x 暂时兼容旧版授权码，建议登录授权中心重新签发以 SKV2. 开头的新授权码。后续版本可在配置中关闭旧码兼容。

03 · LICENSE V2

获取与热更新 V2 授权

  1. 使用邮箱验证码登录授权中心；未购买账户也可按冷却时间领取免费试用。
  2. 执行 /skypvp 或查看启动日志，确认 Core 实际检测到的 IPv4 地址。
  3. 在账户页填写该地址，选择正式授权或试用并生成以 SKV2. 开头的授权码。
  4. 执行 /skypvp license apply <授权码> 立即验证、保存并生效；也可写入 plugins/SkyPVPCore/config.yml 后执行 /skypvp license reload。

一个账户同时只能绑定一个 IP。V2 使用 Ed25519 离线验签并在本地检查到期时间；远程不可用不影响有效授权，联网时会同步撤销状态。

04 · CORE

核心命令

命令用途权限执行者
/skypvp显示 Core、附属、授权与远程服务状态无玩家 / 控制台
/skypvp status完整状态页别名无玩家 / 控制台
/skypvp buy显示购买群、本机授权 IPskypvp.admin.buy玩家 / 控制台
/skypvp license status查看当前授权状态skypvp.admin.license玩家 / 控制台
/skypvp license reload从 config.yml 热加载授权码skypvp.admin.license玩家 / 控制台
/skypvp license apply <授权码>验证、保存并立即应用授权码skypvp.admin.license玩家 / 控制台
/skypvp reload <扩展名>安全重载一个扩展skypvp.admin.reload玩家 / 控制台

可重载的扩展名：SkyPVPKits、SkyPVPLuckyBlock、SkyPVPProgression、SkyPVPWorldGuard。

05 · KITS

职业模块

命令用途权限执行者
/skypvp kit <职业>领取职业skypvp.kit.<规范化职业名>玩家
/skypvp kit give <玩家> <职业>向在线玩家发放职业skypvp.admin.kit.give玩家 / 控制台
/skypvp setupkit <职业>把当前背包保存为职业skypvp.admin.setupkit玩家
/skypvp preview <职业>预览职业内容无玩家

职业名会规范化为小写字母、数字、下划线或短横线。职业发放时若背包已满，放不下的物品会掉落在玩家脚下。

06 · LUCKY BLOCK

幸运方块模块

命令用途
/skypvp luckyblock help显示帮助
/skypvp luckyblock add <奖池> <概率>把手中物品加入奖池；setup 为兼容别名
/skypvp luckyblock set <奖池> <刷新秒数> <HDB-ID>把 8 格内目标方块设为幸运方块
/skypvp luckyblock delete删除 5 格内最近的幸运方块
/skypvp luckyblock list [奖池]列出奖池或幸运方块
/skypvp luckyblock heal修复已加载区块中的方块；restore 为别名
/skypvp luckyblock debug [true|false]查看或切换调试模式

管理命令权限为 skypvp.admin.luckyblock，并兼容旧拼写 skypvp.admin.luckblock。概率可输入小数或百分比。set 需要有效 HeadDatabase ID；heal 只扫描已加载区块，每轮最多修复 4 个。

/skypvp luckyblock add default 25%
/skypvp luckyblock set default 300 <HDB-ID>
/skypvp luckyblock list default

非空奖池会按权重抽取；空奖池仍会触发既定事件与经验逻辑。管理 GUI 还可以配置彩色标题、倒计时、左旋或右旋以及旋转速度。

07 · PROGRESSION

成长模块

命令用途
/skypvp exp [me|在线玩家]查看自己或在线玩家的经验
/skypvp level [在线玩家]查看等级
/skypvp exp add <玩家> <数量> [原因]增加经验
/skypvp exp luckyblock <玩家>触发幸运方块经验奖励
/skypvp exp reload重载成长配置
/skypvp exp help显示成长模块帮助

管理命令权限为 skypvp.admin.exp。可用 PlaceholderAPI 变量：

%skypvp_level%%skypvp_level_display%%skypvp_level_raw%%skypvp_progress%%skypvp_progress_bar%%skypvp_exp_progress%

08 · WORLD PROTECTION

世界保护模块

命令用途
/skypvp worldguard editor切换当前世界的编辑/保护状态
/skypvp worldguard editor <世界>切换指定世界状态，可由控制台执行

所需权限：skypvp.admin.worldguard。修改后用实际玩家测试放置、破坏和交互行为。

09 · PERMISSIONS

权限汇总

skypvp.admin.statusskypvp.admin.licenseskypvp.admin.buyskypvp.admin.reloadskypvp.admin.guiskypvp.admin.kit.giveskypvp.admin.setupkitskypvp.admin.luckyblockskypvp.admin.expskypvp.admin.worldguardskypvp.kit.<职业>

10 · MAINTENANCE

维护与排错

  • 只改配置：使用对应模块的 /skypvp reload <扩展名>；成长模块也可用 /skypvp exp reload。
  • 更新 JAR：执行 save-all flush 与 stop，替换文件后完整启动。
  • 幸运方块异常：先用 list 确认登记，再用 heal 修复已加载区块，必要时开启 debug。
  • 玩家无法领取职业：检查动态权限、职业名和背包；满背包物品应掉到脚下。
  • 绝对不要使用 Bukkit/Paper 全局 /reload，它会造成监听器、任务和插件状态不一致。
上线检查：授权无报错、四个模块加载成功、职业发放、满背包掉落、幸运方块刷新、经验增长与世界保护均实测通过。
吉ICP备2023005418号