三步接入
从零到在游戏里看到资源列表,大概需要两分钟。
打开 控制台 注册账号,在「账号」页点一次「新建 API Key」,
复制生成的密钥(形如 cs_xxxxx)。
游戏内按 Esc → Custom Soul → 配置 → 账号,
把下面的云端地址和 API Key 填进去,保存。
切到「资源」页的「云端」标签,就能看到全部角色包和技能包了。 选中条目点「下载」即可安装。
游戏内配置参数
可直接复制isOwner /
isPublic / isGlobal 字段驱动。
这个云端做了什么
资源分发
提供角色包与技能包的列表与下载接口。列表里每条都带 SHA-256, 模组下载后会强制校验,不一致直接拒绝安装。
上传即校验
投稿的 ZIP 会在服务端按模组的同一套规则逐项检查:清单完整性、扩展名白名单、 符号链接、路径穿越、压缩比、体积上限。不合格的包挡在上传阶段,不会流到玩家手里。
账号与密钥
一个账号可以签发多个长期有效的 API Key,随时停用或删除。 密钥只以哈希形式存储,明文仅在创建时显示一次。
人工审核
投稿的资源默认进入待审核队列,由管理员确认后才对玩家可见。 被拒绝时会给出具体原因。
常见问题
去控制台的「账号」页确认这个 Key 没有被停用或删除,然后重新复制一遍。 注意 Key 区分大小写,前后不要带空格。
说明云端目前还没有已上架的技能包,模组会自动隐藏这个分类,这是正常行为。 等有人投稿并通过审核后就会出现。
通常是网络中断导致的。重试一次;如果反复出现,请反馈给我们。
模组会自动降级到本地缓存列表,并在界面上提示「云端不可用,正在显示当前账号缓存」, 不会白屏也不会崩溃。