Project AS Developer Doc Help

第1章 引言(Introduction)

1.1 文档目标与适用范围

本设计文档旨在系统性描述《星空方舟(Ark in the Sky)》项目的核心系统架构、模块划分、数据加载机制、通信方式以及运行时状态管理。通过本架构文档,开发团队(包括程序、美术、策划、测试等)能够:

  • 明确各模块的功能边界和职责划分;

  • 理解游戏系统间的数据依赖与通信方式;

  • 理解资源与配置的组织方式(ScriptableObject + Resources);

  • 为后续的代码实现、UI 接入、存档机制等提供结构支撑;

  • 为系统升级和长期维护提供清晰的扩展依据。

本架构文档适用于本项目的主流程开发期正式发行阶段 ,也兼顾未来可能的DLC 扩展新游戏+机制支持

1.2 开发目标与目标平台

1.2.1 开发目标

本项目为一款融合生态模拟、资源管理、设施建设、居民管理与多线分支叙事的单机模拟经营游戏。

玩家将运营一座悬浮在天际的生态方舟,逐步建立稳定的生存系统,并在剧情推进中选择未来命运:

  • 移民外星(星际流亡)

  • 重建地表生态(地球复苏)

为支撑本游戏丰富而系统化的玩法内容,技术上需提供:

  • 高度模块化与可维护的系统结构;

  • 数据驱动的可拓展系统;

  • 稳定高效的运行状态管理与 UI 数据交互能力。

1.2.2 目标平台

  • 首发平台 :Windows(PC)

  • 技术引擎 :Unity 2022 LTS

  • 资源规范 :以 ScriptableObject 为核心的配置结构,统一存储于 Resources/Configs/ 中。

  • 后续平台支持(可选) :macOS、Steam Deck、主机平台(如 Switch、PS5)

1.3 架构设计原则

系统架构设计将遵循以下原则:

✓ 模块化

  • 所有游戏功能按职责划分为明确子系统(如任务、居民、设施)

  • 各模块之间解耦,避免循环依赖

✓ 数据驱动

  • 所有运行时数据由 ScriptableObject 驱动,避免硬编码

  • 统一由 DataManager 负责加载与管理配置内容

✓ 可维护与可测试性

  • 所有模块支持独立调试与日志输出

  • 保持接口稳定,支持测试与替换实现

✓ 性能可控

  • 支持按需加载,避免资源冗余

  • 可支持中等规模硬件运行(含低功耗便携平台)

✓ 安全性适度保障

  • 配置数据不采用明文形式保留于打包目录

  • 不暴露运行期调试接口于正式版

1.4 数据加载与运行机制说明

在本项目中,所有基础配置数据(任务、科技、设施、派系等)将采用以下方式管理:

阶段

数据形式

描述

开发期

JSON + 自研工具

策划使用人类可读格式维护数据

构建期

自动生成 ScriptableObject

所有内容导出为 Unity 序列化资产

发布版

打入 Resources 目录

作为常驻内存资源参与构建包打包

运行期

使用 Resource.Load<>() 加载后驻留内存

避免运行期读文件、网络等不稳定方式

通过这一策略,我们将实现:

  • 良好的策划数据编辑体验;

  • 高性能、稳定的运行时数据访问;

  • 较高的资源保护性(防止玩家篡改)

在后续第4章“数据系统设计”中,将对数据组织结构、导入流程与运行管理机制做详尽说明。

14 七月 2025