角色定义(CharacterDefinition)是游戏中所有 NPC 的核心配置。包含角色的基本信息、立绘、Spine 动画资源、音频事件、直播信息和弹幕类型等。

techName:角色的技术名称
nameKey:角色名称,多语言字段
descKey:角色描述,多语言字段
portrait:角色肖像图
emailPortrait:角色在邮件中的头像
textAnimatorStyleTag:文本动画器的样式标签
dialogueEmotionTags:对话情感标签列表
dialogueTaggingGuidance:对话标注指导文本
comments:角色维护评论列表(CharacterMaintainComment,包含 textKey 和 attrTechName)
initialCharacterStates:角色初始状态列表
initialTransform:角色初始 Transform 值
defaultBodySkin:默认身体皮肤(默认 “Normal”)
defaultEyesSkin:默认眼睛皮肤(默认 “Normal”)
defaultMouthSkin:默认嘴巴皮肤(默认 “Normal”)
spineAssetPath:Spine 资源路径
targetSpinePrefab:角色的 Spine 预制体
liveInfoList:直播信息列表(NPCLiveInfo)
allowDanmakuType:允许的弹幕类型列表
mainAudioEvents:角色主要音频事件列表
voiceFrequencyUnits:语音频率单位(默认 4)
lipsFrequencyUnits:口型频率单位(默认 1)

相关SO

CharacterState 角色状态:通过 initialCharacterStates 引用
AudioEvent 音频事件:通过 mainAudioEvents 引用
PixelAnimation 像素动画:间接关联,通过 CharacterState 引用

相关函数

相关命令

AddNPC:将角色加入直播面板
RemoveNPC:将角色从直播面板移除
RemoveAllNPC:清除全部角色
Solo:只保留指定角色
ShowHPBar:显示角色 HP 条
StopHPBar:停止角色 HP 条
Break:扣除角色 HP 条心数
Love:增加角色好感值
Hate:增加角色厌恶值
Shake:震动角色槽位
SetCharacterSkin:切换角色皮肤