游戏叙事与剧情 / 系统课时

剧情日志应该记录哪几个状态

剧情日志应该记录哪几个状态

剧情问题最难排的往往不是“报错”,而是玩家说“这里突然跳错分支”。要复原现场,日志必须能回答节点从哪里进入、条件为什么通过、执行了什么动作、哪些状态发生变化。本节建立一套最小但完整的剧情日志结构。

学习目标

  • 设计节点进入、条件判断、动作执行和状态变化四类核心日志
  • 为同一次剧情运行关联统一上下文,避免日志彼此失联
  • 控制日志粒度,既能定位问题又不过度记录敏感或冗余数据

四类日志缺一不可

第一类是节点进入日志,至少包含会话或存档标识、剧情图、节点 ID 和进入来源。它回答“玩家当前执行到了哪里”。

第二类是条件结果日志,记录条件名、参与判断的关键输入和值、最终真假。它回答“为什么走这条分支”。

第三类是动作执行日志,记录动作类型、目标对象和成功或失败结果。它回答“系统做了什么”。

第四类是状态变化日志,记录真正影响后续剧情的变化,例如任务状态、剧情变量、一次性事件标记。它回答“执行前后发生了什么变化”。

剧情日志上下文链路

用统一字段把一次运行串起来

日志最容易犯的错误,是每条都“看起来有用”,但彼此没有关联。推荐至少保留 traceId、graphId、nodeId 和 eventType 四个公共字段;其中 traceId 贯穿一次剧情执行链,排查时可以直接筛出完整上下文。

下面是一个可运行的 C# 示例,按顺序输出节点进入、条件结果、动作执行和状态变化四条 JSON 日志。

csharp
using System;
using System.Text.Json;

public record NarrativeLog(
    string TraceId,
    string GraphId,
    string NodeId,
    string EventType,
    object Detail);

public static class Program
{
    static void WriteLog(NarrativeLog log)
    {
        Console.WriteLine(JsonSerializer.Serialize(log));
    }

    public static void Main()
    {
        const string traceId = "trace-42";
        const string graphId = "main-story";
        const string nodeId = "gate-check";

        WriteLog(new(traceId, graphId, nodeId, "node_enter",
            new { from = "village-exit" }));

        WriteLog(new(traceId, graphId, nodeId, "condition_result",
            new { condition = "has_key", value = true, result = true }));

        WriteLog(new(traceId, graphId, nodeId, "action_execute",
            new { action = "open_gate", result = "success" }));

        WriteLog(new(traceId, graphId, nodeId, "state_change",
            new { key = "gate.opened", before = false, after = true }));
    }
}

预期输出:

text
{"TraceId":"trace-42","GraphId":"main-story","NodeId":"gate-check","EventType":"node_enter","Detail":{"from":"village-exit"}}
{"TraceId":"trace-42","GraphId":"main-story","NodeId":"gate-check","EventType":"condition_result","Detail":{"condition":"has_key","value":true,"result":true}}
{"TraceId":"trace-42","GraphId":"main-story","NodeId":"gate-check","EventType":"action_execute","Detail":{"action":"open_gate","result":"success"}}
{"TraceId":"trace-42","GraphId":"main-story","NodeId":"gate-check","EventType":"state_change","Detail":{"key":"gate.opened","before":false,"after":true}}

哪些字段最值得保留

如果日志量必须受控,优先保留能重建决策链的字段。节点 ID 和来源节点比“进入了一个剧情节点”更有价值;条件输入和值比单独记录 true 更有价值;状态变化应记录前后值,而不是只记“变量已更新”。

但不要把整个玩家存档直接塞进每条日志。大对象会迅速放大日志量,也可能包含玩家昵称、聊天文本或其他不必要信息。应该只记录当前判断实际依赖的字段,并对可能含敏感内容的文本做脱敏或截断。

用日志定位一次错误分支

排查“玩家本应走 A,却走了 B”时,顺序不要反过来猜代码。先按 traceId 找到节点进入日志,再看条件结果是否符合当时状态;如果条件正确,再检查动作是否执行成功;最后核对状态变化是否被后续节点读到。

如果条件日志显示输入就已经错误,根因多半在上游状态写入;如果条件正确但动作失败,应转向动作执行器;如果动作成功但状态未变化,则重点检查事务提交、异步写入或覆盖更新。

一套好日志的目标不是“记录得最多”,而是让你能从任意异常节点向前还原:从哪里来、为什么走到这里、做了什么、状态最后变成什么。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

剧情日志应该记录哪几个状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通