{"id":122642,"date":"2026-06-07T08:04:06","date_gmt":"2026-06-07T05:04:06","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/"},"modified":"2026-06-07T08:04:06","modified_gmt":"2026-06-07T05:04:06","slug":"playercoordsapi","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/","title":{"rendered":"PlayerCoordsAPI"},"content":{"rendered":"
\n

# PlayerCoordsAPI<\/p>\n

A lightweight Fabric mod that exposes your Minecraft player coordinates via a local HTTP API.<\/p>\n

![Modrinth](https:\/\/modrinth.com\/mod\/playercoordsapi)
\n![Modrinth](https:\/\/modrinth.com\/mod\/playercoordsapi)<\/p>\n<\/div>\n

## \ud83d\udccb Overview<\/p>\n

PlayerCoordsAPI 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.<\/p>\n

## \u2728 Features<\/p>\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, change its port, and configure requests with or without an `Origin` header<\/p>\n

## \ud83d\ude80 Installation<\/p>\n

1. Install Fabric Loader for a supported Minecraft version
\n2. Download the latest `playercoordsapi-x.x.x+mcx.x.x.jar` from the releases page
\n3. Place the jar in your `.minecraft\/mods` folder
\n4. Launch Minecraft with the Fabric profile<\/p>\n

## \u2699\ufe0f Configuration<\/p>\n

The API is read-only and only accepts loopback connections such as `127.0.0.1` and `::1`.
\nFrom Mod Menu, you can configure:
\n– Whether the API is enabled
\n– Which port it listens on (default: `25565`)
\n– How requests without a CORS `Origin` header are handled
\n– How requests with a CORS `Origin` header are handled<\/p>\n

Requests with an `Origin` can be handled in three different modes:
\n– `Allow all`
\n– `Local origins`
\n– `Whitelist`<\/p>\n

In `Whitelist` mode, you can configure each allowed origin with a scheme, host\/IP, and optional port.<\/p>\n

## \ud83d\udd0c API Usage<\/p>\n

| Endpoint | Method | Description |
\n|—————|—————–|———————————————————-|
\n| `\/api\/coords` | `GET`, `OPTIONS` | Returns the player’s current coordinates and world infos |<\/p>\n

### Response Fields<\/p>\n

| Field | Type | Description |
\n|————|———-|——————-|
\n| `x` | `number` | East-West |
\n| `y` | `number` | Height |
\n| `z` | `number` | North-South |
\n| `yaw` | `number` | Horizontal rotation (degrees) |
\n| `pitch` | `number` | Vertical rotation (degrees) |
\n| `world` | `string` | Minecraft world registry ID |
\n| `biome` | `string` | Minecraft biome registry ID |
\n| `uuid` | `string` | Player UUID |
\n| `username` | `string` | Player username |<\/p>\n

### Error Responses<\/p>\n

| Status | Message |
\n|——–|———————|
\n| `403` | Access denied \/ Origin not allowed |
\n| `404` | Player not in world |
\n| `405` | Method not allowed |<\/p>\n

### Response Format Example<\/p>\n

“`json
\n{
\n “x”: 123.45,
\n “y”: 64.00,
\n “z”: -789.12,
\n “yaw”: 180.00,
\n “pitch”: 12.50,
\n “world”: “minecraft:overworld”,
\n “biome”: “minecraft:plains”,
\n “uuid”: “550e8400-e29b-41d4-a716-446655440000”,
\n “username”: “PlayerName”
\n}
\n“`<\/p>\n

## \ud83d\udee0\ufe0f Examples<\/p>\n

Replace `25565` with your configured port if you changed it in the Mod Menu.<\/p>\n

### cURL
\n“`bash
\ncurl http:\/\/localhost:25565\/api\/coords
\n“`<\/p>\n

### Python
\n“`python
\nimport requests<\/p>\n

response = requests.get(“http:\/\/localhost:25565\/api\/coords”)
\ndata = response.json()
\nprint(f”Player {data[‘username’]} (UUID: {data[‘uuid’]}) at X: {data[‘x’]}, Y: {data[‘y’]}, Z: {data[‘z’]}”)
\n“`<\/p>\n

### JavaScript
\n“`javascript
\nfetch(“http:\/\/localhost:25565\/api\/coords”)
\n .then(response => response.json())
\n .then(data => console.log(`Player ${data.username} (UUID: ${data.uuid}) at X: ${data.x}, Y: ${data.y}, Z: ${data.z}`));
\n“`<\/p>\n

—<\/p>\n

\nCrafted by
\n
\nSukikui\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Lightweight Fabric mod exposing locally MC player coords through HTTP API<\/p>\n","protected":false},"featured_media":122643,"template":"","meta":{"_minecraft_slug":"playercoordsapi","_minecraft_project_id":"ZTxdoq6g","_minecraft_author":"Sukikui","_minecraft_license":"MIT","_minecraft_downloads":740,"_minecraft_follows":3,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"playercoordsapi.zip","_minecraft_size_bytes":244234,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-15T22:43:08.251893Z","_minecraft_date_created":"2025-03-04T10:28:42.685308Z","_minecraft_date_modified":"2026-05-12T12:48:51.166034Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playercoordsapi","_minecraft_icon_attachment_id":122643,"_minecraft_imported_at":"2026-06-07T05:04:07+00:00","_minecraft_import_hash":"73be46ad01e4679c8dab92943f7f6b67","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,98,123,92],"mod_loader":[99,100],"minecraft_version":[41,74,38,81,163],"class_list":["post-122642","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-quilt","mod_category-technology","mod_category-utility","mod_loader-fabric","mod_loader-quilt","minecraft_version-1-21-11","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-8","minecraft_version-26-1-2"],"yoast_head":"\nPlayerCoordsAPI - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PlayerCoordsAPI - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Lightweight Fabric mod exposing locally MC player coords through HTTP API\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/starlightskins.lunareclipse.studio\/render\/head\/_Suki_\/full?borderHighlight=true&borderHighlightRadius=7&dropShadow=true\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/\",\"name\":\"PlayerCoordsAPI - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/playercoordsapi-icon-e130c499ce05b222358f9f99f63b0009b1e2bd15.png\",\"datePublished\":\"2026-06-07T05:04:06+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/playercoordsapi-icon-e130c499ce05b222358f9f99f63b0009b1e2bd15.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/playercoordsapi-icon-e130c499ce05b222358f9f99f63b0009b1e2bd15.png\",\"width\":128,\"height\":128},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playercoordsapi\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PlayerCoordsAPI\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PlayerCoordsAPI - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/","og_locale":"en_US","og_type":"article","og_title":"PlayerCoordsAPI - Minecraft","og_description":"Lightweight Fabric mod exposing locally MC player coords through HTTP API","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/starlightskins.lunareclipse.studio\/render\/head\/_Suki_\/full?borderHighlight=true&borderHighlightRadius=7&dropShadow=true","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/","name":"PlayerCoordsAPI - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/playercoordsapi-icon-e130c499ce05b222358f9f99f63b0009b1e2bd15.png","datePublished":"2026-06-07T05:04:06+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/playercoordsapi-icon-e130c499ce05b222358f9f99f63b0009b1e2bd15.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/playercoordsapi-icon-e130c499ce05b222358f9f99f63b0009b1e2bd15.png","width":128,"height":128},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/playercoordsapi\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PlayerCoordsAPI"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/122642","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/122643"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=122642"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=122642"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=122642"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=122642"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}