A lightweight, open-source performance monitoring plugin for modern Paper servers.
Monitor your server's health in real time with an intuitive dashboard, performance snapshots, configurable alerts, and detailed world statistics.
- 📊 Live TPS & MSPT monitoring
- 💾 Memory usage statistics
- ⚙️ CPU usage overview
- 🌍 Per-world performance reports
- 👥 Entity & chunk statistics
- 📦 Tile entity monitoring
- 📈 Performance history
- 📸 Performance snapshots
- 🚨 Configurable warning & critical alerts
- ✅ Recovery notifications
- 🌐 Discord webhook support
- 🎨 Clean inventory GUI
- ⚡ Lightweight and optimized scheduling
- 🔧 Fully configurable
- 📖 Open source
- Java 21 or newer
- Paper 1.21.4 or newer
- Download the latest release from the Releases page.
- Place the JAR into your server's
pluginsfolder. - Start or restart the server.
- Configure PulseGuard inside:
plugins/PulseGuard/
- Reload the plugin or restart the server after changing the configuration.
| Command | Description |
|---|---|
/pulse |
Opens the main dashboard |
/pulse snapshot |
Creates a performance snapshot |
/pulse world |
Shows world statistics |
/pulse history |
Displays performance history |
/pulse reload |
Reloads the configuration |
| Permission | Description |
|---|---|
pulseguard.use |
Basic access |
pulseguard.snapshot |
Create snapshots |
pulseguard.world |
View world statistics |
pulseguard.history |
View history |
pulseguard.admin |
Administrative commands |
monitoring:
interval-seconds: 10
alerts:
enabled: true
tps-warning: 18.0
tps-critical: 15.0
mspt-warning: 40.0
mspt-critical: 50.0
webhook:
enabled: false
url: ""PulseGuard is designed to provide useful server diagnostics while minimizing runtime overhead.
Monitoring tasks run at configurable intervals, expensive operations are avoided whenever possible, and the plugin is intended to integrate cleanly into modern Paper servers without significantly affecting gameplay.
Clone the repository:
git clone https://github.com/Luhtaniilo010/PulseGuard.git
cd PulseGuardBuild using Gradle:
.\gradlew.bat clean build./gradlew clean buildThe compiled plugin will be available in:
build/libs/
Contributions are welcome.
- Fork the repository.
- Create a new branch.
- Commit your changes.
- Open a Pull Request.
Bug reports, feature suggestions, and performance improvements are always appreciated.
| Platform | Status |
|---|---|
| Paper | ✅ Supported |
| Folia | |
| Spigot | |
| Bukkit | ❌ Unsupported |
- Additional performance graphs
- Exportable reports
- Expanded webhook integrations
- More dashboard customization
- Historical data improvements
- Additional optimization metrics
If you encounter a bug, please include:
- PulseGuard version
- Minecraft version
- Paper build
- Java version
- Console errors
- Steps to reproduce the issue
This helps reproduce and resolve problems much faster.
This project is licensed under the MIT License.
See the LICENSE file for more information.
If PulseGuard helps your server, consider giving the repository a ⭐.
Feedback, suggestions, and contributions are greatly appreciated.
Made with ❤️ for the Minecraft community.