---
title: "资源包、复刻与导出"
description: "别人怎么复刻你的卡，怎么把一套系统（变量、行为、界面、音频）打包给另一张卡，完整 JSON 导出里有什么。"
---
# 资源包、复刻与导出

发布本身在[发布](/zh/creator/publishing)。这一页讲的是一张卡整个或部分离开你账号的三种方式：别人做可编辑的副本，把一套系统带进另一张卡的资源包，以及完整的 JSON 导出。

## 复刻

一个世界发布了并且允许二次创作，其他用户就可以做自己的副本：

1. 创建一份完整的副本，归复刻的人所有
2. 名字自动加编号：原作叫「Dark Forest」，你的副本就是「Dark Forest (1)」；再复刻一次就是「Dark Forest (2)」
3. 副本从草稿开始，不会自动发布
4. 保留原作的所有标签、描述、封面、schema 和内容
5. 原世界的 `downloadCount` 加 1
6. 副本的 `sourceWorldId` 指回原作，方便追溯
7. 引用到的素材（比如图片）也一起复制过来

## 资源包

比方说你花了两周做出一套打磨好的战斗系统：变量、行为、界面、音效。一个朋友在做世界，需要一套战斗系统。你不用把整个世界给他。把战斗相关的部分**打包**，发过去就行。

资源包是你世界里选出来的部分打成的一个包。

**资源包里有什么：**

| 部分 | 包含内容 | 必需吗？ |
|---------|----------------|-----------|
| **名称与描述** | 资源包名称、描述、标签、封面、语言、创建日期 | 名称必填 |
| **词条** | 角色简介、剧情、文风指令、设定 | 可以为空 |
| **变量** | HP、金币、好感、标记、JSON 状态 | 可以为空 |
| **行为** | 触发、条件和效果 | 可以为空 |
| **音轨** | BGM、音效、环境音 | 总是包含 |
| **视觉层** | 界面代码（`index.tsx` 和它旁边的文件） | 可选 |
| **组织结构** | 选中的词条用到的情境和词条文件夹 | 自动包含 |

插进另一个世界，它就能在那里用。

**创建资源包**

在画布顶栏点 **⋮ → 存为模板或资源包**。填上名称、描述和标签，然后在 **词条**、**变量** 和 **行为** 下勾选要带的东西。勾一条行为时，它读到或改到的变量会标成「建议」，这样你不会不小心漏掉它们。

卡有自己的界面代码的话，会有一个 **视觉层** 复选框把它带上。勾上之后，下面出现 **别人套用时**，列出别人安装这个界面时哪些示例会被换掉；见[做一个别人也能用的界面](#shareable-interface)。音轨总是包含。

点 **保存到库**。资源包就存进你的资源包库（**面板 → 资源市场 → 我的库**）。

**导入时的选择**

把资源包装进一个已有的世界时，它的内容是**合并**进去的，从不覆盖。装进去之前你要选：

- **要装的部分**：可以不要词条、行为或音频。变量总是跟着来，因为其他部分要用它们。
- **变量 ID 相同**：资源包直接用你卡里已有的那个变量。
- **变量名相同、ID 不同**：逐个选 **合并成一个**（资源包用你的变量）或 **各留一份**（资源包的那份换一个名字）。
- **它的界面**（资源包带界面代码时）：**两个界面都留**、**替换现在的界面**，或 **不要它的界面**。替换会保留你自己的界面；移除资源包就能拿回来。

词条和行为总是拿到新的 ID，行为里引用的变量 ID 会重新映射，所以关系在导入后还在。

<a id="interface-templates"></a>

**界面模板：用别人的界面**

市场里有一个叫 **界面** 的分类：其他创作者做好的完整界面，比如状态条、物品栏、关系和地图。你可以拿一个当你的卡的界面，安装的时候把它的示例换成你卡里自己的东西。

1. 在画布上，按 **还可以加** 旁边的 **资源市场**，把市场筛到 **界面**（或者在 **玩家界面** 上按 **换界面**，再按最下面的 **More interfaces in the Resource market**）。标着 **换成你的角色** 的界面，安装时会把你卡里的角色放进去。
2. 打开一个预览，然后按 **套用到这张卡**。
3. 安装对话框里的 **对应到这张卡** 马上把示例换掉，不用助手，不花积分：
   - 界面里的人（看板上的角色、手机里的联系人）默认变成 **卡里的角色**。名字、简介和头像来自你卡里的角色词条；点一个名字就把那个角色排除。示例人物的示例消息和帖子会随他们一起清空。
   - 其他示例，比如背包里的示例物品，可以保留（**保留示例**）或清空（**清空**）。
   - 界面带来的单个值（比如背包容量）可以指向你卡里一个同类型的变量，不用新加。
4. 自己画聊天的全屏界面默认替换你现在的屏幕；叠在屏幕上面的，比如状态条或侧边抽屉，默认两个都留，不然你的卡就没聊天了。
5. 还想把界面代码里写死的其他文字也换掉，勾上 **让助手适配到这张卡**。你的卡有角色可以对应时，它默认不勾。助手读你卡的变量和设定，把写死的数字、角色、地点和文字换成你的，布局、面板和功能保持不变。界面需要你卡里没有的东西（地图需要地点），它会问你是加上还是去掉那个面板。

助手的适配用你自己的助手积分。不满意结果，按助手消息下面的 **撤销这一回合**，或者移除资源包拿回你原来的界面。

<a id="shareable-interface"></a>

**做一个别人也能用的界面**

要让你的界面在别人安装之后显示他们的角色，它显示的东西得放在变量里，而不是代码里：

1. 把人放进一个 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 }
   }
   ```

2. 属于某个人的东西（消息、帖子、事件）存那个人的 ID，比如 `"from": "aria"`。别人安装界面时，这些会和示例人物一起清空。
3. 其他示例，比如物品或地点，也放进 JSON 变量，每一项有 `name`。安装的人可以保留或清空它们。
4. 界面代码只读这些变量来画。

勾着 **视觉层** 导出资源包时，**别人套用时** 列出每个列表和它会发生什么：人物列表显示 **换成对方的角色**，其他列表显示 **可保留或清空**。显示 **没有人物列表** 的话，说明人还写在代码里，或者他们的变量没勾上。发布到市场之后，这样的界面会标上 **换成你的角色**。

你也可以告诉助手「这个界面我要分享，把人放在变量里」，它就会这么写。

**分享资源包**

存好的资源包默认是私有的。在资源包编辑器里设成 **公开**，其他创作者就能在 **面板 → 资源市场 → 发现** 里搜索、预览和安装它。

你也可以在资源包上点 **下载 JSON**，把文件发给朋友手动导入（**⋮ → 导入资源包**，或 **面板 → 资源市场** 里的 **从文件导入**）。

要分享单个[情境](/zh/creator/modules)，用它设置里的 **把这个情境打包分享**。它会以同样的方式存进你的资源包。

## 完整世界导出

除了资源包这种「部分导出」，你也可以导出完整的世界 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）

打包步骤：

1. 在画布顶栏点 **⋮ → 存为模板或资源包**
2. 命名为「回合制战斗系统 v1.0」，写一段清楚的用法说明
3. 勾上那 2 条行为。它们用到的变量会标成「建议」
4. 勾上那 5 个变量
5. 想让 HP/MP 条一起带上就勾 **视觉层**（音轨总是包含）
6. 加标签：`combat`、`rpg`、`turn-based`
7. 点 **保存到库**

要分享，把资源包设成 **公开**，它就会出现在发现页里，或者点 **下载 JSON** 把文件发出去。

拿到资源包的人打开自己的卡，从 **面板 → 资源市场** 安装，或者对文件点 **⋮ → 导入资源包**。变量名冲突会自动处理。

---

## 另见

- [自定义 UI 指南](/zh/creator/advanced/custom-ui-deep)：搭建玩家玩你的世界时看到的视觉体验
