{"id":28134497,"url":"https://github.com/renvins/serverpulse","last_synced_at":"2025-12-26T12:46:33.471Z","repository":{"id":284442446,"uuid":"954964576","full_name":"renvins/serverpulse","owner":"renvins","description":"Effortless Minecraft performance monitoring with pre-configured Grafana/InfluxDB via Docker.","archived":false,"fork":false,"pushed_at":"2025-08-27T19:51:01.000Z","size":4007,"stargazers_count":24,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-28T04:23:04.988Z","etag":null,"topics":["bukkit","bungeecord","fabric","grafana","grafana-influxdb","influxdb","java","metrics-monitor","minecraft","minecraft-mod","minecraft-monitoring","minecraft-performance","papermc","server-monitoring","spigotmc","velocity"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/renvins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-25T22:26:41.000Z","updated_at":"2025-08-27T19:45:06.000Z","dependencies_parsed_at":"2025-04-10T10:38:41.039Z","dependency_job_id":"a5435c26-6573-48ba-a8d1-a691b217dace","html_url":"https://github.com/renvins/serverpulse","commit_stats":null,"previous_names":["renvins/serverpulse"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/renvins/serverpulse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renvins%2Fserverpulse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renvins%2Fserverpulse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renvins%2Fserverpulse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renvins%2Fserverpulse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/renvins","download_url":"https://codeload.github.com/renvins/serverpulse/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renvins%2Fserverpulse/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278693065,"owners_count":26029429,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","bungeecord","fabric","grafana","grafana-influxdb","influxdb","java","metrics-monitor","minecraft","minecraft-mod","minecraft-monitoring","minecraft-performance","papermc","server-monitoring","spigotmc","velocity"],"created_at":"2025-05-14T14:16:00.945Z","updated_at":"2025-10-06T23:12:29.711Z","avatar_url":"https://github.com/renvins.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![ServerPulse Poster](img/poster.png)\n\n# ServerPulse\n\nServerPulse is an open-source, real-time performance monitoring tool for Minecraft servers. It collects key server metrics (TPS, MSPT, CPU usage, disk usage, memory, player count, entities, chunks, ping) and visualizes them through an integrated Grafana dashboard.\n\n[![Available on Spigot](https://img.shields.io/badge/Available%20on-Spigot-yellow.svg)](https://www.spigotmc.org/resources/serverpulse-1-8-1-21-x-real-time-minecraft-performance-monitoring.123707/)\n[![Available on Modrinth](https://img.shields.io/badge/Available%20on-Modrinth-green.svg)](https://modrinth.com/plugin/serverpulse)\n\n\u003e ### 💬 Community \u0026 Support\n\u003e\n\u003e **Have questions, need help, or want to share your dashboard setup? [Click here to join our Discord Server\\!](https://discord.gg/jZUqcemc4G)**\n\n\u003cdetails\u003e\n\u003csummary\u003e📊 View Dashboard Examples\u003c/summary\u003e\n\n![ServerPulse Grafana Dashboard Example1](img/dash1.png)\n*Example dashboard view 1: System Metrics*\n\n![ServerPulse Grafana Dashboard Example2](img/dash2.png)\n*Example dashboard view 2: System Metrics 2*\n\n![ServerPulse Grafana Dashboard Example3](img/dash3.png)\n*Example dashboard view 3: System \u0026 World Metrics*\n\n![ServerPulse Grafana Dashboard Example4](img/dash4.png)\n*Example dashboard view 4: Player Metrics*\n\u003c/details\u003e\n\n## 🚀 Why Choose ServerPulse?\n\nServerPulse isn't just another metrics exporter - it offers several unique advantages:\n\n-   **Complete Monitoring Stack** - Fully integrated solution with InfluxDB (optimized for time-series data) and pre-configured Grafana dashboards.\n-   **Universal Platform Support** - Works with any Bukkit-based, Velocity, BungeeCord and Fabric server while taking advantage of Paper-specific optimizations when available.\n-   **Per-World Analytics** - Track entity counts, chunk loading, and performance metrics separately for each world.\n-   **Flexible Tagging System** - Group and filter metrics by server, network, region, or any custom dimension through simple configuration.\n-   **Zero-Configuration Dashboards** - Auto-provisioned Grafana dashboards, no manual setup required.\n-   **Alert Notifications** - Integrated Discord and Telegram alerts for critical server metrics (TPS drops, memory issues, etc.).\n-   **Production-Ready Infrastructure** - Built-in health checks, connection retry mechanisms, and proper error handling.\n-   **Docker-First Deployment** - Single command deployment with Docker Compose for the entire monitoring stack.\n\n## 🌟 Platform Support\n\nServerPulse supports **all Minecraft server platforms** in the ecosystem:\n\n-   **Bukkit/Spigot**: Full support with custom TPS monitoring implementation.\n-   **Paper and its forks** (Purpur, Pufferfish, etc.): Enhanced support with native TPS monitoring.\n-   **BungeeCord**: Support for BungeeCord proxy servers with network-wide player monitoring.\n-   **Velocity**: Support for Velocity proxy servers (ofc TPS and world metrics are not available).\n-   **Fabric**: Support for Fabric servers (latest versions of Fabric API and Minecraft).\n\nThe plugin automatically detects your server platform and uses the most efficient implementation available for that environment.\n\n## 📚 Documentation\n\n**For setup guides, configuration instructions, API examples, and developer information, please visit our [Wiki](https://renvins.github.io/serverpulse/).**\n\nThe wiki contains comprehensive documentation on:\n-   Installation and setup instructions\n-   Configuration options and customization\n-   Discord and Telegram alerts configuration\n-   Developer API examples\n-   Contributing guidelines\n\n## 📊 Comparison with Alternative Solutions\n\n| Feature                 | ServerPulse                          | Generic Prometheus Exporters                |\n| ----------------------- | ------------------------------------ | ------------------------------------------- |\n| Setup Time              | ~5 minutes with Docker Compose       | Manual metrics + Prometheus + Grafana setup |\n| Dashboard Configuration | Pre-configured, auto-provisioned     | Manual dashboard creation                   |\n| Data Storage            | InfluxDB (optimized for time-series) | Prometheus (general-purpose)                |\n| Platform Support        | All Minecraft Servers                | Varies by implementation                    |\n| Per-World Metrics       | Built-in                             | Usually not available                       |\n| Custom Tagging          | Flexible tag system                  | Limited labeling                            |\n| Alert System            | Discord and Telegram integration     | Requires manual setup                       |\n| Infrastructure          | Complete stack included              | Manual integration required                 |\n| Health Monitoring       | Automated health checks              | Varies by implementation                    |\n\n## 🤝 Contributing\n\nWe welcome all contributions - bug reports, feature proposals, pull requests, or simply feedback. Read [Contributing](https://github.com/renvins/serverpulse/blob/master/CONTRIBUTING.md)\n\n## 📄 License\n\nServerPulse is licensed under the GNU General Public License v3.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenvins%2Fserverpulse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frenvins%2Fserverpulse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenvins%2Fserverpulse/lists"}