# DaggerHeart 创意工坊：你的第一份卡牌包 你好，欢迎来到车卡器自定义。别担心，制作属于你自己的卡牌包比听起来要简单得多。你不需要成为一名程序员，只需要一点点创意和耐心。 ## 急于开始？先试试 AI 生成提示词！ 如果你已经有一些创意文稿（Word 文档、笔记等），想要快速体验卡牌包制作的乐趣，可以直接跳到 [**第四部分：AI 生成提示词**](#第四部分ai-生成提示词你的魔法代笔人)。AI 能在几分钟内帮你把创意转换成完整的卡牌包！ 不过，我们仍然建议你先通过下面的 [**5分钟快速启程**](#快速启程5分钟创作你的第一个法术) 了解基本原理，这样你就能更好地指导 AI，也能对生成的结果进行质量检查。 --- ## 目录 ### 一、快速入门 - [快速启程：5分钟创作你的第一个法术](#快速启程5分钟创作你的第一个法术) - [第一步：准备你的画布 (卡牌包框架)](#第一步准备你的画布-卡牌包框架) - [第二步：填写预定义字段](#第二步填写预定义字段) - [第三步：创建领域卡牌](#第三步创建领域卡牌) - [第四步：签名并展示 (保存与测试)](#第四步签名并展示-保存与测试) ### 二、卡牌创作工坊（参考手册） - [第一部分：卡牌包的基础](#第一部分卡牌包的基础) - [1.1 卡牌包信息 (元数据)](#11-卡牌包信息-元数据) - [1.2 创作预定义内容 (customFieldDefinitions)](#12-创作预定义内容-customfielddefinitions) - [第二部分：卡牌类型详解](#第二部分卡牌类型详解) - [职业卡牌 (profession)](#职业卡牌-profession) - [种族卡牌 (ancestry)](#种族卡牌-ancestry) - [社群卡牌 (community)](#社群卡牌-community) - [子职业卡牌 (subclass)](#子职业卡牌-subclass) - [领域法术卡牌 (domain)](#领域法术卡牌-domain) - [扩展卡牌 (variant)](#扩展卡牌-variant) - [第三部分：通用规则与最佳实践](#第三部分通用规则与最佳实践) - [3.1 美化你的描述文字 (文本格式化)](#31-美化你的描述文字-文本格式化) - [3.2 为你的卡牌配上精美插图 (imageUrl 字段详解)](#32-为你的卡牌配上精美插图-imageurl-字段详解) ### 三、AI 生成提示词 - [第四部分：AI 生成提示词——你的魔法代笔人](#第四部分ai-生成提示词你的魔法代笔人) ### 四、完整示例 - [第五部分：融会贯通——一个完整的卡牌包示例](#第五部分融会贯通一个完整的卡牌包示例) ### 五、常见问题 - [常见问题 (FAQ)](#常见问题-faq) --- 这篇指南会像一位朋友一样，手把手带你完成从零到一的创作过程。让我们先忘掉复杂的规则，从制作一张你最熟悉的**领域法术卡牌**开始吧！ --- ## 快速启程：5分钟创作你的第一个法术 我们的目标：创造一个名为“火焰球”的法术，它属于“火焰”领域。 ### 第一步：准备你的画布 (卡牌包框架) 首先，打开任何一个纯文本编辑器（比如VS CODE，当然记事本也可以），然后将下面这段最基础的框架代码复制进去。这就像是为你的画作准备好一张干净的画布。 ```json { "name": "我的魔法书", "version": "1.0.0", "author": "你的名字", "description": "这是我创造的第一个卡牌包！", "customFieldDefinitions": { "domains": [] }, "domain": [] } ``` > **小提示**：`JSON` 其实就是一种游戏能读懂的"信息登记表"格式。我们接下来要做的，就是往这张表里填东西。 ### 第二步：填写预定义字段 在车卡器的世界里，所有东西都要“先定义，后使用”。这听起来很专业，但其实很简单。 找到 `customFieldDefinitions` 里的 `domains`，在方括号 `[]` 里加上 `"火焰"`。就像这样： ```json "customFieldDefinitions": { "domains": ["火焰"] }, ``` > **为什么这么做？** > 这能确保你和游戏都“认识”这个概念，以后在创造其他与火焰相关的卡牌时，就不会出错了。 > 同时，这帮助你减少后续可能的笔误等糟糕情况。 ### 第三步：创建领域卡牌 找到最下方的 `domain`，在它的方括号 `[]` 里，把下面这段描述“火焰球”的代码复制进去： ```json "domain": [ { "id": "我的魔法书-你的名字-doma-火焰球", "名称": "火焰球", "领域": "火焰", "描述": "从你手中发射一颗炽热的火球，飞向敌人。\n\n**效果**：对**近战范围**内的一个目标造成**魔法伤害**，并可能使其陷入*燃烧*状态。", "等级": 1, "属性": "法术", "回想": 2 } ] ``` ### 第四步：签名并展示 (保存与测试) 太棒了！你的第一个法术已经创作完成。现在，给你的作品签上名： 1. **修改作者和ID**：记得把代码里的 `"你的名字"` 都换成你自己的名字。 2. **保存文件**：将这个文件保存，文件名可以任意取，但后缀名**必须是 `.json`**。例如：`我的魔法书.json`。 3. **导入游戏**：打开游戏，找到“卡牌管理”功能，导入你刚刚创建的 `.json` 文件。 **恭喜你！** 你现在应该能在游戏中看到你亲手创造的“火焰球”法术了！ --- ### 刚刚发生了什么？(简单回顾) 我们来快速看一下“火焰球”这张“信息登记表”里都填了些什么： * `id`: 每张卡牌独一無二的“身份证号”。 * `名称`: 卡牌的名字，就是“火焰球”。 * `领域`: 它所属的“颜料”，也就是我们刚刚定义好的“火焰”。 * `描述`: 卡牌的效果，这里可以用一些简单的格式让它更好看。 * `等级`, `属性`, `回想`: 是一些游戏数值，现在你只需要知道它们是数字，而且**数字不能加双引号**。 是不是很简单？你已经掌握了最核心的创作流程。 ### 为你的卡牌起一个好名字 (ID命名规范) 你可能注意到了 `id` 字段那一长串文字。这是每张卡牌独一无二的“身份证号”，为了避免和别人的作品冲突，我们强烈建议你从一开始就养成良好的命名习惯。 请严格确保所有卡牌的ID都是唯一的，你可以采用以下规则： * **格式**：`包名-作者-类型缩写-卡牌中文名` * **示例**：`我的魔法书-你的名字-doma-火焰球` * **类型缩写**：`prof` (职业), `ance` (种族), `comm` (社群), `subc` (子职业), `doma` (领域), `vari` (扩展)。 当你准备好创造更复杂的职业、种族或物品时，下面的“卡牌创作工坊”就是你的全能参考手册。 --- ## 卡牌创作工坊 (参考手册) 这里是所有卡牌类型的详细说明和规则。当你想要创造更多内容时，可以随时回来查阅。 ### 第一部分：卡牌包的基础 #### 1.1 卡牌包信息 (元数据) 这部分是你的卡牌包的“封面”，告诉别人它叫什么，是谁做的。 ```json { "name": "星辰魔法学院扩展包", "version": "1.0.0", "description": "包含魔法和龙的主题卡牌包", "author": "你的名字 " } ``` #### 1.2 创作预定义内容(customFieldDefinitions) > **黄金法则：先定义，后使用** > > 这里是你的“调色盘”，所有你要用到的自定义概念（职业名、种族名、领域名等）都必须先在这里声明。 ```json "customFieldDefinitions": { "professions": ["星术师", "月影猎手"], // 你要创造的职业 "ancestries": ["星裔", "月之子"], // 你要创造的种族 "communities": ["星辰学院", "月影圣殿"], // 你要创造的社群 "domains": ["星辰", "月影", "预言"], // 你要创造的领域 "variants": ["神器", "盟友", "法术书"] // 你要创造的其他任何东西（物品、NPC等） } ``` ### 第二部分：卡牌类型详解 这里详细列出了所有6种卡牌的“登记表”模板和填写要求。当你想要创造更多内容时，可以随时回来查阅。 #### 职业卡牌 (profession) * **用途**：定义一个完整的角色职业，是所有角色的起点。 * **关键点**：`领域1` 和 `领域2` 必须是你已经在"调色盘"(`customFieldDefinitions.domains`)里准备好的"颜料"。 ```json { "id": "必填-字符串 (卡牌的身份证号)", "名称": "必填-字符串 (如：元素法师)", "简介": "必填-字符串 (一句话风味描述)", "领域1": "必填-字符串 (必须已在domains中定义)", "领域2": "必填-字符串 (必须已在domains中定义)", "起始生命": "必填-数字 (不要加引号)", "起始闪避": "必填-数字 (不要加引号)", "起始物品": "必填-字符串 (初始装备列表)", "希望特性": "必填-字符串 (描述希望点的效果)", "职业特性": "必填-字符串 (核心能力描述)" } ``` --- #### 种族卡牌 (ancestry) * **用途**：定义角色的种族特性，比如精灵的敏锐视觉或矮人的坚韧。 * **特殊规则**：每个种族**必须且只能有两张**种族卡。这两张卡的 `种族` 和 `简介` 字段内容必须**一模一样**，但 `名称` 和 `效果` 不同，`类别` 分别为 `1` 和 `2`。 ```json { "id": "必填-字符串", "名称": "必填-字符串 (这项种族能力的名称，如：夜视)", "种族": "必填-字符串 (必须已在ancestries中定义)", "简介": "必填-字符串 (同一种族两张卡要完全一样)", "效果": "必填-字符串 (这项能力的具体效果)", "类别": "必填-数字 (只能是 1 或 2)" } ``` --- #### 社群卡牌 (community) * **用途**：描述角色的背景、归属或社会关系，比如来自哪个学院、哪个秘密组织或哪个村庄。 * **关键点**：这张卡牌比较自由，主要由描述性文字组成，让你尽情发挥创意。 ```json { "id": "必填-字符串", "名称": "必填-字符串 (社群的名字，如：星辰学院)", "特性": "必填-字符串 (社群的核心特征，如：博学多才)", "简介": "必填-字符串 (社群的简短介绍)", "描述": "必填-字符串 (详细描述社群带来的能力和关系)" } ``` --- #### 子职业卡牌 (subclass) * **用途**：为你的主职业提供专精或进阶路线，比如一个"战士"可以选择成为"狂战士"或"圣殿骑士"。 * **重要规则**：这张卡牌有几个严格的"必选项"，请务必遵守！ * `主职`：必须和你创造的某个**职业卡牌**的 `名称` 完全一致。 * `等级`：只能在 `基石`、`专精`、`大师` 三者中选择一个。 * `施法`：只能从 `力量`、`敏捷`、`灵巧`、`风度`、`本能`、`知识`、`不可施法` 中选择一个。 ```json { "id": "必填-字符串", "名称": "必填-字符串 (建议格式：子职业名+等级，如：预言师基石)", "描述": "必填-字符串 (子职业能力的详细描述)", "主职": "必填-字符串 (必须与某个职业的名称一致)", "子职业": "必填-字符串 (核心名称，如：预言师)", "等级": "必填-字符串 (只能是 '基石', '专精', '大师' 之一)", "施法": "必填-字符串 (从给定的7个属性中选择一个)" } ``` --- #### 领域法术卡牌 (domain) * **用途**：这就是我们教程里做的法术卡！它代表了某个特定领域的力量的具体体现。 * **关键点**：`领域` 字段必须是你已经在 `domains` 调色盘里定义好的那个。 ```json { "id": "必填-字符串", "名称": "必填-字符串 (法术名，如：火焰球)", "领域": "必填-字符串 (必须已在domains中定义)", "描述": "必填-字符串 (法术效果的详细描述)", "等级": "必填-数字 (法术的等级，1-10)", "属性": "必填-字符串 (通常是“法术”)", "回想": "必填-数字 (法术的回想值)" } ``` --- #### 扩展卡牌 (variant) * **用途**：这是你的**创意沙盒**！用它来创造任何其他卡牌类型无法容纳的东西：魔法物品、重要NPC、特殊地点、任务道具……应有尽有。 * **关键点**： * `类型` 字段必须是你已在 `variants` 中定义好的。 * `子类别`, `等级`, `简略信息` 是**选填**的。如果你的设计里没有这些信息，**直接把这几行删掉就行了**，非常方便！ ```json { "id": "必填-字符串", "名称": "必填-字符串 (物品/NPC的名字，如：星辰王冠)", "类型": "必填-字符串 (必须已在variants中定义，如：神器)", "子类别": "选填-字符串 (如：饰品，如果不需要可以删除此行)", "等级": "选填-数字 (如：8，如果不需要可以删除此行)", "效果": "必填-字符串 (详细描述效果)", "简略信息": "选填-对象 (快速预览信息，如果不需要可以删除此行)" } ``` ### 第三部分：通用规则与最佳实践 #### 3.1 美化你的描述文字 (文本格式化) 在 `描述` 或 `效果` 字段中，你可以使用简单的符号来美化文本： * `**重要术语**` -> **重要术语** (粗体) * `*特殊状态*` -> *特殊状态* (斜体) * `***能力标题***` -> ***能力标题*** (粗体+斜体) * 用一个空行来分隔段落。 * `- 列表项目` 来创建列表。 #### 3.2 为你的卡牌配上精美插图 (`imageUrl` 字段详解) 想让你的卡牌更生动、更专业吗？`imageUrl` 字段就是用来给卡牌添加图片的！这个字段是**完全可选的**，你可以根据自己的喜好和拥有的资源，从下面三种方式中任选一种来使用。 --- ##### 方式一：【最省心】留空，让系统自动寻找 如果你不想为图片路径操心，或者你已经按照推荐的方式整理好了图片文件，那么这是最简单的方法。 * **做法**： 在你的卡牌 JSON 数据中，**完全不要写 `imageUrl` 这一行**。 * **工作原理**： 当你留空时，游戏会扮演一个聪明的助手，它会根据你的卡牌信息**自动推断**图片应该在哪里。推断的“公式”是： `/{卡牌包名称}/{卡牌类型}/{卡牌名称}.webp` * **举个例子**： 还记得我们做的“火焰球”吗？它的卡牌包是 `我的魔法书`，类型是 `domain`，名称是 `火焰球`。 那么，系统就会自动去寻找这个路径下的图片： `/我的魔法书/domain/火焰球.webp` > **提示**：如果你打算用这种方法，只需要确保你的图片文件夹结构和命名与这个"公式"完全一致，一切就都会自动搞定！ --- ##### 方式二：【最掌控】自己填写本地路径 如果你有自己的图片组织方式，或者想为同一张卡牌指定一张特殊的图片（比如“火焰球”的“传说版”插画），你可以自己指定路径。 * **做法**： 在卡牌 JSON 中添加 `imageUrl` 字段，并填入你存放图片的**相对路径**。通常建议路径以 `/` 开头，代表从你的卡牌包根目录开始。 * **工作原理**： 你等于是在明确告诉游戏：“别猜了，去我指定的这个地方找图片”。游戏会根据你给的路径去加载图片。 * **举个例子**： 假设你在你的卡牌包文件夹里建了一个 `images` 文件夹来存放所有图片。 ```json "imageUrl": "/我的魔法书/images/火焰球传说版.webp" ``` 这时，游戏就会准确地加载 `火焰球传说版.webp` 这张图片，而不是自动去寻找 `火焰球.webp`。 > **注意**：这里的路径是相对于你卡牌包所在的位置的，而不是你电脑的C盘或D盘。 --- ##### 方式三：【最便捷】使用互联网图片链接 如果你的图片存放在图床、云存储或者任何公开的网站上，你可以直接使用它的网址。 * **做法**： 在 `imageUrl` 字段中，直接粘贴完整的、以 `http://` 或 `https://` 开头的图片网址。 * **工作原理**： 游戏会从互联网上下载这张图片并显示在卡牌上。 * **举个例子**： ```json "imageUrl": "https://some-image-hosting.com/your-name/fireball.webp" ``` > **重要提醒**： > * **网络依赖**：这种方式需要玩家在游戏时保持网络连接。 > * **链接失效风险**：如果存放图片的网站倒闭了，或者你删除了图片，游戏里的图片也就会失效（显示一个破碎的图标）。 > * **版权问题**：请确保你有权使用这张网络图片！ --- ##### 总结与建议 | 方法 | 做法 | 优点 | 缺点 | | :--- | :--- | :--- | :--- | | **1. 自动推断** | 留空不写 `imageUrl` | 省心省力，卡牌代码干净 | 需要严格遵守文件命名和文件夹结构 | | **2. 本地路径** | 填写相对路径 | 完全掌控，灵活度最高，无需联网 | 需要自己管理文件路径，稍显繁琐 | | **3. 网络链接** | 填写完整网址 | 方便分享，无需打包图片文件 | 依赖网络，链接可能失效，有版权风险 | **给新手的最佳实践建议：** 1. **推荐格式**：尽量使用 `.webp` 格式的图片，因为它体积小、质量高，加载速度快。 2. **推荐尺寸**：卡牌图片的尺寸建议为 **400x600** 像素或类似的竖版长方形比例。 3. **从方式一开始**：刚开始创作时，建议使用**第一种自动推断**的方式。为你的图片起好和卡牌名一样的名字，并放在推荐的文件夹里。这样最不容易出错，也能让你养成良好的文件管理习惯。 ### 第四部分：AI 生成提示词——你的魔法代笔人 你已经学会了如何手动创建卡牌，这很棒！但如果你脑海中有一个完整的世界，写满了整整一个笔记本的职业、种族和法术呢？难道要一张一张地复制粘贴吗？ 当然不用！现在，让我们来认识一下你最强大的盟友：**AI 卡包生成提示词**。 > **模型选择建议** > AI 的"脑容量"很重要。推荐使用像 **Google Gemini 1.5 Pro** 这样拥有超长上下文（记忆力超群）的模型。这样你就可以一次性把你的长篇大作和说明书都交给它，而不用担心它看到后面忘了前面。 --- #### 召唤 AI 的标准对话模板 准备好材料后，打开你选择的 AI 工具，然后复制并粘贴下面这段“咒语”。它会告诉 AI 它的任务是什么。 ```text 我有一份关于 [这里填写你的主题，比如：一个以“深海”为主题的] DaggerHeart 游戏内容文档，需要你帮我转换成标准的卡牌包 JSON 格式。 你的任务是扮演一个高度精确的 DaggerHeart 卡牌数据转换引擎。 在开始工作前，请务必先完整阅读并严格遵守这份《AI-卡包生成提示词.md》里定义的所有规则、约束和格式要求。这是你行动的最高准则。 [在这里粘贴或上传你的《AI-卡包生成提示词.md》文件的全部内容] --- 现在，这是我的创意文稿，请开始转换： [在这里粘贴或上传你的创意文稿的全部内容] ``` #### 黄金法则：永远由你做主 AI 是一个强大的学徒，但**不是**一个完美的大师。它生成的结果**必须由你——真正的创造者——进行最终的检查和确认**。 **收到 AI 生成的代码后，请务必检查：** * [ ] **格式检查**：代码看起来完整吗？有没有明显的括号缺失或逗号错误？ * [ ] **规则检查**：AI 是否遵守了所有核心规则？（比如，种族卡牌是不是正确地生成了两张？子职业的等级是不是在“基石/专精/大师”之中？） * [ ] **内容检查**：AI 是否准确理解了你的创意？有没有曲解某个技能的效果，或者张冠李戴？ AI 会为你节省 95% 的体力劳动，但最后 5% 的灵魂注入和质量把控，永远掌握在你手中。 #### 进阶技巧：如何更好地"调教"AI * **从小处着手**：第一次尝试时，可以先只给 AI 一两个职业的内容，看看效果如何。测试成功后，再把整个文档交给它。 * **像老板一样下指令**：如果 AI 的第一次尝试不够完美，不要气馁。你可以给出更明确的指令，比如：“很好，但请确保所有‘种族卡牌’的简介都完全一致。” 或者 “请把所有‘神器’类型的扩展卡牌都找出来，并为它们添加一个等级字段。” * **分批处理**：如果你的文档实在太长，AI 处理起来有困难，可以把它分成几部分（比如“职业篇”、“种族篇”、“物品篇”），分几次提交给 AI 处理，最后再手动把结果合并到同一个 `.json` 文件里。 --- ### 第五部分：融会贯通——一个完整的卡牌包示例 理论都学完了，是不是感觉还有点抽象？别担心！下面是一个包含**所有卡牌类型**的完整示例，就像一张最终的蓝图。 当你感到迷茫时，随时可以回来看看它是如何将所有部分组合在一起的，或者直接复制它的结构来开始你自己的创作！ #### 完整示例代码 (`.json`) ```json { "name": "星辰魔法学院扩展包", "version": "2.1.0", "description": "以星辰魔法为主题的职业、种族和法术扩展包", "author": "魔法导师 ", "customFieldDefinitions": { "professions": ["星术师", "月影猎手"], "ancestries": ["星裔", "月之子"], "communities": ["星辰学院", "月影圣殿"], "domains": ["星辰", "月影", "预言", "幻象"], "variants": ["神器", "盟友", "法术书"] }, "profession": [ { "id": "星辰魔法学院扩展包-魔法导师-prof-星术师", "名称": "星术师", "简介": "研究星辰运行规律，能够预知未来的学者法师", "领域1": "星辰", "领域2": "预言", "起始生命": 11, "起始闪避": 9, "起始物品": "星图卷轴、观星镜、预言水晶", "希望特性": "**星辰指引** - 在迷茫时总能找到正确的方向", "职业特性": "***星辰共鸣***：你与夜空中的星辰建立了神秘联系。每当你在夜晚施展法术时，获得**优势**。\n\n***命运洞察***：每日一次，你可以预见即将发生的危险，为一次掷骰重投。" } ], "ancestry": [ { "id": "星辰魔法学院扩展包-魔法导师-ance-星光血脉", "名称": "星光血脉", "种族": "星裔", "简介": "体内流淌着来自遥远星辰的古老力量，能够与天空中的星辰进行沟通交流。", "效果": "***星光体质***：你的身体散发着微弱的星光。在完全黑暗中，你和**近距离范围**内的盟友都能正常视物。", "类别": 1 }, { "id": "星辰魔法学院扩展包-魔法导师-ance-星辰沟通", "名称": "星辰沟通", "种族": "星裔", "简介": "体内流淌着来自遥远星辰的古老力量，能够与天空中的星辰进行沟通交流。", "效果": "***星语术***：每次长休后，你可以向星辰询问一个关于未来的问题，GM会给你一个简短但准确的答案。", "类别": 2 } ], "community": [ { "id": "星辰魔法学院扩展包-魔法导师-comm-星辰学院", "名称": "星辰学院", "特性": "博学多才", "简介": "古老的魔法学府，专门研究星辰魔法和预言术", "描述": "***学院人脉***：你认识众多学者和法师。在需要**知识类**或**魔法类**信息时，你总能找到合适的专家咨询。\n\n***图书馆权限***：你可以查阅稀有的魔法典籍，在研究法术或神秘现象时获得**优势**。" } ], "subclass": [ { "id": "星辰魔法学院扩展包-魔法导师-subc-预言师基石", "名称": "预言师基石", "描述": "***命运之眼***：你可以短暂地看见未来的片段。每场战斗一次，你可以警告一个盟友即将到来的攻击，让其获得**优势**进行闪避。\n\n***星图解读***：你精通星象学。通过观察星空，你可以预测天气变化和重大事件的征兆。", "主职": "星术师", "子职业": "预言师", "等级": "基石", "施法": "知识" } ], "domain": [ { "id": "星辰魔法学院扩展包-魔法导师-doma-流星打击", "名称": "流星打击", "领域": "星辰", "描述": "召唤一颗燃烧的流星从天而降，对目标造成毁灭性的打击。\n\n**效果**：对**远距离范围**内的一个目标造成**魔法伤害**，并有几率造成*燃烧*状态。", "等级": 6, "属性": "法术", "回想": 5 } ], "variant": [ { "id": "星辰魔法学院扩展包-魔法导师-vari-星辰王冠", "名称": "星辰王冠", "类型": "神器", "子类别": "饰品", "等级": 8, "效果": "***星光护盾***：佩戴时，你获得**魔法抗性**，所有法术伤害减少2点。\n\n***星辰权威***：你在**魅力**和**威严**相关的检定中获得**优势**。其他人在你面前会感到敬畏。", "简略信息": { "item1": "魔法抗性", "item2": "威严加成" } }, { "id": "星辰魔法学院扩展包-魔法导师-vari-星光水晶", "名称": "纯净星光水晶", "类型": "神器", "效果": "***光芒四射***：水晶散发柔和星光，照亮**近距离范围**。\n\n***能量储存***：可以储存一次法术，随时释放。" } ] } ``` --- #### 示例说明：值得关注的亮点 1. **“调色盘”的完美运用** * 看看 `customFieldDefinitions` 是如何像“调色盘”一样工作的。比如，`professions` 里定义了 `星术师`，下面的职业卡牌就直接引用了它；`domains` 里定义了 `星辰` 和 `预言`，它们也被“星术师”这张卡牌所使用。这就是“先定义，后使用”的黄金法则。 2. **种族卡牌的成双成对** * 注意看 `ancestry` 部分，“星裔”这个种族严格遵守了规则，拥有两张卡牌（`星光血脉` 和 `星辰沟通`）。它们共享完全相同的 `简介` 和 `种族` 字段，但 `名称`、`效果` 和 `类别`（分别是1和2）则各不相同。 3. **子职业与主职业的关联** * `subclass` 卡牌“预言师基石”的 `主职` 字段，准确地填写了 `星术师`，这让游戏知道它是“星术师”职业的一个进阶方向。 4. **扩展卡牌的灵活性** * 在 `variant` 卡牌中，你可以看到**选填字段**的灵活性有多棒： * `星辰王冠`：作为一件传说级物品，它包含了 `子类别`、`等级` 和 `简略信息` 等所有详细信息。 * `纯净星光水晶`：作为一件相对简单的魔法物品，它只保留了必填的 `名称`、`类型` 和 `效果` 字段，非常简洁干净。这证明了你**不需要**为用不到的字段而烦恼。 --- ## 常见问题 (FAQ) * **问：我导入卡牌包时失败了，怎么办？** * **答**：别慌！90% 的问题都出在小细节上。请检查： 1. **括号和逗号**：是不是少了一个逗号 `,` 或者一个括号 `{}`？ 2. **“调色盘”检查**：你卡牌里用到的“领域”、“种族”等，是否都提前在 `customFieldDefinitions` 里定义了？ 3. **引号问题**：是不是所有文字都用英文双引号 `""` 包起来了？是不是数字不小心加了引号？ * **问：我的卡牌图片不显示。** * **答**：图片是可选的。如果你没有在卡牌里设置 `imageUrl` 字段，系统会尝试自动寻找一张图片。它寻找的路径是：`/卡牌包名称/卡牌类型/卡牌名称.webp`。请确保你的图片放在了正确的位置并且名字也对得上。 * **问：这么多规则，记不住怎么办？** * **答**：完全没关系！你不需要记住所有规则。只要从我们第一个“火焰球”的例子开始，每次想创造新东西时，**复制一个已有的成功例子**，然后修改里面的内容。这是最快、最不容易出错的方法！ --- 现在，你已经掌握了创造属于自己世界所需的一切工具。勇敢地去创造吧，你的想象力是这个世界唯一的边界！