YarnCommands_总览

角色与直播

Yarn Command	参数	执行效果
AddNPC	string characterName	等待角色入场动画完成，然后更新当前对话角色。
RemoveNPC	string characterName	等待角色退场动画完成，然后移除角色。
RemoveAllNPC	无	立即清除全部对话角色和相关上下文。
Solo	string characterTechName	等待移除其他角色；目标角色不存在时将其加入。
AddCG	string cgTechName	显示指定 CG；入场动画为非等待执行。
RemoveCG	string cgTechName	移除指定 CG 及其关联角色面板。
CGAnim	string cgTechName, string animationName	让已显示的 CG 播放指定动画。
ApplyNPCState	string characterTechName, string... stateSelectors	根据一个或多个状态选择器解析并应用角色状态。
SetNPCState	string characterTechName, string stateName	对指定角色应用一个明确状态。
SetCharacterSkin	string characterTechName, string skinTechName	切换指定角色的皮肤。
Shake	int speakerIndex, float intensity = 1, float duration = -1	震动直播角色槽位 1 或 2；负时长使用动画默认时长。
ShowImage	string attachmentTechName, string characterName	在指定角色面板显示图片附件；每个角色最多保留四张。
ShowHPBar	string characterName, int heartCount	显示角色对话心形 HP 条。
StopHPBar	string characterName	停止并清除指定角色的 HP 条。
Break	string characterName, int amount	从角色对话 HP 条扣除指定心数，并播放受击效果。
Love	string characterTechName, int amount	修改 $角色名_Love 并播放 Love UI。
Hate	string characterTechName, int amount	修改 $角色名_Hate 并播放 Hate UI。
ClearOptions	无	清除当前直播对话选项。
GenerateNPCOption	string baseNodeName, int optionsCount	从指定节点或节点组生成 NPC 对话选项。
StartLiveStatus	无	将直播状态标记为开启；不会自行打开窗口。
EndLiveStatus	无	将直播状态标记为关闭。
CodeFlow	string controllerName	切换直播窗口 CodeFlow/Case 控制器页面。

属性、战斗与检定

Yarn Command	参数	执行效果
Damage	int amount	对爱式塔造成指定 HP 伤害。
Defense	int amount	增加指定数量的防御层数，不直接恢复 HP。
Heal	int amount	恢复爱式塔 HP。
StartCombat	string combatTechName = ""	开始战斗；可选指定战斗配置。
EndTurn	无	结束当前战斗回合并推进战斗状态。
EndCombat	无	结束战斗并重置回合、优势值和检定锁定状态。
Advantage	int delta	战斗中调整总优势值；正数增加，负数减少。
Check	string attrTechName, int difficulty, string topicTechName = ""	等待执行可见的属性检定，并更新检定结果变量。
SecretCheck	string attrTechName, int difficulty, string topicTechName = ""	等待执行秘密检定，并更新检定结果变量。
MultiCheck	string... checkSpecifications	等待依次执行多个检定，首个成功后停止。格式为 属性_难度_可选Topic。
ApplySE	string seTechName	应用指定特殊效果；同一命令来源通常不重复叠加。
RemoveSE	string seTechName	移除由 Yarn Command 来源施加的指定特殊效果。

Hex 与协议

Yarn Command	参数	执行效果
AddHexProtocol	string protocolTechName	将协议加入库存，但不安装到网格。
InstallHexProtocol	string protocolTechName	确保拥有协议，并尝试随机放置到合法网格位置。
Gottocol	string moduleKey	查找 Module_<moduleKey> 或原始名称，并安装到最早的空核心。
StartMaintain	无	等待玩家完成正式协议维护选择。
FakeMaintain	string protocolName1, string protocolName2, string protocolName3	打开由三个固定协议组成的选择界面，但不等待选择结束。
HintProtocol	string protocolTechName	高亮提示指定协议；需要 Hex UI 已存在。

弹幕与人气

Yarn Command	参数	执行效果
StartDanmaku	无	开始弹幕发射，并重置相关上下文。
StopDanmaku	无	停止弹幕发射并标记为停止。
EnableDanmaku	无	开启弹幕发射许可，但不会主动开始发射。
DisableDanmaku	无	禁止弹幕发射，但不执行完整停止流程。
ClearDanmaku	无	清除当前显示的弹幕。
LoadDanmaku	无	加载当前游戏日对应的弹幕库。
AllowDanmakuType	string typeName	允许指定弹幕类型。
DisableDanmakuType	string typeName	禁止指定弹幕类型。
EmitDanmakuTypeBurst	string typeName, float seconds	在指定秒数内集中发射该类型弹幕。
AddPopularity	float amount	调整当前直播人气/热度；负数可以降低。

算力、成就与内容

Yarn Command	参数	执行效果
AddCompu	int amount	调整算力；正数增加，负数减少。
AddAchievement	string achievementTechName	解锁指定成就。
AddPlayerInfo	string infoKey	将信息加入玩家 Brief 列表；重复添加会移动到列表末尾。
AddPrefix	string textKey	为下一条对话设置本地化前缀；执行时不会立即显示。
StartSituation	string situationTechName	启动指定 Situation。
EndDay	无	执行完整日结流程、清理每日状态、推进到下一天并启动 Initial。
EndGame	string caseName	打开游戏结束界面并选择指定结局页面。

商品与交互物

Yarn Command	参数	执行效果
ActivateGoodsList	string goodsListTechName	激活商品列表并供应其初始商品。
AddDecoration	string decorationTechName	将装饰加入库存，但不一定立即启用。
EnableDecoration	string decorationTechName	确保拥有并启用指定装饰。
DisableDecoration	string decorationTechName	禁用并移除指定装饰的绑定。
GenerateInteract	string techName	激活指定交互物。
DeleteInteract	string techName	停用指定交互物，不删除其定义。

邮件、新闻与音频

Yarn Command	参数	执行效果
AddEmail	string emailTechName	将邮件加入待发送队列。
SendEmail	无	发送当前队列中的邮件。
AddNews	string newsTechName	将新闻加入报纸队列。
SendNewspaper	无	发布当前排队的报纸内容。
PlayAudioEvent	string audioEventTechName	播放指定 Audio Event。
UnlockSong	string songTechName	解锁指定歌曲。
PlaySong	string songTechName	播放指定歌曲。
StopSong	无	停止当前歌曲。

OS 与 UI

Yarn Command	参数	执行效果
OS_Add_Shortcut	string techName	将指定快捷方式加入桌面。
HintShortcut	string shortcutTechName	高亮提示指定桌面快捷方式。
OpenWindow	string windowTechName	打开指定 OS 窗口。
ChangeController	string targetName, string controllerName, string controllerState	修改工作区或已打开窗口中的 FairyGUI Controller 页面。
SetLocation	string locationName	切换世界空间位置，并尝试写入存档变量。
EnableNameTable	string tableTechName	启用指定角色名称替换表。
DisableNameTable	string tableTechName	禁用指定角色名称替换表。
StartFX	string techName	开启所有匹配 TechName 的后处理效果。
StopFX	string techName	停止所有匹配 TechName 的后处理效果。
Warn	string textKey	非等待地播放本地化警告横幅；新警告会替换旧警告。

玩家输入

Yarn Command	参数	执行效果
AskInput	string varName	等待玩家提交非空文本，并写入指定 Yarn 变量。
AskInputNum	无	等待玩家提交数字，并写入固定变量 $InputNumber；解析失败写入 0。

Yarn Spinner 内置

Yarn Command	参数	执行效果
wait	number seconds	暂停 Yarn 指定秒数，例如 <<wait 0.5>>。