
每位玩家。每两分钟。未知的命运。
PXEffect 会按照可配置的间隔,自动为所有在线玩家施加随机的正面或负面药水效果——支持经验等级缩放、实时倒计时、丰富的统计功能以及深度的服务器集成。经过精心打磨,性能优异,可直接用于生产环境。
? 预览
✨ 什么是 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 在线状态

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

Every player. Every two minutes. A random fate.
PXEffect automatically applies random positive or negative potion effects to every online player at a configurable interval — with XP-level scaling, live countdowns, rich statistics, and deep server integrations. Polished, performant, and production-ready.
? Preview
✨ What is PXEffect?
Imagine every player on your server is constantly one tick away from receiving a Speed boost — or a Wither curse. PXEffect makes chaos part of your server's DNA.
Every 2 minutes (fully configurable), each online player is handed a randomly selected potion effect. Higher XP levels? Stronger effects. The countdown ticks live in the action bar. The tension is real.
Whether you run a survival, minigame, RPG, or event server — PXEffect adds a layer of unpredictable energy that keeps players on their toes.
? Core Features
? Random Effect Engine
Randomly selects from all vanilla positive and negative potion effects every interval
- ✅ Full pool of positive effects — Speed, Strength, Regeneration, Night Vision, Absorption, Luck, and more
- ✅ Full pool of negative effects — Slowness, Weakness, Poison, Wither, Blindness, Levitation, and more
- ✅ Toggle positive and negative categories independently
- ✅ Customise which specific effects are in the pool via
config.yml
- ✅ Configurable effect duration in ticks
⚡ XP Level Scaling
Effect strength automatically scales with the player's XP level
| ? XP Level |
? Effect Strength |
| Level 0 – 9 |
Level I |
| Level 10 – 19 |
Level II |
| Level 20 – 29 |
Level III |
| Level 30 – 39 |
Level IV |
| Level 40+ |
Level V |
Fully customisable tiers in config.yml — set your own ranges and amplifiers.
⏱️ Live Action Bar Countdown
Players always know exactly when their next effect is coming
Next Effect: 01:59
Next Effect: 00:45
Next Effect: 00:03
- ? Updates every second in real time
- ? Fully customisable format with MiniMessage support
- ? Hex colours, gradients, and legacy
& codes all supported
- ? Can be toggled off per-player or globally
? Effect Notifications
When an effect lands, players are informed clearly and stylishly:
- ? Chat message — shows effect name, level, and whether it's positive or negative
- ? Title + Subtitle — dramatic on-screen announcement (configurable fade times)
- ? Custom sounds — different sounds for positive vs negative effects
- ✨ Particle burst — visual particle effect at the player's location
- ? All messages fully customisable with MiniMessage
? Boss Bar Display (Optional)
An optional countdown boss bar at the top of the screen
- Choose from all Bukkit boss bar colours and styles
- Automatically fills and depletes as the timer counts down
- Fully MiniMessage-formatted title
- Enable/disable per-server in config
? Statistics System
Track everything that happens on your server
| Stat |
Description |
| ? Total Effects |
Every effect ever applied |
| ? Positive Effects |
Total positive effects given |
| ❤️ Negative Effects |
Total negative effects given |
| ? Most Common |
The effect given most frequently |
- Persisted to
stats.yml across server restarts
- Viewable via
/pxeffect info
- Exposed via PlaceholderAPI
?️ World & Region Control
worlds:
blacklist:
- lobby
- creative_world
per-world:
survival: true
minigames: false
worldguard:
region-blacklist:
- spawn
- safe_zone
- shop_area
- ? World blacklist — exclude specific worlds entirely
- ?️ Per-world toggle — enable or disable on a world-by-world basis
- ? WorldGuard regions — players inside blacklisted regions are skipped
? Integrations
| Integration |
Status |
What it does |
PlaceholderAPI |
✅ Supported |
7 custom %pxeffect_...% placeholders |
| ?️ WorldGuard |
✅ Supported |
Region blacklist |
| ? Vault |
✅ Supported |
Permission API bridge |
| ? LuckPerms |
✅ Supported |
Native Bukkit delegation |
| ? bStats |
✅ Built-in |
Anonymous usage metrics |
? PlaceholderAPI Placeholders
| Placeholder |
Returns |
%pxeffect_next_effect% |
Formatted countdown 01:45 |
%pxeffect_next_effect_sec% |
Raw seconds remaining |
%pxeffect_total_effects% |
Total effects applied |
%pxeffect_positive_effects% |
Positive effects count |
%pxeffect_negative_effects% |
Negative effects count |
%pxeffect_most_common% |
Most given effect name |
%pxeffect_interval% |
Configured interval (seconds) |
? Commands
| Command |
Description |
Permission |
/pxeffect reload |
Hot-reload the entire plugin |
pxeffect.reload |
/pxeffect info |
View stats, interval, and integration status |
pxeffect.use |
Alias: /pxe
? Permissions
| Permission |
Default |
Description |
pxeffect.use |
✅ Everyone |
Receive effects + use /pxeffect |
pxeffect.bypass |
❌ Nobody |
Exempt from all effects |
pxeffect.reload |
? OP |
Reload plugin configuration |
pxeffect.admin |
? OP |
Full admin access |
⚙️ Configuration Highlights
general:
interval: 120 # Seconds between effects
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
? Full config with every option documented ships inside the plugin on first run.
⚡ Performance
PXEffect is engineered for 500+ concurrent players:
- ?️ Single repeating task — one 1-second scheduler handles everything (cooldowns, action bar, boss bar, effect firing). Zero per-player tasks.
- ? Thread-safe statistics —
AtomicLong counters, no locks needed
- ? Memory-efficient —
ConcurrentHashMap for cooldown/bossbar state
- ♻️ Hot-reload safe — scheduler shuts down cleanly before config reload, then restarts
- ? Shaded bStats only — no unnecessary bundled libraries
? Installation
1. Download PXEffect-1.0.0.jar
2. Drop it into your /plugins/ folder
3. Start or restart your server
4. Edit plugins/PXEffect/config.yml
5. Run /pxeffect reload
✅ Compatible with Spigot 1.20.4+, Paper, and Purpur
✅ Java 17 required
✅ No required dependencies — all integrations are optional
?️ Changelog
v1.0.0 — Initial Release
- ? Full random effect engine with positive/negative pools
- ⚡ XP level scaling (5 configurable tiers)
- ⏱️ Live action bar countdown
- ? Boss bar display
- ? Title, subtitle, sound, and particle notifications
- ? World blacklist and per-world toggle
- ?️ WorldGuard region blacklist
- ? PlaceholderAPI (7 placeholders)
- ? Vault integration
- ? Statistics system with persistence
- ? Cooldown persistence across restarts
- ? Full hot-reload via
/pxeffect reload
- ? Debug mode
- ? bStats metrics
- ? Update checker
? Support & Community
Got a bug? Feature request? Just want to chat?
Discord: allay_gaming_x
Open an issue on GitHub or reach out on Discord — responses are fast!
? About the Author
Pawan — Minecraft plugin developer passionate about performance, polish, and player experience.
PXEffect is built with care — every config option, every message, every integration is intentional.
? Discord Live Status

PXEffect v1.0.0 · Made with ❤️ by Pawan · MIT License
评论 0
登录后参与评分
还没有评论,来抢沙发吧