重构: Game_NPC 设计

[heartcase]

1. 移除SelfData依赖
2. 拓展一个专用的Game_NPCEvent
3. 整理了之前讨论的场景外NPC活动规则
   ====
   对象属性

属性名	说明	类型
offSceneCounter	场景外 NPC 移动计数	number
routine	路径队列	Queue<Game_PathNode>
patrol	巡逻队列	Queue<Game_PathNode>
pos	NPC 位置	[MapId, x, y, d]
name	NPC 事件标识	string
event	场景内事件对象	Game_NPCEvent
patterns	行为模式组	List<Pattern>
dialogueName	NPC 对话模式标识 (事件页条件)	string
behaviorName	NPC 移动模式标识	string
actionName	NPC 动作模式标识 (待更新)	string

初始化

在加载完$dataEventMap后:

1. 遍历$dataEventMap.events里所有的事件e:
   1. 如果e.meta.GameNPC为true
      • (待更新) 读取e.pages[0].list的注释, 遍历每一行初始化数据

时间驱动: updateOffScene

对于每个场景外 NPC, 每经过周期 x 执行:

1. 设置队列l的值:

   • 如果routine不为空 则设l为routine
   • 如果patrol不为空 则设l为patrol
   • 否则跳过剩余动作

2. 设l的列头为目标点p

3. offSceneCounter增加 x

4. 重复offSceneCounter 大于 p.cost:

   1. offSceneCounter 减少 p.cost
   2. 将p从l中出队
   3. 如果l为patrol:
      • 将p加入队列l
   4. 如果l为routine且为空
      • 设置l为patrol
   5. 如果l为空
      • 跳过剩余动作
   6. 重新设p的值为l列头

5. 将p.pos赋给pos

6. 如果pos所在的mapId为$gameMap._mapId

   • 创建标识符为name的Game_NPCEvent实例, 并赋值给event
   • 加载Sprite_Character到Scene

地图移动驱动: updateOnSceneMovement

对于每个在场景内的 NPC, 每次刷新时若没有其他行动则:

1. 设置队列l的值:

   • 如果routine不为空 则设l为routine
   • 如果patrol不为空 则设l为patrol
   • 否则跳过剩余动作

2. 设l的列头为目标点p

   • 如果pos和p.pos相等:

     1. 将p从l中出队
     2. 如果l为patrol:
        • 将p加入队列l
     3. 如果l为routine且为空
        • 设置l为patrol
     4. 如果l为空
        • 跳过剩余动作
     5. 重新设p的值为l列头

3. 如果p所在的mapId不为$gameMap._mapId

   • 则移除event
   • 移除event对应的sprite
   • 跳过剩余动作

4. 设置d为 event.findDirectionTo求到p.pos位置的方向

5. 执行event.moveforward

6. 将pos设置为pos位移 d 方向 1 格的坐标

地图动作: updateOnSceneAction

(待更新)

行为模式切换

对于所有 NPC, 当外界状态发生变化时, 或对某一 NPC, 自身状态发生变化时:

1. 遍历patterns中的每一个pattern:

   1. 如果pattern中的conditions均满足条件

      • 设newPattern为 pattern

   2. 如果behaviorName不相等

      • 更新routine, patrol (跨地图寻路)

   3. 更新dialogueName和actionName

2. 刷新地图, $gameMap.requestRefresh()

[MikanHako1024]

设计的行动

6-7	7-9	9-18	18-22	22-6
家	家-店	店	店-家	家

设想的配置

时间 cases

• 6:00
  • 当 6:00 时间点到来时 触发
  • 打断之前的循环行动 (睡觉)
  • 设置路线 : 无
  • 路线完成后 : 在房间内闲逛 (循环动作)
• 7:00
  • 打断之前的闲逛 (打断循环行动)
  • 设置路线 : 当前位置 -> 店铺
  • 路线完成后 : 在店铺内闲逛 (循环动作)
    • 不在意完成时间，但路线结束后总要有个循环动作，如闲置
• 9:00
  • 打断之前的闲逛 (打断循环行动)
  • 设置路线 : 当前位置 -> 柜台
  • 路线完成后 :
    • 设置循环动作 : 站立
    • 设置事件开关 开店 ON
      • 判断开店开关状态，提供不同的对话交互
• 18:00
  • 打断之前的循环动作
  • 设置路线 : 当期位置 -> 家
  • 路线完成后 : 房间内闲逛
• 22:00
  • 打断之前的循环动作
  • 设置路线 : 当期位置 -> 床
  • 路线完成后 : 睡觉，事件开关 睡觉 ON

[MikanHako1024]

Game_DynamicEvent 和 Game_NPCEvent 什么区别

[MikanHako1024]

设计的行动

6-7 7-9 9-18 18-22 22-6
家 家-店 店 店-家 家

设想的配置

时间 cases

• 6:00

  • 当 6:00 时间点到来时 触发
  • 打断之前的循环行动 (睡觉)
  • 设置路线 : 无
  • 路线完成后 : 在房间内闲逛 (循环动作)

• 7:00

  • 打断之前的闲逛 (打断循环行动)

  • 设置路线 : 当前位置 -> 店铺

  • 路线完成后 : 在店铺内闲逛 (循环动作)

    • 不在意完成时间，但路线结束后总要有个循环动作，如闲置

• 9:00

  • 打断之前的闲逛 (打断循环行动)

  • 设置路线 : 当前位置 -> 柜台

  • 路线完成后 :

    • 设置循环动作 : 站立

    • 设置事件开关 开店 ON

      • 判断开店开关状态，提供不同的对话交互

• 18:00

  • 打断之前的循环动作
  • 设置路线 : 当期位置 -> 家
  • 路线完成后 : 房间内闲逛

• 22:00

  • 打断之前的循环动作
  • 设置路线 : 当期位置 -> 床
  • 路线完成后 : 睡觉，事件开关 睡觉 ON

拟引入 行为树 管理NPC的行动

基本功能/能力：根据当前条件，进行某一动作

• 条件判断：根据条件判断是否执行节点
  • 修饰节点 - Condition
• 依次执行：依次执行节点
  • 组合节点 - Sequence
  • 组合节点 - Selector
• 并行执行？：同时执行节点
  • 组合节点 - Parallel
• 执行命令
  • 动作节点 - 执行RM命令
• 随机：赋值随机值
  • 动作节点 - RandomValue
• while循环：循环执行子树 直到成功/失败
  • 修饰节点 - Until Success/Failure
• for循环：循环执行子树 共N次
  • 修饰节点 - Repeater
• 跳出：跳出子树的执行 return
  • 修饰节点 - Return Success/Failure
• 逻辑运算取反：子树结果取反
  • 修饰节点 - Inverter
• 设置结果 - 结果强制 Success/Failure
  • 修饰节点 - Result Success/Failure
• 中断：结束执行
  • none, self, lowerpriorit, both
  • 修饰节点 - 黑板装饰器
• 等待：等待一段时间
  • 动作节点 - Wait
• 变量：记录值
• 等待下一帧
• ...

节点介绍（个人理解）

• 根节点
  • 不能被修饰节点修饰
• 动作节点
  • Action
    • 叶子节点
    • 执行一个动作
• 组合节点
  • 非叶子节点
  • Sequence
    • 顺序执行子树
    • 当遇到 Failure 结束执行 返回 Failure
    • 未遇到 Failure 返回 Success
  • Selector
    • 顺序执行子树
    • 当遇到 Success 结束执行 返回 Success
    • 未遇到 Success 返回 Failure
• 修饰节点
  • 非叶子节点
  • 有且只有一个直接子节点
  • (Condition)
    • 满足条件时执行被修饰的节点 返回 节点结果
    • 不满足条件时 返回 Failure
  • (ResultSuccess)
    • 执行被修饰的节点 返回 Success
  • (ResultFailure)
    • 执行被修饰的节点 返回 Failure
  • (UntilFailure)
    • 循环执行被修饰节点 直到节点结果为Failure 返回Failure？

示例

[Root]
    (Condition) : 工作日
    Sequence
        (ResultSuccess)
        (Condition : 6:00 ~ 7:00)
        Sequence
            Action : 起床动作
            Action : 设置巡逻 房间内巡逻
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 6:00 ~ 7:00  (考虑记录这个条件表达式 与父节点公用这个条件表达式)
            Action : 执行巡逻移动
            Action : 清除巡逻

        (ResultSuccess)
        (Condition) : 7:00 ~ 9:00
        Sequence
            Action : 设置移动 移至店铺
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 移动未完成
            Sequence
                (ResultSuccess)
                Selector
                    (Condition) : 晴天
                    Action : 设置移动方式 行走
                    (Condition) : 雨天
                    Action : 设置移动方式 跑步
                Action : 执行路径移动
            Action : 开门 标志ON
            (Condition) : 移动方式 跑步
            Action : 设置移动方式 行走
            Action : 进门 (传送至店内门口)
            Action : 设置巡逻 店铺内巡逻
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 7:00 ~ 9:00
            Action : 执行巡逻移动
            Action : 清除巡逻

        (ResultSuccess)
        (Condition) : 9:00 ~ 18:00
        Sequence
            Action : 设置移动 移至柜台
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 移动未完成
            Action : 执行路径移动
            Action : 营业 标志ON
            // Action : 互动标志设置为xxx (TODO)
            Action : 设置巡逻 柜台前巡逻 (也可以是站在同一个位置不移动)
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 9:00 ~ 18:00
            Action : 执行巡逻移动
            Action : 清除巡逻
            Action : 营业 标志OFF

        (ResultSuccess)
        (Condition) : 18:00 ~ 22:00
        Sequence
            Action : 设置移动 移至家
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 移动未完成
            Action : 执行路径移动  (这一部分也可以考虑直接 : 循环移动到家)
            Action : 设置巡逻 家内巡逻
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 18:00 ~ 22:00
            Action : 执行巡逻移动
            Action : 清除巡逻

        (ResultSuccess)
        (Condition) : 18:00 ~ 22:00
        Sequence
            Action : 设置移动 移至家
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 移动未完成
            Action : 执行路径移动  (这一部分也可以考虑直接 : 循环移动到家)
            Action : 设置巡逻 家内巡逻
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 18:00 ~ 22:00
            Action : 执行巡逻移动
            Action : 清除巡逻

        (ResultSuccess)
        (Condition) : 22:00 ~ 6:00+1
        Sequence
            Action : 设置移动 移至床
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 移动未完成
            Action : 执行路径移动
            Action : 设置巡逻 睡觉巡逻 (睡觉的动作等)
            (ResultSuccess)
            (UntilFailure)
            (Condition) : 22:00 ~ 6:00+1
            Action : 执行巡逻移动
            Action : 清除巡逻

[ 此处暂时省略gif展示 ]