PlayerCoordsAPI

模组

· 作者 Sukikui

轻量级 Fabric 模组,通过 HTTP API 暴露本地 Minecraft 玩家坐标

0 本站下载 0 关注 更新于 1 个月前

需要前置:Cloth Config API、Fabric API

最新 0.2.1+mc26.3 · 26.3 · Fabric / Quilt

一键开服(送7天)

PlayerCoordsAPI icon  PlayerCoordsAPI

一个轻量级的 Fabric 模组,通过本地 HTTP API 暴露你的 Minecraft 玩家坐标。

? 概览

PlayerCoordsAPI 通过一个简单的 HTTP 端点提供对你 Minecraft 玩家坐标的实时访问。这使得外部应用程序能够追踪你的位置,而无需读取 Minecraft 内存或捕获屏幕。

✨ 特性

  • 仅在 localhost 上运行的轻量级 HTTP 服务器,提供你的坐标
  • 仅客户端 - 不需要服务端组件
  • 适用于单人游戏和多人游戏
  • Mod 菜单集成,允许你启用/禁用 API、更改端口,并配置是否携带 Origin 头部的请求

? 安装

  1. 为受支持的 Minecraft 版本安装 Fabric Loader
  2. 从 发布页面 下载最新的 playercoordsapi-x.x.x+mcx.x.x.jar
  3. 将 jar 文件放入 .minecraft/mods 文件夹
  4. 使用 Fabric 配置文件启动 Minecraft

⚙️ 配置

该 API 为只读模式,仅接受回环连接,如 127.0.0.1 和 ::1。 在 Mod 菜单中,你可以配置:

  • 是否启用 API
  • 监听哪个端口(默认:25565)
  • 如何处理不带 CORS Origin 头部的请求
  • 如何处理带 CORS Origin 头部的请求

带 Origin 的请求可以通过三种不同的模式处理:

  • Allow all(允许所有)
  • Local origins(本地来源)
  • Whitelist(白名单)

在 Whitelist 模式下,你可以配置每个允许的来源,包括协议、主机/IP 和可选端口。

? API 用法

端点 方法 描述
/api/coords GET, OPTIONS 返回玩家当前的坐标和世界信息

响应字段

字段 类型 描述
x number 东西方向
y number 高度
z number 南北方向
yaw number 水平旋转角度(度)
pitch number 垂直旋转角度(度)
world string Minecraft 世界注册 ID
biome string Minecraft 生物群系注册 ID
uuid string 玩家 UUID
username string 玩家用户名

错误响应

状态码 消息
403 拒绝访问 / 来源不允许
404 玩家不在世界中
405 方法不允许

响应格式示例

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

?️ 示例

如果你在 Mod 菜单中更改了端口,请将 25565 替换为你配置的端口。

cURL

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

Python

import requests

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

JavaScript

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

由以下人员制作 Sukikui

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源