3.6 KiB
3.6 KiB
xiandie
《衔蝶》开发代码
说明
- animation frames：res://config/animation/entity_sprite_frames.tres
插件
ProAnimatedSprite2D
插件路径：addons/property-inspector/pro_animation_sprite2d
ProAnimatedSprite2D，增强 AnimatedSprite2D 的表现，在其基础上增加：
- 播放+移动：播放特定动画时自动移动，可配置移速
- 播放某动画后自动跳转：播放一个动画结束后，自动播放另一个
- 自动跳转可以设置循环播放次数，若干次后再跳转
- 跳转前可以等待 wait_time 时长
其中：
- action configs 配置动画跳转逻辑
- move configs 配置播放特定动画时的移动速度
- ProAnimatedSprite2D 配置项跳过保存默认值，有利于统一控制、变更默认值
Ground 与 GroundLoader
- 正常游戏：Main -> GroundLoader -> Ground
- 开发阶段：直接编辑 Ground
Ground 说明
AnimationPlayer：每个 Ground 都有一个 AnimationPlayer，脚本继承自定义的 AnimationRoot
主要功能说明：
- 正常的 AnimationPlayer 功能
- oneshot_animation 场景首次加载时播放的 animation
主要方法与数据说明：
- _default_data() : 本场景的默认存档数据
- _on_ground_ready(): 在父节点 Ground 加载完成后回调
- set_data(property: StringName, value: Variant)：用于设置需要存档的数据
- ground_archive：存档数据
Entity 说明
位置：res://scene/entity/
子目录说明：
- ambient：光照
- general：音效等
- partical：粒子效果
- ux：用户交互
主要类型说明：
- ambush：触发区域，触发后执行回调
- 可以配置是否一次性
- 可配置触发方式：enter, area_enter, interact
- 可在场景加载时触发
- 触发效果有：播放对话（期间锁定玩家）；播放动画；回调方法（AnimationPlayer 的方法，注意“_”开头的方法会被忽略）
- inspectable：可在检阅窗口进行审视的物品，可以附加文案
- local_inspectable：运镜+检阅，无需检阅窗口
- note：显示文案
- 显示方式：os（玩家头顶气泡），ballon（下方字幕，可播放配音）
- npc
- portal：传送门
- 名称有: left（默认）, right（默认）, 1, 2, 3, ...
- 关键参数：targer_scene 与 target_portal（target_portal 为 none 时不启用）
- 三种模式：default（通道）；opened（打开的门）；locked（锁定的门）；对应不同图标与操作音效
- 锁定的门可以配置启用钥匙（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。