第一部分：认识 Andrion Studio

什么是 Andrion Studio？

Andrion Studio 是一个由国人开发、完全免费的跨平台游戏引擎，它旨在为开发者提供一个简单、高效、功能强大的开发环境，让游戏创作变得更加轻松。

• 核心特点：
  • 跨平台： 一套代码，可以轻松发布到 Windows, macOS, Linux, Android, iOS, Web (HTML5) 等多个平台。
  • 免费开源： 核心引擎完全免费，无版税，无隐藏费用，个人和商业项目均可使用。
  • 可视化编辑器： 提供强大的所见即所得的编辑器，通过拖拽即可搭建场景、设计UI。
  • Lua 脚本： 使用简单易学的 Lua 语言进行游戏逻辑编写，上手快，非常适合独立开发者和小团队。
  • 资源商店： 内置资源商店，可以方便地导入模型、音效、图片等资源，加速开发。
  • 活跃的社区： 拥有中文社区，开发者可以方便地交流求助。

适合谁使用？

• 游戏开发初学者： 对游戏制作感兴趣，想从零开始学习。
• 独立开发者/小团队： 需要一个低成本、高效率的工具来制作中小型项目。
• Hobbyist (爱好者)： 希望制作自己的游戏Demo或完整作品的爱好者。
• 有经验的开发者： 如果想快速验证一个游戏想法，Andrion 也是一个不错的选择。

第二部分：新手入门指南

这是从零开始学习 Andrion Studio 的标准路径。

步骤 1：下载与安装

1. 访问官网： 打开 Andrion Studio 的官方网站 andrion.cn。
2. 下载版本： 根据你的操作系统（Windows, macOS, Linux）下载对应的安装包。
3. 安装： 像安装普通软件一样完成安装即可，Windows 版本通常是一个 .exe 安装程序。

步骤 2：初识界面（第一次打开）

启动 Andrion Studio，你会看到主界面，主要包含以下几个区域：

• 场景视图： 中间最大的窗口，是你在游戏中看到的世界，可以在这里放置角色、道具等。
• 层次结构： 左侧面板，列出了当前场景中所有的游戏对象，以树状结构展示，方便管理。
• 属性检查器： 右侧面板，选中任何一个游戏对象后，这里会显示该对象的所有属性（如位置、大小、颜色、脚本等），你可以直接在这里修改。
• 资源管理器： 左上角面板，存放你项目中所有的资源文件（图片、模型、音效、脚本等）。
• 工具栏： 顶部菜单栏和快捷工具栏，包含文件操作、播放、暂停、停止等常用功能。

步骤 3：创建你的第一个项目

1. 点击 文件 -> 新建项目。
2. 选择一个模板,2D 或 3D，对于新手，推荐从 2D 开始。
3. 为你的项目命名,并选择一个保存位置，然后点击 创建。

步骤 4：运行你的第一个场景

1. 在 工具栏 中，点击绿色的 播放 按钮（一个三角形图标）。
2. 几秒钟后,一个新窗口会弹出，显示你的游戏场景，这就是你的游戏在运行时的样子。
3. 点击红色的 停止 按钮可以回到编辑器。

恭喜！你已经成功运行了第一个 Andrion 项目！

第三部分：核心概念与工作流

理解这些概念是掌握 Andrion 的关键。

游戏对象

游戏世界中的一切都是游戏对象，玩家、敌人、树木、UI按钮、摄像机……它们都是 GameObject。

• 创建： 在 层次结构 面板右键 -> 创建，或直接从 资源管理器 中将预制体拖入场景。
• 组件： 游戏对象本身是空的，它的功能是由“组件”赋予的。
  • Transform (变换): 每个GameObject都有，用于控制位置、旋转、缩放。
  • Sprite (精灵): 让一个GameObject显示2D图片。
  • Camera (摄像机): 决定了玩家能看到什么。
  • Rigidbody (刚体): 让GameObject具有物理属性，如重力、碰撞。
  • Script (脚本): 赋予GameObject自定义逻辑。

组件

组件是 Andrion 的核心，你可以把组件想象成乐高积木上的功能块，你可以为一个游戏对象添加多个组件来组合出复杂的功能。

• 如何添加组件？ 在 层次结构 中选中一个GameObject，然后在右侧 属性检查器 中点击 添加组件 按钮。

脚本 - 游戏的灵魂

游戏的核心逻辑是通过脚本来实现的,Andrion 使用 Lua 语言。

• 创建脚本：

  
  （图片来源网络，侵删）
  1. 在 资源管理器 中右键 -> 创建 -> Lua 脚本。
  2. 给脚本命名（PlayerController）。
  3. 双击脚本,会打开代码编辑器。

• 脚本结构：

  -- 这是一个简单的脚本示例
  -- 当游戏对象被创建时调用
  function Start()
      print("游戏对象已启动！")
      -- 在这里获取组件，进行初始化
      --  self.sprite = self:GetComponent("Sprite")
  end
  -- 每一帧都会调用（约60次/秒）
  function Update(dt)
      -- dt 是时间增量，用于实现与帧率无关的逻辑
      -- 在这里处理输入、移动、AI等
      --  self.transform.position.x = self.transform.position.x + 100 * dt
  end

• 将脚本附加到游戏对象：

  1. 在 资源管理器 中创建好脚本。
  2. 将脚本文件直接拖拽到 层次结构 中的某个游戏对象上，或者拖到该对象的 属性检查器 中。

资源管理

• 导入资源： 将图片、音效等文件直接从你的电脑文件夹拖拽到 Andrion 的 资源管理器 面板中即可。
• 素材类型：
  • 图片: 会被自动识别为 Texture (纹理)。
  • 精灵图集: 如果你有多张小图片放在一张大图上，可以将其导入为 Sprite Atlas (精灵图集)，更高效。
  • 音效: 导入为 Audio Clip。
  • 3D模型: 支持 .obj, .fbx 等格式。

第四部分：实战项目：制作一个简单的 2D 平台跳跃游戏

让我们通过一个具体的小项目来巩固所学知识。

目标： 一个可以左右移动、跳跃的方块，并有一个地面。

第1步：创建场景

1. 新建一个 2D 项目。
2. 在 层次结构 中，右键 -> 创建 -> 空游戏对象，命名为 Player。
3. 再创建一个空游戏对象,命名为 Ground。

第2步：设置玩家

1. 选中 Player 对象。
2. 在 属性检查器 中点击 添加组件 -> Sprite。
3. 在 Sprite 组件的 Sprite 属性中，点击 选择，然后从 资源管理器 中选择一张方块图片（如果没有，可以先用一个颜色代替）。
4. 为了让玩家能移动,我们添加物理属性，点击 添加组件 -> Rigidbody 2D。
5. 再添加一个 添加组件 -> Box Collider 2D，这是碰撞体，用于检测碰撞。

第3步：编写玩家控制脚本

1. 在 资源管理器 中右键 -> 创建 -> Lua 脚本，命名为 PlayerController。

2. 双击打开 PlayerController.lua，输入以下代码：

   -- 获取按键输入状态
   local Input = CS.UnityEngine.Input
   function Start()
       -- 获取刚体组件的引用，避免每一帧都去查找
       self.rb = self:GetComponent("Rigidbody2D")
       -- 设置移动速度和跳跃力度
       self.moveSpeed = 5
       self.jumpForce = 10
       self.isGrounded = false
   end
   function Update(dt)
       -- 左右移动
       local moveHorizontal = Input.GetAxis("Horizontal") -- 获取 A/D 或 左/右箭头的输入值
       self.rb.velocity = CS.UnityEngine.Vector2(moveHorizontal * self.moveSpeed, self.rb.velocity.y)
       -- 跳跃 (当按下空格键且在地面上时)
       if (Input.GetKeyDown("Space") or Input.GetKeyDown("UpArrow")) and self.isGrounded then
           self.rb.velocity = CS.UnityEngine.Vector2(self.rb.velocity.x, self.jumpForce)
       end
   end
   -- 当玩家与地面发生碰撞时调用
   function OnCollisionEnter2D(collision)
       if collision.gameObject.name == "Ground" then
           self.isGrounded = true
       end
   end
   -- 当玩家与地面分离时调用
   function OnCollisionExit2D(collision)
       if collision.gameObject.name == "Ground" then
           self.isGrounded = false
       end
   end

   注意：CS.UnityEngine 是 Andrion 中调用 C# Unity API 的方式，用于获取输入、向量等。

3. 将 PlayerController 脚本拖拽到 层次结构 中的 Player 对象上。

第4步：设置地面

1. 选中 Ground 对象。
2. 添加组件 -> Sprite，选择一张长条图片作为地面。
3. 添加组件 -> Box Collider 2D，确保它的尺寸能覆盖整个地面图片。
4. 重要： 调整 Ground 的位置，确保它在 Player 的下方。

第5步：设置摄像机

1. 默认情况下,场景中应该有一个 Main Camera。
2. 选中 Main Camera。
3. 在 属性检查器 中，找到 Follow 组件（如果没有，可以添加一个）。
4. 将 Player 对象拖拽到 Follow 组件的 Target 字段中，这样摄像机就会一直跟随玩家。

第6步：运行和测试

点击 播放 按钮！现在你应该可以用 A/D 或方向键移动方块，用 空格 或 上箭头 跳跃了。

第五部分：学习资源推荐

官方资源（首选）

• 官方文档： https://docs.andrion.cn/ (最权威、最全面的技术参考)
• 官方示例项目： 在 Andrion Studio 的 文件 -> 打开示例 中，有多个不同类型的完整项目，是学习代码和架构的绝佳材料。
• 官方B站频道： 搜索 "Andrion Studio 官方"，有官方发布的入门教程和功能介绍视频。

社区资源

• 官方QQ群： 在官网或B站可以找到群号，这是国内最活跃的交流地，遇到问题可以在这里提问。
• CSDN / 知乎 / 掘金： 搜索 "Andrion Studio"，可以找到很多开发者分享的教程、心得和开源项目。
• Bilibili (B站)： 搜索 "Andrion Studio 教程"，有很多UP主制作的从入门到精通的视频系列，适合视觉学习者。

学习建议

1. 动手实践： 不要只看教程，跟着敲代码，自己尝试修改和创造。
2. 从模仿开始： 先完整地跟着一个教程做出一个小游戏，然后再尝试加入自己的创意。
3. 阅读示例： 官方示例是最好的老师，尝试去理解示例中每一部分代码的作用。
4. 利用好社区： 遇到问题时，先自己尝试搜索，解决不了再去社区提问，提问时要说清楚你的问题、你尝试过的步骤和相关的错误信息。

希望这份详细的教程能帮助你顺利开启 Andrion Studio 的游戏开发之旅！祝你玩得开心！