布吉岛API开发文档
开发说明
接口域名
- 正式环境：
http://api.bjd-mc.com:8080
申请方式
联系官方管理申请个人的开发者秘钥，QQ：97960910，后续考虑开放自助申请。
使用须知
禁止使用此接口实现不公平的优势，例如：制作overlay等程序，本接口主旨是用于查询自己或他人的战绩，不是用来海量查询对局内游戏用户数据来实现不公平的优势。一经发现，封禁TOKEN且不再授权。
数据格式
返回标准的Json格式，由开发者自行解析
错误信息
使用标准的HTTP状态码代表具体错误，可前往错误代码处查看详情
玩家数据模块
起床战争数据
接口
POST /gamestats
本接口用于获取用户的起床战争战绩
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问token |
| Content-Type | application/json | 请求方式 |
参数说明
| 字段名 | 必须 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 玩家的昵称 |
| gametype | 是 | String | 游戏类型（bedwars） |
| subtype | 否(不传入默认为"all") | String | 榜单类型（"all","2025","2026"等） |
返回说明
{
"_id": "dacd251f-462d-****-****-d05bf613b5df",//用户的uuid，唯一身份信息
"name": "******", //用户昵称
"banned": true, //封禁状态：若为封禁状态，则应告知用户此战绩仅供参考
"bedwars": { //起床战争
"bwxp32": { //模式：此处为经验模式32人
"use_item": { //使用的特殊道具
"CHEST": 298, //防御塔
"WOLF_SPAWN_EGG": 658, //铁傀儡
"GOLDEN_APPLE": 21063, //金苹果
"BLAZE_ROD": 923, //救援平台
"ENDER_PEARL": 8329, //末影珍珠
"TNT": 551, //TNT
"FIRE_CHARGE": 12562, //烈焰弹
"SNOWBALL": 779 //搭桥蛋
},
"bed_destory": 1234, //拆床数
"game": 1597, //游戏场次
"upgrade": { //团队商店
"DEFENSE": 217, //防御陷阱
"ALARM_TRAP": 91, //报警陷阱
"SHARPNESS": 642, //锋利附魔
"COUNTER_OFFENSIVE_TRAP": 60,//反击陷阱
"PROTECTION": 1465, //护甲强化
"HEAL": 41, //治愈池
"TRAP": 279, //这是个陷阱
"FAST_DIG": 209, //疯狂矿工
"IRON_FORGE": 342 //铁锻炉
},
"final_kills": 6328, //最终击杀
"lose": 460, //失败
"bed_lose": 1234, //被拆床，数据有误，2024年11月11日重新统计
"win": 1137, //胜利
"deaths": 2360 //死亡
},
"bwxp64": {
},
"bwxp8x4": {
}
}
}
空岛战争数据
接口
POST /gamestats
本接口用于获取用户的起床战争战绩
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问token |
| Content-Type | application/json | 请求方式 |
参数说明
| 字段名 | 必须 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 玩家的昵称 |
| gametype | 是 | String | 游戏类型（skywars） |
| subtype | 否(不传入默认为"all") | String | 榜单类型（"all","2025","2026"等） |
返回说明
{
"_id": "46c00736-****-****-****-919c6e734a7c", //
"name": "*****", //
"banned": true, //封禁状态：若为封禁状态，则应告知用户此战绩仅供参考
"skywars": { //空岛战争
"solo": { //单人模式
"kills": 46012, //击杀
"projectileKills": 15770, //弹射物击杀
"use_item": { //使用道具
"TNT": 16296 //TNT
},
"game": 16738, //游戏场次
"special_item": { //神器
"GOLDEN_APPLE": 1464, //附魔金苹果
"TOTEM": 718, //不死图腾
"SLIME_BALL": 994, //击退球
"END_CRYSTAL": 732 //末影水晶
},
"lose": 9587, //失败
"win": 7000, //胜利
"deaths": 9598 //死亡
},
"effect": { //相关效果和配置
"kit": "Enderman", //职业
"particleeffect": "alphabet", //全身特效
"glasscolor": "none", //出生仓
"winsound": "stal", //胜利声音
"projectileeffect": "sparks", //投掷物特效
"killsound": "blazedeath" //击杀声音
},
"swrdouble": { //双人模式
"kills": 10574, //同单人
"projectileKills": 3849, //同单人
"use_item": { //同单人
"TNT": 2222 //同单人
}, //
"game": 3225, //同单人
"special_item": { //同单人
"GOLDEN_APPLE": 172, //同单人
"TOTEM": 17, //同单人
"END_CRYSTAL": 15 //同单人
},
"lose": 1568, //同单人
"win": 1602, //同单人
"deaths": 1567 //同单人
}
}
}
职业枚举
Alchemist 炼金术士
Troll 陷阱大师
Tank 重装战士
Swordsman 剑士
Snow 雪怪
Spider 蜘蛛人
Sniper 鹰眼
Pyromaniac 烈焰人
Notch 史蒂夫
Noob 菜鸟
None 无职业
Ninja 忍者
Musician 音乐家
Leather 游侠
Knockback 弹力拳手
Food 美食家
IceMan 雪人
Flash 闪电
Explosive 爆破者
Feller 樵夫
EnderDragon 末影龙
Enchanter 附魔师
Drown 溺尸
Builder 建造师
Enderman 末影人
Archer 射手
Alchemist 炼金术士
Assassin 刺客
全身特效枚举
water 水花
flame 火焰
smoke 烟雾
critical 暴击
slime 史莱姆
snow 雪
magic 魔法
music 音符
happy 高兴
angry 愤怒
potion 药水
poison 中毒
alphabet 附魔台文字
lava 岩浆
lava_drip 岩浆下落
heart 爱心
redstone 绯红/红石
sparks 烟花
portal 传送门
colourful 多彩
none 无
投掷物特效枚举
water 水花
flame 火焰
smoke 烟雾
critical 暴击
slime 史莱姆
snow 雪
magic 魔法
music 音符
happy 高兴
angry 愤怒
potion 药水
poison 中毒
alphabet 附魔台文字
lava 岩浆
lava_drip 岩浆下落
heart 爱心
redstone 绯红/红石
sparks 烟花
portal 传送门
clouds 云
none 无
出生仓枚举
white 白色玻璃
orange 橙色玻璃
magenta 品红色玻璃
lightblue 浅蓝色玻璃
yellow 黄色玻璃
lime 黄绿色玻璃
pink 粉色玻璃
gray 灰色玻璃
lightgray 浅灰色玻璃
cyan 青色玻璃
purple 紫色玻璃
blue 蓝色玻璃
brown 棕色玻璃
green 绿色玻璃
red 红色玻璃
black 黑色玻璃
lapis 青金石块
redstone 红石块
emerald 绿宝石块
diamond 钻石块
none 玻璃
击杀声音枚举
pigdeath 猪
catdeath 猫
muledeath 骡
lightning 闪电
cathiss 猫 嘶嘶
explosion 爆炸
ghastwarn 恶魂警告
wolfgrowl 狼号
guardiancurse 守卫者诅咒
zombiehorsedeath 僵尸马
zombiedeath 僵尸
blazedeath 烈焰人
guardiandeath 守卫者
endermandeath 末影人
ghasthurt 恶魂
golemdeath 铁傀儡
skeletonhorsedeath 骷髅马
witherdeath 凋零
dragongrowl 末影龙嚎
none 无音效
胜利声音枚举
thunder 雷电
witherambient 凋零
gamemusic 游戏
credits 制作组
witherspawn 凋零生成
11 唱片 11
dragon 末影龙嚎
menu 主菜单
13 唱片 13
enderdragondeath 末影龙之觞
mall Mall 唱片
mellohi Mellohi 唱片
cat Cat 唱片
stal Stal 唱片
far Far 唱片
blocks Blocks 唱片
wait Wait 唱片
chirp Chirp 唱片
ward Ward 唱片
strad Strad 唱片
none 无音效
村庄守卫战数据
接口
POST /gamestats
本接口用于获取用户的村庄守卫战战绩
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问token |
| Content-Type | application/json | 请求方式 |
参数说明
| 字段名 | 必须 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 玩家的昵称 |
| gametype | 是 | String | 游戏类型（vdefense） |
返回说明
{
"banned": true, //封禁状态：若为封禁状态，则应告知用户此战绩仅供参考
"result": {
"wins": 0, //胜利次数
"kills": 196, //击杀数
"highestWave": 15, //最高波数
"level": 4, //当前等级
"gamesPlayed": 4, //游戏场次
"nextLevelExp": 2829, //下一次升级所需经验
"name": "冒险家123456", //玩家名
"loses": 1, //失败次数
"exp": 2148, //经验值
"uuid": "00000000-0000-4000-****-0000000*****", //UUID
"deaths": 2 //死亡次数
},
"ttl": 21595 //缓存超时时间（单位秒）
}
竞技场数据
接口
POST /gamestats
本接口用于获取用户的竞技场战绩
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问token |
| Content-Type | application/json | 请求方式 |
参数说明
| 字段名 | 必须 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 玩家的昵称 |
| gametype | 是 | String | 游戏类型（arenapvp） |
返回说明
{★表示重要数据，☆表示次级数据，其他数据不重要
"banned": true, //封禁状态：若为封禁状态，则应告知用户此战绩仅供参考
"result": { //结果
"kills": 0, //击杀★
"eloSumobestof3elo": 1000, //模式的elo☆
"partyVsPartyWins": 0, //组队胜利☆
"eloSoupelo": 1000, //模式的elo☆
"eloDebuffelo": 1000, //模式的elo☆
"uuid": "********-****-****-****-************", //
"brackets": 0, //特殊模式数据，未启用
"eloCrystalelo": 0, //模式的elo☆
"lms": 0, //特殊模式数据，未启用
"eloNodebuffelo": 1000, //模式的elo☆
"juggernaut": 0, //特殊模式数据，未启用
"globalElo": 1000, //全局ELO★
"eloAxepvpelo": 1000, //模式的elo☆
"id": 5, //用户自增id
"eloComboelo": 1000, //模式的elo☆
"eloBuilduhcelo": 1000, //模式的elo☆
"eloGappleelo": 1000, //模式的elo☆
"deaths": 0, //死亡★
"sumoWins": 0, //特殊模式数据，未启用
"username": "****", //玩家名
"eloSingleelo": 1000 //模式的elo☆
},
"ttl": 21600 //此缓存过期时间
}
逃离暗区数据
接口
POST /gamestats
本接口用于获取用户的逃离暗区游戏数据
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问token |
| Content-Type | application/json | 请求方式 |
参数说明
| 字段名 | 必须 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 玩家的昵称 |
| gametype | 是 | String | 游戏类型（anqu） |
返回说明
{
"banned": true, //封禁状态：若为封禁状态，则应告知用户此战绩仅供参考
"ttl": 21600, //此缓存过期时间
"_id": 67fedc52618500d8f17c7b94, //内部id，忽略
"uuid": {}, //忽略，后续将不返回
"role_id": 00000000-5ed4-ce1b-38e5-d4521c4a4e9d, //uuid，用户唯一uuid
"battle": 1280, //下图次数
"fail": 776, //逃脱失败次数
"name": "早****艰", //玩家名
"stime": 335098, //总探索时间（秒）
"chest": 13129, //总摸箱子数
"escape": 504, //逃脱成功次数
"kill": 1769, //总击杀数
"eat": 1974, //消耗食物
"trap": 79, //设置陷阱
"hit": 232, //箭矢命中
"shoot": 1075, //射箭数
"killMob": 507, //击杀中立生物
"potion": 1146, //消耗药水
"pearl": 3, //使用珍珠
"destroy": 14, //破坏对手防具
"totem": 10 //使用图腾
}
职业战争数据
接口
POST /gamestats
本接口用于获取用户的职业战争战绩
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问token |
| Content-Type | application/json | 请求方式 |
参数说明
| 字段名 | 必须 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 玩家的昵称 |
| gametype | 是 | String | 游戏类型（kitbattle） |
返回说明
{
"result": {
"kills": 62, //击杀
"coins": 2619, //硬币
"projectiles_hit": 24, //远程命中
"challenge_wins": 0, //挑战胜利（未开放）
"uuid": "00000000-0470-47dd-8f50-5f46faa68a27", //玩家uuid
"kits": "PvP+, 弓箭手+++, 吸血鬼, 蝰蛇, 刺客, 蘑菇煲, 禅宗, 南瓜怪, 香精, 雷神, 绿巨人, 冥王, 瞥视者, 登山客, 恶龙, 骑士, 烈焰, 波塞冬, 自爆兵, 忍者, 践踏者, 时间领主, 交换者, 雪傀儡, 灾星", //拥有的职业
"kitUnlockers": 0, //剩余职业箱
"tournament_wins": 0, //竞技胜利（未开放）
"dataexp": 1005, //经验
"soups_eaten": 206, //消耗品使用
"deaths": 50, //死亡
"killstreaks_earned": 13, //连杀
"username": "冒险家ABCD", //玩家名
"abilities_used": 47 //技能使用
},
"ttl": 21600, //
"banned": false //
}