饥荒联机版的大厅 API 讲解，说明各个参数的含义
以下 API 返回的内容都在游戏内大厅有体现
很多查服网站/QQ机器人都基于此 API ，例如
weiliang.uu@gmail.com 编辑于 2026.6.27
服务器所属平台，固定字符串
Steam Steam 平台，枚举值为 1
PSN PlayStation 平台，枚举值为 2
Rail WeGame 平台，枚举值为 4
XBone XBox平台，枚举值为 16
Switch Switch平台，枚举值为 32
2026.6.8：手机端正在测试，后续可能会加上
2026.6.9：已经有消息了，7.21手机端正式上线
https://lobby-v2-cdn.klei.com/regioncapabilities-v2.json
GET 无参数
获取各个地区的唯一标识符（即 Klei 在各个地区的大厅服务器）
{
"LobbyRegions": [
{
"Region": "us-east-1"
},
{
"Region": "eu-central-1"
},
{
"Region": "ap-southeast-1"
},
{
"Region": "ap-east-1"
}
]
}
us-east-1 美东（Virginia）eu-central-1 中欧（Frankfurt）ap-southeast-1 东南亚（Singapore）ap-east-1 东亚（Hongkong）一般国内服务器会分配到 ap-southeast-1 和 ap-east-1 ，如果需要扫描全球服务器也可以都加上
https://lobby-v2-cdn.klei.com/<Region>-<Platform>.json.gz
GET 包含两个参数
示例：
https://lobby-v2-cdn.klei.com/ap-east-1-Steam.json.gzhttps://lobby-v2-cdn.klei.com/ap-southeast-1-Rail.json.gz用于获取当前地区 & 平台下的服务器列表，非常长
{
"GET": [
{
"__addr": "223.75.212.24",
"__rowId": "KU_PROlxwF7",
"host": "KU_PROlxwF7",
"steamclanid": "103582791475045866",
"clanonly": false,
"platform": 1,
"mods": true,
"name": "红中777的世界",
"pvp": false,
"session": "76502A2E1D939376",
"fo": false,
"password": false,
"guid": "4414974742339413782",
"maxconnections": 3,
"dedicated": true,
"clienthosted": true,
"ownernetid": "R:76561197974902469",
"connected": 1,
"mode": "survival",
"port": 10999,
"v": 728321,
"tags": "WS:DA,简体中文 (simplified chinese),survival,洞穴",
"season": "summer",
"lanonly": false,
"intent": "relaxed",
"allownewplayers": true,
"kleiofficial": false,
"serverpaused": true,
"steamid": "90286736685008923",
"psnsessionid": "bbbe96c0-5187-4464-9889-f9e49f4f5efc",
"steamroom": "0",
"secondaries": {
"1449762760": {
"__addr": "223.75.212.24",
"id": "1449762760",
"steamid": "90286736685005851",
"port": 10998
}
}
},
更多服务器...
]
}
可能会有一些遗漏的字段
__addr 服务器主世界的 IP 地址__rowId 这条服务器在大厅中的 ID，不固定，随时会变化host 服务器主机使用的开服 Token 的 Klei ID，客户端房间的话一般可以当作是房主的 Klei IDsteamclanid 群组（Clan）的公开 ID ，使用 https://steamcommunity.com/gid/<ClanID>/ 访问clanonly 仅限群组（Clan）人员进入platform 所属平台，值为枚举值mods 启用模组name 服务器名pvp 玩家对战session 服务器主世界的 sessionid，使用 TheWorld.meta.session_identifier 获取fo 仅好友可进（即 FriendOnly）password 启用密码guid 服务器唯一标识符，用于向 Klei 发送举报（screens/serverlistingscreens.lua 397行），但游戏里似乎并未实装此功能maxconnections 玩家最大连接数dedicated 专用服务器房间（一般是多世界房间）clienthosted 游戏客户端开启的服务器ownernetid 不清楚connected 已连接的玩家数mode 游戏模式port 服务器主世界端口v 服务器的游戏版本，不同平台可能会有偏差tags 服务器标签，字符串以 , 分隔season 季节lanonly 局域网房间intent 风格allownewplayers 允许新玩家进入，使用 TheNet:SetAllowIncomingConnections(bool) 调整kleiofficial Klei官方服务器serverpaused 服务器暂停steamid 不清楚，可能跟Steam有关psnsessionid 不清楚，可能是 PS 平台特有steamroom 不清楚，平台不同值也不同secondaries 从世界连接1449762760 从世界的ID（在存档文件的server.ini，以 ID 作为 Key 可能是为了防止重复）__addr 从世界的IP地址id 也是从世界的IDsteamid 不清楚port 从世界端口https://lobby-v2-<Region>.klei.com/lobby/read
POST 包含一个参数和请求体（注意 Region 和 __rowId 要对应）
示例：
https://lobby-v2-ap-east-1.klei.com/lobby/read
https://lobby-v2-ap-southeast-1.klei.com/lobby/read
用于获取房间的详情
我测试了 20 线程 Read，4分钟左右可扫完 2000+ 服务器，但对 CPU 性能有一定要求，并且 API 似乎没有速率限制，猛猛扫，Python 代码下载
{
"__gameId": "DontStarveTogether",
"__token": "Klei开服Token",
"query": {
"__rowId": "list服务器的__rowId"
}
}
{
"GET": [
{
"__addr": "112.0.152.171",
"__rowId": "KU_Zzh0_OIb",
"host": "KU_Zzh0_OIb",
"steamclanid": "103582791475045866",
"clanonly": false,
"platform": 1,
"mods": true,
"name": "文姿的世界",
"pvp": false,
"session": "6FEC324DEFC945C5",
"fo": false,
"password": false,
"guid": "8058977555117627454",
"maxconnections": 6,
"dedicated": true,
"clienthosted": true,
"connected": 1,
"mode": "survival",
"port": 10999,
"v": 728321,
"tags": "WS:AA,简体中文 (simplified chinese),survival,洞穴,wormhole marks",
"season": "autumn",
"lanonly": false,
"intent": "survival",
"allownewplayers": true,
"kleiofficial": false,
"serverpaused": false,
"steamid": "90286743238795266",
"steamroom": "0",
"secondaries": {
"3906936301": {
"__addr": "112.0.152.171",
"id": "3906936301",
"steamid": "90286743238793218",
"port": 10998
}
},
"data": "return { day=13, dayselapsedinseason=12, daysleftinseason=8 }",
"worldgen": "return {str=\"AQAAABAAAAAREAAATQUAAHjanVdLj9xEEP4r0Zx9yD4CymEOUVgBEggpG8LRKttlu+V2t1PdXq8zGmnhQCReB+DAiSCkRQKJWxAc4M+QZJOc+AtUe2bj9mPCCu1qt7vdXV2Pr76qJrQ1qWurVQmnYSWhlcLYsNJGWKHV8ubNm4FBa4XKTCiS5eL4wzv33r13673w7gdvH9195+jOIlB1SaASXYa8M6wExmiWh4GpI2OFrS3PVuuA8H4tCBO3abtntTiOa1mxAmjCvUWweB9OG5TyxmLdX6qgxOXi+bePnv363SJoNMkkQ7VrOUETLxcXPzx89vDTJ2efvTw/f/Hl10/OPn/61zcvf/niydkni6AUasbQ64E+QSKRYCjxBGVoLPH9yxSkwWCH5a9sqghTiJxFZS2tcOKRWDhZkGxMzmL5WlFCtRV4BT1f2bTj8kt9+dYIgTKk5QJkA61hG7VWoSXEkDAj3dh8ueDtbQrGsmSQVJt+dyUILBKIxIxEmIovoMkqVNL55tVqKnXD22Yvy3JtrAElbJvwFao/ZesyktggJv2aFFluY4Jo6zynWP81AmvCLTI89UGWsVbIX1woZs5NzIhqpdqSfTsRlpLO/I2IZiznfo3omUE6LrwtOVARaTFxzsiHEQevjWqT9+sJxiKpdW1KrYz1wxmDjfnQWMbw5m4pBiJtx3fVUhYoq35Zxwgq1JZvSXAi11igVPiqdcu5tqaigbdKkBwT0sYTAcpKzihOn6j2g5ARGJNhUWhv8waKMzHVDXs6ZE8U2M5jATnlpJ44yVOOvUtal/4W5515nILKOCCDcM/EKNe1Skr3p18rJNQjyEwNYtUKZr3audzMxHxnskqBqXcgU0ANCOmphCBtXqHif60vGSmWuvLOWlQWYumbmHIi2zEuGscGzGHuy2alx4GLh+X7Z2NSEJSV7wuHIhPnWktvEVvUKd9AesBYhrnU6km2zfiyRCpH2EyJDzO/ZAMA8D5fHjuIoR0Xs36OBPn0F+fog1pyjeo8YoaJH4oYR+gIO3j4+2ZuY4aLxByZMQz8sxEo/nEYnHX4VoyXN6iyWvgZ3ejIDDG3DfJmPfGpbELsJZDJhxmwOW0QOldeAoSA8PLblG661PemriQwXpn9x9Sv+PpMgwfJTGuDpfvjh1zO5VjHZzPrvNkkUEKGFgpnr+Jq4dggtvU8GbhsHJSLBw+APF25Q6CM96jZ05cFyUmZqclejnaATWU7pih/7pScFrudfMH0MypQFfqqdwCbV1u4ysfgAecdU0GjSp2wuqk4xcRxcgdANJwLcdc0jUGRa5B+W5HNBCOvfcJpuHFEV1MsgSP8CSoqPcilrrwO8sOImFXSNcW+PwYZaUbI8cQx5yS+NsbnywRark8F0r4PBQeyQciYVpAU5+XQNPaVHJMK52sxajeYtwbSbCOyrO0AOBeldcBD45x/GEjNNa+LQ6rZBy6E3Hga20oOGkfpRJxw+9m30ldoOqeN/KBJ3+cm3ZseDKeHw+kNnt52NNp2zf12uN8PD/rhYT/0jr3Rvwm858F+Pzzoh4f90Dv2Jg8/Anrg2sM9b7zvjQ/YqYPnxDpYRcxt7HtH54pzgPlNZbhcXQ/21sP30FvHd8Pbt+4d7XgGXR8/g0bvmovH3z//+fHkXTNZ3obuqx8vHp1vPv599hP/Xnv6x9mL337/58+P///Dpjfhqu+Zq2gzeL70V0yfQkOLdz9De7THcIJTWL9WG++xNCW2+Xq0o68CbtjcO2ZKVTvKzKQpeg2PkgbHF8rVF8cgpnBg2ljMdqbA0Xjdk8p17jYceuq/WdLjlPX6X+U5OAI=\"}",
"players": "return {\n {\n colour=\"CD4F39\",\n eventlevel=0,\n name=\"文姿\",\n netid=\"76561199010636358\",\n prefab=\"wilson\" \n } \n}",
"mods_info": [
"workshop-362175979",
"Wormhole Marks",
"1.4.5",
"1.4.5",
true,
"LuaJit",
"LuaJit",
"1.0.1",
"1.0.1",
false
],
"desc": "Hello, World!",
"tick": 15,
"clientmodsoff": false,
"nat": 5
}
]
}
可能会有一些遗漏的字段
__addr 至 secondaries 都与 List 部分重复，跳过
dataday 天数dayselapsedinseason 当前季节已过的天数daysleftinseason 当前季节剩余的天数worldgen 压缩后的世界配置数据players 已连接的玩家colour 玩家的颜色（即计分板中的玩家头像框和名字的颜色）eventlevel 活动（暴食/熔炉）的等级，目前并没有此类活动，所以都是 0name 玩家名prefab 选择的人物（即预制体）netid SteamID，通过 https://steamcommunity.com/profiles/<netid>/ 可以查到玩家Steam主页mods_info 模组信息（若模组为 server_only 且设置了自隐藏则不会被显示），每 5 条为一组workshop-362175979 模组的创意工坊 ID ，以 workshop- 开头判断是否为创意工坊模组，使用https://steamcommunity.com/sharedfiles/filedetails/?id=<ID> 查看Wormhole Marks 模组名1.4.5 分别代表服务器和创意工坊的模组版本，用于验证服务器模组是否过期（猜测）true 是否需要客户端加载此模组desc 服务器描述（即 Description）tick 服务器与客户端的通信频率，（存档文件 Cluster.ini 的 tick_rate）clientmodsoff 服务器禁用客户端的本地模组，进入房间时会提示，Klei 没有开放这个功能nat 网络 Nat 分级（猜测），一般各类云服有公网IP就是 5 ，家宽一般是 7https://api.dstserverlist.top/api/v2/Server/Version
第三方API，获取最新的游戏版本，可能会有一段时间的延迟
GET 返回文本，POST 返回 JSON