📋 Overview

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.

✨ Features

• Lightweight HTTP server running only on localhost providing your coordinates
• Client-side only - no server-side components needed
• Works in singleplayer and multiplayer
• Mod menu integration allowing you to enable/disable the API, change its port, and configure requests with or without an Origin header

🚀 Installation

1. Install Fabric Loader for a supported Minecraft version
2. Download the latest playercoordsapi-x.x.x+mcx.x.x.jar from the releases page
3. Place the jar in your .minecraft/mods folder
4. Launch Minecraft with the Fabric profile

⚙️ Configuration

The API is read-only and only accepts loopback connections such as 127.0.0.1 and ::1.
From Mod Menu, you can configure:

• Whether the API is enabled
• Which port it listens on (default: 25565)
• How requests without a CORS Origin header are handled
• How requests with a CORS Origin header are handled

Requests with an Origin can be handled in three different modes:

• Allow all
• Local origins
• Whitelist

In Whitelist mode, you can configure each allowed origin with a scheme, host/IP, and optional port.

🔌 API Usage

Endpoint	Method	Description
/api/coords	GET, OPTIONS	Returns the player's current coordinates and world infos

Response Fields

Field	Type	Description
x	number	East-West
y	number	Height
z	number	North-South
yaw	number	Horizontal rotation (degrees)
pitch	number	Vertical rotation (degrees)
world	string	Minecraft world registry ID
biome	string	Minecraft biome registry ID
uuid	string	Player UUID
username	string	Player username

Error Responses

Status	Message
403	Access denied / Origin not allowed
404	Player not in world
405	Method not allowed

Response Format Example

{
  "x": 123.45,
  "y": 64.00,
  "z": -789.12,
  "yaw": 180.00,
  "pitch": 12.50,
  "world": "minecraft:overworld",
  "biome": "minecraft:plains",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "username": "PlayerName"
}

🛠️ Examples

Replace 25565 with your configured port if you changed it in the Mod Menu.

cURL

curl http://localhost:25565/api/coords

Python

import requests

response = requests.get("http://localhost:25565/api/coords")
data = response.json()
print(f"Player {data['username']} (UUID: {data['uuid']}) at X: {data['x']}, Y: {data['y']}, Z: {data['z']}")

JavaScript

fetch("http://localhost:25565/api/coords")
    .then(response => response.json())
    .then(data => console.log(`Player ${data.username} (UUID: ${data.uuid}) at X: ${data.x}, Y: ${data.y}, Z: ${data.z}`));

---