pCPS

⚡ pCPS — Ultra-Optimized Cross-Version CPS Limitation & Click Multipliers Plugin

pCPS is an ultra-modern, lightweight, and highly optimized CPS Limitation, Hard Click Rate Capping & Leaderboard plugin designed for Minecraft 1.8 through 26.3+ (Spigot, Paper, Purpur, Leaf, Folia).

Created by Pinou007, pCPS provides complete control over left-click (attack) and right-click (place/interact) click rates, featuring customizable BossBars with 15% extra limit scaling, multi-hit click multipliers, cumulative Top 10 leaderboards, interactive 54-slot Admin GUIs with Nether Star filter cycling, hard click capping with burst peaks, contextual limit overrides, condition action scripting, player-only particles & sounds, OP alert bypass, rich Discord Webhook embeds with 3D player head avatars, and full PlaceholderAPI integration.

⚡ Key Highlights

• ⚡ Cross-Version Smooth BossBars (1.8 - 26.3+): Provides real-time CPS monitoring with smooth 1% interpolation progress, +15% scale limit margin, custom colors, styles, and auto-idle hiding modes (HIDE or DISABLE).

• 🛡️ Hard CPS Rate Capping & Peak Burst Allowance: Physically caps click rates in-game by cancelling extra clicks above a hard limit (e.g. 15 CPS in PvP/interactions) after a configurable burst peak (hard_peak_left/right: 20), without stopping real CPS monitoring or alert tracking. Setting any limit to -1 makes it unlimited!

• 🌊 Contextual Limit Overrides: Automatically applies different CPS limits and hard caps when a player is sneaking, in water, or placing blocks.

• 🔊 Player-Only Particles & Sound Effects: Play custom sounds (e.g. ENTITY_ITEM_BREAK) and spawn player-only particles (e.g. SMOKE_NORMAL, VILLAGER_ANGRY) when clicks are hard-capped or when alert thresholds are reached.

• 📜 Scripted Actions & Multi-Command Triggers: Execute lists of commands with custom condition scripts evaluating permissions, worlds, health, sneaking, water, and held items.

• 🏆 54-Slot Leaderboard GUI with Mode Filtering: Interactive 54-slot inventory with a Nether Star button at slot 4 cycling between TOTAL, LEFT, and RIGHT click CPS leaderboards.

• 🌐 Rich Discord Webhook Embeds: Sends rich embeds featuring the player's 3D head avatar, UUID, IP address, CPS stats (min, max, current), and configurable event triggers (on_limit_exceeded, on_punishment_executed, on_burst_peak).

🛠️ Quick Commands

• /cps — Strictly a 0-argument player command to toggle personal CPS display on/off. Configurable aliases: /clicks, /mycps.
• /pcps — Open the main interactive Admin GUI panel.
• /pcps leaderboard <LEFT/RIGHT/TOTAL> — View top 10 CPS click leaders.
• /pcps leaderboard remove <player> — Remove a player from the CPS leaderboard.
• /pcps add-double-cps <player> <mult> <LEFT/RIGHT/BOTH> [duration] [reason] — Add click multiplier.
• /pcps remove-bonus <player> <DOUBLE_CPS/ALL> — Remove active player bonuses.
• /pcps player <player> — View detailed player click stats, session duration, bonus count, and client version (ViaVersion & Floodgate Bedrock).
• /pcps placeholder [player] — Display all PlaceholderAPI placeholders and live values.
• /pcps reload — Reload all configuration and language files.

🧩 Placeholders

The following PlaceholderAPI placeholders are exposed by pCPS:

• %pcps_cps_left% — Current Left-Click CPS rate.
• %pcps_cps_right% — Current Right-Click CPS rate.
• %pcps_cps_total% — Current Cumulative Total CPS rate (Left + Right).
• %pcps_max_cps_left% — Peak recorded Left CPS in session.
• %pcps_max_cps_right% — Peak recorded Right CPS in session.
• %pcps_max_cps_total% — Peak recorded Cumulative Total CPS in session.
• %pcps_avg_cps_left% — Session average Left CPS rate.
• %pcps_avg_cps_right% — Session average Right CPS rate.
• %pcps_avg_cps_total% — Session average Cumulative Total CPS rate.
• %pcps_limit_left% — Configured Left CPS limit.
• %pcps_limit_right% — Configured Right CPS limit.
• %pcps_bonus_multiplier_left% — Active Left CPS multiplier.
• %pcps_bonus_multiplier_right% — Active Right CPS multiplier.
• %pcps_bonus_active_count% — Total active bonuses saved.
• %pcps_top_left_N_name% — Name of player at rank N (1 to 10) in Left CPS leaderboard.
• %pcps_top_left_N_value% — CPS score of player at rank N (1 to 10) in Left CPS leaderboard.
• %pcps_top_right_N_name% — Name of player at rank N (1 to 10) in Right CPS leaderboard.
• %pcps_top_right_N_value% — CPS score of player at rank N (1 to 10) in Right CPS leaderboard.
• %pcps_top_total_N_name% — Name of player at rank N (1 to 10) in Cumulative Total CPS leaderboard.
• %pcps_top_total_N_value% — CPS score of player at rank N (1 to 10) in Cumulative Total CPS leaderboard.
• %pcps_target_name% — Name of current PvP opponent.
• %pcps_target_ping% — Ping of current PvP opponent.
• %pcps_target_cps_left% — Left CPS rate of current PvP opponent.
• %pcps_target_cps_right% — Right CPS rate of current PvP opponent.
• %pcps_target_cps_total% — Cumulative Total CPS rate of current PvP opponent.

🔐 Permissions

• pcps.admin — Master admin permission giving access to /pcps, Admin GUI, reload, and player inspection.
• pcps.alerts — Receive staff alert notifications when a player exceeds CPS limits.
• pcps.bypass.cps.all — Complete bypass of all CPS limits and hard click capping.
• pcps.bypass.cps.left — Bypass Left CPS limits and hard capping.
• pcps.bypass.cps.right — Bypass Right CPS limits and hard capping.
• pcps.bypass.alerts — Bypass warnings, player notifications, and staff alert logs completely.
• pcps.limit.left.<amount> — Set dynamic custom Left CPS limit for a player or group (use -1 for unlimited).
• pcps.limit.right.<amount> — Set dynamic custom Right CPS limit for a player or group (use -1 for unlimited).
• pcps.group.vip — Example group node defined in config.yml.

🧩 Dependencies & Compatibility

• Minecraft: 1.8, 1.12, 1.16, 1.18, 1.20, 1.21.4+ (up to 26.3)
• Software: Spigot, Paper, Purpur, Folia, Leaf
• Optional Hooks: PlaceholderAPI, Floodgate (Bedrock), ViaVersion, WorldGuard