Armory3D 开源项目安装与使用教程

1. 项目目录结构及介绍

Armory3D 是一个基于Blender的开源游戏引擎，它利用Kha库来跨平台编译。以下是其基本的目录结构及其重要组成部分简介：

• armory: 核心引擎代码所在目录。

  • engine: 包含游戏引擎的核心逻辑实现。
  • editor: 相关编辑器工具或扩展功能的代码。

• blender: Blender插件相关文件夹，用于在Blender内部集成Armory引擎的功能。

  • io_scene_armory: 负责导入导出特定于Armory的场景数据。

• samples: 示例项目集合，帮助新用户快速理解如何使用Armory进行开发。

• templates: 项目模板，提供给用户快速开始新项目的起点。

• .github: GitHub相关的元数据，如工作流定义等。

• docs: 文档资料，虽然本教程不在该目录下，但用户可以在此找到更详细的说明。

• build: 编译生成的临时或最终产物通常存放于此，具体取决于用户的构建设置。

• HaxeLibrary: Haxe编程语言的库文件，Armory使用Haxe作为主要开发语言。

• ProjectTemplate: 新建Armory项目的默认模板结构。

2. 项目的启动文件介绍

在Armory中，一个典型的启动流程从Blender内开始。项目的主要控制不通过单独的传统启动文件完成，而是通过Blender中的场景设置和Armory插件设置来定义。因此，“启动文件”可以理解为你的主Blender场景文件（通常命名为.blend）。在这个场景里：

• Armory Player Properties: 这是在Blender的属性面板中的Armory专用标签页，用来配置编译和运行选项。
• 场景中的物体、逻辑砖块（Logic Bricks） 和 Armory Scripting 直接决定了游戏的行为，是逻辑执行的起点。

当你准备编译并运行游戏时， Armory插件将根据当前场景的内容生成相应的可执行文件或WebGL应用。

3. 项目的配置文件介绍

Armory的配置主要是通过Blender内的界面以及特定的 .arm 文件来进行的。尽管没有传统意义上的单一“配置文件”，但以下几个关键点需要注意：

• .arm场景文件：每个Blender场景保存时，Armory会自动生成对应的.arm文件，存储场景的Armory特定设置和编译指令。
• Armory Player Properties中的设置：包括目标平台（如Windows、Linux、HTML5）、构建模式（开发/发布）和优化级别等，这些都是项目的重要配置。
• 自定义构建脚本（如果有）：对于高级用户，可以通过Kha文件结构中的project.json或其他辅助脚本来微调编译过程。

综上所述，Armory3D的项目管理和配置紧密地与Blender集成在一起，强调了以场景为中心的工作流程。了解这些关键元素，将有助于快速上手并高效地使用Armory进行游戏开发。