Files
GameServerManager/docs/oneClickDeploy.json
yxsj245 d110668ad7 feat: add one-click deploy functionality and update remote sources
- Introduced a new module for one-click deploy source management, including types and functions for handling game manifests and downloads.
- Added a new constant for the one-click deploy list URL to replace the old third-party online game interface.
- Updated sponsor status documentation to reflect changes in how sponsor eligibility is determined for one-click deploy downloads.
2026-10-02 20:21:04 +08:00

60 lines
3.5 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"_readme": [
"一键开服云端清单。上传地址固定为:https://web.files.xiaozhuhouses.asia/files/开源项目/GameServerManager/oneClickDeploy.json",
"面板会实时拉取该地址:内存缓存 60 秒,点击「刷新列表」会强制重新拉取;云端不可达时回退到上一次成功拉取的本地缓存。",
"games 为空数组是合法状态,表示云端暂未配置游戏,面板会显示「云端暂无游戏」而不是报错;下面的两条示例可直接删掉。",
"单条记录有问题(缺 id、缺 name、缺下载地址、格式不支持、id 重复)只会跳过该条并在面板与服务端日志提示原因,不影响其它游戏。",
"id 是唯一标识,必须与前端发起的 gameId 一致,建议只用小写英文、数字与连字符。",
"download.url 是统一下载地址:赞助者与非赞助者使用同一个 URL,不需要写两份链接。",
"下载环节的差异只在请求本身:本地记录了赞助者密钥、且地址属于 download.xiaozhuhouses.asia 时,面板会先换取会话 Cookie 再请求同一地址,由下载服务调度到赞助者专用节点;没有密钥、或换取会话失败时直接用同一地址普通下载。",
"因此把自己托管的直链写进 url 也是允许的,只是不会走赞助者专用节点。",
"download.platforms 可分别覆盖 windows / linux / macos 的下载配置,未提供的平台回退到顶层配置;macOS 缺少独立配置时回退 linux。",
"format 支持 zip / 7z / tar / tar.gz / tgz / tar.xz / txz;缺省时按 fileName 或下载地址后缀推断。",
"supportedPlatforms 缺省表示 Windows、Linux、macOS 全平台可用。",
"本文件中的下载地址均为占位符,正式上传前请替换为真实链接。"
],
"schemaVersion": 1,
"updatedAt": "2026-02-14T10:00:00+08:00",
"notice": "当前为示例清单,请替换真实下载地址后再上传",
"games": [
{
"id": "example-multi-platform",
"name": "示例游戏(分平台)",
"description": "演示按平台提供不同压缩包,赞助者与非赞助者共用同一下载地址",
"image": "https://web.files.xiaozhuhouses.asia/files/开源项目/GameServerManager/OneClickDeploy/images/example.png",
"type": ["示例类型", "生存"],
"version": "v1.0.0",
"supportedPlatforms": ["windows", "linux"],
"download": {
"fileName": "example-server.zip",
"format": "zip",
"size": 0,
"url": "https://download.xiaozhuhouses.asia/d/PLACEHOLDER_FILE_ID/example-server.zip",
"platforms": {
"windows": {
"fileName": "example-server-windows.zip",
"format": "zip",
"url": "https://download.xiaozhuhouses.asia/d/PLACEHOLDER_FILE_ID/example-server-windows.zip"
},
"linux": {
"fileName": "example-server-linux.tar.gz",
"format": "tar.gz",
"url": "https://download.xiaozhuhouses.asia/d/PLACEHOLDER_FILE_ID/example-server-linux.tar.gz"
}
}
}
},
{
"id": "example-simple",
"name": "示例游戏(单地址)",
"description": "最简写法:所有平台共用同一个压缩包与同一个下载地址",
"image": "",
"type": ["示例类型"],
"version": "v1.0.0",
"download": {
"url": "https://download.xiaozhuhouses.asia/d/PLACEHOLDER_FILE_ID/example-simple-server.7z",
"format": "7z"
}
}
]
}