传奇盒子(原传奇助手)系列挂机脚本函数说明

   传奇助手系列可能对于合击服的玩家来说兴许有点陌生，但是对于单职业玩家来说确实再熟悉不过了！想当初，GEE单职业版本刚刚流行的时候，是传奇GEE助手改变了无挂可用的局面，颠覆性的录制脚本方式以及创新的自动换装功能，深受用户喜爱。经过一段时间的演变发展，陆续推出了GOM助手、HERO助手、传奇猎刃（ASK引擎、APPLE引擎、给力引擎、LDM2、神盾登录器）等系列版本，最后整合成了传奇盒子，并且并入各大热门辅助版本中去，至此传奇助手的辉煌正式落下帷幕！虽然期间不过短短两载春秋，现如今助手的辉煌可能已不复当年之勇，但是凭借其简单灵活的脚本功能、稳定的挂机体验足矣在传奇脱机挂的历史上，留下厚重的一笔！现在，我们还能在一些常见的传奇辅助中找到当初助手的身影，今天我们就来分享下传奇助手系列常用的脚本函数。

小退重进()

----------------
单击(x,y)
@param x,y 游戏窗口坐标

右击(x,y)
@param x,y 游戏窗口坐标

按键(key)
@param key 键盘虚拟码

输入字符(c)
@param content 内容
-------------------------

获取包裹占位
num=获取包裹物品数量()

输出脚本》工具
输出日志("log")

输出到DbgView
调试打印("content")

【动作类】
等待(itv)
说明：等待一段时间
参数：itv，类型为数字，表示等待的时间，单位为毫秒
示例：等待(1500)

对话("name")
说明：对话指定名字的NPC，从而打开NPC对话框
参数：name，类型是字符串，表示NPC名字
示例：对话("比奇老兵")
注意：游戏的NPC名字可能有空格存在，请使用脚本工具进行NPC名字采集

坐标对话(x,y)
说明：与特定坐标上的NPC对话，从而打开NPC对话框
参数：x，y，类型为数字，表示NPC的坐标
示例：坐标对话(330,330)

选择("cmd")
说明：选择NPC菜单
参数: cmd，类型为字符串，表示菜单命令
示例: NPC对话中卖对应的命令为@sold（可通过工具中NPC对话内容查看到），则选择卖菜单的脚本命令为 选择("@sold")

移动到范围2("mapid",x,y,range)
说明：移动到某地图的指定坐标的周围，可跨图移动
参数：mapid，类型为字符串，表示地图id（地图id可以由脚本工具进行查看）
x，y，类型为数字，表示地图坐标
range，类型为数字，表示离目标坐标的距离
示例：移动到范围2("3",305,373,5) --表示移动到盟重省仓库周围

移动到地图2("mapid")
说明：移动到某地图，可跨图移动
参数：mapid，类型为字符串，表示地图id
示例：移动到地图2("D601") --表示移动到蜈蚣洞地牢一层东

开始挂机()
说明：开始循环挂机
参数：无
示例：开始挂机()

开始挖矿()
说明：开始循环挖矿
参数：无
示例：开始挖矿()

开始泡点()
说明：开始泡点
参数：无
示例：开始泡点()

bok=使用物品("name")
说明：使用包裹内的物品
参数：name，类型为字符串，表示物品名字，支持*通配符
返回值：bok，类型为boolean（真假），表示是否成功
示例：
使用物品("回城传送*")
等待(1500)

bok=使用装备("name",equipmentindex)
说明：穿装备
参数：name，类型为字符串，表示装备名字
equipmentindex，装备索引，使用挂机》工具》身上装备查看
返回值：bok，类型为boolean，表示是否成功
示例：使用装备("鹤嘴锄",1)

买("name",num,itv)
说明：从商店购买物品
参数：name，类型为字符串，表示物品名字
num，类型为数字，表示购买数量
itv，一次购买后等待的时间
示例：买("强效金创药",10,1500)

买装备("name")
说明：从商店购买装备，会挑持久最高的买
参数：name，类型为字符串，表示装备名字
示例：买("斩马刀")

卖([stdmode1],[stdmode2],[stdmode3])
说明：卖物品到商店
参数：stdmode1,stdmode2,stdmode3都为可选参数，表示物品分类，可使用挂机》工具》包裹查看物品分类
示例：卖() --卖全部物品到商店
卖(22,23) --卖戒指
卖(4) --卖书

喊话("content")
说明：喊话
参数：content，类型为字符串，表示喊话内容
示例：喊话("!卖雷霆套，要的mm")
喊话("@服务")

设置来回挂机路线()
设置环状挂机路线()
添加挂机路线点2("mapid",x,y,dis)
说明：当挂机路线为来回挂机路线时，挂机从第一点挂机到最后一点，再从最后一点挂回第一点，形成一个来回，依此循环。
当挂机路线为环状挂机路线时，挂机从第一点挂机到最后一点，再到第一点，形成一个环，依此循环。
参数：mapid，类型为字符串，表示地图id
x，y，类型为数字，表示地图坐标
dis，类型为数字，表示离目标坐标的距离
示例： --牛魔洞一层
设置来回挂机路线()
添加挂机路线点2("D2071",230,214,3)
添加挂机路线点2("D2071",32,267,3)
添加挂机路线点2("D2071",27,153,3)
添加挂机路线点2("D2071",279,167,3)
添加挂机路线点2("D2071",249,15,3)
添加挂机路线点2("D2071",13,52,3)
添加挂机路线点2("D2071",152,158,3)

result=边走边打2("mapid",x,y,dis)
说明：边走边打到指定地图的指定坐标周围
参数：map，类型为字符串，表示地图名字
mapid，类型为字符串，表示地图编号
x,y，类型为数字，表示地图坐标
dis，类型为数字，表示离目标地图坐标的距离
返回值：result，类型为boolean(真假)，true(真)表示顺利到达，false(假)表示触发了停止挂机
示例： --废矿入口
if 边走边打2("D401",29,178,5)==false then
使用物品("回城卷")
等待(2000)
return 回城()
end

游戏菜单(menu)
说明：点击游戏窗口上悬浮的按钮，如在线回收，每日打卡等
参数：按钮的菜单号，可以通过录制功能获得
返回值：无
示例：游戏菜单(1)

刷新包裹()
说明：刷新包裹
参数：无
示例：刷新包裹()

【信息类】
num=获取物品数量("name")
说明：获取包裹里某种物品的数量
参数：name，类型为字符串，表示物品名字，支持周知物品，通配符
返回值：num，类型为数字，表示数量
示例：local nWMnum=获取物品数量("[沃玛装备]") --获取沃玛装备数量
local nHpDrugnum=获取物品数量("强效金创药") --获取强效金创药数量
local nQHnum=获取物品数量("强化*") --获取所有强化技能书数量

brepair=是否需要修理(persistLowPercent,[equipmentindex1],[equipmentindex2],[equipmentindex3])
说明：判断装备是否需要修理
参数：persistLowPercent，类型为数字，表示最低持久百分比
equipmentindex，类型为数字，表示装备序号（使用脚本》工具可以查看），可设置多个
返回值：brepair，类型为boolean，表示是否需要修理（低于最低持久百分比就要修）
示例：local brepair=是否需要修理(80,1)

bsold=是否需要卖([stdmode1],[stdmode2],[stdmode3])
说明：根据挂机的物品处理设置判断包裹里是否有需要卖的东西
参数：stdmode，可选参数，类型为数字，表示物品分类，可设置多个分类
返回值：bsold，类型为boolean，表示是否需要卖东西
示例：--是否需要卖首饰
local bsold=是否需要卖(19,20,21,22,23,24,26)
if bsold then
--卖物脚本代码
end

bsave=是否需要存()
说明：根据挂机的物品处理设置判断包裹里是否有需要存的东西
参数：无
返回值：bsave，类型为boolean，表示是否需要存仓
示例：local bsave=是否需要存()
if bsave then
--存物脚本代码
end

mapid=获取地图id()
说明：获取当前地图编号
参数：无
返回值：mapid，类型为字符串，表示地图编号，如比奇省为0，盟重省为3，尸魔洞一层为D2051
示例：local mapid=获取地图id()

清空周知物品()
添加周知物品("name","items")
说明：清空和定义周知物品
参数：name，类型为字符串，表示周知物品名
items，类型为字符串，表示周知物品项，用|风格，仅支持普通名字，不支持通配符和周知物品
示例：
清空周知物品()
添加周知物品("祖玛武器","裁决之杖|骨玉权杖|龙纹剑")

【高级】
1.商铺购买("name",buytype,num)
说明：从商铺购买物品
参数：name，类型为字符串，表示物品名字
buytype，类型为数字，表示商铺类型，1=元宝商铺，2=点卷商铺，3=金币商铺
num，类型为数字，表示购买数量
返回值：无
示例：商铺购买("盟重传送石",1,1)

2.获取主号信息(attribute)
说明：获取主号的信息
参数：attribute，类型为数字，表示属性项，1=名字，2=位置，4=生死，6=包裹负重，7=最大包裹负重，8=血量，9=最大血量，10=魔量，11=最大魔量，12=金币
返回：根据属性项对应返回
示例：hp=获取主号信息(8)

3.更新怪物数组()
说明：更新怪物数组缓存，为后面使用做准备
参数：无
返回：无

4.num=获取怪物数量()
说明：获取缓存中怪物数量
参数：无
返回：num，类型为数字，表示怪物数量
示例：更新怪物数组()
local num=获取怪物数量()

5.获取指定怪物信息(index,attribute)
说明：获取缓存中指定怪物的信息
参数：index，类型为数字，表示怪物索引
attribute，类型为数字，表示属性项：1=名字，2=位置，4=生死，5=有无肉可挖
返回：根据属性项对应返回
示例：x,y=获取指定怪物信息(1,2)

6.查找怪物("name")
说明：从缓存中查找指定怪物
参数：name，类型为字符串，表示怪物名字
返回：怪物对象，0表示未找到
示例：g1=查找怪物("赏金猎人")
if g1>0 then
播放声音("提示.wav")
end

7.获取怪物信息(monster,attribute)
说明：获取怪物对象的信息
参数：monster，类型为数字，表示怪物对象
attribute，类型为数字，表示属性项：1=名字，2=位置，4=生死，5=有无肉可挖
返回：根据属性项对应返回
示例：x,y=获取怪物信息(g1,2)

8.清空用户检测()
设置用户检测("function", itv)
说明：挂机过程中，自定义指定时间间隔的触发，用于解决一些挂机过程中特殊的需要
参数：function，类型为字符串，表示自定义检测函数名字，对应脚本中的一个函数
itv，类型为数字，表示检测间隔，单位为毫秒
示例：
function 答题提醒()
local a=获取NPC对话内容()
if string.find(a,"请在%d秒回答")~=nil then
播放声音("警告.wav")
end
return 2
end

do
--设置答题提醒
清空用户检测()
设置用户检测("答题提醒",1000)
--开始
清空挂机路线()
开始挂机()
end