返回业务教程
ed

EmptyDea 教程

EmptyDea 是插件机器人框架。它启动后连接租赁服,再从运行目录读取插件配置、插件代码、数据、日志和缓存。日常维护主要围绕登录 Cookie、插件目录、配置开关和后台热重载完成。

阅读顺序 先处理登录和目录,再修改插件配置
运行目录:默认是 EmptyDea_storage,也可以启动时手动指定。插件配置、插件代码、数据和日志都在这里。 常用重载:后台终端输入 reload 热重载 Frame 和插件;输入 rebootstop 会断开 MC 连接并重连。
插件看 JSON

插件是否启用由配置 JSON 里的“是否禁用”决定。改完配置或脚本后,在后台输入 reload 让配置重新生效。

01

启动并确认运行目录

启动 EmptyDea 后,先确认根存储目录。直接回车会使用默认的 EmptyDea_storage

需要把配置放到其他位置时,在这一步填写新的目录路径。后续教程里的路径都以这个运行目录为准。

启动目录
请输入 EmptyDea 根存储目录
默认EmptyDea_storage直接回车使用
自定义填写目录路径配置和插件都会放到该目录
10 秒无输入自动使用默认目录
02

处理登录 Cookie

首次使用推荐选择 注册 4399 账号并登录获取 Cookie。如果已经保存过可用 Cookie,再选择 继续启动

菜单也支持手动替换、测试当前 Cookie、游客 Cookie、邮箱 Cookie、Cookie 实名认证和 4399 账号登录。真实 Cookie 不要发给别人。

登录 Cookie
请选择登录 Cookie 操作
INFO 当前未保存 EmptyDea 登录 Cookie
1继续启动
2手动替换登录 Cookie
3测试当前登录 Cookie
4获取游客 / 邮箱 Cookie
5登录 4399 账号获取 Cookie
6注册 4399 账号并登录获取 Cookie
首次使用推荐输入6
03

按提示完成 4399 注册登录

选择注册入口后,按终端提示填写 4399 用户名密码实名姓名身份证号。注册成功后选择保存为当前登录 Cookie。

如果账号已经存在,就回到登录 Cookie 菜单,选择“登录 4399 账号获取 Cookie”。验证码或验证链接按终端提示完成后再继续重试。

4399 注册
注册 4399 账号并生成 Cookie
请输入要注册的 4399 用户名: user_4399
请输入要注册的 4399 密码: ********
请输入实名认证姓名: 已按客户资料填写
请输入实名认证身份证号: 已按客户资料填写
SUCC 4399 注册成功,Cookie 已生成
是否保存为当前登录 Cookiey
04

填写服务器信息

按提示填写 服务器号。如果服务器没有密码,服务器密码直接留空。

登录方式当前以本地 Cookie 为主。启动参数里的 auth-server、apikey、用户名密码一般不用给客户作为常规入口。

连接配置
补全租赁服连接信息
服务器号必填目标租赁服编号
服务器密码可留空无密码直接回车
Cookie使用本地保存可回车沿用已保存 Cookie
05

认识 EmptyDea_storage

运行目录里最常用的是 configlangdatalogcache

frame_config.json 是框架连接配置;local_cookie 保存登录 Cookie。不要把 Cookie、token、服务器密码或日志敏感内容公开。

目录结构
EmptyDea_storage
config插件配置 JSON控制插件启停和参数
lang插件代码目录Lua / JS / Dynamic 代码
data插件数据插件持久化内容
log / cache日志和缓存排错时查看日志
06

找到插件配置目录

插件配置放在 EmptyDea_storage/config。框架会递归扫描里面的 JSON 文件。

每个插件配置通常会放在自己的文件夹里。框架配置文件不是插件配置,不要当成普通插件去改。

配置目录
插件配置从这里读取
路径config/插件名/*.json可分文件夹管理
扫描递归读取 JSON名称和来源为空会跳过
跳过emptydea框架配置.json这是框架配置
07

认识插件代码目录

Lua 插件代码放在 EmptyDea_storage/lang/LuaLoader。JavaScript 插件一般放在 lang/JavaScriptLoader,Dynamic 插件代码放在 lang/DynamicLoader/code

配置 JSON 里的“来源”要和加载器对应,插件名称也要和代码文件或插件目录对应。

代码目录
lang 下按加载器分目录
LuaLoaderlang/LuaLoaderLua 插件脚本
JavaScriptLoaderlang/JavaScriptLoaderJS 插件目录
Dynamiclang/DynamicLoader/code动态插件工程
08

查看插件 JSON 字段

常用字段是 名称描述是否禁用来源配置

“是否禁用”是最容易写反的字段:true 表示禁用,false 表示启用。“配置”里的内容会作为用户配置传给插件读取,不要随意改字段名。

配置 JSON
一个 Lua 插件配置示例
{ "名称": "example.lua" }
{ "描述": "示例插件" }
{ "来源": "LuaLoader" }
{ "是否禁用": false } // false = 启用
{ "配置": { "greeting": "你好" } }
09

开启或关闭插件

打开对应插件 JSON,把 是否禁用 改成 false 就是开启;改成 true 就是关闭。

这里的字段名叫“是否禁用”,所以逻辑和“是否启用”相反。改完后需要重新加载配置,最常用方式是在后台终端输入 reload。

插件启停
字段:是否禁用
启用插件false禁用 = 否,插件会被加载
禁用插件true禁用 = 是,启动扫描时跳过
WARN 如果写成 "true",插件不会启动。
修改后执行reload
10

打开后台终端菜单

在后台终端输入 ?helpmenu 或中文问号 可以显示后台菜单。

插件也能注册自己的后台入口,所以不同实例看到的菜单项可能会更多。

后台菜单
==== EmptyDea MENU ====
reload重新启动 Frame,但不断开当前 MC 连接
reboot重新启动 Frame,并断开 MC 后重连
stop同 reboot,走断开和重连流程
11

热重载插件

改完插件配置或代码后,在后台终端输入 reload。它会重新启动 Frame 和所有插件,但不会主动断开 MC 连接。

适合改配置、启停插件、替换 Lua 脚本后快速生效。如果改了连接信息、Cookie 或需要机器人重新进服,再用 reboot 或 stop。

重载区别
reload / reboot / stop
> reload
SUCC EmptyDea Frame 和插件已重新启动
reload不断开 MC插件和 Frame 重新启动
reboot断开并重连机器人重新连接服务器
stop同重连流程后台菜单里也可使用
12

检查插件是否生效

插件不生效时,先看 JSON 是否禁用,再看来源和代码目录是否对应,最后看终端输出和 log 目录。

常见问题是把“是否禁用”写反、Lua 文件名和配置名称不一致、配置改完没有 reload。

排查顺序
插件不生效先看这里
1是否禁用true 会跳过加载
2来源和目录LuaLoader 对应 lang/LuaLoader
3日志和报错查看终端输出或 log
13

保护敏感信息

排查问题时不要公开 local_cookieframe_config.json 里的连接信息、服务器密码、token 或完整日志。

需要让别人协助排查时,先给 Cookie、token、服务器号、服务器密码、玩家 UID 等内容打码。

安全提醒
不要公开这些内容
Cookielocal_cookie登录凭据
连接frame_config.json服务器号和连接配置
日志log 目录发出前先检查敏感内容
EmptyDea 插件操作顺序 启动 EmptyDea → 选择运行目录 → 注册 4399 账号并登录获取 Cookie → 保存 Cookie → 填写服务器号 → 找到 EmptyDea_storage/config 和 lang → 修改插件 JSON 或代码 → false 启用 / true 禁用 → 后台输入 reload 热重载。
继续查看 EmptyDea 配置完成后,可以继续看基础和其他业务教程