交互体验 interaction.yml

interaction.yml 控制玩家看到和听到的一切：聊天格式、反馈、私聊、工具显示。

interaction — 交互设置

interaction:
  commandPrefix: "ark"
  streaming: false
  responseDelay: 300
  maxMessageLength: 300
  chatFormat: "{prefix}{name}§r: {message}"
  actionBarFeedback: true
  soundFeedback: true
  onboarding:
    enabled: true
  feedback:
    enabled: true
  dmMode:
    publicChatPrefix: "!"
    autoTimeoutMinutes: 15

字段	类型	默认值	说明
commandPrefix	string	"ark"	命令前缀（/ark）
streaming	bool	false	流式输出（逐字显示）
responseDelay	int	300	回复前延迟（毫秒）
maxMessageLength	int	300	单条回复最大字符数
chatFormat	string	"{prefix}{name}§r: {message}"	聊天格式模板
actionBarFeedback	bool	true	行动条思考动画
soundFeedback	bool	true	音效反馈
onboarding.enabled	bool	true	新玩家欢迎提示
feedback.enabled	bool	true	回复评分按钮
dmMode.publicChatPrefix	string	"!"	私聊模式下公共聊天前缀
dmMode.autoTimeoutMinutes	int	15	私聊模式自动超时（分钟）

npc — NPC 配置

控制 NPC 绑定模块的全局行为。助手级 NPC 配置在各助手的 config.yml 中设置，参见NPC 绑定。

npc:
  maxDistance: 15.0
  tickLookAt: true
  bubble:
    enabled: false
    maxLines: 5
    maxChars: 0
    durationSeconds: 8
    offsetY: 0.5

字段	类型	默认值	说明
maxDistance	double	15.0	对话最大距离（方块），超出自动结束
tickLookAt	bool	true	对话期间 NPC 持续面向玩家
bubble.enabled	bool	false	是否启用 NPC 头顶气泡。开启后聊天栏仍发送完整内容，气泡仅做预览
bubble.maxLines	int	5	气泡最大行数，超出时取最后 N 行以显示最新内容
bubble.maxChars	int	0	气泡最大显示字符数，<= 0 表示不截断
bubble.durationSeconds	int	8	回复完成后气泡保持显示的秒数
bubble.offsetY	double	0.5	气泡相对 NPC 头顶的 Y 轴额外偏移

气泡与聊天栏

NPC 对话始终通过聊天栏发送完整内容。气泡开启后作为额外的头顶预览，仅显示最新的几行。

toolDisplay — 工具显示

toolDisplay:
  overrides:
    execute-command:
      displayName: "执行命令"
    memory-read:
      displayName: "回忆中"

控制 AI 调用工具时 ActionBar 的显示文案。工具调用的完整日志（入参+出参）仅在服务器控制台输出，聊天框不再展示工具调用提示。

字段	说明
overrides.<key>.displayName	工具显示名，用于 ActionBar 显示