⚡ 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
