Skip to content

关于 KBEngine Nex

KBEngine Nex 是以 KBEngine 1.x 为基线,由社区持续维护和现代化演进的版本。服务端底层框架使用 C++ 编写,游戏逻辑层使用 Python(支持热更新),开发者无需重复实现游戏服务端通用的底层技术,可以将精力集中在游戏业务开发上。

从 Nex 3.x 开始,项目正式将 baseline 从 KBEngine 2.x 切换回 KBEngine 1.x。引擎协议、EntityDef、客户端 SDK 和资源结构均以 1.x 协议体系为基础继续扩展,从基线上避免 2.x 分支协议差异带来的兼容问题。

找到组织

Nex 相比 KBEngine 的核心升级

区别KBEngineKBEngine Nex
IDE 插件不支持✅ KBEX(PyCharm)
macOS 支持不支持✅ 完整支持(编译 + 运行)
UE5 SDK不支持✅ 支持
TS SDK(Cocos、Laya)不支持✅ 支持
C# SDK(Godot、Unity)不支持✅ 支持
C++ SDK(UE5、Cocos2dx)仅支持UE4✅ 支持
Unity WebSocket不支持✅ 支持
WebConsole旧版本✅ 已重构
Python 版本3.73.12
Python VENV复杂配置✅ 支持
MySQL5.x5.x ~ 9.x
新增数据库MongoDB / PostgreSQL
ARM 架构不支持✅ 支持(含 Apple Silicon)
网络模型select(Win)/ epoll(Linux)IOCP(Win)/ io_uring(Linux)/ kqueue(macOS)
第三方依赖过时✅ 全面升级
一键安装不支持✅ 提供脚本
Linux 编译工具makefilecmake + ninja
Docker 基础镜像✅ 提供 dockerfile
平台覆盖测试✅ 每版本全平台编译验证

开发体验

原版 KBEngine 只能在命令行和零散工具之间切换,Nex 提供了 KBEX —— PyCharm IDE 插件,在 IDE 内一站式完成项目创建、服务端启动调试、代码补全跳转、SDK 生成和热更。插件还内置了进程管理、性能分析、Watcher 和 SpaceViewer 等可视化运维面板,并支持远程 SSH 同步与 Docker 开发环境。

3.x 基线与协议兼容

Nex 3.x 以 KBEngine 1.x 作为唯一协议基线,不再沿用早期 Nex 基于 KBEngine 2.x 的协议分支。这样可以让服务端、客户端 SDK、EntityDef 定义和已有 1.x Assets 共享一致的协议语义,避免因混用 1.x/2.x 定义、消息编号或数据布局而产生协议不匹配。

在 1.x 基线上,Nex 继续提供独立演进的性能、安全、跨平台和工具链能力。

客户端生态

KBEngine 仅有 Unity 和 UE4 的旧版 SDK。Nex 新增了 C#(Godot/Unity)、TypeScript(Cocos/Laya)、原生 C++ 三种 SDK,Unity 端支持 WebSocket 直连,满足更广泛的客户端技术选型。

底层现代化

  • Python 3.7 → 3.12,统一使用现代 Python 运行时,支持 VENV 虚拟环境和 asyncio 协程
  • Python 全平台动态运行时,Debug/Release 统一链接 Release Python,支持加载原生扩展模块(Windows 为 .pyd,Linux/macOS 为动态扩展)
  • makefile → cmake + ninja,编译速度大幅提升
  • vcpkg 统一管理第三方依赖,彻底告别手动配置
  • C++ 标准升级至 17/20,清理所有编译警告
  • MySQL 5.x → 兼容至 9.x,新增 MongoDBPostgreSQL 支持

平台覆盖

KBEngine 仅支持 Linux x64 和 Windows 调试。Nex 新增了 macOS、ARM64、Apple Silicon 完整支持,经过 Ubuntu、Debian、CentOS、Deepin 等 8 个平台的每版本编译验证。

网络层重构

Windows 从 select 切换为 IOCP,Linux 接入 io_uring,macOS 使用 kqueue,三大平台全部采用 completion 模型,高并发下的网络性能显著提升。

导航系统

引入 recastnavigation + Detour 导航,支持多层建筑内贴合 navmesh 高度的寻路,并提供配套的 Web 端 navmesh 生成工具

容器化

提供 Dockerfile 和基础镜像,支持 k8s 多套配置文件按环境启动,方便容器化部署和 CI/CD 集成。

Demo 资源

平台链接
Unitydemo_kbengine_unity3d_default
UE5demo_kbengine_ue5_default
UE5 C++ SDKdemo_kbengine_ue5_cxx
C++demo_kbengine_cxx_console
CocosCreatordemo_kbengine_cocos_creator_default
Godotdemo_kbengine_godot_default