给你的 Custom Soul 智能体
换个灵魂

这里是 Custom Soul 模组的云端资源站。浏览其他玩家制作的 MMD 角色包与技能包, 在游戏内一键下载安装;也可以把你自己的作品投稿上来分享给所有人。

三步接入

从零到在游戏里看到资源列表,大概需要两分钟。

1拿到 API Key

打开 控制台 注册账号,在「账号」页点一次「新建 API Key」, 复制生成的密钥(形如 cs_xxxxx)。

2填进游戏配置

游戏内按 Esc → Custom Soul → 配置 → 账号, 把下面的云端地址和 API Key 填进去,保存。

3打开资源中心

切到「资源」页的「云端」标签,就能看到全部角色包和技能包了。 选中条目点「下载」即可安装。

游戏内配置参数

可直接复制
云端地址 cloudBaseUrl
https://csoul.xrstudio.cn
角色包列表路径 characterListPath
/api/v1/resources?type=character
技能包列表路径 skillPackListPath
/api/v1/resources?type=skillpack
投稿页 uploadPageUrl
https://csoul.xrstudio.cn/cloud/upload.php
隐私政策页 privacyPageUrl
https://csoul.xrstudio.cn/privacy.html
超时 timeoutSeconds
30
注意:「云端地址」只填到主机名,不要带路径。 模组会丢弃地址里的路径部分,路径请填在上面两个「列表路径」字段里。
关于筛选:资源页的「全部 / 我的 / 公开 / 平台」四个筛选是 客户端过滤,由服务端返回的 isOwner / isPublic / isGlobal 字段驱动。

这个云端做了什么

📦

资源分发

提供角色包与技能包的列表与下载接口。列表里每条都带 SHA-256, 模组下载后会强制校验,不一致直接拒绝安装。

🛡️

上传即校验

投稿的 ZIP 会在服务端按模组的同一套规则逐项检查:清单完整性、扩展名白名单、 符号链接、路径穿越、压缩比、体积上限。不合格的包挡在上传阶段,不会流到玩家手里。

👤

账号与密钥

一个账号可以签发多个长期有效的 API Key,随时停用或删除。 密钥只以哈希形式存储,明文仅在创建时显示一次。

🔍

人工审核

投稿的资源默认进入待审核队列,由管理员确认后才对玩家可见。 被拒绝时会给出具体原因。

常见问题

游戏里提示「API Key 无效」怎么办?

去控制台的「账号」页确认这个 Key 没有被停用或删除,然后重新复制一遍。 注意 Key 区分大小写,前后不要带空格。

看不到「技能包」分类?

说明云端目前还没有已上架的技能包,模组会自动隐藏这个分类,这是正常行为。 等有人投稿并通过审核后就会出现。

下载提示「下载不完整」?

通常是网络中断导致的。重试一次;如果反复出现,请反馈给我们。

云端挂了会怎样?

模组会自动降级到本地缓存列表,并在界面上提示「云端不可用,正在显示当前账号缓存」, 不会白屏也不会崩溃。