创建项目 Assets

Assets 包含 EntityDef、Python 逻辑、资源配置和服务端启动脚本，应与引擎源码和运行产物分开管理。

Assets 是项目的 EntityDef、Python 逻辑、配置、地图和启动脚本集合。构建完成后，在仓库根目录运行：

Windows

.\new_assets.bat

Linux/macOS

sh new_assets.sh

默认输出到根目录的 server_assets。如果该目录已经存在，请先确认其中是否有项目代码；不要直接覆盖已有 Assets。

也可以直接调用 kbcmd 指定输出位置：

# Windows
.\kbe\bin\server\kbcmd.exe --newassets=python --outpath=D:\Projects\my_server_assets

# Linux/macOS
./kbe/bin/server/kbcmd --newassets=python --outpath=/srv/my_server_assets

项目结构和脚本目录说明见 创建项目。

运行环境变量

项目启动脚本会临时设置以下环境变量：

变量	含义
KBE_ROOT	引擎根目录，即包含 kbe 的目录
KBE_RES_PATH	资源搜索路径，包括引擎资源、项目根目录和项目 res
KBE_BIN_PATH	服务端程序目录，通常是 $KBE_ROOT/kbe/bin/server
KBE_VENV_PATH	可选 VENV 根目录或 site-packages 路径
uid / UID / XUID	用于区分服务组，具体变量名取决于脚本和平台

正常单机开发不必永久写入系统环境变量。Assets 不在引擎根目录附近，或同一机器运行多套服务时，应显式设置 KBE_ROOT，并检查脚本打印的所有路径。

Windows 的 KBE_RES_PATH 使用分号分隔；Linux/macOS 使用冒号。不要把另一平台的分隔符原样复制。

VENV

当前引擎使用 Python 3.12，并会自动识别 Assets 根目录中的 .venv 或 venv。推荐创建方式：

尚未安装 Python 3.12 时，从 Python 官方下载页获取对应平台版本。安装多个 Python 版本时，应先执行 python --version、python3.12 --version 或 py -3.12 --version，确认创建 VENV 的解释器确实是 3.12。

# Windows
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

# Linux/macOS
python3.12 -m venv .venv
./.venv/bin/python -m pip install -r requirements.txt

VENV 的主次版本必须与嵌入式 Python 3.12 一致，尤其是包含 .pyd、.so 或其他二进制扩展时。详见 VENV 虚拟环境。