README.md

KULT: Divinity Lost - SealDice 插件包

📁 项目简介

本项目包含一套专为 SealDice 搭建的《KULT: Divinity Lost》辅助工具集。旨在帮助 GM（游戏主持人）和玩家在跑团过程中快速生成详细的角色卡、进行沉浸式的塔罗占卜以及获取灵感。

📦 文件清单与功能

文件名	类型	功能描述	依赖
Kult Char.js	角色生成	随机或指定生成 KULT 的 25 种原型角色（含沉眠者/觉悟者）。自动处理属性分配、外表组合、黑暗秘密与缺陷的逻辑。	无
Kult Tarot.js	塔罗占卜 (图文版)	包含 68 张 KULT 专属塔罗牌数据。支持五星牌阵与单张抽取。需要配置本地图片。	图片资源
Kult Tarot-V.js	塔罗占卜 (纯文版)	与图文版逻辑一致，但移除所有图片输出。适用于无法加载图片或需要纯净文本记录的场景。	无

⚠️ 注意：Kult Tarot.js 和 Kult Tarot-V.js 使用相同的注册指令（.kt），请勿同时启用，否则后加载的插件会覆盖前者的功能。

---

🛠️ 安装与配置

1. 脚本安装

将 .js 文件放入 SealDice 的 data/Default/scripts 扩展目录中，并在控制台重载插件。

2. 图片资源配置 (仅 Kult Tarot.js 需要)

如果您使用图文版塔罗插件，请确保完成以下步骤：

1. 在您的骰子数据目录中创建文件夹：data/images/Kult。
2. 将 68 张塔罗牌图片放入该文件夹。
3. 命名规则：必须严格命名为 纯占卜版_00.png 至 纯占卜版_67.png。
4. 路径修改：打开 Kult Tarot.js，找到以下代码行并修改为您电脑的实际绝对路径（注意双反斜杠 \\）：

   const IMAGE_DIR = "C:\\Users\\Administrator\\Desktop\\骰子名称\\data\\images\\Kult";

---

💻 指令手册

1. 角色生成器 (Kult Char.js)

快速生成包含身份、秘密、缺陷、特质、属性及外貌的完整角色概念。

• 随机生成
  • 指令：.kchar
  • 效果：从所有原型中随机抽取一个并生成详细数据。
• 指定原型
  • 指令：.kchar [原型名称]
  • 示例：.kchar 浪人、.kchar 沉眠者、.kchar 畸变者
  • 特殊逻辑：沉眠者会从全局列表中抽取秘密和缺陷；觉悟者会显示能力与限制而非特质。
• 帮助
  • 指令：.kchar help

2. 塔罗占卜系统 (Kult Tarot.js / Kult Tarot-V.js)

基于 KULT 规则书的占卜系统，支持根据不同情境（人/地/事/物）自动切换牌义解释。

• 通用五星牌阵
  • 指令：.kt (或 .kulttarot)
  • 效果：抽取 5 张牌（核心、过去、动力、弱点、优势）。
  • 显示逻辑：每个位置随机显示一种维度的解释（如【人物】或【情境】），保持版面整洁。
• 特定主题牌阵
  • 指令：.kt [类型]
  • 可用类型：
    • .kt 人 (或 ind)：人物塑造
    • .kt 地 (或 loc)：地点生成
    • .kt 组织 (或 org)：教团/组织
    • .kt 事件 (或 sit)：阴谋/剧情
    • .kt 怪物 (或 cre)：怪物/存在
    • .kt 物品 (或 item)：神器/物品
  • 效果：抽取 5 张牌，并显示该牌在对应主题下的详细解释。
• 单张全解 (灵感模式)
  • 指令：.kt 单张 (或 .kt draw, .kt 1)
  • 效果：随机抽取 1 张 牌。
  • 显示逻辑：列出该牌的所有信息（基础义、人物、地点、组织、情境、生物、物品），作为 GM 的灵感查询手册。

Created for KULT: Divinity Lost