LumenContext API 总览
lumen 对象（惯例命名，也可叫 spark 兼容 sb3 写法）提供以下成员：
| 成员 | 类型 | 说明 |
|---|---|---|
lumen.logger | PrefixedLogger | 带子插件名前缀的日志器（info/warning/error/debug） |
lumen.VERSION | str | LumenBridge 版本号 |
lumen.onBDS | bool | 恒为 True（运行在 Endstone/BDS 上） |
lumen.debug | bool | 是否开启调试模式（读取主配置 debug 字段） |
lumen.on(event, handler) | method | 注册事件监听器 |
lumen.once(event, handler) | method | 注册一次性事件监听器 |
lumen.off(event, handler) | method | 移除事件监听器 |
lumen.emit(event, *args) | method | 触发事件 |
lumen.QClient | OneBotAdapter | OneBot 适配器（发消息、调 API） |
lumen.msgbuilder | module | OneBot 消息段构建器 |
lumen.packbuilder | module | OneBot action 包构建器 |
lumen.mc | MCBridge | Minecraft 游戏接口桥 |
lumen.storage | Storage | 子插件私有 JSON 存储 |
lumen.env | EnvPool | 全局共享变量池 |
lumen.web | WebBridge | Web 扩展接口（配置表单/API/页面） |
lumen.call_action(...) | method | 通用 OneBot action 调用入口 |
lumen.register_regex_action(...) | method | 向正则引擎注册自定义动作 |
lumen.run_on_main(func) | method | 把函数调度到游戏主线程执行 |
lumen.endstone | property | endstone 顶级模块透传 |
lumen.plugin | property | LumenBridge 插件实例（endstone.plugin.Plugin） |
lumen.server | property | Endstone Server 对象 |
lumen.scheduler | property | Endstone 任务调度器 |
lumen.import_module(name) | method | 按需导入任意 endstone 子模块 |
lumen.get_player(name) | method | 获取在线玩家对象 |