
# PlayerCoordsAPI
A lightweight Fabric mod that exposes your Minecraft player coordinates via a local HTTP API.
📋 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
🚀 Installation
- Install Fabric Loader
- Download the latest
playercoordsapi-x.x.x+mcx.x.x.jar
from the releases page - Place the jar in your
.minecraft/mods
folder - Launch Minecraft with the Fabric profile
🔌 API Usage
Endpoint | Method | Description |
---|---|---|
/api/coords |
GET |
Returns the player's current coordinates and world infos |
Response Format
{
"x": 123.45,
"y": 64.00,
"z": -789.12,
"world": "overworld",
"biome": "plains"
}
Response Fields
Field | Type | Description |
---|---|---|
x |
number |
East-West |
y |
number |
Height |
z |
number |
North-South |
world |
string |
Minecraft world |
biome |
string |
Minecraft biome |
Error Responses
Status | Message |
---|---|
403 |
Access denied |
404 |
Player not in world |
🔒 Security
For security reasons, the API server:
- Only accepts connections from localhost
127.0.0.1
- Runs on port
25565
by default - Provides read-only access to player position data
🛠️ Examples
cURL
curl http://localhost:25565/api/coords
Python
import requests
response = requests.get("http://localhost:25565/api/coords")
data = response.json()
print(f"Player 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 at X: ${data.x}, Y: ${data.y}, Z: ${data.z}`));
Made with ❤️ by
Sukikui