PxEffect

插件

· 作者 Pawan

每 2 分钟,信件会随机切换增益与减益效果

0 本站下载 0 关注 更新于 5 个月前

需要前置:PlaceholderAPI、LuckPerms、WorldGuard

最新 1.0.0 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

PxEffect Banner

每位玩家。每两分钟。未知的命运。

PXEffect 会按照可配置的间隔,自动为所有在线玩家施加随机的正面或负面药水效果——支持经验等级缩放、实时倒计时、丰富的统计功能以及深度的服务器集成。经过精心打磨,性能优异,可直接用于生产环境。






? 预览

? 动作栏倒计时 ? 效果通知 ? /pxeffect info
action bar notification pxeffect-info

? 截图 — 安装插件并分享你的截图!



✨ 什么是 PXEffect?

想象一下,你服务器上的每位玩家都随时可能获得一个速度提升——或者一个凋灵诅咒。PXEffect 让混乱成为你服务器的 DNA。

每隔 2 分钟(完全可配置),每个在线玩家都会获得一个随机选择的药水效果。经验等级越高?效果越强。倒计时实时显示在动作栏中。紧张感拉满。

无论你运行的是生存、小游戏、RPG 还是活动服务器——PXEffect 都能增添一层不可预测的能量,让玩家时刻保持警惕。



? 核心特性


? 随机效果引擎

每个间隔从所有原版正面和负面药水效果中随机选择

  • ✅ 完整的正面效果池——速度、力量、生命恢复、夜视、吸收、幸运等
  • ✅ 完整的负面效果池——迟缓、虚弱、中毒、凋灵、失明、漂浮等
  • ✅ 独立切换正面和负面类别
  • ✅ 通过 config.yml 自定义效果池中包含哪些具体效果
  • ✅ 可配置效果的持续时间(以刻为单位)

⚡ 经验等级缩放

效果强度会自动根据玩家的经验等级进行缩放

? 经验等级 ? 效果强度
等级 0 – 9 I 级
等级 10 – 19 II 级
等级 20 – 29 III 级
等级 30 – 39 IV 级
等级 40+ V 级

在 config.yml 中完全自定义层级——设置你自己的范围和增幅器。


⏱️ 实时动作栏倒计时

玩家始终清楚下一次效果何时到来

Next Effect: 01:59
Next Effect: 00:45
Next Effect: 00:03
  • ? 每秒实时更新
  • ? 完全自定义格式,支持 MiniMessage
  • ? 支持十六进制颜色、渐变色和传统的 & 代码
  • ? 可按玩家或全局关闭

? 效果通知

当效果生效时,玩家会以清晰且时尚的方式收到通知:

  • ? 聊天消息——显示效果名称、等级以及是正面还是负面
  • ? 标题 + 副标题——戏剧性的屏幕公告(可配置淡入淡出时间)
  • ? 自定义音效——正面和负面效果使用不同的声音
  • ✨ 粒子爆发——在玩家位置产生视觉粒子效果
  • ? 所有消息均支持 MiniMessage 完全自定义

? Boss 栏显示 (可选)

屏幕顶部的可选倒计时 Boss 栏

  • 从所有 Bukkit Boss 栏颜色和样式中选择
  • 随着计时器倒数自动填充和耗尽
  • 标题完全由 MiniMessage 格式化
  • 可在配置中按服务器启用/禁用

? 统计系统

追踪服务器上发生的一切

统计项 描述
? 总效果数 历史上施加的所有效果
? 正面效果数 给予的正面效果总数
❤️ 负面效果数 给予的负面效果总数
? 最常见效果 出现频率最高的效果
  • 持久化存储到 stats.yml,跨服务器重启保留
  • 通过 /pxeffect info 查看
  • 通过 PlaceholderAPI 暴露数据


?️ 世界与区域控制

worlds:
  blacklist:
    - lobby
    - creative_world
  per-world:
    survival: true
    minigames: false

worldguard:
  region-blacklist:
    - spawn
    - safe_zone
    - shop_area
  • ? 世界黑名单——完全排除特定世界
  • ?️ 按世界切换——按世界逐个启用或禁用
  • ? WorldGuard 区域——处于黑名单区域内的玩家将被跳过


? 集成

集成 状态 功能说明
PlaceholderAPI ✅ 支持 7 个自定义 %pxeffect_...% 占位符
?️ WorldGuard ✅ 支持 区域黑名单
? Vault ✅ 支持 权限 API 桥接
? LuckPerms ✅ 支持 原生 Bukkit 委托
? bStats ✅ 内置 匿名使用指标统计

? PlaceholderAPI 占位符

占位符 返回值
%pxeffect_next_effect% 格式化倒计时 01:45
%pxeffect_next_effect_sec% 剩余原始秒数
%pxeffect_total_effects% 已应用的特效总数
%pxeffect_positive_effects% 正面特效数量
%pxeffect_negative_effects% 负面特效数量
%pxeffect_most_common% 最常触发的特效名称
%pxeffect_interval% 配置的时间间隔(秒)


? 命令

命令 描述 权限节点
/pxeffect reload 热重载整个插件 pxeffect.reload
/pxeffect info 查看统计、间隔和集成状态 pxeffect.use

别名: /pxe



? 权限

权限节点 默认值 描述
pxeffect.use ✅ 所有人 接收特效 + 使用 /pxeffect 命令
pxeffect.bypass ❌ 无 豁免所有特效
pxeffect.reload ? OP 重载插件配置
pxeffect.admin ? OP 完全管理员权限


⚙️ 配置亮点

general:
  interval: 120             # 特效触发间隔(秒)
  positive-effects-enabled: true
  negative-effects-enabled: true
  debug: false

action-bar:
  enabled: true
  format: "<gray>Next Effect: <gold>{time}"

xp-scaling:
  enabled: true
  tiers:
    - { min: 0,  max: 9,  amplifier: 0 }
    - { min: 10, max: 19, amplifier: 1 }
    - { min: 20, max: 29, amplifier: 2 }
    - { min: 30, max: 39, amplifier: 3 }
    - { min: 40, max: 999999, amplifier: 4 }

sounds:
  positive:
    sound: ENTITY_PLAYER_LEVELUP
    volume: 1.0
    pitch: 1.2
  negative:
    sound: ENTITY_WITHER_HURT
    volume: 0.8
    pitch: 0.8

? 首次运行时,插件内包含带有每个选项详细文档的完整配置文件。



⚡ 性能

PXEffect 专为支持 500+ 并发玩家 而设计:

  • ?️ 单一重复任务 — 一个每秒执行一次的调度器处理所有事务(冷却时间、动作栏、Boss 栏、特效触发)。无需为每个玩家创建独立任务。
  • ? 线程安全的统计信息 — 使用 AtomicLong 计数器,无需锁机制
  • ? 内存高效 — 使用 ConcurrentHashMap 存储冷却时间和 Boss 栏状态
  • ♻️ 热重载安全 — 在重载配置前优雅关闭调度器,然后重新启动
  • ? 仅阴影打包 bStats — 不包含不必要的捆绑库


? 安装步骤

1. 下载 PXEffect-1.0.0.jar
2. 将其放入你的 /plugins/ 文件夹中
3. 启动或重启服务器
4. 编辑 plugins/PXEffect/config.yml
5. 运行 /pxeffect reload

✅ 兼容 Spigot 1.20.4+、Paper 和 Purpur ✅ 需要 Java 17 ✅ 无需依赖项 — 所有集成均为可选



?️ 更新日志

v1.0.0 — 初始版本发布

  • ? 完整的随机特效引擎,包含正/负面特效池
  • ⚡ XP 等级缩放(5 个可配置层级)
  • ⏱️ 实时动作栏倒计时
  • ? Boss 栏显示
  • ? 标题、副标题、音效和粒子通知
  • ? 世界黑名单及按世界切换功能
  • ?️ WorldGuard 区域黑名单
  • ? PlaceholderAPI(7 个占位符)
  • ? Vault 集成
  • ? 带持久化的统计系统
  • ? 跨重启的冷却时间持久化
  • ? 通过 /pxeffect reload 实现完全热重载
  • ? 调试模式
  • ? bStats 指标统计
  • ? 更新检查器


? 支持与社区

遇到 Bug?有功能建议?或者只是想聊聊?

Discord: allay_gaming_x

在 GitHub 上提交 Issue 或在 Discord 上联系我们——响应迅速!




? 关于作者

Pawan — Minecraft 插件开发者,热衷于性能优化、细节打磨与玩家体验。

PXEffect 精心打造 —— 每一个配置选项、每一条消息、每一次集成都经过深思熟虑。



? Discord 在线状态

allay_gaming_x's Discord status


PXEffect v1.0.0 · Made with ❤️ by Pawan · MIT License

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源