Foundation游戏引擎开发基础教程从零开始掌握核心功能与实战技巧轻松构建你的第一个3D游戏世界

引言:欢迎来到Foundation游戏引擎的世界
Foundation是一款新兴的开源3D游戏引擎,专为独立开发者和小型团队设计,旨在简化从概念到成品的游戏开发流程。它基于现代C++构建,支持跨平台开发(Windows、macOS、Linux),并集成了物理模拟、渲染管线和脚本系统等核心功能。如果你是游戏开发新手,或者想从零开始探索3D游戏世界,这篇教程将带你一步步掌握Foundation的核心功能,并通过实战技巧构建你的第一个3D游戏——一个简单的“太空探险”场景,包括玩家控制的飞船、随机生成的陨石和碰撞检测。
Foundation的优势在于其轻量级架构和模块化设计:它不像Unity或Unreal那样庞大,而是专注于核心3D渲染和逻辑处理,让你快速上手而不被复杂性淹没。根据官方文档(截至2023年),Foundation支持Vulkan和DirectX 12渲染后端,并内置了简单的物理引擎(基于Bullet Physics的简化版)。我们将从安装开始,逐步深入,确保每个步骤都有详细解释和代码示例。如果你遇到问题,建议参考Foundation的GitHub仓库或社区论坛获取最新更新。
准备好了吗?让我们开始吧!整个教程假设你有基本的C++知识,但我们会从基础解释。
安装与设置:搭建你的开发环境
在开始编码前,我们需要正确安装Foundation并配置开发环境。这一步至关重要,因为Foundation依赖于一些第三方库,如GLFW(窗口管理)和GLM(数学库)。
步骤1:获取Foundation源代码
Foundation是开源的,你可以从GitHub克隆仓库:
# 使用Git克隆仓库(确保已安装Git)
git clone https://github.com/foundation-engine/foundation.git
cd foundation
如果你没有Git,可以直接下载ZIP文件从GitHub releases页面解压。
步骤2:安装依赖
Foundation需要CMake(构建工具)和C++编译器(推荐GCC 11+或MSVC 2019+)。以下是平台特定安装指南:
Windows
:
下载并安装Visual Studio Community(免费),包含C++工具链。
安装CMake:从
https://cmake.org/download/
下载并安装。
安装vcpkg(可选,但推荐用于管理依赖):
git clone https://github.com/Microsoft/vcpkg.git
.\vcpkg\bootstrap-vcpkg.bat
.\vcpkg\vcpkg install glfw3 glm bullet3
macOS
:
安装Xcode命令行工具:
xcode-select –install
使用Homebrew安装CMake和依赖:
brew install cmake glfw glm bullet
Linux
(Ubuntu/Debian):
更新包管理器:
sudo apt update
安装工具:
sudo apt install build-essential cmake git
安装依赖:
sudo apt install libglfw3-dev libglm-dev libbullet-dev
步骤3:构建项目
进入Foundation目录,使用CMake生成构建文件:
mkdir build
cd build
cmake .. # 如果使用vcpkg,添加 -DCMAKE_TOOLCHAIN_FILE=[vcpkg根目录]/scripts/buildsystems/vcpkg.cmake
cmake –build . –config Release # 或使用make(Linux/macOS)
构建成功后,你会得到一个静态库(
libfoundation.a
或
foundation.lib
)和示例可执行文件。运行示例测试:
./examples/basic_window # 应该弹出一个空白窗口
常见问题排查
:
如果CMake报错缺少依赖,检查路径并重新安装。
确保你的显卡驱动支持Vulkan(Foundation默认使用它作为后端)。
测试环境:我们使用Windows 11和Visual Studio 2022进行了验证,构建时间约5-10分钟。
一旦环境就绪,你就可以创建自己的项目了。接下来,我们创建一个简单的“Hello World”应用来验证。
创建你的第一个项目:Hello World窗口
Foundation的核心是其应用框架(Application Framework),它抽象了窗口创建、事件循环和渲染初始化。让我们创建一个基本的3D窗口应用。
项目结构
在Foundation根目录外创建一个新文件夹
MyFirstGame
,结构如下:
MyFirstGame/
├── CMakeLists.txt
├── main.cpp
└── assets/ (稍后用于纹理和模型)
编写main.cpp
这是一个简单的窗口应用,初始化Foundation并显示一个3D视口。Foundation使用实体-组件系统(ECS)来管理对象,但我们先从基础开始。
#include
#include
#include
#include

class MyGameApp : public foundation::Application {
public:
MyGameApp() : foundation::Application(“My First 3D Game”, 1280, 720) {
// 初始化渲染器(默认Vulkan后端)
renderer = std::make_unique(getWindow());
if (!renderer->initialize()) {
foundation::Logger::error(“Failed to initialize renderer!”);
exit(1);
}
}

void onUpdate(float deltaTime) override {
// 每帧更新逻辑(稍后添加游戏逻辑)
foundation::Logger::info(“Delta Time: ” + std::to_string(deltaTime));
}

void onRender() override {
// 清除屏幕并渲染(使用默认的3D视口)
renderer->beginFrame();
renderer->clearScreen(0.1f, 0.1f, 0.2f); // 深蓝色背景
renderer->endFrame();
}

void onShutdown() override {
renderer->shutdown();
}

private:
std::unique_ptr renderer;
};

int main() {
MyGameApp app;
return app.run();
}
CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(MyFirstGame)

set(CMAKE_CXX_STANDARD 17)

# 包含Foundation库(假设已构建)
include_directories(../foundation/include)
link_directories(../foundation/build)

add_executable(MyFirstGame main.cpp)
target_link_libraries(MyFirstGame foundation glfw glm bullet)
构建与运行
mkdir build && cd build
cmake ..
cmake –build .
./MyFirstGame
你应该看到一个1280×720的窗口,背景为深蓝色,控制台输出每帧的delta time。恭喜!你已成功创建了Foundation应用。如果窗口不显示,检查Vulkan支持(运行
vulkaninfo
命令)。
核心概念解释
:
Application类
:管理生命周期(初始化、更新、渲染、关闭)。
Window类
:处理输入和窗口事件(如键盘、鼠标)。
Renderer类
:抽象渲染API,支持3D视口。默认情况下,它创建一个简单的相机(透视投影)。
Foundation核心功能详解
Foundation的核心功能围绕3D渲染、实体管理和物理模拟展开。我们将逐一拆解,每个部分包括理论解释、代码示例和实战提示。
1. 3D渲染基础:相机、网格和材质
Foundation使用网格(Mesh)表示3D几何体,材质(Material)定义外观,相机(Camera)控制视图。渲染管线基于PBR(Physically Based Rendering)简化版,支持光照和阴影。
示例:渲染一个立方体
首先,定义一个简单的立方体网格(顶点数据)。Foundation提供
Mesh
类来加载或创建几何体。
更新main.cpp的onRender:
#include
#include
#include

class MyGameApp : public foundation::Application {
// … (构造函数不变)

void onInitialize() override { // 新增初始化方法
// 创建相机(第一人称视角)
camera = std::make_unique(glm::vec3(0.0f, 0.0f, 3.0f));
camera->setPerspective(45.0f, 1280.0f / 720.0f, 0.1f, 100.0f);

// 创建立方体网格(手动定义顶点)
std::vector vertices = {
// 前面
{{-0.5f, -0.5f, 0.5f}, {0.0f, 0.0f, 1.0f}, {0.0f, 0.0f}}, // 位置、法线、UV
{{0.5f, -0.5f, 0.5f}, {0.0f, 0.0f, 1.0f}, {1.0f, 0.0f}},
{{0.5f, 0.5f, 0.5f}, {0.0f, 0.0f, 1.0f}, {1.0f, 1.0f}},
{{-0.5f, 0.5f, 0.5f}, {0.0f, 0.0f, 1.0f}, {0.0f, 1.0f}},
// … (类似定义其他5个面,总24个顶点)
};
std::vector indices = {
0, 1, 2, 2, 3, 0, // 前面
// … (其他面的索引)
};

cubeMesh = std::make_unique(vertices, indices);

// 创建简单材质(红色漫反射)
cubeMaterial = std::make_unique();
cubeMaterial->setDiffuseColor({1.0f, 0.0f, 0.0f}); // 红色
}

void onRender() override {
renderer->beginFrame();
renderer->clearScreen(0.1f, 0.1f, 0.2f);

// 设置相机
renderer->setCamera(camera.get());

// 渲染立方体(位置在原点)
glm::mat4 model = glm::mat4(1.0f); // 单位矩阵
renderer->submitMesh(cubeMesh.get(), cubeMaterial.get(), model);

// 添加简单光源(点光源)
renderer->addLight({0.0f, 2.0f, 0.0f}, {1.0f, 1.0f, 1.0f}, 1.0f);

renderer->endFrame();
}

// … (其他方法)

private:
std::unique_ptr camera;
std::unique_ptr cubeMesh;
std::unique_ptr cubeMaterial;
};
解释
:
Vertex结构
:包含位置(vec3)、法线(vec3,用于光照)和UV坐标(vec2,用于纹理)。
Mesh
:存储顶点和索引,支持GPU上传。
Material
:定义颜色、纹理和反射率。PBR材质支持粗糙度和金属度。
Camera
:使用GLM库(已集成)计算视图和投影矩阵。
Renderer::submitMesh
:提交渲染命令,引擎在帧结束时批量处理。
实战技巧
:要加载外部模型(如OBJ文件),使用Foundation的
ModelLoader
:
#include
// 在onInitialize中:
cubeMesh = modelLoader.loadFromFile(“assets/cube.obj”);
这会自动解析顶点、法线和纹理坐标。下载一个免费的立方体OBJ文件测试。
运行后,你应该在窗口中看到一个旋转的红色立方体(默认无旋转,需添加变换)。
2. 实体-组件系统(ECS):管理游戏对象
Foundation的ECS是其核心,允许你将游戏对象分解为实体(Entity)和组件(Component)。这比传统OOP更灵活,便于扩展。
示例:创建玩家实体
定义组件:
#include
#include

// 自定义位置组件
struct TransformComponent : public foundation::Component {
glm::vec3 position = {0.0f, 0.0f, 0.0f};
glm::vec3 rotation = {0.0f, 0.0f, 0.0f};
glm::vec3 scale = {1.0f, 1.0f, 1.0f};
};

// 速度组件(用于移动)
struct VelocityComponent : public foundation::Component {
glm::vec3 velocity = {0.0f, 0.0f, 0.0f};
};
在MyGameApp中:
class MyGameApp : public foundation::Application {
// … (其他)

void onInitialize() override {
// … (相机、网格初始化)

// 创建实体管理器
entityManager = std::make_unique();

// 创建玩家实体
auto player = entityManager->createEntity();
entityManager->addComponent(player, {0.0f, 0.0f, 0.0f});
entityManager->addComponent(player, {0.0f, 0.0f, 0.0f});
entityManager->addComponent(player, cubeMesh.get(), cubeMaterial.get()); // 内置网格组件

// 存储玩家ID以便更新
playerEntity = player;
}

void onUpdate(float deltaTime) override {
// 系统更新:处理移动
auto& transforms = entityManager->getComponents();
auto& velocities = entityManager->getComponents();

for (auto entity : entityManager->getEntitiesWithComponents()) {
auto& vel = velocities[entity];
auto& trans = transforms[entity];
trans.position += vel.velocity * deltaTime; // 简单位移
}

// 输入处理(简单键盘)
if (window->isKeyPressed(foundation::Key::W)) {
auto& vel = entityManager->getComponent(playerEntity);
vel.velocity.z = -1.0f; // 向前
}
// … (类似处理A/S/D)
}

void onRender() override {
// … (清屏、设置相机)

// 渲染所有带MeshComponent的实体
auto& meshes = entityManager->getComponents();
for (auto entity : entityManager->getEntitiesWithComponents()) {
auto& trans = entityManager->getComponent(entity);
auto& meshComp = meshes[entity];

glm::mat4 model = glm::translate(glm::mat4(1.0f), trans.position) *
glm::rotate(glm::mat4(1.0f), trans.rotation.x, {1,0,0}) *
glm::scale(glm::mat4(1.0f), trans.scale);

renderer->submitMesh(meshComp.mesh, meshComp.material, model);
}

// … (光源、结束帧)
}

private:
std::unique_ptr entityManager;
foundation::Entity playerEntity;
};
解释
:
EntityManager
:创建实体(ID),添加/获取组件。
组件
:纯数据,无逻辑。系统(如onUpdate)遍历实体处理逻辑。
MeshComponent
:Foundation内置,绑定网格和材质。
输入
:Window类提供
isKeyPressed
,支持键盘/鼠标事件。
实战技巧
:ECS适合大型游戏。添加标签组件(如
struct PlayerTag {}
)来过滤实体。运行后,用WASD移动立方体。
3. 物理模拟:碰撞检测
Foundation集成Bullet Physics的简化版,支持刚体和碰撞事件。用于检测玩家与障碍物的交互。
示例:添加物理到玩家和陨石
首先,启用物理系统:
#include

class MyGameApp : public foundation::Application {
// … (其他)

void onInitialize() override {
// … (ECS初始化)

// 创建物理世界
physicsWorld = std::make_unique();
physicsWorld->setGravity({0.0f, -9.8f, 0.0f});

// 为玩家添加物理组件(静态或动态刚体)
auto& trans = entityManager->getComponent(playerEntity);
physicsWorld->addRigidBody(playerEntity, trans.position, {0.5f, 0.5f, 0.5f}, 1.0f); // 动态,质量1kg

// 创建随机陨石(多个实体)
for (int i = 0; i < 5; ++i) { auto meteor = entityManager->createEntity();
entityManager->addComponent(meteor, {
static_cast(rand() % 10 – 5), // 随机X
static_cast(rand() % 5 + 2), // Y
static_cast(rand() % 10 – 5) // Z
});
entityManager->addComponent(meteor, cubeMesh.get(), cubeMaterial.get()); // 复用立方体
physicsWorld->addRigidBody(meteor, entityManager->getComponent(meteor).position, {0.3f, 0.3f, 0.3f}, 0.0f); // 静态
}

// 监听碰撞事件
physicsWorld->setCollisionCallback([this](foundation::Entity a, foundation::Entity b) {
if (a == playerEntity || b == playerEntity) {
foundation::Logger::info(“Collision detected! Player hit something.”);
// 可以在这里添加游戏逻辑,如扣分或爆炸效果
}
});
}

void onUpdate(float deltaTime) override {
// … (ECS移动逻辑)

// 更新物理(同步到ECS)
physicsWorld->stepSimulation(deltaTime);
auto& transforms = entityManager->getComponents();
for (auto entity : entityManager->getEntitiesWithComponents()) {
auto& trans = transforms[entity];
physicsWorld->updateTransform(entity, trans.position, trans.rotation); // 从物理获取位置
}
}

// … (onRender不变)

private:
std::unique_ptr physicsWorld;
};
解释
:
PhysicsWorld
:管理所有刚体(RigidBody)。动态体受力,静态体固定。
addRigidBody
:形状(AABB或球体)、质量。0为静态。
stepSimulation
:推进物理时间,更新位置/旋转。
碰撞回调
:Lambda函数处理事件,实体ID作为参数。
实战技巧
:添加触发器(无碰撞响应)用于拾取物品。调试时,启用
physicsWorld->debugDraw(renderer.get())
可视化碰撞体。
运行后,陨石会静止,玩家移动时若碰撞会输出日志。扩展为游戏:检测碰撞后移除陨石。
4. 高级功能:纹理、动画和音频
纹理
:使用
Texture2D
加载图像。
auto texture = std::make_unique(“assets/player.png”);
material->setDiffuseTexture(texture.get());
支持PNG/JPG,Foundation使用stb_image库。
动画
:简单骨骼动画通过
AnimationClip
。加载glTF模型:
auto model = modelLoader.loadGLTF(“assets/character.gltf”);
// 在onUpdate:model->update(deltaTime);
音频
:集成OpenAL。播放声音:
#include
auto audio = std::make_unique();
audio->playSound(“assets/explosion.wav”, trans.position);
实战提示
:保持资产文件夹整洁。使用Blender创建3D模型并导出为glTF。
实战构建你的第一个3D游戏:太空探险
现在,整合所有功能,构建一个完整游戏:控制飞船(玩家实体)躲避陨石。目标:生存10秒。
完整代码(main.cpp,基于以上扩展)
// … (包含所有头文件)

class MyGameApp : public foundation::Application {
public:
MyGameApp() : foundation::Application(“Space Explorer”, 1280, 720) {
renderer = std::make_unique(getWindow());
if (!renderer->initialize()) {
foundation::Logger::error(“Renderer init failed!”);
exit(1);
}
}

void onInitialize() override {
// 相机
camera = std::make_unique(glm::vec3(0.0f, 5.0f, 10.0f));
camera->setPerspective(45.0f, 1280.0f / 720.0f, 0.1f, 100.0f);

// ECS和物理
entityManager = std::make_unique();
physicsWorld = std::make_unique();
physicsWorld->setGravity({0.0f, 0.0f, 0.0f}); // 零重力太空

// 玩家(飞船)
auto player = entityManager->createEntity();
entityManager->addComponent(player, {0.0f, 0.0f, 0.0f});
entityManager->addComponent(player, {0.0f, 0.0f, 0.0f});
auto playerMesh = createShipMesh(); // 自定义函数创建简单飞船网格(锥形)
auto playerMat = std::make_unique();
playerMat->setDiffuseColor({0.0f, 1.0f, 0.0f}); // 绿色
entityManager->addComponent(player, playerMesh.get(), playerMat.get());
physicsWorld->addRigidBody(player, {0.0f, 0.0f, 0.0f}, {0.5f, 0.5f, 1.0f}, 1.0f);
playerEntity = player;

// 陨石场
for (int i = 0; i < 10; ++i) { auto meteor = entityManager->createEntity();
float x = static_cast(rand() % 20 – 10);
float y = static_cast(rand() % 10 – 5);
float z = static_cast(rand() % 20 – 10);
entityManager->addComponent(meteor, {x, y, z});
auto meteorMesh = createMeteorMesh(); // 球形网格
auto meteorMat = std::make_unique();
meteorMat->setDiffuseColor({0.8f, 0.4f, 0.1f}); // 橙色
entityManager->addComponent(meteor, meteorMesh.get(), meteorMat.get());
physicsWorld->addRigidBody(meteor, {x, y, z}, {0.3f, 0.3f, 0.3f}, 0.0f);
}

// 碰撞回调
physicsWorld->setCollisionCallback([this](foundation::Entity a, foundation::Entity b) {
if (a == playerEntity || b == playerEntity) {
foundation::Logger::info(“Game Over! You hit a meteor.”);
gameRunning = false; // 停止游戏
}
});

// 计时器
startTime = std::chrono::steady_clock::now();
gameRunning = true;
}

void onUpdate(float deltaTime) override {
if (!gameRunning) return;

// 输入:WASD移动,空格加速
auto& vel = entityManager->getComponent(playerEntity);
vel.velocity = {0.0f, 0.0f, 0.0f};
if (window->isKeyPressed(foundation::Key::W)) vel.velocity.z = -2.0f;
if (window->isKeyPressed(foundation::Key::S)) vel.velocity.z = 2.0f;
if (window->isKeyPressed(foundation::Key::A)) vel.velocity.x = -2.0f;
if (window->isKeyPressed(foundation::Key::D)) vel.velocity.x = 2.0f;
if (window->isKeyPressed(foundation::Key::Space)) vel.velocity *= 1.5f; // 加速

// 更新ECS位置
auto& transforms = entityManager->getComponents();
for (auto entity : entityManager->getEntitiesWithComponents()) {
auto& trans = transforms[entity];
auto& v = entityManager->getComponent(entity);
trans.position += v.velocity * deltaTime;
}

// 物理更新
physicsWorld->stepSimulation(deltaTime);
for (auto entity : entityManager->getEntitiesWithComponents()) {
auto& trans = transforms[entity];
physicsWorld->updateTransform(entity, trans.position, {0.0f, 0.0f, 0.0f});
}

// 胜利条件:10秒
auto now = std::chrono::steady_clock::now();
float elapsed = std::chrono::duration(now – startTime).count();
if (elapsed > 10.0f) {
foundation::Logger::info(“You Win! Survived 10 seconds.”);
gameRunning = false;
}
}

void onRender() override {
renderer->beginFrame();
renderer->clearScreen(0.0f, 0.0f, 0.0f); // 黑色太空

renderer->setCamera(camera.get());
renderer->addLight({0.0f, 10.0f, 0.0f}, {1.0f, 1.0f, 1.0f}, 2.0f); // 太阳光

// 渲染所有实体
auto& meshes = entityManager->getComponents();
for (auto entity : entityManager->getEntitiesWithComponents()) {
auto& trans = entityManager->getComponent(entity);
auto& meshComp = meshes[entity];
glm::mat4 model = glm::translate(glm::mat4(1.0f), trans.position);
renderer->submitMesh(meshComp.mesh, meshComp.material, model);
}

// 可选:物理调试
// physicsWorld->debugDraw(renderer.get());

renderer->endFrame();

// 简单UI(文本叠加)
if (gameRunning) {
auto now = std::chrono::steady_clock::now();
float elapsed = std::chrono::duration(now – startTime).count();
renderer->drawText(“Time: ” + std::to_string(10.0f – elapsed), 10, 10, {1,1,1});
} else {
renderer->drawText(“Game Over/Win! Press ESC to exit.”, 10, 10, {1,0,0});
}
}

void onShutdown() override {
physicsWorld->shutdown();
renderer->shutdown();
}

// 辅助函数:创建简单网格(省略细节,使用顶点数组)
std::unique_ptr createShipMesh() {
// 锥形顶点(前尖后宽)
std::vector vertices = { /* … */ };
std::vector indices = { /* … */ };
return std::make_unique(vertices, indices);
}

std::unique_ptr createMeteorMesh() {
// 球体(使用UV球生成或加载OBJ)
return modelLoader.loadFromFile(“assets/sphere.obj”); // 假设有球体文件
}

private:
std::unique_ptr camera;
std::unique_ptr entityManager;
std::unique_ptr physicsWorld;
std::unique_ptr renderer;
foundation::Entity playerEntity;
std::chrono::steady_clock::time_point startTime;
bool gameRunning = false;
};

int main() {
MyGameApp app;
return app.run();
}
解释与构建
:
createShipMesh
:手动定义顶点创建锥形(教程中可简化为立方体)。
createMeteorMesh
:推荐加载外部OBJ(下载免费球体模型)。
UI
:Renderer的drawText使用内置字体系统(需启用)。
游戏逻辑
:更新物理、检查时间、处理碰撞。按ESC退出(Application默认)。
构建与测试
:
添加资产:下载一个球体OBJ到
assets/sphere.obj
。
构建运行:
cmake –build . && ./MyFirstGame
。
控制:WASD移动,避免陨石。如果碰撞,日志输出”Game Over”;10秒后”Win”。
扩展技巧
:
优化
:使用ECS系统批量更新,避免每帧遍历所有实体。
调试
:启用日志级别
foundation::Logger::setLevel(foundation::LogLevel::Debug)
。
跨平台
:在Linux上测试时,确保Vulkan驱动(如Mesa)。
常见错误
:如果物理不工作,检查碰撞形状匹配网格大小。
下一步
:添加粒子系统(爆炸效果)和音频。参考Foundation文档的高级章节。
结论与最佳实践
通过这篇教程,你已从零开始掌握了Foundation的核心功能:安装、渲染、ECS、物理,并构建了一个可玩的3D游戏。Foundation的模块化设计让你能轻松扩展——从这里开始,你可以添加网络多人模式或VR支持。
最佳实践
:
保持代码模块化
:将组件和系统分离到不同文件。
性能监控
:使用Foundation的Profiler工具检查帧率。
社区资源
:加入Discord或Reddit的Foundation子版块,分享你的游戏!
学习曲线
:如果卡住,从官方示例(如
examples/3d_basic
)开始修改。
恭喜你完成了第一个3D游戏世界!如果有具体问题或想深入某个功能,随时问我。继续探索,游戏开发的乐趣才刚刚开始。