**Modern, Hosting-Friendly System Monitoring for Velocity**<\/p>\n
Advanced Velocity monitoring plugin that **automatically adapts to any hosting environment** – from budget shared hosting to dedicated servers.<\/p>\n
## \ud83c\udf1f Key Features<\/p>\n
– \u2705 **Works on ANY hosting** – Shared, VPS, dedicated, or cloud
\n– \ud83c\udfaf **Auto-detects environment** – No configuration needed
\n– \ud83d\udd04 **Smart fallbacks** – JVM monitoring when system access is limited
\n– \u26a1 **Async operations** – Zero performance impact
\n– \ud83d\udcca **Comprehensive monitoring** – CPU, RAM, Disk, Network, JVM metrics
\n– \ud83d\udd14 **Discord\/Slack alerts** – Real-time notifications
\n– \ud83d\udee0\ufe0f **Hot-reload config** – No restart required<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Velocity**: 3.4.0+
\n– **Java**: 21+<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
1. Download `BubbleLog-2.0.0.jar`
\n2. Place in `plugins\/` folder
\n3. Start server – **that’s it!**<\/p>\n
**First Commands**<\/p>\n
“`bash
\n\/bubblelog env # Check environment capabilities
\n\/bubblelog status # View monitoring status
\n\/bubblelog reload # Reload configuration
\n“`<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Default config at `plugins\/bubblelog\/config.yml`:<\/p>\n
“`yaml
\nmonitoring:
\n interval: 30 # Seconds between checks
\n cpu: { enabled: true }
\n ram: { enabled: true }
\n disk: { enabled: true }
\n network: { enabled: true }
\n jvm: { enabled: true }<\/p>\n
alerts:
\n enabled: true
\n thresholds:
\n cpu: 80.0 # Alert at 80% CPU
\n ram: 85.0 # Alert at 85% RAM
\n disk: 90.0 # Alert at 90% disk
\n discord:
\n enabled: false
\n webhook-url: “”
\n“`<\/p>\n
### Shared Hosting Optimization
\n“`yaml
\nmonitoring:
\n interval: 60 # Higher interval for shared hosting
\n jvm: { enabled: true } # Always keep enabled
\n“`<\/p>\n
## \ud83d\udcca What Gets Monitored<\/p>\n
| Metric | Full Access | Shared Hosting |
\n|——–|————|—————-|
\n| CPU | System CPU | JVM Process CPU |
\n| RAM | System Memory | JVM Heap |
\n| Disk | All Disks | Skipped |
\n| Network | Player stats | Player stats |
\n| JVM | Full metrics | Full metrics |<\/p>\n
## \ud83c\udfae Commands<\/p>\n
| Command | Description |
\n|———|————-|
\n| `\/bubblelog env` | Show environment capabilities |
\n| `\/bubblelog status` | View monitoring status |
\n| `\/bubblelog reload` | Hot-reload configuration |
\n| `\/bubblelog validate` | Check config validity |
\n| `\/bubblelog test webhook` | Test Discord webhook |<\/p>\n
**Permission**: `bubblelog.admin`<\/p>\n
## \ud83d\udd27 Troubleshooting<\/p>\n
### “Limited system access detected”
\n\u2705 **Normal on shared hosting!** Plugin works with JVM-only monitoring.<\/p>\n
### Performance Issues
\nIncrease monitoring interval:
\n“`yaml
\nmonitoring:
\n interval: 120 # Check every 2 minutes
\n“`<\/p>\n
### Discord Webhooks
\n1. Create webhook in Discord server settings
\n2. Copy webhook URL
\n3. Add to config:
\n“`yaml
\nalerts:
\n discord:
\n enabled: true
\n webhook-url: “https:\/\/discord.com\/api\/webhooks\/…”
\n“`<\/p>\n
## \ud83c\udfd7\ufe0f Building<\/p>\n
“`bash
\n.gradlew.bat shadowJar # Windows
\n.\/gradlew shadowJar # Linux\/Mac
\n“`<\/p>\n
Output: `build\/libs\/BubbleLog-2.0.0.jar`<\/p>\n
## \ud83d\udcdd License<\/p>\n
MIT License – See LICENSE file<\/p>\n
## \ud83d\udcac Support<\/p>\n
– **GitHub Issues**: For bug reports
\n– **Commands**: `\/bubblelog env` to check your setup<\/p>\n
—<\/p>\n
**Made for server administrators running Velocity on any hosting! \ud83d\ude80**<\/p>\n
“`logging:
\n # Name of the log file
\n filename: “system-usage.log”
\n # Also log to console\/server log
\n console: false
\n # Date format for log entries
\n date-format: “yyyy-MM-dd HH:mm:ss”
\n # Maximum number of log files to keep (0 = unlimited)
\n max-files: 7<\/p>\n
alerts:
\n # Enable performance alerts
\n enabled: true
\n thresholds:
\n # CPU usage threshold for alerts (percentage)
\n cpu: 80.0
\n # RAM usage threshold for alerts (percentage)
\n ram: 85.0
\n # Disk usage threshold for alerts (percentage)
\n disk: 90.0
\n # Send alerts to server console
\n console: true
\n # Log alerts to file
\n log-to-file: true
\n # Cooldown between same alert types (seconds)
\n cooldown: 300
\n discord:
\n # Enable Discord webhook alerts
\n enabled: false
\n # Discord webhook URL for alerts
\n webhook-url: “”
\n status-reports:
\n # Enable periodic Discord status reports
\n enabled: false
\n # Discord status report interval in seconds (3600 = 1 hour)
\n interval: 3600
\n slack:
\n # Enable Slack webhook alerts
\n enabled: false
\n # Slack webhook URL for alerts
\n webhook-url: “”
\n“`<\/p>\n
## Log Format<\/p>\n
The plugin logs comprehensive system metrics in the following format:<\/p>\n
“`
\n[2025-07-10 14:30:00] CPU: 45.67% | RAM: 2.34GB\/8.00GB (29.25%) | Disk(C:): 120.5GB\/500.0GB (24.10%) | Players: 45\/100 (45.0%), Servers: 3\/4 | JVM: Heap 67.8%, Threads: 42, GC: 1250ms
\n“`<\/p>\n
**Includes:**
\n– **System Metrics**: CPU, RAM, and disk usage with percentages
\n– **Network Metrics**: Current\/max players, server utilization, backend server status
\n– **JVM Metrics**: Heap utilization, active threads, total GC time
\n– **Timestamps**: Configurable date\/time formatting<\/p>\n
## Alert Types<\/p>\n
The plugin can send alerts for:<\/p>\n
– **High CPU Usage**: When CPU usage exceeds the configured threshold
\n– **High RAM Usage**: When memory usage exceeds the configured threshold
\n– **High Disk Usage**: When any disk exceeds the configured threshold
\n– **Critical System State**: When multiple resources are under stress simultaneously<\/p>\n
### Alert Destinations<\/p>\n
– **Console Logging**: Alerts appear in server console with \ud83d\udea8 emoji
\n– **File Logging**: Alerts are saved to `alerts.log` in the logs directory
\n– **Discord Webhooks**: Rich embeds with colored alerts and timestamps
\n– **Slack Webhooks**: Formatted messages with appropriate warning colors<\/p>\n
### Webhook Setup<\/p>\n
For Discord webhooks:
\n1. Create a webhook in your Discord server
\n2. Copy the webhook URL
\n3. Set `alerts.discord.enabled: true` and paste the URL<\/p>\n
For Slack webhooks:
\n1. Create an incoming webhook in your Slack workspace
\n2. Copy the webhook URL
\n3. Set `alerts.slack.enabled: true` and paste the URL<\/p>\n
## Building<\/p>\n
To build the plugin from source:<\/p>\n
1. Ensure you have Java 17+ installed
\n2. Clone this repository
\n3. Run `build.bat` (Windows) or `.\/gradlew shadowJar` (Linux\/Mac)
\n4. The compiled plugin will be in `build\/libs\/BubbleLog-1.0.0.jar`<\/p>\n
## Project Structure<\/p>\n
“`
\nBubbleLog\/
\n\u251c\u2500\u2500 src\/main\/java\/net\/bubblecraft\/bubblelog\/
\n\u2502 \u251c\u2500\u2500 BubbleLog.java # Main plugin class
\n\u2502 \u251c\u2500\u2500 config\/ConfigManager.java # Configuration handling
\n\u2502 \u2514\u2500\u2500 monitor\/SystemMonitor.java # System monitoring logic
\n\u251c\u2500\u2500 build.gradle # Build configuration
\n\u251c\u2500\u2500 config-example.yml # Example configuration
\n\u251c\u2500\u2500 build.bat # Windows build script
\n\u2514\u2500\u2500 README.md # This file
\n“`<\/p>\n
## Dependencies<\/p>\n
– OSHI – For system and hardware information
\n– Configurate – For YAML configuration<\/p>\n
## License<\/p>\n
This project is licensed under the MIT License – see the LICENSE file for details.<\/p>\n
## Support<\/p>\n
If you encounter any issues or have questions, please open an issue on GitHub.<\/p>\n
## Error Handling & Reliability<\/p>\n
BubbleLog is designed with **comprehensive error handling** to ensure it never affects server performance:<\/p>\n
– \u2705 **Isolated Error Handling**: Each monitoring component fails independently
\n– \u2705 **Graceful Degradation**: Continues monitoring even if individual components fail
\n– \u2705 **Safe Defaults**: Invalid data is replaced with safe fallback values
\n– \u2705 **Non-Blocking Operations**: File I\/O and webhook errors don’t stop monitoring
\n– \u2705 **Data Validation**: All system values are validated before use
\n– \u2705 **Recovery Mechanisms**: Automatic recovery on next monitoring cycle<\/p>\n
## \ud83c\udfae Discord Integration<\/p>\n
BubbleLog provides rich Discord webhook integration for real-time server monitoring and alerts.<\/p>\n
### Features
\n– **\ud83d\udea8 Instant Alerts**: Rich embed alerts for CPU, RAM, and disk usage
\n– **\ud83d\udcca Status Reports**: Periodic comprehensive system status reports
\n– **\ud83c\udfa8 Rich Formatting**: Professional embeds with color-coded severity levels
\n– **\u26a1 Real-time**: Immediate notifications when thresholds are exceeded
\n– **\ud83d\udd27 Configurable**: Customizable thresholds and report intervals<\/p>\n
### Discord Alert Example
\n“`
\n\u26a1 High CPU Usage
\nCPU usage is 85.23% (threshold: 80.0%)<\/p>\n
Alert Type: High CPU Usage
\nSeverity: \u26a0\ufe0f Warning
\nServer: Velocity Proxy
\nTimestamp: July 10, 2025 2:30 PM
\n“`<\/p>\n
### Discord Status Report Example
\n“`
\n\u2705 System Status Report
\nCurrent server performance metrics and health status<\/p>\n
\ud83d\udda5\ufe0f CPU Usage: 45.32%
\n\ud83e\udde0 Memory Usage: 65.2% (5.2 GB \/ 8.0 GB)
\n\ud83d\udc65 Players Online: 85 \/ 100 (85.0%)
\n\ud83d\udcbe Disk Usage: C:: 68.5% (15.8 GB free)
\n\ud83c\udfe5 Overall Health: \u2705 Healthy
\n“`<\/p>\n
### Quick Setup
\n1. Create a Discord webhook in your server
\n2. Copy the webhook URL
\n3. Configure BubbleLog:
\n“`yaml
\nalerts:
\n discord:
\n enabled: true
\n webhook-url: “YOUR_WEBHOOK_URL_HERE”
\n status-reports:
\n enabled: true
\n interval: 3600 # Hourly reports
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
Modern, Hosting-Friendly System Monitoring for Velocity<\/p>\n","protected":false},"featured_media":35321,"template":"","meta":{"_minecraft_slug":"bubblelog","_minecraft_project_id":"M9pHij5I","_minecraft_author":"ethan08921","_minecraft_license":"MIT","_minecraft_downloads":20,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bubblelog.zip","_minecraft_size_bytes":14895844,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:32:41.003801Z","_minecraft_date_created":"2025-12-18T08:30:52.610227Z","_minecraft_date_modified":"2026-01-20T13:33:32.977146Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bubblelog","_minecraft_icon_attachment_id":35321,"_minecraft_imported_at":"2026-06-01T17:06:18+00:00","_minecraft_import_hash":"771dec5641b6a1ad0c03dcd8bfaa3f8a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,123,92,985],"mod_loader":[986],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-35320","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n