首次使用优先选择“注册 4399 账号并登录获取 Cookie”。已经保存过 Cookie 时,再选择继续启动或测试当前 Cookie。
EmptyDea 教程
EmptyDea 是插件机器人框架。它启动后连接租赁服,再从运行目录读取插件配置、插件代码、数据、日志和缓存。日常维护主要围绕登录 Cookie、插件目录、配置开关和后台热重载完成。
插件是否启用由配置 JSON 里的“是否禁用”决定。改完配置或脚本后,在后台输入 reload 让配置重新生效。
启动并确认运行目录
启动 EmptyDea 后,先确认根存储目录。直接回车会使用默认的 EmptyDea_storage。
需要把配置放到其他位置时,在这一步填写新的目录路径。后续教程里的路径都以这个运行目录为准。
处理登录 Cookie
首次使用推荐选择 注册 4399 账号并登录获取 Cookie。如果已经保存过可用 Cookie,再选择 继续启动。
菜单也支持手动替换、测试当前 Cookie、游客 Cookie、邮箱 Cookie、Cookie 实名认证和 4399 账号登录。真实 Cookie 不要发给别人。
按提示完成 4399 注册登录
选择注册入口后,按终端提示填写 4399 用户名、密码、实名姓名 和 身份证号。注册成功后选择保存为当前登录 Cookie。
如果账号已经存在,就回到登录 Cookie 菜单,选择“登录 4399 账号获取 Cookie”。验证码或验证链接按终端提示完成后再继续重试。
填写服务器信息
按提示填写 服务器号。如果服务器没有密码,服务器密码直接留空。
登录方式当前以本地 Cookie 为主。启动参数里的 auth-server、apikey、用户名密码一般不用给客户作为常规入口。
认识 EmptyDea_storage
运行目录里最常用的是 config、lang、data、log 和 cache。
frame_config.json 是框架连接配置;local_cookie 保存登录 Cookie。不要把 Cookie、token、服务器密码或日志敏感内容公开。
找到插件配置目录
插件配置放在 EmptyDea_storage/config。框架会递归扫描里面的 JSON 文件。
每个插件配置通常会放在自己的文件夹里。框架配置文件不是插件配置,不要当成普通插件去改。
认识插件代码目录
Lua 插件代码放在 EmptyDea_storage/lang/LuaLoader。JavaScript 插件一般放在 lang/JavaScriptLoader,Dynamic 插件代码放在 lang/DynamicLoader/code。
配置 JSON 里的“来源”要和加载器对应,插件名称也要和代码文件或插件目录对应。
查看插件 JSON 字段
常用字段是 名称、描述、是否禁用、来源 和 配置。
“是否禁用”是最容易写反的字段:true 表示禁用,false 表示启用。“配置”里的内容会作为用户配置传给插件读取,不要随意改字段名。
开启或关闭插件
打开对应插件 JSON,把 是否禁用 改成 false 就是开启;改成 true 就是关闭。
这里的字段名叫“是否禁用”,所以逻辑和“是否启用”相反。改完后需要重新加载配置,最常用方式是在后台终端输入 reload。
打开后台终端菜单
在后台终端输入 ?、help、menu 或中文问号 ? 可以显示后台菜单。
插件也能注册自己的后台入口,所以不同实例看到的菜单项可能会更多。
热重载插件
改完插件配置或代码后,在后台终端输入 reload。它会重新启动 Frame 和所有插件,但不会主动断开 MC 连接。
适合改配置、启停插件、替换 Lua 脚本后快速生效。如果改了连接信息、Cookie 或需要机器人重新进服,再用 reboot 或 stop。
检查插件是否生效
插件不生效时,先看 JSON 是否禁用,再看来源和代码目录是否对应,最后看终端输出和 log 目录。
常见问题是把“是否禁用”写反、Lua 文件名和配置名称不一致、配置改完没有 reload。
保护敏感信息
排查问题时不要公开 local_cookie、frame_config.json 里的连接信息、服务器密码、token 或完整日志。
需要让别人协助排查时,先给 Cookie、token、服务器号、服务器密码、玩家 UID 等内容打码。