KBEngine X
KBEngine X 是 KBEngine Nex 的专用 VS Code 插件,提供自动补全、XML 文件自动追踪、模板生成等功能,为 KBE 开发者提供接近 Python 原生的开发体验。
功能
服务端管理
- 启动 / 关闭服务端 — 一键启动或停止 KBEngine 服务端
- 热更 — 支持手动热更与自动热更(监听文件变更自动触发)
- 启动机器人 — 管理 Bots 进程
代码智能
- .def XML 补全 & 跳转 — 自动追踪 entity_defs 目录下的
.def 文件,提供属性、方法等智能补全
- 动态 Python 路径 — 点 base/cell 文件自动切换 extraPaths,确保 IntelliSense 只看到当前子工程的上下文
- 子工程切换 — 快速切换 base / cell / login / bots / db / interface 子工程
代码生成
- 生成客户端实体 — 根据服务端 entity_defs 自动生成客户端实体脚本
- 生成 SDK — 一键生成客户端 SDK
运维工具
- 进程状态面板 — 查看所有 Machine 及其上运行的组件进程
- 性能分析 — 连接 Telnet 控制台执行 TICK / CPROFILE / PYPROFILE / EVENT / NETWORK 查询
- Watcher 查询 — 实时查询引擎内部 Watcher 路径
- Space Viewer — 查询 cellappmgr 获取所有 space,并可深入查看 cell 内 entity 列表
日志与诊断
- 实时日志 — 捕获服务端各组件的日志输出,支持级别过滤
- 原始日志错误检测 — 启动后自动扫描日志文件中的 ERROR
插件系统
- 插件市场 — 从 GitHub / Gitee 浏览、安装、管理 KBEngine 插件
- 一键安装 / 卸载 / 启用 / 禁用
工作区
- 初始化工作区 — 自动检测 KBE 项目结构并提示初始化
- 项目路径映射 — 自动映射项目路径以支持跳转
安装
在 VS Code 扩展市场搜索 KBEngine X 安装
配置
| 配置项 |
类型 |
默认值 |
说明 |
kbengine-nex-x.kbeEnginePath |
string |
"" |
KBEngine 服务端引擎路径 |
kbengine-nex-x.clientProjectPath |
string |
"" |
客户端项目路径 |
kbengine-nex-x.sdkPath |
string |
"" |
SDK 生成路径 |
kbengine-nex-x.clientEntityPath |
string |
"" |
客户端实体脚本路径 |
kbengine-nex-x.autoHotReload |
boolean |
false |
启用自动热更 |
kbengine-nex-x.hotReloadInterval |
number |
10 |
热更延迟(秒) |
kbengine-nex-x.hotReloadWatchDirs |
array |
["base","cell","common","server_common","user_type"] |
热更监听子目录 |
kbengine-nex-x.serverType |
string |
"Local" |
连接类型 |
kbengine-nex-x.clientType |
string |
"CSharp" |
客户端引擎类型(CSharp / TypeScript / CXX) |
kbengine-nex-x.stopServerType |
string |
"SAFE_KILL" |
停止服务端方式(SAFE_KILL / PKILL9) |
kbengine-nex-x.telnetPwd |
string |
"pwd123456" |
Telnet 调试密码 |
kbengine-nex-x.logCacheSize |
number |
100 |
日志缓存大小(MB) |
许可
专有软件,保留所有权利。
| |