xiandie

《衔蝶》开发代码

说明

• animation frames：res://config/animation/entity_sprite_frames.tres

插件

• DialogueManager 使用与维护说明
• GIF 插件
• Godot Steam

ProAnimatedSprite2D

插件路径：addons/property-inspector/pro_animation_sprite2d

ProAnimatedSprite2D，增强 AnimatedSprite2D 的表现，在其基础上增加：

1. 播放+移动：播放特定动画时自动移动，可配置移速
2. 播放某动画后自动跳转：播放一个动画结束后，自动播放另一个
3. 自动跳转可以设置循环播放次数，若干次后再跳转
4. 跳转前可以等待 wait_time 时长

其中：

1. action configs 配置动画跳转逻辑
2. move configs 配置播放特定动画时的移动速度
3. ProAnimatedSprite2D 配置项跳过保存默认值，有利于统一控制、变更默认值

Ground 与 GroundLoader

• 正常游戏：Main -> GroundLoader -> Ground
• 开发阶段：直接编辑 Ground

整体说明

GroundLoader 加载/切换 Ground 时，分为上下两段转场：

• 上半段（旧场景变黑）：先暂停旧 ground，即在转场黑屏过程中旧的 ground 会 paused
• 下半段（新场景出现）：先暂停，在完全出现后再运行 【特殊注意⚠️】
• AnimationPlayer 的 process_mode 并非 inderited，而是 pausable。这意味着 AnimationPlayer 的 _on_ground_ready 在转场时仍旧可以直接运行。
  • 同样独立设置的还有 Sfx/Sfx2D，它们仍旧可以播放音频直到上半段转场结束
  • CameraFocusMarker 也需要如此，以确保镜头快速拉到指定位置
  • 盒子 canvas layer
• 一些 npc、player 大运行脚本会被中断。如果想让它们仍旧运行，需设置为 pausable。

Ground 说明

AnimationPlayer：每个 Ground 都有一个 AnimationPlayer，脚本继承自定义的 AnimationRoot

主要功能说明：

1. 正常的 AnimationPlayer 功能
2. oneshot_animation 场景首次加载时播放的 animation

主要方法与数据说明：

1. _default_data() : 本场景的默认存档数据
2. _on_ground_ready(): 在父节点 Ground 加载完成后回调
3. set_data(property: StringName, value: Variant)：用于设置需要存档的数据
4. ground_archive：存档数据

Entity 说明

位置：res://scene/entity/

子目录说明：

1. ambient：光照
2. general：音效等
3. partical：粒子效果
4. ux：用户交互

主要类型说明：

1. ambush：触发区域，触发后执行回调
   1. 可以配置是否一次性
   2. 可配置触发方式：enter, area_enter, interact
   3. 可在场景加载时触发
   4. 触发效果有：播放对话（期间锁定玩家）；播放动画；回调方法（AnimationPlayer 的方法，注意“_”开头的方法会被忽略）
2. inspectable：可在检阅窗口进行审视的物品，可以附加文案
3. local_inspectable：运镜+检阅，无需检阅窗口
4. note：显示文案
   1. 显示方式：os（玩家头顶气泡），ballon（下方字幕，可播放配音）
5. npc
6. portal：传送门
   1. 名称有: left（默认）, right（默认）, 1, 2, 3, ...
   2. 关键参数：targer_scene 与 target_portal（target_portal 为 none 时不启用）
   3. 三种模式：default（通道）；opened（打开的门）；locked（锁定的门）；对应不同图标与操作音效
   4. 锁定的门可以配置启用钥匙（prop_key），可在使用后自动消耗该钥匙

存档结构

• 存档命名为："save"+三位数字
• 如果不足三位数字，则会忽略；超过三位数字不会忽略，可以正常读取
• 这是为了方便多存档功能进行文本排序等
• 开发阶段 debug 存档：save000
• 开发阶段 index 页面进入的游戏存档：save001
• 发行后，玩家游戏过程中，自动保存的存档编号范围（最多 10 个，循环保存）：000-019
• 发行后，玩家游戏过程中，手动保存的存档编号范围（最多 10 个栏位）：050-059
• 发行后，玩家游戏过程中最多有以上 20 个存档

每个场景都有一份 GroundArchive 存档，通过 ArchiveManager.archive.ground_archive() 可以获得。

current_scene 是通过 GroundLoader 加载的，在 ground loader 加载 ground 时，会先更新 archive 的 current scene，然后加载 ground。

重大更新日志（功能）

• Sign 触发机制，图标位置管理
• GroundArchive：场景内 namespace 隔离，内部需要保证节点名 unique
• 基础节点：Inspectable，Ambush，Note，Interactable，Closeup，Npc
• PropHud 切换与点击展示
• SignSnapper 拉动机制
• ReenterLock 机制
• Vibe Sfx & Manager
• 转场 process 机制优化：暂停 & sfx 等保持运行
• EventManager 控制事件，使用 Event2D 控制绑定关系
• Vibe Control 控制氛围情绪音乐