{"id":49494233,"url":"https://github.com/lucaazalim/minecraft-server-ping","last_synced_at":"2026-05-01T08:33:31.548Z","repository":{"id":40480140,"uuid":"94515119","full_name":"lucaazalim/minecraft-server-ping","owner":"lucaazalim","description":"A Java Minecraft server \"pinger\" (MOTD ping) API.","archived":false,"fork":false,"pushed_at":"2025-07-27T01:51:35.000Z","size":80,"stargazers_count":55,"open_issues_count":0,"forks_count":16,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-31T19:55:24.716Z","etag":null,"topics":["java","minecraft","minecraft-server","motd","multiplayer","ping","server"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lucaazalim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"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":"2017-06-16T06:59:44.000Z","updated_at":"2026-01-21T06:29:34.000Z","dependencies_parsed_at":"2024-08-18T00:45:52.984Z","dependency_job_id":null,"html_url":"https://github.com/lucaazalim/minecraft-server-ping","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lucaazalim/minecraft-server-ping","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucaazalim%2Fminecraft-server-ping","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucaazalim%2Fminecraft-server-ping/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucaazalim%2Fminecraft-server-ping/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucaazalim%2Fminecraft-server-ping/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucaazalim","download_url":"https://codeload.github.com/lucaazalim/minecraft-server-ping/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucaazalim%2Fminecraft-server-ping/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32490813,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"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":["java","minecraft","minecraft-server","motd","multiplayer","ping","server"],"created_at":"2026-05-01T08:33:31.057Z","updated_at":"2026-05-01T08:33:31.530Z","avatar_url":"https://github.com/lucaazalim.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCServerPing\n\nA lightweight Java library for retrieving Minecraft server information via the Server List Ping protocol. This library provides access to the same data displayed in the Minecraft client's server list.\n\n## Features\n\n- Server MOTD (Message of the Day) with color code support\n- Player count and player samples\n- Server version and protocol information\n- Base64 encoded favicon\n- Built-in SRV record resolution\n- Automatic Text Component to legacy text conversion\n- Configurable timeouts and connection parameters\n\n## Installation\n\nAdd the dependency to your `pom.xml`:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ebr.com.azalim\u003c/groupId\u003e\n  \u003cartifactId\u003emcserverping\u003c/artifactId\u003e\n  \u003cversion\u003e1.0.9\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Usage\n\n### Basic Example\n\n```java\nimport br.com.azalim.mcserverping.MCPing;\nimport br.com.azalim.mcserverping.MCPingOptions;\nimport br.com.azalim.mcserverping.MCPingResponse;\n\n// Simple ping with default settings\nMCPingResponse response = MCPing.getPing(\"mc.hypixel.net\");\n\n// With custom options\nMCPingOptions options = MCPingOptions.builder()\n    .hostname(\"example.com\")\n    .port(25565)\n    .timeout(3000)\n    .build();\n\nMCPingResponse response = MCPing.getPing(options);\n\n// Access server information\nSystem.out.println(\"MOTD: \" + response.getDescription().getStrippedText());\nSystem.out.println(\"Players: \" + response.getPlayers().getOnline() + \"/\" + response.getPlayers().getMax());\nSystem.out.println(\"Version: \" + response.getVersion().getName());\nSystem.out.println(\"Ping: \" + response.getPing() + \"ms\");\n```\n\nSee the [example class](src/main/java/br/com/azalim/mcserverping/examples/MCPingExample.java) for a complete implementation.\n\n### Configuration Options\n\nThe `MCPingOptions` class supports the following configuration:\n\n- `hostname` (required) - Server hostname or IP address\n- `port` (optional, default: 25565) - Server port\n- `timeout` (optional, default: 5000) - Connection timeout in milliseconds\n- `readTimeout` (optional, default: 5000) - Read timeout in milliseconds\n- `charset` (optional, default: UTF-8) - Character encoding for MOTD\n- `protocolVersion` (optional, default: 4) - Minecraft protocol version\n\n### Available Data\n\nThe `MCPingResponse` object provides access to:\n\n- **Description**: Server MOTD with `getText()` and `getStrippedText()` methods\n- **Players**: Online/max player counts and player samples (if provided)\n- **Version**: Protocol version and version name\n- **Favicon**: Base64 encoded server icon\n- **Ping**: Response time in milliseconds\n- **Hostname/Port**: Resolved server address (useful with SRV records)\n\n## Requirements\n\n- Java 8 or higher\n- Maven for building\n\n## Credits\n\nThis project is based on the original work of:\n\n- **jamietech**: [MinecraftServerPing](https://github.com/jamietech/MinecraftServerPing)\n- **zh32**: [Server List Ping implementation](https://gist.github.com/zh32/7190955)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucaazalim%2Fminecraft-server-ping","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucaazalim%2Fminecraft-server-ping","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucaazalim%2Fminecraft-server-ping/lists"}