KBEngine Nex

Appearance

安装和启动 ​

本栏目介绍从获取源码到服务端成功运行的完整流程。KBEngine Nex 3.x 使用 CMake 3.25+、Ninja Multi-Config 和 vcpkg 管理跨平台构建，并提供 Windows、Linux 和 macOS 安装脚本。

服务端内置 Python 3.12 动态运行时；启动引擎本身不依赖系统 Python，但创建 VENV、安装逻辑层依赖以及执行 Python 管理工具时，开发机或服务器仍需要 Python 3.12。

阅读顺序 ​

首次安装建议依次阅读：

  1. 环境与工具；
  2. 选择 Windows、Linux 或 macOS 安装流程；
  3. 编译与测试；
  4. 创建项目 Assets；
  5. 数据库与管理配置；
  6. 启动与停止。

多环境、多节点或正式部署场景，再继续阅读 启动参数与多环境配置 和 部署与更新。

需要在 Windows 上阅读、调试 C++ 源码时，可在完成环境准备后额外生成 Visual Studio 工程。

目录约定 ​

本文使用以下目录名称：

text
KBEngine-Nex/
├─ install/                  # 三平台安装脚本
├─ kbe/
│  ├─ src/                  # C++ 源码和 CMakePresets.json
│  ├─ bin/server/           # 构建完成后的服务端运行目录
│  └─ res/                  # 引擎公共资源和 Python 3.12 标准库
├─ server_assets/           # 示例或新建的项目 Assets
├─ new_assets.bat
└─ new_assets.sh

kbe/bin/server 不只是可执行文件目录，还包含 Python 动态库等运行依赖。部署或移动引擎时应整体保留运行目录和 kbe/res，不能只复制 baseapp、cellapp 等单个程序。

获取源码 ​

推荐从项目 Git 仓库克隆完整源码：

bash
git clone https://github.com/KBEngineLab/KBEngine-Nex.git
cd KBEngine-Nex

使用源码压缩包也可以，但后续 vcpkg 仍需要访问 Git 仓库和依赖下载地址。