PlayerCoordsAPI

📋 Обзор

PlayerCoordsAPI предоставляет доступ к координатам вашего игрока в Minecraft в реальном времени через простой HTTP-эндпоинт. Это позволяет внешним приложениям отслеживать вашу позицию без необходимости читать память Minecraft или захватывать экран.

✨ Возможности

• Легкий HTTP-сервер, работающий только на localhost и предоставляющий ваши координаты
• Только клиентская часть — серверные компоненты не нужны
• Работает в одиночной и многопользовательской игре
• Интеграция с Mod Menu позволяет включать/отключать API, менять порт и настраивать запросы с заголовком Origin или без него

🚀 Установка

1. Установи Fabric Loader для поддерживаемой версии Minecraft
2. Скачай последний playercoordsapi-x.x.x+mcx.x.x.jar со страницы релизов
3. Помести jar в папку .minecraft/mods
4. Запусти Minecraft с профилем Fabric

⚙️ Настройка

API работает только на чтение и принимает лишь loopback-подключения, такие как 127.0.0.1 и ::1. Через Mod Menu можно настроить:

• Включён ли API
• На каком порту он слушает (по умолчанию: 25565)
• Как обрабатываются запросы без заголовка CORS Origin
• Как обрабатываются запросы с заголовком CORS Origin

Запросы с Origin можно обрабатывать в трёх режимах:

• Allow all
• Local origins
• Whitelist

В режиме Whitelist можно настроить каждый разрешённый origin со схемой, хостом/IP и необязательным портом.

🔌 Использование API

Поля ответа

Ответы с ошибками

Пример формата ответа

{
  "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"
}

🛠️ Примеры

Замени 25565 на настроенный порт, если ты менял его в 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}`));

Crafted by Sukikui