xFPSAlert — Real-Time FPS Monitoring & Alerts for Minecraft Servers

A comprehensive Bukkit plugin to monitor player FPS in real time. It offers configurable alerts (action bar, boss bar, titles, sounds), performance tips, admin tools, and ProtocolLib integration—all with modern design and customization in mind.

Features
Core Functionality

• Real-time FPS Monitoring — Monitors client FPS using multiple detection methods
• Smart Alert System — Customizable alerts when FPS drops below a threshold
• Alert Types — Action bar, boss bar, chat, titles, sounds
• Cooldown System — Prevents alert spam
• Critical Alerts — Special notifications for dangerously low FPS

Advanced Features

• Performance Tips — Suggests optimization strategies for better FPS
• Trigger Commands — Executes commands on low FPS
• Comprehensive Logging — Logs to console and file
• ProtocolLib Integration — Enhanced accuracy via packet analysis
• Permission Control — Bypass and receive permissions

Customization

• Hex & Gradient Colors — Fully customizable with MiniMessage
• Multilingual Support — Separate messages.yml file for translations
• Configurable Alert Messages — Modify all texts and effects easily

️ Admin Tools

• Command system with tab completion
• Toggle monitoring and view individual player FPS
• Real-time config reloading
• Debug mode for diagnostics

Requirements

• Server: Spigot, Paper, or compatible fork
• Optional: ProtocolLib

Commands & Permissions
Commands

Command Description Permission
/fps Main command xfpsalert.admin
/fps help Show command help xfpsalert.admin
/fps reload Reload config xfpsalert.reload
/fps toggle [player] Toggle monitoring on a player xfpsalert.toggle
/fps check [player] Check a player’s current FPS xfpsalert.check
/fps status Plugin status summary xfpsalert.admin

Permissions

Permission Description Default
xfpsalert.* All plugin permissions OP
xfpsalert.admin Administrative control OP
xfpsalert.receive Receive alerts TRUE
xfpsalert.bypass Bypass FPS monitoring FALSE
xfpsalert.reload Reload configuration OP
xfpsalert.toggle Toggle monitoring for players OP
xfpsalert.check Check other players’ FPS OP
Alert Types Overview
Action Bar

• Minimalistic overlay
• Gradient colors
• Real-time FPS display

Boss Bar

• Visible progress bar
• Custom colors and durations
• Useful for low FPS warnings

Performance Tips
Automatically suggested optimizations:

• Lower render distance
• Disable fancy graphics
• Close background tasks
• Allocate more RAM

Author
GodXPro

• Developer: GodXPro
• Discord: godxpro.exe