zFPSAlert -----
High-performance Minecraft plugin for real-time FPS monitoring and server optimization zFPSAlert
High-performance Minecraft plugin for real-time FPS monitoring and server optimization
Overview
zFPSAlert is a powerful Minecraft plugin designed to monitor player FPS in real-time and automatically optimize server performance to ensure smooth gameplay for all players.
✨ Features
Commands
/fps
/fps check Steve
/fps toggle Notch
/fps reload
Permissions
⚙️ Configuration
general:
debug: false
log-to-file: true
check-interval: 20
auto-optimization: true
fps-monitoring:
enabled: true
warning-threshold: 30
critical-threshold: 15
consecutive-readings: 3
packet-detection: true
alerts:
warning:
enabled: true
types: ["chat", "actionbar"]
cooldown: 30
critical:
enabled: true
types: ["title", "chat"]
cooldown: 15
optimization:
enabled: true
chunk-optimization: true
entity-ai-reduction: true
particle-reduction: true
alerts:
fps-warning:
chat: "&e⚠ Your FPS is low ({fps}). Server optimizations applied."
actionbar: "&e⚠ Low FPS: {fps}"
fps-critical:
title: "&c⚠ CRITICAL FPS"
subtitle: "&cFPS: {fps}"
chat: "&c Critical FPS detected ({fps})! Maximum optimizations applied."
Dependencies
Required
Optional
Compatibility
Installation
Color Codes
The plugin supports Minecraft color codes and hex colors:
# Standard color codes
&a - Green
&c - Red
&e - Yellow
&b - Aqua
&d - Light Purple
# Hex color example
&#FF5555 - Custom Red
FF55 - Custom Green
Author
Created by: GamingHuzai
License
This project is licensed under the MIT License.
MIT License
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Pro Tip: Enable debug mode in config.yml for detailed logging during setup!
Made with ❤️ GamingHuzai
High-performance Minecraft plugin for real-time FPS monitoring and server optimization
Overview
zFPSAlert is a powerful Minecraft plugin designed to monitor player FPS in real-time and automatically optimize server performance to ensure smooth gameplay for all players.
✨ Features
- Real-time FPS Monitoring - Track player FPS continuously
- ⚡ Auto Optimization - Automatically reduce server load for low FPS players
- ProtocolLib Integration - Advanced packet-based FPS detection
- Configurable Thresholds - Customizable warning and critical FPS levels
- Smart Alerts - Multiple notification types (chat, title, actionbar)
- ️ Permission System - Granular control over plugin features
- Debug Logging - Comprehensive logging for troubleshooting
Commands
| Command | Description | Permission |
| /fps | Show your current FPS | zfpsalert.use |
| /fps check <player> | Check another player's FPS | zfpsalert.check |
| /fps toggle <player> | Toggle FPS monitoring for a player | zfpsalert.toggle |
| /fps reload | Reload plugin configuration | zfpsalert.reload |
Code (Text):
/fps
/fps check Steve
/fps toggle Notch
/fps reload
Permissions
| Permission | Description | Default |
| zfpsalert.* | All plugin permissions | op |
| zfpsalert.use | Basic plugin usage | true |
| zfpsalert.admin | Administrative access | op |
| zfpsalert.check | Check other players FPS | op |
| zfpsalert.toggle | Toggle FPS monitoring | op |
| zfpsalert.reload | Reload configuration | op |
| zfpsalert.bypass | Bypass FPS monitoring | false |
⚙️ Configuration
Code (Text):
general:
debug: false
log-to-file: true
check-interval: 20
auto-optimization: true
fps-monitoring:
enabled: true
warning-threshold: 30
critical-threshold: 15
consecutive-readings: 3
packet-detection: true
alerts:
warning:
enabled: true
types: ["chat", "actionbar"]
cooldown: 30
critical:
enabled: true
types: ["title", "chat"]
cooldown: 15
optimization:
enabled: true
chunk-optimization: true
entity-ai-reduction: true
particle-reduction: true
Code (Text):
alerts:
fps-warning:
chat: "&e⚠ Your FPS is low ({fps}). Server optimizations applied."
actionbar: "&e⚠ Low FPS: {fps}"
fps-critical:
title: "&c⚠ CRITICAL FPS"
subtitle: "&cFPS: {fps}"
chat: "&c Critical FPS detected ({fps})! Maximum optimizations applied."
Dependencies
Required
- Minecraft 1.20+
- Java 17+
Optional
- ProtocolLib 5.1.0+ (For advanced FPS detection)
Compatibility
| Server Type | Supported |
| Paper | ✅ |
| Spigot | ✅ |
| Bukkit | ⚠️ (Limited features) |
- ✅ 1.20.4
- ✅ 1.20.3
- ✅ 1.20.2
- ✅ 1.20.1
- ✅ 1.20.0
Installation
- Download the latest zFPSAlert-x.x.x.jar
- Place the jar file in your plugins/ folder
- Restart your server
- Configure the plugin in plugins/zFPSAlert/config.yml
- Reload with /fps reload
Color Codes
The plugin supports Minecraft color codes and hex colors:
Code (Text):
# Standard color codes
&a - Green
&c - Red
&e - Yellow
&b - Aqua
&d - Light Purple
# Hex color example
&#FF5555 - Custom Red
FF55 - Custom Green
| Code | Color | Code | Style |
| &0 | Black | &l | Bold |
| &1 | Dark Blue | &m | Strikethrough |
| &2 | Dark Green | &n | Underline |
| &3 | Dark Aqua | &o | Italic |
| &4 | Dark Red | &r | Reset |
Author
Created by: GamingHuzai
License
This project is licensed under the MIT License.
Code (Text):
MIT License
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Pro Tip: Enable debug mode in config.yml for detailed logging during setup!
Made with ❤️ GamingHuzai
Resource Information
Author:
----------
Total Downloads:
32
First Release:
May 27, 2025
Last Update:
May 27, 2025
Category:
---------------
All-Time Rating:
3 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings