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