{"id":21971393,"url":"https://github.com/SpencerSharkey/gomc","last_synced_at":"2025-07-22T17:33:01.710Z","repository":{"id":57511519,"uuid":"109222382","full_name":"SpencerSharkey/gomc","owner":"SpencerSharkey","description":"⛏️minecraft golang library","archived":false,"fork":false,"pushed_at":"2020-06-08T20:05:37.000Z","size":32,"stargazers_count":6,"open_issues_count":3,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-06-19T23:29:31.887Z","etag":null,"topics":["go","go-library","golang-library","minecraft","minecraft-api","minecraft-query"],"latest_commit_sha":null,"homepage":"","language":"Go","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/SpencerSharkey.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}},"created_at":"2017-11-02T05:42:08.000Z","updated_at":"2023-04-13T01:32:26.000Z","dependencies_parsed_at":"2022-08-29T05:21:04.919Z","dependency_job_id":null,"html_url":"https://github.com/SpencerSharkey/gomc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpencerSharkey%2Fgomc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpencerSharkey%2Fgomc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpencerSharkey%2Fgomc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpencerSharkey%2Fgomc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SpencerSharkey","download_url":"https://codeload.github.com/SpencerSharkey/gomc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227149549,"owners_count":17738250,"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","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":["go","go-library","golang-library","minecraft","minecraft-api","minecraft-query"],"created_at":"2024-11-29T14:50:23.320Z","updated_at":"2024-11-29T14:50:32.679Z","avatar_url":"https://github.com/SpencerSharkey.png","language":"Go","readme":"Minecraft Go\n===\n[![Build Status](https://travis-ci.org/SpencerSharkey/gomc.svg?branch=master)](https://travis-ci.org/SpencerSharkey/gomc)\n[![Coverage Status](https://coveralls.io/repos/github/SpencerSharkey/gomc/badge.svg?branch=master)](https://coveralls.io/github/SpencerSharkey/gomc?branch=master)\n[![Maintainability](https://api.codeclimate.com/v1/badges/9b0cf6b594cbf294dd5c/maintainability)](https://codeclimate.com/github/SpencerSharkey/gomc/maintainability)\n[![HitCount](http://hits.dwyl.io/SpencerSharkey/gomc.svg)](http://hits.dwyl.io/SpencerSharkey/gomc)\n\n## Introduction\nGo (golang) library for Minecraft utilities. \n\nThe only functionality currently implemented is a query client compatible with the vanilla Minecraft [query protocol](http://wiki.vg/Query).\n\nPlanned packages:\n* ~~query~~ [/query](https://github.com/SpencerSharkey/gomc/tree/master/query)\n* rcon\n\n**Note:** This package is being developed for use within the [spencersharkey/mcapi](https://github.com/spencersharkey/mcapi) application, aimed at exposing an HTTP client for various Minecraft-related utilities.\n\n## \"query\" Package Documentation\n\n### (*query.Request) Simple()\n```golang\ntype SimpleResponse struct {\n\tHostname   string `json:\"hostname\"`\n\tGameType   string `json:\"gametype\"`\n\tMap        string `json:\"map\"`\n\tNumPlayers int    `json:\"numplayers\"`\n\tMaxPlayers int    `json:\"maxplayers\"`\n\tHostPort   int16  `json:\"hostport\"`\n\tHostIP     string `json:\"hostip\"`\n}\n```\nSimple request example:\n```golang\nreq := query.NewRequest()\nerr := req.Connect(\"127.0.0.1:25565\")\nres, err := req.Simple()\n```\n```json\n{\n  \"hostname\": \"Revive Minecraft! http://revive.gg/chat\",\n  \"gametype\": \"SMP\",\n  \"map\": \"world\",\n  \"numplayers\": 4,\n  \"maxplayers\": 128,\n  \"hostport\": 25565,\n  \"hostip\": \"127.0.0.1\"\n}\n```\n### (*query.Request) Full()\n*Note:* `FullResponse` embeds the `SimpleResponse` struct\n```golang\ntype FullResponse struct {\n\tSimpleResponse\n\tInfo    map[string]string `json:\"info\"`\n\tPlayers []string          `json:\"players\"`\n}\n```\nFull request example:\n```golang\nreq := query.NewRequest()\nerr := req.Connect(\"127.0.0.1:25565\")\nres, err := req.Full()\n```\n```json\n{\n  \"hostname\": \"Revive Minecraft! http://revive.gg/chat\",\n  \"gametype\": \"SMP\",\n  \"map\": \"world\",\n  \"numplayers\": 4,\n  \"maxplayers\": 128,\n  \"hostport\": 25565,\n  \"hostip\": \"127.0.0.1\",\n  \"info\": {\n    \"game_id\": \"MINECRAFT\",\n    \"plugins\": \"\",\n    \"version\": \"1.12.2\"\n  },\n  \"players\": [\n    \"SpencerSharkey\",\n    \"RumBull\",\n    \"lonemajestyk\",\n    \"nakkirakki\"\n  ]\n}\n```\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSpencerSharkey%2Fgomc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSpencerSharkey%2Fgomc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSpencerSharkey%2Fgomc/lists"}