喊叫
在某些情况下, 角色会触发特定的对话并作为气泡显示在其头顶。
这些对话写在 CharaText 表格中, 而你的角色则在 idText 单元格中填入该对话的 ID 将其链接。
| 单元格 | calm | fov | aggro | dead | kill |
|---|---|---|---|---|---|
| 触发 | 冷静 | 视线 | 激怒 | 亡语 | 击杀 |
您还可以在每个条目中插入 自定义音频 标签，使其成为有声音的喊叫，例如，"你不能通过！！<sound=gandalf,0.8>" 在触发此喊叫时，有80%的概率播放ID为 gandalf 的音频。
对话
想添加一些角色来聊天吧时的对话, 可以在 LangMod/**/Dialog/ 文件夹中准备一个 dialog.xlsx 表格。
此表格的格式与游戏的对话表格 Elin/Package/_Elona/Lang/_Dialog/dialog.xlsx 相同, 但你只需 unique 表格和包含你角色 ID 的那一行。
此处 ID 和角色 ID 相同。
格式
dialog.xlsx的文本数据从表格第5行开始，而非源表格式的第4行。
剧情
剧情是通过多选项对话和附加动作构成的丰富交互系统。
要为角色定义自定义剧情, 请使用 addDrama_剧情表名称 标签, CWL将自动定向该剧情。
自定义剧情表必须放置在 LangMod/**/Dialog/Drama/ 文件夹下, 且名称需与标签匹配。例如：使用 addDrama_drama_example 时需对应Dialog/Drama/drama_example.xlsx文件。
重要: 您只需提供 1 份剧情表，它可以放置在任何语言子文件夹中。CWL支持在同一表格内提供多语言的本地化。
制作时可参考游戏内置剧情表 Elin/Package/_Elona/Lang/_Dialog/Drama, 或含有模板的Tiny Mita范例：
热重载
剧情表支持在游戏运行时编辑保存后热重载。
基础结构
剧情表按从上至下顺序执行, 由多行剧情单元构成。每行剧情单元包含以下列(由首行定义)：
step：标记后续行为剧情步骤起点, 直至遇到下一个step标记jump：执行该行时跳转的目标步骤if/if2：执行条件。若同时存在if2列, 则需同时满足两个条件action：执行的动作param：动作参数actor：当前说话角色 ID, 用于多人对话场景。默认tg。后缀?以显示名称为???id：文本行唯一标识(仅文本行必需)text_XX/text_JP/text_EN：实际对话内容。XX为语言代码，例如text_CN,text_ZHTW。text列将作为缺失语言代码的备选。
剧情通过步骤串联执行, 每个步骤包含若干行剧情单元, 可混合对话/动作/条件判断。
main是默认起始步骤, end是默认结束步骤。自定义步骤名请避免使用下划线_或flag前缀, 以免与内部步骤冲突。
剧情动作
文本行需要玩家输入(点击/按键)继续到下一行, 动作行(choice除外)连续执行且不可与文本共存(若共存则忽略文本)。
常用动作：
| 动作 | 参数 | 说明 |
|---|---|---|
inject | Unique | 插入"Let's Talk"及一些通用步骤 |
choice | 为文本添加选项(需配合text和jump) | |
choice/bye | 插入默认告别选项 | |
cancel | 设置右键/ESC键行为(需配合jump, 通常是end) | |
setFlag | flag, 值(可选) | 设置flag值(默认1) |
reload | 重新加载剧情，以便应用当前剧情中所做的任何flag更改。需配合jump，通常是main。这并不是指热重载，开发时热重载只需要你保存文件更改并再次打开对话即可 | |
enableTone | 启用对话语气转换 | |
addActor | 添加角色标识(actor列填写新ID时自动触发) | |
invoke | 方法名 | 调用方法 |
setBG | 图片名(可选) | 设置背景图(支持Texture文件夹自定义png), 为空时则清除 |
BGM | BGM ID | 切换背景音乐, 详见Sound 音频/BGM |
stopBGM | 停止BGM | |
lastBGM | 停止并恢复之前BGM | |
sound | 音频ID | 播放音频, 详见Sound 音频/BGM |
wait | 时长 | 暂停执行(秒), 通常用于等待动画效果 |
alphaIn | 持续时间 | 淡入效果(秒) |
alphaOut | 持续时间 | 淡出效果 |
alphaInOut | 持续时间, 等待时间, 持续时间 | 先淡入, 等待, 再淡出 |
fadeIn | 时长, white/black(可选) | 渐显(白/黑) |
fadeOut | 时长, white/black(可选) | 渐隐 |
fadeInOut | 持续时间, 等待时间, 持续时间 | 先渐显, 等待, 再渐隐 |
hideUI | 过渡时间 | 隐藏界面(结束剧情时恢复) |
hideDialog | 隐藏对话框(需配合wait使用) | |
end | 直接结束剧情 | |
addKeyItem | 关键物品id | 给予玩家关键物品 |
drop | 物品id | 在玩家位置生成物品 |
addResource | 资源类型, 数量 | 添加家园资源 |
shake | 屏幕震动 | |
slap | 扇剧情所有者角色 | |
destroyItem | 物品id | 从背包移除指定物品 |
focus | 立即聚焦镜头到剧情所有者 | |
focusChara | 角色id, 速度(可选) | 移动镜头到同地图角色 |
focusPC | 速度(可选) | 聚焦玩家角色 |
unfocus | 重置镜头 | |
destroy | 角色id | 移除同地图角色 |
save | 存档 | |
setHour | 小时数 | 设置游戏时间 |
多参数使用 , 半角逗号分隔，中间不要有空格。
触发条件
通过 if/if2 列添加该行的条件判断：
| 条件 | 参数 | 说明 |
|---|---|---|
hasFlag | flag | 玩家拥有非零值flag |
!hasFlag | flag | 玩家无flag或值为零 |
hasMelilithCurse | 玩家有Melilith诅咒 | |
merchant | 玩家在商人公会 | |
fighter | 玩家在战士公会 | |
thief | 玩家在盗贼公会 | |
mage | 玩家在法师公会 | |
hasItem | 物品id | 玩家持有指定物品 |
isCompleted | 任务id | 玩家已完成指定任务 |
条件格式为 条件,参数, 支持扩展表达式：
=,test_flag,1
,counter,20
>,flag,0
!,flag,69大多数情况下, 只需要在表格中使用 if 列。如果需要更复杂的条件, 可以插入一个新列, 并将首行值设置为 if2。
条件判定
if 列仅在剧情表加载时判定一次，这意味着您无法动态启用/禁用行。请使用 reload 或 CWL 的 invoke* 拓展条件。
内置跳转
执行 inject/Unique 动作后，会有大量内置的剧情步骤被注入当前剧情表。要使用它们，只需将它们设置为 jump 目标即可。有些步骤已经在默认的 inject/Unique 对话中使用了，你无需再次使用。
| 步骤名称 | 用途 |
|---|---|
_banish | 结束剧情 |
_bye | 结束剧情 |
_toggleSharedEquip | 切换 tg 的共享装备状态 |
_daMakeMaid | 将 tg 设为女仆 |
_joinParty | 如果 tg 的特质允许加入，则将其设为队伍成员。这不是邀请！ |
_leaveParty | 将 tg 从队伍移除，并送回据点区域 |
_makeLivestock | 将 tg 设为派系家畜 |
_makeResident | 将 tg 设为派系居民 |
_depart | 将 tg 从派系移除 |
_rumor | 查看流言 |
_sleepBeside | 切换 tg 是否在玩家旁睡觉 |
_disableLoyal | 切换 tg 忠诚心状态 |
_suck | tg 吸血或者吸猫。优先吸血，其次吸猫 |
_insult | 切换 tg 嘲讽状态 |
_makeHome | 将当前区域分支设为 tg 的家 |
_invite | 尝试邀请 tg 成为同伴，会检查玩家属性和 tg 可邀请状态。无条件邀请入队请使用CWL拓展动作join_party() |
_Guide | 引导玩家前往一系列地点 |
_tail | 纯洁的肉体关系 |
_whore | 有金钱交易的肉体关系 |
_bloom | 加深与 tg 的羁绊 |
_buy | 从 tg 购买物品 |
_buyPlan | 从 tg 购买研究图纸 |
_give | 给 tg 物品 |
_blessing | 对队伍施加祝福 |
_train | 与 tg 进行技能训练 |
_changeDomain | 改变 tg 的领域 |
_revive | 复活死亡的同伴 |
_buySlave | 从 tg 购买奴隶 |
_trade | 与 tg 交换物品 |
_identify | 与 tg 鉴定物品 |
_identifyAll | 与 tg 鉴定所有物品 |
_identifySP | 与 tg 使用高级技能鉴定物品 |
_bout | 发起决斗 |
_news | 在地图上生成随机地城 |
_heal | 治疗玩家 |
_food | 从 tg 购买食物 |
_deposit | 向 tg 存款 |
_withdraw | 向 tg 取款 |
_copyItem | 与 tg 复制物品 |
_extraTax | 缴纳额外税金 |
_upgradeHearth | 升级炉石 |
_sellFame | 出售声望 |
_investZone | 投资当前区域 |
_investShop | 投资 tg 的商店 |
_changeTitle | 更改玩家称号 |
_buyLand | 扩展当前区域地图 |
_disableMove | 使 tg 无法移动 |
_enableMove | 使 tg 可以移动 |
剧情拓展
在使用剧本表内置的 action 时未能达到预期效果？需要更多条件检查？CWL 允许您在 DLL 中添加自定义拓展方法，并在剧本表中调用它们。
Mod Help集成
有时您可能想为玩家提供一些提示，以便他们更好地体验您精彩的剧情故事。通过使用CWL制作模组，您可以使用Mod Help 来提供定制的帮助页面。
