跳转到内容
logo
我的世界XyeBBS论坛3群 进群吹水聊天!众多整合包作者、插件作者、玩家在内哦!不定时发福利,公布重要通知!

【API教程】XyeBBS整合包游玩记录上报接口接入教程

icon论坛事务-其他浏览 595回复 0
发布于 2025-06-28 18:08:04

整合包游玩记录上报接口接入教程

介绍

该接口可用于为您的整合包提供云端的玩家游玩数据的记录,您只需要接入该平台。

我们将为你提供全套的适配Mod,模组将会在触发对应条件时,提示玩家对对应整合包进行评分。

同时我们将会记录客户端如下数据:

  1. 提交IP
  2. 玩家ID
  3. 是否正版
  4. 游玩时间
  5. 玩家死亡次数
  6. 击杀怪物数量
  7. 挖掘方块数量
  8. 是否完成所有任务
  9. 评分值
  10. 评分内容

为防止接口的滥用,我们将会进行一些常规的防机器人手段:

  • 必须携带对应的User-Agent,否则请求将会被过滤
  • 对应资源同一IP仅能提交一次数据,后续将无法修改

接口详细

请求地址

https://resource-api.xyeidc.com/api/resources/{resourceId}/play/records

请求格式

POST

请求头

"UserAgent": "XyeBBS-GameClient"

请求Body

字段类型必须备注
gameIdstring√玩家ID
onlineModestring√玩家ID
playTimelong√游玩时间(minute)
deathCountinteger√死亡次数
breakBlockCountinteger√挖掘方块数量
placeBlockCountinteger√放置方块数量
killCountinteger√击杀数量
questFinishedboolean是否完成所有任务
scorefloat√分数(0-5)
notesstring评论内容

范例

{
    "gameId": "EvoYyc", 
    "onlineMode": true, 
    "playTime": 1232, 
    "deathCount": 23, 
    "breakBlockCount": 4262, 
    "placeBlockCount": 4244, 
    "killCount": 321, 
    "questFinished": true, 
    "score": 5, 
    "notes": "评价内容"
}

返回值

Success - 成功

{
    "data": null,
    "msg": "Success",
    "code": 200
}

Fail - 失败

{
    "data": null,
    "msg": "失败原因",
    "code": 501
}

注意事项

必须携带User-Agent否则请求将被过滤

代码范例(待完成)

XyeAPI.java

// 使用Java语言接入
帖子打赏
参与人数打赏物品(0)

正在加载内容…
回复帖子善语结善缘,恶语伤人心。要记得文明发言哦!
登录后参与讨论登录账号后即可发表您的回复和看法