{"id":25912919,"url":"https://github.com/sukikui/playercoordsapi","last_synced_at":"2026-03-13T01:08:45.648Z","repository":{"id":280169372,"uuid":"940252160","full_name":"Sukikui/PlayerCoordsAPI","owner":"Sukikui","description":"A lightweight Fabric mod that exposes your Minecraft player coordinates via a local HTTP API","archived":false,"fork":false,"pushed_at":"2025-03-01T17:31:09.000Z","size":86,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-01T18:31:22.233Z","etag":null,"topics":["api","client-side","fabric","http","minecraft-mod"],"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/Sukikui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-02-27T21:28:40.000Z","updated_at":"2025-03-01T17:30:29.000Z","dependencies_parsed_at":"2025-03-01T18:31:36.524Z","dependency_job_id":"47f7ba89-3e3d-47a7-9032-e41b5e22b80a","html_url":"https://github.com/Sukikui/PlayerCoordsAPI","commit_stats":null,"previous_names":["sukikui/playercoordsapi"],"tags_count":1,"template":false,"template_full_name":"FabricMC/fabric-example-mod","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sukikui%2FPlayerCoordsAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sukikui%2FPlayerCoordsAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sukikui%2FPlayerCoordsAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sukikui%2FPlayerCoordsAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sukikui","download_url":"https://codeload.github.com/Sukikui/PlayerCoordsAPI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241644551,"owners_count":19996179,"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":["api","client-side","fabric","http","minecraft-mod"],"created_at":"2025-03-03T10:17:28.231Z","updated_at":"2026-03-13T01:08:45.602Z","avatar_url":"https://github.com/Sukikui.png","language":"Java","readme":"\u003cdiv align=\"center\"\u003e\n\n# PlayerCoordsAPI\n\nA lightweight Fabric mod that exposes your Minecraft player coordinates via a local HTTP API.\n\n\u003c/div\u003e\n\n## 📋 Overview\n\nPlayerCoordsAPI provides real-time access to your Minecraft player coordinates through a simple HTTP endpoint. This enables external applications to track your position without needing to read Minecraft's memory or capture the screen.\n\n## ✨ Features\n\n- Lightweight HTTP server running only on localhost providing your coordinates\n- Client-side only - no server-side components needed\n- Works in singleplayer and multiplayer\n- Mod menu integration allowing you to enable/disable the API\n\n## 🚀 Installation\n\n1. Install [Fabric Loader](https://fabricmc.net/use/)\n2. Download the latest `playercoordsapi-x.x.x+mcx.x.x.jar` from the [releases page](https://github.com/Sukikui/PlayerCoordsAPI/releases)\n3. Place the jar in your `.minecraft/mods` folder\n4. Launch Minecraft with the Fabric profile\n\n## 🔌 API Usage\n\n| Endpoint      | Method | Description                                              |\n|---------------|--------|----------------------------------------------------------|\n| `/api/coords` | `GET`  | Returns the player's current coordinates and world infos |\n\n### Response Format\n\n```json\n{\n  \"x\": 123.45,\n  \"y\": 64.00,\n  \"z\": -789.12,\n  \"world\": \"overworld\",\n  \"biome\": \"plains\"\n}\n```\n\n### Response Fields\n\n| Field   | Type     | Description     |\n|---------|----------|-----------------|\n| `x`     | `number` | East-West       |\n| `y`     | `number` | Height          |\n| `z`     | `number` | North-South     |\n| `world` | `string` | Minecraft world |\n| `biome` | `string` | Minecraft biome |\n\n### Error Responses\n\n| Status | Message             |\n|--------|---------------------|\n| `403`  | Access denied       |\n| `404`  | Player not in world |\n\n## 🔒 Security\n\nFor security reasons, the API server:\n- Only accepts connections from localhost `127.0.0.1`\n- Runs on port `25565` by default\n- Provides read-only access to player position data\n\n## 🛠️ Examples\n\n### cURL\n```bash\ncurl http://localhost:25565/api/coords\n```\n\n### Python\n```python\nimport requests\n\nresponse = requests.get(\"http://localhost:25565/api/coords\")\ndata = response.json()\nprint(f\"Player at X: {data['x']}, Y: {data['y']}, Z: {data['z']}\")\n```\n\n### JavaScript\n```javascript\nfetch(\"http://localhost:25565/api/coords\")\n  .then(response =\u003e response.json())\n  .then(data =\u003e console.log(`Player at X: ${data.x}, Y: ${data.y}, Z: ${data.z}`));\n```\n\n\u003cdiv align=\"center\"\u003e\nMade with ❤️ by \n\u003cimg src=\"https://crafatar.com/avatars/7d2159e810514c3eb504c279cadd4273?size=100\u0026overlay\" width=\"20\" height=\"20\" style=\"vertical-align: -3px;\"\u003e \nSukikui\n\u003c/div\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsukikui%2Fplayercoordsapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsukikui%2Fplayercoordsapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsukikui%2Fplayercoordsapi/lists"}