这份教程假设你完全不会编程、没听过 Lua。
每一页只讲一件事,代码可以直接抄,抄完点「运行」就能在手机上看到效果。
看的时候按键盘 ← → 翻页;上面那排是章节,点一下直接跳过去。
教程分为 12 章,按顺序看最省劲
标「必看」的是新手一定要会的;标「以后再看」的等你能跑通再说。
1.1安装:先在 D 盘建个「千机图灵」文件夹
收到的是 千机图灵.zip。安装就三步,照着做:
① 建文件夹
打开「此电脑」→ 双击 D 盘 → 空白处右键 → 新建 → 文件夹 → 名字打 千机图灵。
最后就是 D:\千机图灵 这个目录。
② 把压缩包里的东西放进去
- 方式一(推荐):双击打开
千机图灵.zip→ 全选里面的文件(Ctrl+A)→ 直接拖进D:\千机图灵 - 方式二:右键 zip → 全部解压缩 → 把解压出来的内容剪切 → 粘贴到
D:\千机图灵
打开千机图灵.vbs、pc、Java、手机端 这些文件本身,而不是那个 .zip 压缩包。
打开千机图灵.vbs —— 关掉窗口就全没了,配置也存不住;② 放在
C:\Program Files —— 系统盘没写权限,程序存不了配置;③ 放在 桌面 / 下载文件夹 —— 容易被清理软件删,路径也经常变。
1.2启动,顺手生成桌面快捷方式
进到 D:\千机图灵 里,双击 打开千机图灵.vbs。第一次启动会慢几秒,别连点好几下。
它只是个快捷方式,指向的还是
D:\千机图灵 —— 所以这个文件夹别改名、别挪地方,不然图标会失效。
- 先看
Java文件夹还在不在 —— 被 360 / 火绒 / Defender 隔离掉就打不开,恢复它并加白名单。 - 确认路径是
D:\千机图灵这种干净的路径(别放桌面、别放很深的层级、别带奇怪符号)。 - 还不行就截图问客服,别自己删文件试。
认一下界面
资源
界面
插件
打开
连接
运行
打包
不要求一次记住,下面用到哪个再回来看。
1.3把手机端装到手机上
电脑上写脚本、手机上跑脚本。所以手机要先装好 手机端\千机图灵.apk。
手机怎么开 USB 调试
- 设置 → 关于手机 → 连续点「版本号」7 次 → 提示「已进入开发者模式」
- 回到 设置 → 系统/更多设置 → 开发者选项 → 打开 USB 调试
- 插上数据线后手机会弹「是否允许 USB 调试」→ 点允许(勾「一律允许」省事)
手机端\千机图灵.apk 复制到手机存储里,用手机文件管理器点开安装;或者直接在电脑上用 adb 装。1.4电脑连上手机(关键一步)
点工具栏的 「连接」,弹出这个框:
这条依赖 adb,模拟器一般自带;真机需要数据线 + 驱动。
127.0.0.1 / 37271,点「连接设备」。云手机 / 别人帮你开了反向调试时,把对方给的 IP 和端口填这里。
② 数据线是不是只能充电的「劣质线」;
③ 电脑上别的软件(另一个模拟器、其他助手)抢占了 adb → 把它们关掉再试。
1.530 秒验证:你的第一个脚本
先随便建一个项目(点「新建」→ 名字随便填 → 创建,下一章细讲),把中间编辑区的内容全选删掉,敲这一行:
main.lua复制print("你好,我是第一次写脚本")
然后点工具栏 「运行」。
小知识:打印 和 print 是同一个东西,中文英文随便用。日志面板只是给你自己看,打包发给客户后客户看不到。
2.1新建项目:只填 3 个东西
点工具栏 「新建」,弹出来的框里只有三项:
| 字段 | 怎么填 | 能不能改 |
|---|---|---|
| 存放位置 | 项目文件夹放哪,默认在 千机图灵\ 下面。不用动。 | 创建时定 |
| 应用包名 | 像网址倒着写的名字,英文小写 + 点,例如 com.abc.monster。两个项目不能重复。 | 打包时还能改 |
| 应用名称 | 客户手机上显示的名字,中文可以,例如 自动打怪。 | 打包时还能改 |
com.xiaobai.helper(那是引擎自己的包名),也不要带中文、空格、大写。写错了打包会失败。
2.2项目里都有什么
创建完,左边工程面板会出现 4 个分区,你只需要先管第 1 个:
.png、YOLO 模型 .onnx 都放这。脚本里写 找图("开始.png", ...) 就能用,不用写手机路径。加文件 / 删文件
- 在「脚本」分区上 右键 → 新建文件,输名字会自动补
.lua - 资源:右键 → 添加文件到此分区,选图片即可(会自动显示缩略图)
- 所有改动记得 Ctrl+S;点「运行」时会先自动保存,但别指望它兜底
2.3「运行」按钮到底做了什么
很多人以为「运行」是在电脑上跑脚本 —— 不是,是把脚本推到手机上跑。
| 你电脑上的 | 手机上变成 |
|---|---|
脚本\我的项目.lua | 手机上的主脚本(启动就跑它) |
脚本\副本.lua | 同目录下的 副本.lua,用 require("副本") 调 |
资源\开始.png | img/开始.png(脚本里直接写 "开始.png" 就行) |
界面\main.ui | ui/main.ui |
2.4右边那一栏(函数说明)是最好的老师
软件右边有一整列中文函数说明,每条都带「怎么用 + 例子」。新手 90% 的问题在这都能查到。
- 顶部有搜索框,输
找图、读数字、点击直接定位 - 每条都有「例子」那一栏,可以照抄
- 点函数名一般会把示例插入到代码区(省得手打)
3.1别怕,Lua 是最好上手的语言之一
你不需要装任何东西。左边代码区写,右边点「运行」,手机上就有反应 —— 这就是学 Lua 的全部环境。
看一眼复制print("打怪开始") if 血量 < 30 then print("血太少了,先加血") end
② 怎么存东西(变量)
③ 怎么判断(if)
④ 怎么重复(循环)
⑤ 怎么打包一段代码复用(函数)
Blood 和 blood 是两个不同的名字。中文名不受影响。
3.2第一件事:把结果显示出来
1.lua复制print("你好") print(123) print("血量是", 88)
日志面板会输出:
日志复制[脚本 main:1] 你好 [脚本 main:2] 123 [脚本 main:3] 血量是 88
- 文字要用引号包起来(单引号双引号都行);数字不用引号
- 多个东西用逗号隔开,会连在一起打印
打印=print,一样的东西
想在手机屏幕上看文字,用
提示("文字", 100, 300)。
print 是 Lua 原生命令,本教程所有代码统一用英文写法,最保险。引擎另外内置了一批中文别名(
点击、滑动、找图、找色、读数字、延时、提示……),
这些在软件右侧「函数说明」里能搜得到就代表能用,搜不到就别写。拿不准的时候:中文名一律去右侧函数说明里搜一遍,有就放心用,没有就用英文。
3.3变量:给它起个名字,把东西存起来
变量复制local 名字 = "小白" local 等级 = 80 local 正在打怪 = true print(名字, 等级) 等级 = 81 -- 后面想改,直接重新赋值 print(等级)
| 类型 | 长什么样 | 说明 |
|---|---|---|
| 字符串(文字) | "小白" / 'abc' | 必须带引号 |
| 数字 | 80 / 3.14 | 不带引号 |
| 布尔(真假) | true / false | 只有这两种,不能写 True |
| 空值 | nil | 「什么都没有」,找图失败返回的就是它 |
local 表示「这个变量只在本文件/本函数里用」,是好习惯,建议都写。不写也能跑(会变成全局变量),但脚本一大就容易互相打架。
3.4注释与算术
注释和算术复制-- 这一行不会执行,是写给人看的说明 -- 想临时关掉一行代码,前面加两个减号就行 local a = 10 local b = 3 print(a + b) -- 13 print(a - b) -- 7 print(a * b) -- 30 print(a / b) -- 3.3333333333333 print(a % b) -- 1(余数,判断「能不能整除」很有用) -- 文字拼接用两个点 print("血量:" .. a .. "/" .. b) -- 血量:10/3
取整数(3.9) → 3 | 四舍五入(3.6) → 4 | 随机数(1, 100) → 1~100 随机
123 .. "个" 能拼成文字 123个;但 "123" + 1 会报错。
读数字读出来是数字,读文字读出来是文字,别混。
3.5if:让脚本自己做决定(最重要的一节)
语法就一个模板:if 条件 then ... end。注意结尾必须有 end。
最简版复制local 血量 = 25 if 血量 < 30 then print("血太少了") end print("这一行一定会执行")
if 忘了写 end → 报 'end' expected。记住口诀:一个 if 配一个 end。缩进(前面的空格)不影响运行,但一定要缩,不然自己都看不懂。
加个否则:if / else
二选一复制local 血量 = 80 if 血量 < 30 then print("先加血") else print("继续打") end
3.6多个条件:elseif 和比较符
三段判断复制local 血量 = 50 if 血量 < 30 then print("危险,加血") elseif 血量 < 70 then print("有点低,注意") else print("状态很好") end
| 写法 | 意思 | 例子 |
|---|---|---|
== | 等于(两个等号!) | 名字 == "小白" |
~= | 不等于 | 状态 ~= "打怪" |
> < >= <= | 大于 / 小于 / 大于等于 / 小于等于 | 血量 <= 0 |
and | 并且(两个都成立) | 血量 < 30 and 有药 |
or | 或者(一个成立就行) | 血量 < 30 or 没蓝 |
not | 不成立 | not 正在打怪 |
== 写成 =(一个等号是赋值,两个才是比较)。if 名字 = "小白" then 会直接报错。
3.7循环:让脚本一直干活
脚本的骨架基本都是「一直重复:看一眼 → 做判断 → 点一下」。
主循环模板(背下来)复制while true do -- 这里写每次要干的事 print("我在循环里") 延时(1000) -- 停 1 秒(1000 毫秒),千万别不写! end
延时 会疯狂空转:手机发烫、卡死、甚至被系统杀掉。经验值:判断类 100~300ms,等界面 500ms,长时间不变 1000ms。
数着次数循环:for
跑 10 次就停复制for i = 1, 10 do print("第 " .. i .. " 次") 延时(500) end print("10 次跑完了")
延时() 会立刻被打断,所以即使卡在循环里也能停。
3.8函数:把一段代码取个名字
为什么要函数?因为同一段操作你要写几十遍 —— 包成函数,写一遍,到处调用。
定义 + 调用复制-- 定义(只是"写好",不会执行) function 打招呼() print("你好呀") 延时(300) end -- 调用(这样才会真的执行) 打招呼() 打招呼()
带参数:让它能变
参数复制function 打招呼(名字) print("你好," .. 名字) end 打招呼("小白") 打招呼("老王")
带返回值:把结果交回来
return复制function 加血够不够(当前血, 需要血) if 当前血 >= 需要血 then return true else return false end end if 加血够不够(80, 50) then print("够,可以打") end
3.9实战:把一个常用操作封装起来
假设你每次打怪都要「找一次开始按钮再点它」。不封装的话,写 5 遍就长这样:
main.lua复制local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) end 延时(500) local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) end 延时(500) -- 还要再来三遍……
main.lua复制function 点开始() -- 封装 local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) return true -- 点到了 end return false -- 没找到 end 点开始() -- 用 点开始() 点开始()
② 代码短了,一眼能看出流程;
③ 可以直接把
if 点开始() then 当条件用(因为它 return true/false)。
3.10表(一):一堆东西排排站
「表」就是一个抽屉里放好几样东西。新手先只记「数组式」:
数组式表复制local 怪物 = {"鸡", "鹿", "狼", "熊"} print(怪物[1]) -- 鸡 ← 注意:从 1 开始,不是 0! print(怪物[4]) -- 熊 print(#怪物) -- 4 ← # 是"一共几个" -- 加一个 怪物[5] = "龙" print(#怪物) -- 5
遍历(一个个过一遍)
for 遍历复制local 怪物 = {"鸡", "鹿", "狼"} for i = 1, #怪物 do print("第" .. i .. "只:" .. 怪物[i]) end
怪物[0] 拿到的是 nil,不会报错,但你会莫名其妙拿不到值。
3.11表(二):带名字的抽屉(键值式)
数组是「1号、2号、3号」,键值式是「给它取个名字」:
键值式表复制local 角色 = { 名字 = "小白", 等级 = 80, 血量 = 100, } print(角色.名字) -- 小白 print(角色.等级) -- 80 角色.等级 = 81 -- 改值 角色.蓝量 = 50 -- 新增一项 print(角色.蓝量) -- 50
遍历所有项
pairs复制local 角色 = {名字 = "小白", 等级 = 80} for 键, 值 in pairs(角色) do print(键, 值) -- 等级 80 / 名字 小白(顺序不固定) end
local 血 = 角色.血量 or 100 —— 如果 角色.血量 是 nil,就用 100。这招在「配置项可能没填」的时候特别好用。
3.12表(三):表里套表(实战最常用)
坐标、检测结果这类「一组一组的数」都要靠套表:
套表复制-- 三个按钮的坐标,每个都是一张小表 local 按钮 = { {名字 = "开始", x = 540, y = 1200}, {名字 = "确定", x = 720, y = 900}, {名字 = "关闭", x = 1000, y = 120}, } for i = 1, #按钮 do local 项 = 按钮[i] print(项.名字, 项.x, 项.y) 点击(项.x, 项.y) 延时(300) end
真实场景:遍历找图结果
YOLO 检测结果就是表复制local 结果 = 模型检测(0, 0, 9999, 9999, 0.35) if 结果 ~= nil then for i = 1, #结果 do local 物 = 结果[i] print(物.cls, 物.prob, 物.cx, 物.cy) -- 类别 / 置信度 / 中心点 end end
print(结果) 只会显示一个地址(table: 0x7f...)。要看内容就 for k, v in pairs(结果) do print(k, v) end。
3.13「能跑」和「好维护」的差距
同一个功能,两种写法都能跑,但第二个改起来不痛苦:
main.lua复制while true do local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) 延时(1000) local x2, y2 = 找图("确定.png", 0, 0, 9999, 9999, 0.8) if x2 ~= nil then 点击(x2, y2) 延时(1000) end end 延时(500) end
main.lua复制function 找并点(图片) -- 通用工具 local x, y = 找图(图片, 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) 延时(800) return true end return false end while true do if 找并点("开始.png") then 找并点("确定.png") end 延时(500) end
找并点 一行搞定所有按钮);② 一堆固定数据 → 写成表(按钮坐标、地图名);
③ 先返回再判断 → 少写 if 嵌套(
if 找并点("x") then ...)。
3.14新手最常见的 6 个报错
| 日志里写的 | 原因 | 怎么改 |
|---|---|---|
'end' expected | if / while / for / function 少了 end | 数一下:几个 if 就要几个 end |
attempt to call a nil value | 函数名写错,或用了没定义的函数 | 对照右侧函数说明核对名字;自己写的函数要定义在调用前面 |
attempt to index a nil value | 拿 nil 当表用,例如找图失败后直接 x.foo | 先 if x ~= nil then 再取 |
attempt to perform arithmetic on a nil value | 拿 nil 做加减(读数字没读到) | 用 读数字(..., 0) 给默认值 |
unexpected symbol near '=' | 比较写成 = | 改成 == |
| 点了运行没反应、也没日志 | 没连手机 / 脚本第一行就死循环 | 先看连接状态;循环里补 延时() |
[脚本 main:12] 里的 12 就是行号 —— 直接跳到第 12 行看,八成就在那一行或上一行。报错不怕,怕的是不看日志硬猜。
4.1脚本怎么「看见」屏幕:三种方式
| 方式 | 适合什么 | 优点 | 缺点 |
|---|---|---|---|
| 找图 | 按钮、图标、固定界面 | 最好写,截图就能用 | 换分辨率/换皮肤会失效 |
| 找色 | 血条、状态灯、进度条 | 快、省资源 | 要自己选颜色,颜色会变 |
| 认字 | 金币、战力、提示语 | 数值类必用 | 字体太花会认错 |
顺序永远是:看 → 判断 → 动手
4.2点击、长按、滑动
基本操作复制点击(540, 1200) -- 点屏幕中间偏下 点击(540, 1200, 300) -- 点完等 300 毫秒 滑动(540, 1500, 540, 700, 400) -- 从下往上滑(翻页/拖地图) 长按(540, 1200, 1500) -- 按住 1.5 秒 按键("back") -- 返回键 按键("home") -- 回桌面
② 软件工具栏的 图色工具 里能看坐标、取色、截图;
③ 先截图到电脑上,用画图软件量像素(准,但麻烦)。
先点再等,最常用的两行复制点击(x, y) 延时(500)
4.3找图:脚本的眼睛
找图复制-- 找图(图片名, 左, 上, 右, 下, 偏差) local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then print("找到了,坐标", x, y) 点击(x, y) else print("没找到") end
0, 0, 9999, 9999= 全屏找。只在某个区域找就填真实坐标,速度快很多- 偏差 0.8 是常用值:0.9 更严(不容易认错,但可能找不到),0.7 更松
- 找不到返回
nil,先判 nil 再点击,不然会报错 - 图片名只写文件名,不用写路径 —— 图片放进「资源」分区就自动对应
② 四周留 2~3 像素,别把边框切掉;
③ 越小越准。截图后存成
.png 放进「资源」。
找图("a.png|b.png", ...) 任意一张命中都算;找图EX(...) 能告诉你命中的是第几张。
4.4找色:比找图快,适合状态判断
找色 / 颜色数量复制-- 找色(左, 上, 右, 下, 颜色, 相似度) local x, y = 找色(0, 0, 9999, 9999, "#ff0000", 0.9) if x ~= nil then print("屏幕上有红色") end -- 颜色数量:某区域里有多少个这个颜色(判断进度条、血条) local n = 颜色数量(100, 1400, 400, 1440, "#ff3b3b-101010", 0.9) if n > 0 then print("血条还有颜色,数量", n) end
| 函数 | 什么时候用 |
|---|---|
| 找色 | 「这个位置有没有这个颜色」,比如技能冷却好了没 |
| 颜色数量 | 「这个颜色占多少」,比如血条长度、进度条 |
| 多点找色 findMultiColor | 几个点同时满足才算命中,最严格,防误判 |
"#ff0000" 是纯红。带 -101010 表示允许每个通道 ±16 的误差,写宽松点更稳。颜色用「图色工具」直接吸,别手打。
4.5认字:读数字、读文字、点文字
常用四招复制-- 1) 只读数字(战力、金币、次数) local 金币 = 读数字(700, 100, 1000, 150, 0) print("金币", 金币) -- 2) 读文字(名字、提示语) local 名字 = 读文字(100, 500, 600, 560, "") if 名字 == "挑战成功" then print("过关了") end -- 3) 直接点文字(最省事,免字库) 点文字("确定") -- 4) 等文字出现(最多等 10 秒) local x, y = 等文字("战斗胜利", 10) if x ~= nil then 点击(x, y) end
读数字(..., 0) 里最后那个 0 是「读不出来就返回 0」。不写默认值会返回 nil,拿去做加减直接报错。
4.6换手机就错位?设好「设计分辨率」
你在自己手机上量出坐标 540,1200,别人的手机分辨率不一样就会点歪。设一次设计分辨率就全解决了:
一行搞定适配复制设置设计分辨率(1080, 1920) -- 按你量坐标时用的那台手机填 点击(540, 1200) -- 以后所有坐标都按 1080x1920 写,自动换算
print(屏幕宽(), 屏幕高()),或者 print(分辨率())。
本章最重要的组合套路
模板复制function 找并点(图片, 偏差) local x, y = 找图(图片, 0, 0, 9999, 9999, 偏差 or 0.8) if x ~= nil then 点击(x, y) 延时(600) return true end return false end
这 9 行会陪着你写完整套脚本,先背下来。第 5 章马上用它。
5.1完整实战:一个能交付的小脚本
假设要做的功能:启动游戏 → 等主界面 → 循环:关弹窗 / 血少加血 / 点开始 / 点胜利。这就是最典型的自动化脚本骨架。
main.lua(可直接抄,改配置区即可)复制-- ========== ① 配置区:以后只改这里 ========== local 游戏包名 = "com.xxx.game" local 低血线 = 30 -- ========== ② 工具函数 ========== function 找并点(图片, 偏差) local x, y = 找图(图片, 0, 0, 9999, 9999, 偏差 or 0.8) if x ~= nil then 点击(x, y) 延时(600) return true end return false end function 等图(图片, 秒) local 用时 = 0 while 用时 < (秒 or 10) * 1000 do local x, y = 找图(图片, 0, 0, 9999, 9999, 0.8) if x ~= nil then return x, y end 延时(300) 用时 = 用时 + 300 end return nil end -- ========== ③ 启动 ========== 设置设计分辨率(1080, 1920) 启动app(游戏包名) 延时(8000) print("游戏已启动") local x, y = 等图("主界面.png", 30) if x == nil then 提示("进不去游戏,脚本结束", 200, 500, 18, "#ff5555") return end print("已进主界面") -- ========== ④ 主循环 ========== while true do if 找并点("关闭弹窗.png") then print("关弹窗") elseif 找并点("开始战斗.png") then print("开始战斗") elseif 找并点("胜利确定.png") then print("结算确认") else local 血量 = 读数字(60, 40, 260, 90, 100) if 血量 < 低血线 then print("血量低", 血量, "先加血") 找并点("加血按钮.png") end 延时(500) end end
5.2逐段解释(每一块在干嘛)
| 段落 | 作用 | 为什么这么写 |
|---|---|---|
| ①配置区 | 把所有要改的东西提到最上面 | 以后换游戏、调阈值只改这 3 行,不用翻遍全文 |
| ②工具函数 | 「找并点」「等图」两个万能动作 | 后面 20 处点击都靠它,写一次用一辈子 |
| ③启动 | 设分辨率 → 开游戏 → 等主界面 | 等图 最多等 30 秒,进不去就提示并 return(结束脚本) |
| ④主循环 | 无限循环按优先级判断 | if / elseif 是从上往下试,最要紧的放最前面 |
5.3让它更像正式产品:加卡密和状态提示
打包版必备的两段复制-- 打包版启动时引擎已经自动弹框验过卡密了,这里直接拿那张卡 提示("已登录:" .. 当前卡密(), 100, 60, 16, "#7CE38B", -1) -- 毫秒 -1 = 常驻 -- 循环里给自己和客户看当前状态(打包版客户能看到) 提示("正在战斗 血量 " .. 血量, 100, 60, 16, "#7CE38B", -1)
提示(...):屏幕上的小浮字,毫秒 -1 是常驻(当成状态栏用);②
print(...):只在你自己的日志面板能看到,客户看不到,调试用。
加一层"防卡死"保护
兜底复制local 连续失败 = 0 while true do if 找并点("开始战斗.png") then 连续失败 = 0 else 连续失败 = 连续失败 + 1 if 连续失败 > 60 then -- 大概 30 秒啥也没干成 print("卡住了,重进游戏") 停止app(游戏包名) 延时(3000) 启动app(游戏包名) 延时(10000) 连续失败 = 0 end 延时(500) end end
6.1打包前先自查这 5 条
项目名.lua(打包后 APP 启动就跑它);② 所有用到的图片都在「资源」分区里(别只在电脑某个文件夹里);
③ 脚本能独立跑起来——不依赖你手动点运行、不依赖调试版的任何东西;
④ 需要卡密的话,
卡密登录 那套已经写好(勾「官方卡密」时会自动帮你加密);⑤ 分辨率适配那行
设置设计分辨率 已经加上。
点工具栏「打包」
弹出来的对话框上一排是「打包类型」,下拉只有两个选项:打包apk 和 打包脚本。这一章讲第一个。
6.2打包对话框,一栏一栏填
| 字段 | 怎么填 |
|---|---|
| 应用名称 | 手机上显示的名字,中文随便写 |
| 包名 | 英文小写+点,不能和已装的 App 重复;改过就得当新 App 装 |
| 版本名 / 版本码 | 版本名给人看(1.0.0),版本码是整数给系统比大小(1、2、3…)。每次发新版版本码必须变大 |
| 打包脚本 | 默认自动选主脚本,一般不用动 |
| 架构 | 至少勾 arm64-v8a;想兼容老手机就再勾 armeabi-v7a(包会大一点) |
| 应用图标 | 可不填,默认蓝图标。要自定义就选一张 png |
| 输出目录 | 默认 android\AI,出现"重名"会自动加 (1)(2) |
6.3两个勾选框决定「安不安全」
勾上会自动带上「最强加密」。
代价:不能用热更新(每次改脚本都要重新打包发客户)。
其它小开关
- 加密脚本:默认开,别关
- 打包自动版本加一:默认开,省得每次手改版本码
- 开机自启 / 打开直接运行:客户装上就自动跑,适合"傻瓜版",也更容易被系统杀
- 自检最新版:配合热更新用(第 7 章)
- 记录日志:出问题能查,建议开
6.4点「开始打包」之后发生了什么
打包是云端打包,你电脑上不需要装 Android SDK,也不要有 android 目录。
| 情况 | 结果 |
|---|---|
| 成功 | APK 落到 android\AI\应用名.apk,托盘气泡提醒,正式扣费 |
| 失败 | 弹窗告诉原因,自动退款,不扣钱 |
| 10 分钟没回报 | 冻结金额自动退回 |
| 提示「还没开通打包」 | 去后台开通包月,或等全站免费打包时段 |
② 把 APK 改成客户看得懂的名字(
自动打怪_v1.0.2.apk);③ 提醒客户开「悬浮窗 / 后台运行 / 电池不优化」三项权限,不然会被系统杀。
7.1什么是热更新:不用重装 APK 就能改脚本
客户已经装好的 APK,脚本有 bug 或者要加功能 —— 传统做法是重新打包、让客户卸载重装,客户早跑了。
客户流失率极高,而且版本一多你自己都乱。
APK 不用动,客户完全无感。
② APK 里勾了「自检最新版」(默认开)。
7.2打包脚本 + 上传
- 工具栏「打包」→ 打包类型选 打包脚本
- 版本码填一个比上次大的整数(比如上次 3,这次填 4)
- 点开始打包 → 产物是
android\AI\项目名(4).xbhot - 打开浏览器进客户后台 → 热更新 → 选项目 → 选这个 .xbhot → 版本号(留空自动 +1)→ 填更新说明 → 上传
| 你会关心的问题 | 答案 |
|---|---|
| 客户怎么才能拿到新版 | APK 启动时自动去拉,不用客户点任何东西 |
| 调试版会拉吗 | 不会。电脑推脚本的调试版自动跳过热更新,只有打包版才拉 |
| 能存几个版本 | 只自动保留最近 5 个,旧的会被删 |
| 发错了怎么办 | 版本列表里点「替换」切回上一版(5 秒内只能切一次) |
| 能不能传明文 .lua | 可以,但传上去服务器还会再加一层加密 |
8.1登录客户后台,先建项目
浏览器打开官网 → 登录 → 进「客户后台」。左侧一般有这几项:卡密、资费说明、个人信息、热更新、云函数、对接文档。
资费说明
个人信息
热更新
云函数
对接文档
项目ID:1000123(点一下复制)
项目密钥:a1b2c3…(点一下复制)
8.2项目设置:这些开关直接影响客户体验
| 设置项 | 作用 | 建议 |
|---|---|---|
| 默认窗口 | 一张卡密能同时在几台设备上登录 | 新手设 1(一台一卡) |
| 默认类型 | 生成卡密默认是小时/天/周/月/季/年 | 月卡最多就设「月」 |
| 卡密长度 | 生成的卡密字符数(≥6) | 12~16,太短容易撞 |
| 在线判定(秒) | 多久没心跳算离线(默认 300) | 默认就行 |
| 心跳间隔(秒) | 客户端多久报一次(默认 120,最低 120) | 建议不超过「在线判定」的一半 |
| 允许自助解绑 | 客户换手机时能不能自己解绑 | 开(不然天天找你解绑) |
| 解绑扣时(小时) | 每解绑一台扣多少时长(2~720,默认 6) | 6~24,太少客户会反复换机 |
| 每日解绑上限 | 一天最多解绑几次(1~99) | 1~3,防共享卡密轮流踢 |
| 允许自助改窗口 | 客户能不能自己加设备数 | 看你的定价策略 |
| 允许自助续费 | 客户能不能自己买卡续时长 | 开,能多赚钱 |
| 项目公告 | 脚本登录时带回给客户看(停机通知等) | 经常写一句 |
| 旧版本作废 | 重新打包后,老 APK 是否立刻失效 | 强制升级时开,平时别开 |
| 项目开关 | 紧急停用整个项目 | 出事时的急停按钮 |
客户不用再找你 → 你省事 → 时长照扣,不吃亏。
8.3生成卡密、发卡、查卡
- 生成后自动复制到剪贴板,直接去 QQ 发就行
- 一键复制未使用、导出 TXT(可选 全部列 / 只要卡密 / 卡密+类型+时长)
- 筛选:状态(未使用 / 已激活 / 已到期 / 已停用)、关键词、一次粘一堆卡密批量查
- 批量操作:删除 / 停用 / 恢复 / 解绑 / 改窗口 / 改时间(正数加、负数减)
- 单卡:改窗口、解绑、停用、删除、看卡密日志(客户哪天几点登录哪台设备都在这)
8.4客户最常问的 4 句话,怎么回答
| 客户说 | 真实原因 | 你怎么办 |
|---|---|---|
| "提示窗口上限" | 卡密已经在别的手机登录了 | 开了自助解绑的话让他自己解(扣时长);没开就去后台「解绑」 |
| "卡密无效" | 输错、粘到空格、把大写当小写(卡密是小写字母数字) | 让他复制粘贴,别手打 |
| "到期了想续" | 时长用完 | 发新卡让他用「续费」功能(后台开「允许自助续费」) |
| "换手机了" | 设备绑在旧机上 | 新版客户端会自动解绑并扣时,不用你动手 |
- 你去后台点「解绑」= 不扣客户时长(人情)
- 客户自己换机触发自动解绑 = 按「解绑扣时」扣(防止无限换设备白嫖)
9.1云函数是什么:把代码放在服务器上
正常情况下脚本在客户手机上跑,代码就在 APK 里,被人扒出来就完了。云函数是把核心逻辑放在服务器,手机上只拿到执行结果。
if 血量 < 30 then 加血() end逻辑在 APK 里,反编译能看到
local 配置 = 云函数表(项目ID, 密钥, "打怪配置")逻辑在服务器,手机只拿到参数
后台怎么建
- 客户后台 → 云函数 → 选项目 → 新建云函数
- 填:名称(脚本里用它调用)、窗口(默认 1)、版本号、最低客户端版本码(0 = 不限)、Lua 代码
- 保存 → 手机上跑脚本就能拉到
9.2脚本里怎么调用
main.lua复制local 项目ID = "1000123" local 密钥 = "你的项目密钥" -- 方式一:直接拿回一个表(最常用) local 配置 = 云函数表(项目ID, 密钥, "打怪配置") if 配置 ~= nil then local 地图 = 配置.地图 or "新手村" local 低血 = 配置.低血线 or 30 print("云端配置:", 地图, 低血) end -- 方式二:拿源码自己处理(进阶,一般不用) local 结果 = 云函数(项目ID, 密钥, "打怪配置") if 结果 ~= nil and 结果.code == 0 then print("云端返回成功") end
② 藏核心逻辑:把判断流程放云端,学生扒包也看不到完整逻辑。
所以:云函数失败不能导致脚本直接崩,一定要给默认值(上面
or "新手村" 就是干这个的)。
10.1先注册一个「统计账号」
数据统计和卡密后台不是同一套账号,要单独注册(在官网的「数据统计 / 云数据」入口)。
- 账号:4~20 位字母数字
- 密码:≥ 6 位
- QQ:找回密码用,可以留空
- 每台设备每天只能注册 1 个
还能当"云存档"用:客户的配置存在云上,换手机一键恢复。
10.2加表头 + 上报数据
① 网页上加列
统计页 → 表头设置 → + 加一列 → 填列名(≤ 8 个字,比如「泰拉」「等级」)→ 保存表头。
② 脚本里上报
main.lua复制-- 上报数据(统计账号, 密码, 设备名, 数据表) -- 第三个参数"设备名"是你自己起的标识,网页上按它查;用 设备型号() 拼一下最省事 上报数据("myuser", "mypass", 设备型号() .. "-1区", { 泰拉 = 12345, 等级 = 80, 金币 = 999, })
② 设备名建议用
设备名() 或者你自己拼("区1-角色A"),后面查的时候好找;③ 别每秒都上报,30 秒~5 分钟一次就够,不然数据表爆炸。
③ 云配置(换手机不用重设参数)
保存 / 读取复制保存云配置("账号", "密码", "我的配置") -- 把当前设置存到云 local 行 = 云配置列表("账号", "密码") -- 看有哪些配置 获取云配置("账号", "密码", "我的配置") -- 换手机后一键恢复
11.1YOLO 和找图有什么不一样
| 对比 | 找图 | YOLO |
|---|---|---|
| 原理 | 像素逐点比对 | AI 模型识别"物体" |
| 换皮肤/换角度 | 立刻失效 | 照样认得出 |
| 一次找多个同类 | 麻烦(要写多次) | 一次返回全部(带坐标) |
| 需要什么 | 截图一张 | 训练好的 .onnx 模型 |
| 速度 | 快 | 慢一些(吃性能) |
.onnx(官方有配套的模型训练工具)。模型文件放进项目「资源」分区。
11.2三行代码用起来
main.lua复制-- 1) 加载模型(只在开头加载一次,别放循环里) local ok = 模型加载("怪物.onnx") if not ok then print("模型加载失败", 模型信息()) return end -- 2) 检测:区域 + 置信度门限 while true do local 结果 = 模型检测(0, 0, 9999, 9999, 0.35) if 结果 ~= nil then for i = 1, #结果 do local 物 = 结果[i] print("发现", 物.cls, 物.prob, 物.cx, 物.cy) 点击(物.cx, 物.cy) -- 点它的中心点 延时(500) end end 延时(800) end
| 字段 | 含义 |
|---|---|
cls | 类别名(比如 "怪物") |
prob | 置信度 0~1,越大越确定 |
x, y, w, h | 左上角坐标 + 宽高 |
cx, cy | 中心点(点击就用它) |
模型加载 写进 while 循环 → 每秒加载一次模型,手机直接卡死;② 置信度调到 0.1 → 满屏假目标乱点。先用 0.35~0.5 试。
12.1最常见的问题(按出现频率排)
| 现象 | 原因与解决 |
|---|---|
| 脚本跑几分钟就停 | 被系统杀了。开:悬浮窗权限 + 允许后台运行 + 电池「不优化」+ 关省电模式;部分机型还要在最近任务里「锁定」 |
| 点了运行手机没反应 | 没连上;或连的是另一台手机;或脚本第一行就死循环没延时 |
| 找图一直找不到 | ① 图片没放进资源区;② 相似度 0.8 太高/太低;③ 截图带了背景;④ 分辨率没设 设置设计分辨率 |
| 换手机就点歪 | 同上,加 设置设计分辨率(宽, 高) |
| 打包提示"还没开通打包" | 后台没包月 / 没有次卡 / 不在免费时段 |
| 打包失败说项目太大 | 超过 8MB,删掉大图或改用热更新 |
| 热更新不生效 | 用的是调试版(调试版跳过热更新);或打包时勾了 AOT;或版本码没变大 |
| 客户装上闪退 | 架构没勾 arm64-v8a;或安卓版本太低;或没给权限 |
12.2新手学习路线(照着走不迷路)
② 勤存版本:每改好一次就另存一个
main_v2.lua,改坏了能退回去;③ 先看日志:报错行号都给你了,别硬猜。
- 看日志最后一行报什么错,跳到那一行
- 把可疑代码注释掉(前面加
--),二分法找问题行 - 只留最核心的几行跑,能跑通再一点点加回来
- 还不行就问客服,带上截图和日志,别只说"不能用"
把第 1~6 章照着做一遍,你就能做出第一个能发给客户的成品。
第 7~11 章是让你卖得更好、维护更省事的东西,等你有了第一个客户再回来看。
教程里没覆盖到的函数,去软件右侧「函数说明」里搜名字,那里是完整的。