- ◆ 游戏版本
- 1.12.2
- ◆ 服务端核心
- CatServer
- ◆ 前置/依赖
- HybridServerSpawn, HybridServerAPI
- ◆ 模组加载器
- Forge
- ◆ 原作者
- leu
HybridServerSpawnAddon · 刷神功能扩展
保底机制 | 庆祝特效 | 神兽高亮 | 神兽事件 | 传送与强制刷新 | PAPI变量
作者:leu
保底机制 | 庆祝特效 | 神兽高亮 | 神兽事件 | 传送与强制刷新 | PAPI变量
作者:leu
适用环境:CatServer 1.12.2 · 前置:HybridServerSpawn + HybridServerAPI · 软依赖
laceholderAPI
laceholderAPI▎插件简介
HybridServerSpawnAddon 是 HybridServerSpawn 刷神插件的功能扩展附属,核心功能为保底机制:每次原插件刷神时,附近符合条件的玩家保底计数 +1,达到阈值后自动触发保底强制刷神,长期不出神兽的玩家必定能刷到一只。在此基础上,插件还提供刷新庆祝特效、神兽与玩家双高亮、按日期或周几锁定神兽形态与材质的神兽事件、神兽传送、管理员强制刷新以及丰富的 PAPI 变量。插件纯事件驱动,所有 Pixelmon 操作走运行时反射,编译期零 NMS 依赖,兼容 CatServer 发布版,轻量化无卡顿。
▎核心功能一览
| 功能 | 说明 |
| ★ 保底机制 | 每次原插件刷神给附近玩家保底 +1,达到阈值自动触发保底强制刷神。支持阈值、计数半径、触发时机(下次原刷神/立即)、成功/失败是否消耗、命中就绪玩家时触发或重置等配置,数据持久化到 guaranteed.yml,提供 PAPI 变量与管理指令 |
| 刷新庆祝特效 | 神兽刷新时播放粒子、音效、闪电,全部可配置开关与类型 |
| 神兽+玩家双高亮 | 刷新瞬间给目标玩家和神兽加发光粒子,防止找不到神兽 |
| 神兽事件 | 按指定日期或周几从列表随机抽取神兽,锁定当日该物种刷新的形态(form)与材质(texture),玩家上线自动播报 |
| 神兽传送 | /hstp 传送到最近仍存活的神兽,支持冷却、坐标偏移、仅本人可传开关 |
| 强制刷新 | /hsaddon forcespawn [玩家] 管理员强制刷神,复用主插件反射接口 |
| PAPI变量 | 提供下次刷新倒计时、当前几率、今日已刷数、上只神兽、玩家幸运值、今日事件神兽、保底进度等变量 |
▎保底机制详解
| 配置项 | 默认值 | 说明 |
| guaranteed.threshold | 10 | 保底达到多少次后触发强制刷神 |
| guaranteed.nearby-only | true | 仅给刷神位置附近的玩家计数,false 则全体在线且允许的玩家都计数 |
| guaranteed.radius | 128 | nearby-only 为 true 时的计数半径(格) |
| guaranteed.trigger-on-next-original-spawn | true | 达到阈值后等待下一次原插件刷神再触发,false 则立即强制刷神 |
| guaranteed.consume-on-success | true | 保底触发成功后是否清零 |
| guaranteed.consume-on-fail | true | 保底触发失败后是否清零 |
▎运行安全机制
| 机制 | 说明 |
| 事件钩子 | 监听 PokemonSpawnPost (MONITOR 优先级),不干扰原插件刷神流程 |
| 保底防递归 | 保底触发期间屏蔽该玩家的原刷神事件,volatile 标志位防并发,避免保底刷神连锁触发 |
| NMS反射 | 所有 Pixelmon 实体操作运行时反射调用,编译期零 NMS 依赖,兼容 CatServer 发布版 |
| 方法缓存 | 反射 Method 存入 ConcurrentHashMap,避免重复 getMethod 与 setAccessible |
| 异常保护 | 所有反射与事件调用外层 try/catch,异常吞掉不崩服 |
| 跨天检测 | 每 60 秒检查日期,神兽事件跨天自动重新抽取并全服广播 |
| 数据持久化 | 神兽事件存入 event-data.yml,保底计数存入 guaranteed.yml,重载不丢失 |
| 定时任务 | 所有任务有界且 onDisable 时取消,无内存泄漏 |
▎命令与权限
| 命令 | 说明 |
| /hsaddon guaranteed get [玩家] | 查看玩家保底值与就绪状态 (hybridserverspawnaddon.admin) |
| /hsaddon guaranteed set <玩家> <值> | 设置玩家保底值 (hybridserverspawnaddon.admin) |
| /hsaddon guaranteed reset [玩家] | 重置玩家保底 (hybridserverspawnaddon.admin) |
| /hsaddon forcespawn [玩家] | 强制刷神 (hybridserverspawnaddon.admin) |
| /hsaddon reload | 重载配置 (hybridserverspawnaddon.admin) |
| /hstp | 传送到最近神兽 (hybridserverspawnaddon.teleport) |
