资源包、复刻与导出
发布本身在发布。这一页讲的是一张卡整个或部分离开你账号的三种方式:别人做可编辑的副本,把一套系统带进另一张卡的资源包,以及完整的 JSON 导出。
复刻
一个世界发布了并且允许二次创作,其他用户就可以做自己的副本:
- 创建一份完整的副本,归复刻的人所有
- 名字自动加编号:原作叫「Dark Forest」,你的副本就是「Dark Forest (1)」;再复刻一次就是「Dark Forest (2)」
- 副本从草稿开始,不会自动发布
- 保留原作的所有标签、描述、封面、schema 和内容
- 原世界的
downloadCount加 1 - 副本的
sourceWorldId指回原作,方便追溯 - 引用到的素材(比如图片)也一起复制过来
资源包
比方说你花了两周做出一套打磨好的战斗系统:变量、行为、界面、音效。一个朋友在做世界,需要一套战斗系统。你不用把整个世界给他。把战斗相关的部分打包,发过去就行。
资源包是你世界里选出来的部分打成的一个包。
资源包里有什么:
| 部分 | 包含内容 | 必需吗? |
|---|---|---|
| 名称与描述 | 资源包名称、描述、标签、封面、语言、创建日期 | 名称必填 |
| 词条 | 角色简介、剧情、文风指令、设定 | 可以为空 |
| 变量 | HP、金币、好感、标记、JSON 状态 | 可以为空 |
| 行为 | 触发、条件和效果 | 可以为空 |
| 音轨 | BGM、音效、环境音 | 总是包含 |
| 视觉层 | 界面代码(index.tsx 和它旁边的文件) | 可选 |
| 组织结构 | 选中的词条用到的情境和词条文件夹 | 自动包含 |
插进另一个世界,它就能在那里用。
创建资源包
在画布顶栏点 ⋮ → 存为模板或资源包。填上名称、描述和标签,然后在 词条、变量 和 行为 下勾选要带的东西。勾一条行为时,它读到或改到的变量会标成「建议」,这样你不会不小心漏掉它们。
卡有自己的界面代码的话,会有一个 视觉层 复选框把它带上。勾上之后,下面出现 别人套用时,列出别人安装这个界面时哪些示例会被换掉;见做一个别人也能用的界面。音轨总是包含。
点 保存到库。资源包就存进你的资源包库(面板 → 资源市场 → 我的库)。
导入时的选择
把资源包装进一个已有的世界时,它的内容是合并进去的,从不覆盖。装进去之前你要选:
- 要装的部分:可以不要词条、行为或音频。变量总是跟着来,因为其他部分要用它们。
- 变量 ID 相同:资源包直接用你卡里已有的那个变量。
- 变量名相同、ID 不同:逐个选 合并成一个(资源包用你的变量)或 各留一份(资源包的那份换一个名字)。
- 它的界面(资源包带界面代码时):两个界面都留、替换现在的界面,或 不要它的界面。替换会保留你自己的界面;移除资源包就能拿回来。
词条和行为总是拿到新的 ID,行为里引用的变量 ID 会重新映射,所以关系在导入后还在。
界面模板:用别人的界面
市场里有一个叫 界面 的分类:其他创作者做好的完整界面,比如状态条、物品栏、关系和地图。你可以拿一个当你的卡的界面,安装的时候把它的示例换成你卡里自己的东西。
- 在画布上,按 还可以加 旁边的 资源市场,把市场筛到 界面(或者在 玩家界面 上按 换界面,再按最下面的 More interfaces in the Resource market)。标着 换成你的角色 的界面,安装时会把你卡里的角色放进去。
- 打开一个预览,然后按 套用到这张卡。
- 安装对话框里的 对应到这张卡 马上把示例换掉,不用助手,不花积分:
- 界面里的人(看板上的角色、手机里的联系人)默认变成 卡里的角色。名字、简介和头像来自你卡里的角色词条;点一个名字就把那个角色排除。示例人物的示例消息和帖子会随他们一起清空。
- 其他示例,比如背包里的示例物品,可以保留(保留示例)或清空(清空)。
- 界面带来的单个值(比如背包容量)可以指向你卡里一个同类型的变量,不用新加。
- 自己画聊天的全屏界面默认替换你现在的屏幕;叠在屏幕上面的,比如状态条或侧边抽屉,默认两个都留,不然你的卡就没聊天了。
- 还想把界面代码里写死的其他文字也换掉,勾上 让助手适配到这张卡。你的卡有角色可以对应时,它默认不勾。助手读你卡的变量和设定,把写死的数字、角色、地点和文字换成你的,布局、面板和功能保持不变。界面需要你卡里没有的东西(地图需要地点),它会问你是加上还是去掉那个面板。
助手的适配用你自己的助手积分。不满意结果,按助手消息下面的 撤销这一回合,或者移除资源包拿回你原来的界面。
做一个别人也能用的界面
要让你的界面在别人安装之后显示他们的角色,它显示的东西得放在变量里,而不是代码里:
把人放进一个 ID 表明是人的 JSON 变量里,比如
npcs、characters或contacts。做成一个按人物 ID 做键的对象;每个人有name,可以有bio和avatar(一个素材、一个 URL 或一个字母)。好感或信任这类数字也可以放进去。json{ "aria": { "name": "Aria", "bio": "A squire in the royal city", "avatar": "A", "affinity": 30 }, "ken": { "name": "Ken", "bio": "Runs the tavern", "avatar": "K", "affinity": 10 } }属于某个人的东西(消息、帖子、事件)存那个人的 ID,比如
"from": "aria"。别人安装界面时,这些会和示例人物一起清空。其他示例,比如物品或地点,也放进 JSON 变量,每一项有
name。安装的人可以保留或清空它们。界面代码只读这些变量来画。
勾着 视觉层 导出资源包时,别人套用时 列出每个列表和它会发生什么:人物列表显示 换成对方的角色,其他列表显示 可保留或清空。显示 没有人物列表 的话,说明人还写在代码里,或者他们的变量没勾上。发布到市场之后,这样的界面会标上 换成你的角色。
你也可以告诉助手「这个界面我要分享,把人放在变量里」,它就会这么写。
分享资源包
存好的资源包默认是私有的。在资源包编辑器里设成 公开,其他创作者就能在 面板 → 资源市场 → 发现 里搜索、预览和安装它。
你也可以在资源包上点 下载 JSON,把文件发给朋友手动导入(⋮ → 导入资源包,或 面板 → 资源市场 里的 从文件导入)。
要分享单个情境,用它设置里的 把这个情境打包分享。它会以同样的方式存进你的资源包。
完整世界导出
除了资源包这种「部分导出」,你也可以导出完整的世界 JSON:打开 我的库 → 我的项目,选中卡,点 下载。导出的文件包含 WorldDefinition 里的一切:
- 所有词条(
entries)和词条文件夹结构(entryFolders) - 所有变量(
variables) - 行为(
reactions,旧卡里是rules) - 情境(
worldbooks) - 根组件(
rootComponent):整个世界 UI 的入口,包括index.tsx和它旁边的所有文件 - 在玩家界面编辑器里搭的玩家界面(
uiDoc) - 自定义 UI TSX 组件(
customUI,旧卡) - 音轨(
audioTracks)、BGM 播放列表(bgmPlaylist)、条件 BGM(conditionalBGM) - 场景图(
sceneImages)和回复处理规则(replyRules) - 空间系统(
systems)和场景(scenes) - 编辑器模式(
editorMode: "simple" | "advanced") - 世界设置(
settings):温度、token 上限、布局模式、扫描深度等
注意:分享用的语言版本分组键(languageGroupId)存在世界记录本身上(用于发现页匹配),不在 WorldDefinition 里,所以导出的 JSON 里没有它。
完整导出的用途:
- 备份。 定期导出一份本地副本。
- 版本控制。 提交到 git 仓库来跟踪改动。大改之前导出一份,当手动存档点。
- 协作。 把 JSON 发给协作者,他可以导入后在自己的账号上干活。
- 迁移。 计划中的离线版用同一种格式。
导入用 卡的设置 里的 导入文件(这会替换当前卡的内容),资源包用 ⋮ → 导入资源包。导入器认 Yumina 世界 JSON、SillyTavern 角色卡(包括嵌在 PNG 里的 V2 卡)和资源包 JSON。
例子:给社区的一个战斗系统资源包
比方说你在你的 RPG 世界里做了一套回合制战斗系统,包含:
- 变量:
HP(数字,0–100)、MP(数字,0–50)、ATK、DEF、battlePhase(文字) - 行为:
trigger death settlement when HP hits zero、MP naturally recovers 5 per turn at turn start - 界面:卡的界面代码里的 HP 和 MP 条
- 音频:战斗 BGM(循环)、受击音效(sfx)
打包步骤:
- 在画布顶栏点 ⋮ → 存为模板或资源包
- 命名为「回合制战斗系统 v1.0」,写一段清楚的用法说明
- 勾上那 2 条行为。它们用到的变量会标成「建议」
- 勾上那 5 个变量
- 想让 HP/MP 条一起带上就勾 视觉层(音轨总是包含)
- 加标签:
combat、rpg、turn-based - 点 保存到库
要分享,把资源包设成 公开,它就会出现在发现页里,或者点 下载 JSON 把文件发出去。
拿到资源包的人打开自己的卡,从 面板 → 资源市场 安装,或者对文件点 ⋮ → 导入资源包。变量名冲突会自动处理。
另见
- 自定义 UI 指南:搭建玩家玩你的世界时看到的视觉体验
