player
<p>[TOC]</p>
<h2>新增函数</h2>
<h3>检查玩家当前是否是攻击状态,true是攻击状态</h3>
<pre><code>player:check_attack_state()</code></pre>
<h3>不确定</h3>
<pre><code>player:get_moneys()</code></pre>
<h3>不确定</h3>
<pre><code>player:get_money_group()</code></pre>
<h3>通过idx获取道具数据</h3>
<pre><code>player:getEquipDataByidx(idx)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>idx</td>
<td>number</td>
<td>道具id</td>
</tr>
</tbody>
</table>
<h3>获取道具AniCount</h3>
<pre><code>player:get_equip_aniCount(idx)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>idx</td>
<td>number</td>
<td>道具id</td>
</tr>
</tbody>
</table>
<h3>跳转超链</h3>
<pre><code>player:jump_link(id, data)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>超链id</td>
</tr>
<tr>
<td>data</td>
<td>table</td>
<td>携带数据</td>
</tr>
</tbody>
</table>
<h3>检测条件</h3>
<pre><code>player:check_condi(id, isAlert)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>table 条件id或条件id数组</td>
</tr>
<tr>
<td>isAlert</td>
<td>boolean</td>
<td>是否提示</td>
</tr>
</tbody>
</table>
<h2>变量</h2>
<h3>设置变量</h3>
<pre><code>player:set_param(id, value)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>变量id</td>
</tr>
<tr>
<td>value</td>
<td>any</td>
<td>变量value</td>
</tr>
</tbody>
</table>
<h3>获取变量</h3>
<pre><code>player:get_param(id)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>变量id</td>
</tr>
</tbody>
</table>
<h3>获取键值对变量</h3>
<pre><code>player:get_key_value(id, key)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>键值对id</td>
</tr>
<tr>
<td>key</td>
<td>any</td>
<td>变量key</td>
</tr>
</tbody>
</table>
<h3>设置键值对变量</h3>
<pre><code>player:set_key_value(id, key, value)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>键值对id</td>
</tr>
<tr>
<td>key</td>
<td>any</td>
<td>变量key</td>
</tr>
<tr>
<td>value</td>
<td>any</td>
<td>变量value</td>
</tr>
</tbody>
</table>
<h3>获取值</h3>
<pre><code>player:get_value(id)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>id</td>
</tr>
</tbody>
</table>
<h3>设置值</h3>
<pre><code>player:set_value(id, value)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>id</td>
</tr>
<tr>
<td>value</td>
<td>any</td>
<td>value</td>
</tr>
</tbody>
</table>
<h3>检测一组变量</h3>
<pre><code>player:check_params(params)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>params</td>
<td>table</td>
<td>条件数组</td>
</tr>
</tbody>
</table>
<h2>货币</h2>
<h3>获取货币数量</h3>
<pre><code>player:get_pay_money(id)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>货币id</td>
</tr>
</tbody>
</table>
<h3>获取充值比例</h3>
<pre><code>player:get_pay_point(id)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>number</td>
<td>货币id</td>
</tr>
</tbody>
</table>
<h3>检查货币数组是否足够</h3>
<pre><code>player:check_pay_money(array)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>array</td>
<td>table</td>
<td>数据格式如{{1,2000},{2,2000}}</td>
</tr>
</tbody>
</table>
<h3>检查v1的支付比例是否大于v2</h3>
<pre><code>player:check_pay_point(array)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>array</td>
<td>table</td>
<td>{{货币id1,货币id2}}</td>
</tr>
</tbody>
</table>
<h3>通过名称获取货币id</h3>
<pre><code>player:get_money_id_by_name(name)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>string</td>
<td>货币名称</td>
</tr>
</tbody>
</table>
<h3>获取货币数量</h3>
<pre><code>player:query_money(moneyId)</code></pre>
<h3>获取货币数量</h3>
<pre><code>player:get_money(id)</code></pre>
<h2>角色</h2>
<h3>是否是新人</h3>
<pre><code>player:is_new_role()</code></pre>
<h3>获取累计真实充值天数</h3>
<pre><code>player:get_pay_day()</code></pre>
<h3>获取每日真实充值金额</h3>
<pre><code>player:get_daily_pay()</code></pre>
<h3>获取在线时间(单位秒)</h3>
<pre><code>player:get_online_time()</code></pre>
<h3>获取累计在线时间(单位秒)</h3>
<pre><code>player:get_online_time_count()</code></pre>
<h3>获取累计登录天数</h3>
<pre><code>player:get_login_day()</code></pre>
<h3>获取角色战斗力</h3>
<pre><code>player:get_attr_count()</code></pre>
<h3>根据类型id获取属性值</h3>
<pre><code>player:get_attr(id)</code></pre>
<h3>获取副本时间</h3>
<pre><code>player:get_copy_time(id)</code></pre>
<h3>获取角色当前血量</h3>
<pre><code>player:get_cur_hp()</code></pre>
<h3>获取角色当前蓝量</h3>
<pre><code>player:get_cur_mp()</code></pre>
<h3>获取角色最大血量</h3>
<pre><code>player:get_max_hp()</code></pre>
<h3>获取角色最大蓝量</h3>
<pre><code>player:get_max_mp()</code></pre>
<h3>获取角色名称</h3>
<pre><code>player:get_name()</code></pre>
<h3>获取玩家真实姓名</h3>
<pre><code>player:get_user_name()</code></pre>
<h3>获取角色名称颜色</h3>
<pre><code>player:get_name_color()</code></pre>
<p>获取角色当前方向
人物方向 [0.上; 1.右上; 2.右; 3.右下; 4.下; 5.左下; 6.左; 7.左上; 0xff无效位置]</p>
<pre><code>player:get_direction()</code></pre>
<h3>获取玩家唯一ID</h3>
<pre><code>player:get_user_id()</code></pre>
<h3>检查玩家是否死亡</h3>
<pre><code>player:is_die()</code></pre>
<h3>检查玩家是否活着</h3>
<pre><code>player:is_alive()</code></pre>
<h3>获取玩家等级</h3>
<pre><code>player:get_level()</code></pre>
<h3>获取玩家转生等级</h3>
<pre><code>player:get_rein_level()</code></pre>
<h3>获取玩家当前经验值</h3>
<pre><code>player:get_cur_exp()</code></pre>
<h3>获取玩家当前最大经验值</h3>
<pre><code>player:get_max_exp()</code></pre>
<h3>获取玩家当前PK模式</h3>
<pre><code>player:get_pk_mode()</code></pre>
<h3>退出到选择角色界面(有无提示)</h3>
<pre><code>player:exit_role(isTips)</code></pre>
<h3>退出到登录界面</h3>
<pre><code>player:exit_login()</code></pre>
<h3>退出游戏[3.40.8版本]</h3>
<pre><code>player:exit_game()</code></pre>
<h3>是否是该玩家性别装备</h3>
<pre><code>player:is_gender_item(itemData)</code></pre>
<p>获取玩家职业
返回值 [0.战士; 1.法师; 2.道士]</p>
<pre><code>player:get_job()</code></pre>
<h3>获取职业名字</h3>
<pre><code>player:get_job_name()</code></pre>
<h3>获取玩家性别返回值 [0.男; 1.女]</h3>
<pre><code>player:get_gender()</code></pre>
<h3>获取玩家称号列表</h3>
<pre><code>player:get_title_list()</code></pre>
<h3>通过称号ID获取称号数据</h3>
<pre><code>player:get_title(id)</code></pre>
<h3>通过称号ID检查是否有称号</h3>
<pre><code>player:check_title(id)</code></pre>
<h3>设置pk模式</h3>
<pre><code>player:set_pk_mode(mode)</code></pre>
<h2>怪物</h2>
<h3>根据idx获取怪物表名字</h3>
<pre><code>player:get_mon_name(idx)</code></pre>
<h3>根据idx获取怪物表等级</h3>
<pre><code>player:get_mon_level(idx)</code></pre>
<h3>根据idx获取怪物名称颜色,返回cc.c3b</h3>
<pre><code>player:get_mon_color(idx)</code></pre>
<h3>请求地图怪物数据</h3>
<pre><code>player:requset_minimap_monsters()</code></pre>
<h2>队伍</h2>
<h3>创建队伍</h3>
<pre><code>player:create_team()</code></pre>
<h3>邀请玩家入队value 1.number(玩家ID); 2.string(玩家名称)</h3>
<pre><code>player:invite_team(value)</code></pre>
<h3>拒绝组队邀请id 玩家唯一ID</h3>
<pre><code>player:refuse_team(id)</code></pre>
<h3>同意组队邀请id 玩家唯一ID</h3>
<pre><code>player:receive_team(id)</code></pre>
<h3>同意申请入队id 玩家唯一ID</h3>
<pre><code>player:receive_join_team(id)</code></pre>
<h3>请求入队申请列表</h3>
<pre><code>player:request_team_list()</code></pre>
<h3>请求附近队伍</h3>
<pre><code>player:request_near_team()</code></pre>
<h3>请求加入队伍id 队长唯一ID</h3>
<pre><code>player:request_join_team(id)</code></pre>
<h3>召集队友</h3>
<pre><code>player:call_team_member()</code></pre>
<h3>离开队伍</h3>
<pre><code>player:leave_team()</code></pre>
<h3>踢出队伍id 玩家唯一ID</h3>
<pre><code>player:sub_team_member(id)</code></pre>
<h3>保存允许组队状态state 0.不允许; 1.允许;</h3>
<pre><code>player:set_team_state(state)</code></pre>
<h3>移交队长id 玩家唯一ID</h3>
<pre><code>player:set_team_leader(id)</code></pre>
<h3>请求地图组队成员数据</h3>
<pre><code>player:request_minimap_team()</code></pre>
<h3>队伍成员列表</h3>
<pre><code>player:get_team_members()</code></pre>
<h2>好友</h2>
<h3>添加好友</h3>
<pre><code>player:add_friend(name)</code></pre>
<h3>删除好友</h3>
<pre><code>player:remove_friend(name)</code></pre>
<h3>请求好友列表</h3>
<pre><code>player:request_friend_list()</code></pre>
<h3>清空好友申请列表</h3>
<pre><code>player:clear_friend_list()</code></pre>
<h3>好友加到黑名单</h3>
<pre><code>player:add_friend_to_black(name)</code></pre>
<h3>好友移出黑名单</h3>
<pre><code>player:remove_friend_from_black(name)</code></pre>
<h3>同意好友申请</h3>
<pre><code>player:apply_firend(name)</code></pre>
<h3>不同意好友申请</h3>
<pre><code>player:unapply_firend(name)</code></pre>
<h3>获取好友列表</h3>
<pre><code>player:get_firend_list()</code></pre>
<h3>是否是我的好友</h3>
<pre><code>player:is_firend()</code></pre>
<h3>是否在黑名单</h3>
<pre><code>player:is_blacklist()</code></pre>
<h2>邮件</h2>
<h3>请求获取邮件列表 一次十条</h3>
<pre><code>player:request_mail_list()</code></pre>
<h3>删除已读邮件</h3>
<pre><code>player:remove_read_mail()</code></pre>
<h3>读邮件</h3>
<pre><code>player:read_mail(mailId)</code></pre>
<h3>删除邮件</h3>
<pre><code>player:remove_mail(mailId)</code></pre>
<h3>邮件提取</h3>
<pre><code>player:get_mail_item(mailId)</code></pre>
<h3>邮件全部提取</h3>
<pre><code>player:get_mail_items()</code></pre>
<h2> 拍卖行</h2>
<h3>请求拍卖行上架列表type int [1.表示查询自己上架的物品; 2.表示查询参与过的]</h3>
<pre><code>player:request_auction_put_List(type)</code></pre>
<h3>拍卖行请求上架</h3>
<pre><code>player:request_auction_putin(makeindex, count, bidPrice, buyPrice, currencyID, rebate)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>makeindex</td>
<td>number</td>
<td>物品唯一ID</td>
</tr>
<tr>
<td>count</td>
<td>number</td>
<td>数量</td>
</tr>
<tr>
<td>bidPrice</td>
<td>number</td>
<td>竞拍价格</td>
</tr>
<tr>
<td>buyPrice</td>
<td>number</td>
<td>一口价</td>
</tr>
<tr>
<td>currencyID</td>
<td>number</td>
<td>货币ID</td>
</tr>
<tr>
<td>rebate</td>
<td>number</td>
<td>折扣(非必选)</td>
</tr>
</tbody>
</table>
<h3>拍卖行请求下架物品唯一ID 物品唯一ID</h3>
<pre><code>player:request_auction_putout(makeindex)</code></pre>
<h3>拍卖行请求重新上架</h3>
<pre><code>player:request_auction_reputin(makeindex, count, bidPrice, buyPrice, currencyID, rebate)</code></pre>
<table>
<thead>
<tr>
<th>param参数 </th>
<th>类型 </th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>makeindex</td>
<td>number</td>
<td>物品唯一ID</td>
</tr>
<tr>
<td>count</td>
<td>number</td>
<td>数量</td>
</tr>
<tr>
<td>bidPrice</td>
<td>number</td>
<td>竞拍价格</td>
</tr>
<tr>
<td>buyPrice</td>
<td>number</td>
<td>一口价</td>
</tr>
<tr>
<td>currencyID</td>
<td>number</td>
<td>货币ID</td>
</tr>
<tr>
<td>rebate</td>
<td>number</td>
<td>折扣</td>
</tr>
</tbody>
</table>
<h3>拍卖行请求领取竞拍成功物品 [3.40.3版本]</h3>
<pre><code>player:request_acquire_bid_item(makeindex)</code></pre>
<h2> 排行榜</h2>
<h3>请求排行榜数据type 类别ID</h3>
<pre><code>player:request_rank_data(type)</code></pre>
<h3>请求玩家排行榜数据userId 玩家唯一ID type int [1.玩家; 2.英雄]</h3>
<pre><code>player:request_rank_data(userId, type)</code></pre>
<h2>行会</h2>
<h3>请求行会申请列表</h3>
<pre><code>player:request_guild_apply_list()</code></pre>
<h3>行会同盟申请操作</h3>
<pre><code>player:request_apply_operate()</code></pre>
<h3>请求行会成员列表</h3>
<pre><code>player:request_guild_members()</code></pre>
<h3>请求世界行会列表</h3>
<pre><code>player:request_guild_world_list(page)</code></pre>
<h3>邀请玩家入会</h3>
<pre><code>player:invite_join_guild(id)</code></pre>
<h3>踢出行会</h3>
<pre><code>player:remove_guild_member(id)</code></pre>
<h3>任命行会职位</h3>
<pre><code>player:request_appoint_guild_rank()</code></pre>
<h3>获取我的行会信息</h3>
<pre><code>rank 职位id
contribute 贡献
todayDonateGold 当天捐钱
isJoinGuild bool是否加入行会
guildName 行会名称
guildId 行会id
isChairMan bool是否是会长或者副会长</code></pre>
<pre><code>player:get_guild_info()</code></pre>
<h3>行会成员列表</h3>
<pre><code>player:get_guild_members()</code></pre>
<h3>获取行会名称</h3>
<pre><code>player:get_guild_name()</code></pre>
<h3>检查是否有公会</h3>
<pre><code>player:is_guild()</code></pre>
<h3>获取公会职位ID</h3>
<pre><code>player:get_guild_rank()</code></pre>
<h3>获取是否是会长或者副会长</h3>
<pre><code>player:is_guild_leader()</code></pre>
<h3>获取行会ID</h3>
<pre><code>player:get_guild_id()</code></pre>
<h2>求购</h2>
<h3>请求求购数据</h3>
<pre><code>data = {
type 类型(int), -- 0: 世界求购, 1: 我的求购, 2: 我的已收
pageIndex 请求页码(int),
stdmode 筛选的stdmode(string), -- #分隔需要筛选的stdmode 例: &quot;1#2#3#4&quot;
currency 筛选货币(string), -- ,分隔需要筛选的货币ID 例: &quot;1,2,3&quot;
sort 排序规则(int), -- 0: 不排序 1: 单价正序 2: 单价倒序 3: 总价正序 4: 总价倒序
itemids 筛选道具idx(string), -- ,分隔筛选的道具Index 例: &quot;1001,1002,1003&quot;
}</code></pre>
<pre><code>player:request_purchase_item_list(data)</code></pre>
<h3>请求求购出售物品</h3>
<pre><code>data = {
guid = 求购列表标识id,
qty = 出售数量
}</code></pre>
<pre><code>player:request_purchase_sell(data)</code></pre>
<h3>请求上架求购物品</h3>
<pre><code>data = {
qty 求购数量(int),
minqty 求购最小数量(int),
price 物品单价(int),
itemid 道具Index,
currency 货币ID
}</code></pre>
<pre><code>player:request_purchase_putIn(data)</code></pre>
<h3>请求下架求购物品id 求购列表标识id, 不填则全部下架</h3>
<pre><code>player:request_purchase_put_out(id)</code></pre>
<h3>请求取出求购已收物品</h3>
<pre><code>player:request_purchase_take_out(id)</code></pre>
<h2>宝箱</h2>
<h3>请求获取宝箱物品奖励</h3>
<pre><code>player:request_box_award()</code></pre>
<h3>请求再开启宝箱</h3>
<pre><code>player:request_open_box()</code></pre>
<h2>装备物品</h2>
<h3>获取装备40-44定义变量</h3>
<pre><code>player:get_item_var(itemData, value)</code></pre>
<h3>获取装备0-31定义标识</h3>
<pre><code>player:get_item_tag(itemData, index)</code></pre>
<h3>请求玩家穿戴装备</h3>
<pre><code>itemData table装备数据
pos 装备位置
isFromHero bool是否来自英雄背包```
</code></pre>
<p>player:take_equip(itemData, pos, isFromHero)</p>
<pre><code>
###请求玩家脱下装备</code></pre>
<p>itemData table装备数据
isFromHero bool是否来自英雄背包</p>
<pre><code></code></pre>
<p>player:untake_equip(itemData, isToHero)</p>
<pre><code>
### 检测玩家是否是可穿戴装备</code></pre>
<p>player:is_use_equip(itemData)</p>
<pre><code>
### 是否是可穿戴装备(英雄)</code></pre>
<p>player:is_use_equip_hero(itemData)</p>
<pre><code>
### 通过装备stdmode获取对应装备位</code></pre>
<p>player:get_item_pos(stdmode)</p>
<pre><code>
### 获取佩戴装备需要等级</code></pre>
<p>player:get_item_level(itemData)</p>
<pre><code>
### 获取佩戴装备需要转生等级</code></pre>
<p>player:get_item_rein(itemData)</p>
<pre><code>
### 通过装备位获取玩家身上佩戴的装备数据</code></pre>
<p>player:get_item_by_pos(pos)</p>
<pre><code>
### 获取玩家对应装备位数据列表</code></pre>
<p>player:get_equip_list(pos)</p>
<pre><code>
###获得需要比较的装备</code></pre>
<p>itemData 装备数据
isHero 是否对比英雄
返回值 table, 具体用法参考官方 GUILayout/ItemTips.lua</p>
<pre><code></code></pre>
<p>player:get_diff_equip(itemData, isHero)</p>
<pre><code>
###对比传入装备和自身穿戴的装备</code></pre>
<p>itemData 装备数据
from 物品来自(界面位置), 可参照元变量”ITEMFROMUI_ENUM”
返回值 table</p>
<pre><code></code></pre>
<p>player:check_equip_power(itemData, from)</p>
<pre><code>
### 获取cfg_item和cfg_equip表配置数据</code></pre>
<p>player:get_itemdef()</p>
<pre><code>
### 通过物品ID获取cfg_item和cfg_equip表配置的物品数据</code></pre>
<p>player:get_item_data(itemId)</p>
<pre><code>
### 检测配置表里是否有该物品 </code></pre>
<p>player:is_item(itemId)</p>
<pre><code>
###检查物品满足条件</code></pre>
<p>items 物品二位数组{{物品ID,数量},{物品ID,数量}}
isAlert 不满足条件是否提示,true提示
double 需要物品数量倍数
pos 对应装备位(装备佩戴的装备计算在内)</p>
<pre><code></code></pre>
<p>player:check_items(items, isAlert, double, pos)</p>
<pre><code>
### 通过物品ID获取物品特效ID</code></pre>
<p>player:get_item_anim(id)</p>
<pre><code>
### 通过道具唯一id移除物品(可指定数量)</code></pre>
<p>makeIds number|string 物品唯一ID,多个id用,分割
count number 叠加物品扣除数量，不填此参数，默认全部扣除不可叠加物品全部扣除
desc string 描述
return boolean</p>
<pre><code></code></pre>
<p>player:remove_item_by_makeid(actor,makeIds,count,desc)</p>
<pre><code>
###获取当前物品数量</code></pre>
<p>id 物品ID
pos 装备位(对应装备位的装备是否计算在内)</p>
<pre><code></code></pre>
<p>player:get_item_num(id, pos)</p>
<pre><code>
### 获取快捷使用数据</code></pre>
<p>player:get_quick_items()</p>
<pre><code>
### 获取快捷栏物品数量</code></pre>
<p>player:get_quick_item_num(id)</p>
<pre><code>
### 通过物品ID使用物品</code></pre>
<p>player:use_item(itemId)</p>
<pre><code>
### 通过物品数据使用物品</code></pre>
<p>player:use_itemData(itemData)</p>
<pre><code>
### 通过物品ID获取物品数据</code></pre>
<p>player:get_item_by_id(itemId)</p>
<pre><code>
### 通过唯一ID获取背包物品数据</code></pre>
<p>player:get_item_by_makeid(makeid, isHore)</p>
<pre><code>
### 通过物品ID获取物品名称</code></pre>
<p>player:get_item_name(id)</p>
<pre><code>
### 通过物品ID获取物品stdmode</code></pre>
<p>player:get_item_stdMode(id)</p>
<pre><code>
### 通过物品名称获取物品ID</code></pre>
<p>player:get_item_id(itemName)</p>
<pre><code>
### 通过装备位获取玩家身上佩戴的装备Id</code></pre>
<p>player:get_id_by_pos(pos)</p>
<pre><code>
### 通过装备位获取玩家身上佩戴的装备名称</code></pre>
<p>player:get_name_by_pos(pos)</p>
<pre><code>
### 获取自定义属性标题</code></pre>
<p>player:get_item_custom_title(itemData, pos)</p>
<pre><code>
### 获取装备附加属性</code></pre>
<p>player:get_item_attidvalue(itemData)</p>
<pre><code>
通过物品ID获取物品名称颜色
返回值 十六进制格式 &quot;#FFFFFF&quot;
</code></pre>
<p>player:get_item_color(itemId)</p>
<pre><code>
### 通过物品ID获取道具名字颜色ID, 颜色表ID</code></pre>
<p>player:get_item_color_id(itemId)</p>
<pre><code>
### 物品是否是绑定</code></pre>
<p>player:is_item_bind(itemId)</p>
<pre><code>
###拆分道具</code></pre>
<p>data 道具数据
num 数量</p>
<pre><code></code></pre>
<p>player:split_item(itemData, num)</p>
<pre><code>
###获取装备属性itemId 物品ID
</code></pre>
<p>player:get_item_attr(itemId, isStr)</p>
<pre><code>
## npc
### 获取当前npc</code></pre>
<p>player:get_cur_npc()</p>
<pre><code>
### 获取npc</code></pre>
<p>player:get_npc()</p>
<pre><code>
## buff（不传actor为自己）
### 获取buff列表</code></pre>
<p>player:get_buff_list(actor)</p>
<pre><code>
### 获取buff</code></pre>
<p>player:get_buff(id, actor)</p>
<pre><code>
### 检查是否有buff</code></pre>
<p>player:check_buff(buffId, actor)</p>
<pre><code>
### 检查是否有buff数组(一维)</code></pre>
<p>player:check_buffs(buffs, actor)</p>
<pre><code>
### 检查是否有buff数组(二维或),有一组达成则返回true</code></pre>
<p>player:check_buffsEx(array, actor)</p>
<pre><code>
### 获取buff时间</code></pre>
<p>player:get_buff_time(id)</p>
<pre><code>
### 获取BUFF配置数据</code></pre>
<p>player:get_buff_data(id)</p>
<pre><code>
### 获取BUFF名称</code></pre>
<p>player:get_buff_name(id)</p>
<pre><code>
### 获取BUFF属性</code></pre>
<p>player:get_buff_attr(id)</p>
<pre><code></code></pre>
<p>player:get_buffdef()</p>
<pre><code>
## 技能
###获取已学技能</code></pre>
<p>isNormal 是否排除普攻
isActive 是否只获取主动技能</p>
<pre><code></code></pre>
<p>player:get_skill(isNormal, isActive)</p>
<pre><code>
### 获取技能数据</code></pre>
<p>player:get_skill_by_id(id)</p>
<pre><code>
### 判断是否拥有技能</code></pre>
<p>player:has_skill(id)</p>
<pre><code>
### 获取手游技能图片</code></pre>
<p>player:get_skill_icon_path(id)</p>
<pre><code>
###设置技能快捷键 id 技能ID key 键位[0~16]
</code></pre>
<p>player:set_skill(id, key)</p>
<pre><code>
### return ssr.GetSkillKey(id)</code></pre>
<p>player:get_skill_pos(id)</p>
<pre><code>
### return ssr.GetSkillConfig()</code></pre>
<p>player:get_skill_config()</p>
<pre><code>
### 获取技能名称</code></pre>
<p>player:get_skill_name(id)</p>
<pre><code>
### 获取技能名称列表</code></pre>
<p>player:get_skill_names()</p>
<pre><code>
### 释放技能</code></pre>
<p>player:release_skill(id)</p>
<pre><code>
## 背包
### 获取背包剩余格子数</code></pre>
<p>player:get_bag_black()</p>
<pre><code>
### 获取背包最大格子数</code></pre>
<p>player:get_bag_count()</p>
<pre><code>
### 获取背包已使用格子数</code></pre>
<p>player:get_bag_use_num()</p>
<pre><code>
### 获取背包所有物品数据</code></pre>
<p>player:get_bag_items()</p>
<pre><code>
### 通过物品ID遍历背包找到匹配的物品对象</code></pre>
<p>player:get_bag_item(itemId)</p>
<pre><code>
### 整理背包</code></pre>
<p>player:fresh_bag()</p>
<pre><code>
###检测物品背包是否有富余格子数存放</code></pre>
<p>itemId 物品ID
num 物品数量
isAlert 不足时是否需要提示 boolean</p>
<pre><code></code></pre>
<p>player:check_bag_space(itemId, num, isAlert)</p>
<pre><code>
背包是否满
isTips bool是否弹出提示
</code></pre>
<p>player:is_bag_full(isTips)</p>
<pre><code>
###丢弃物品 [3.40.3版本] itemData 物品数据
</code></pre>
<p>player:drop_bag_item(itemData)</p>
<pre><code>
## 仓库
### 通过唯一ID获取仓库物品</code></pre>
<p>player:get_depot_item(makeId)</p>
<pre><code>
### 获取仓库最大格子</code></pre>
<p>player:get_depot_size()</p>
<pre><code>
### 仓库取出道具</code></pre>
<p>player:get_depot_item(itemData)</p>
<pre><code>
### 仓库放入道具</code></pre>
<p>player:set_depot_item(itemData)</p>
<pre><code>
## 地图
### 获取当前地图名称</code></pre>
<p>player:get_map_name()</p>
<pre><code>
### 获取当前地图ID</code></pre>
<p>player:get_map_id()</p>
<pre><code>
### 请求小地图怪物数据</code></pre>
<p>player:request_minmap_monster()</p>
<pre><code>
### 获取小地图怪物数据</code></pre>
<p>player:get_minmap_monster()</p>
<pre><code>
### 获取地图ID,如果是镜像地图返回原地图ID,如果isTemp=true,则范围镜像地图ID</code></pre>
<p>player:get_cur_map(isTemp)</p>
<pre><code>
### 获取人物在当前地图的坐标</code></pre>
<p>player:get_pos()</p>
<pre><code>
### 获取人物是否在该范围</code></pre>
<p>player:is_range(p)</p>
<pre><code>
### 获取人物在当前地图的坐标</code></pre>
<p>player:get_map_pos()</p>
<pre><code>
### 当前地图数据ID</code></pre>
<p>player:get_map_data()</p>
<pre><code>
### 当前地图的小地图ID</code></pre>
<p>player:get_minimap_id()</p>
<pre><code>
### 是否是安全区域</code></pre>
<p>player:is_safe()</p>
<pre><code>
## 自动
### 开始自动战斗</code></pre>
<p>player:star_auto()</p>
<pre><code>
### 停止自动战斗</code></pre>
<p>player:stop_auto()</p>
<pre><code>
###开始自动寻路</code></pre>
<p>mapID: 地图ID
mapX: 坐标x
mapY: 坐标y
target:
{
type: [0.怪物; 1.NPC]
index: 目标类型index
}
type: 寻路类型
可参考GUIDefine.AUTO_MOVE_TYPE</p>
<pre><code></code></pre>
<p>player:auto_move(mapId, x, y, target, type)</p>
<pre><code>
### 是否自动寻路中</code></pre>
<p>player:is_auto()</p>
<pre><code>
###设置自动寻路
```target = {type = 0怪物 1Npc ,index = 目标类型索引}```
</code></pre>
<p>player:set_auto(mapId, x, y, target)</p>
<pre><code>
## 其他
### 检查客服是否开启</code></pre>
<p>player:check_service()</p>
<pre><code>
###发送公告</code></pre>
<p>Type 公告类型
4.顶部跑马灯公告(Msg、 FColor、 BColor)
5.屏幕跑马灯公告 可控制Y轴坐标 (Msg、 FColor、 BColor、 Y、 Count)
6.聊天上方公告(Msg、 FColor、 BColor、 Time、 Label)
9.普通通用提示(Msg)
10.可控制X轴Y轴公告(Msg、 FColor、 BColor、 X、 Y)
11.屏幕跑马灯公告(系统公告) (Type、 Msg、 FColor、 BColor)
12.系统频道公告(Msg、 FColor、 BColor)
13.带缩放效果的公告,可设置Y轴(Msg、 FColor、 BColor、Y)
】
Msg -- 提示内容
FColor -- 文字色值ID
BColor -- 背景色值ID
X -- 坐标X
Y -- 坐标Y
Time -- 倒计时
Count -- 播放次数
Label -- 响应Link</p>
<pre><code></code></pre>
<p>player:send_msg(data)</p>
<pre><code>
### 消息弹窗</code></pre>
<p>player:alert(type, style, msg, tab)</p>
<pre><code>
| param参数 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| type | number | 9为弹窗 |
| style | number | 0白色、1黄色、2绿色、3红色 |
| msg | string | 消息 |
| tab | table | 设置弹窗次数显示时间(非必选) |
</code></pre>
<p>player:send_msg_to_chat()</p>
<pre><code>
### 通过cfg_ManagePayStore表ID请求充值</code></pre>
<p>player:request_pay(id, payWay, money)</p>
<pre><code>
###请求进行交易id 玩家唯一ID
</code></pre>
<p>player:request_trade(id)</p>
<pre><code>
###通知服务端 时装显示开关type int [2.设置显示神魔; 1.设置时装显示]
</code></pre>
<p>player:notice_fashion_setting(type)</p>
<pre><code>
### 邀请上马</code></pre>
<p>player:invite_hores(id)</p>
<pre><code>
###请求确认加属性点 [新版属性加点]</code></pre>
<p>data 加点数据table {"Bonus":[{"id":1,"value":1}, ...]}
point 剩余加点数```</p>
<pre><code>player:request_add_rein_attr()</code></pre>
<h3>请求点击NPC [3.40.5版本]</h3>
<pre><code>player:request_click_npc(npcId)</code></pre>
<h3>开始自动挂机</h3>
<pre><code>player:start_play()</code></pre>
<h3>结束自动挂机</h3>
<pre><code>player:stop_play()</code></pre>
<h3>查看玩家目标信息</h3>
<pre><code>targetId 目标ID
notForbid 是否不判断地图禁止查看</code></pre>
<pre><code>player:look_info(targetId, notForbid)</code></pre>
<h3>私聊玩家</h3>
<pre><code>player:chat_target(targetID, targetName)</code></pre>
<h3>快速选择玩家</h3>
<pre><code>data = {
type [0.玩家; 50.怪物; 400.英雄]
imgNotice 没有目标时是否创建范围圈
systemTips 没有目标时是否弹提示
}</code></pre>
<pre><code>player:select_role(imgNotice, systemTips)</code></pre>
<h3>快速选择怪物</h3>
<pre><code>data = {
type [0.玩家; 50.怪物; 400.英雄]
imgNotice 没有目标时是否创建范围圈
systemTips 没有目标时是否弹提示
}```
</code></pre>
<p>player:select_monster()</p>
<pre><code>
### 选择目标ID</code></pre>
<p>player:select_target(targetId)</p>
<pre><code>
### 屏幕点击状态</code></pre>
<p>player:get_touch_state()</p>
<pre><code>
### 小地图界面是否打开</code></pre>
<p>player:is_minimap_open()</p>
<pre><code>
### 鼠标移动位置</code></pre>
<p>player:get_move_pos()</p>
<pre><code></code></pre>
<p>player:get_item_where()</p>
<pre><code>
### 是否是自动捡取状态</code></pre>
<p>player:is_auto_pick()</p>
<pre><code>
### 是否自动捡物中</code></pre>
<p>player:is_pick()</p>
<pre><code>
### 开始自动捡取物品</code></pre>
<p>player:start_pick()</p>
<pre><code>
### 停止自动捡取物品</code></pre>
<p>player:stop_pick()</p>
<pre><code>
### 是否是玩家</code></pre>
<p>player:is_player(actor)</p>
<pre><code>
### 玩家是否在摆摊状态</code></pre>
<p>player:is_stall(actorID)</p>
<pre><code>
### 是否是网络玩家</code></pre>
<p>player:is_net_player(actor)</p>
<pre><code>
### 是否是怪物</code></pre>
<p>player:is_monster(actor)</p>
<pre><code>
### 是否是NPC</code></pre>
<p>player:is_npc(actor)</p>
<pre><code>
### 是否是英雄</code></pre>
<p>player:is_hero(actor)</p>
<pre><code>
### 是否是人形怪</code></pre>
<p>player:is_human(actor)</p>
<pre><code>
### 获取actor地图x坐标</code></pre>
<p>player:get_actor_map_x(actor)</p>
<pre><code>
### 获取actor地图y坐标</code></pre>
<p>player:get_actor_map_y(actor)</p>
<pre><code>
### 获取actorID</code></pre>
<p>player:get_actor_id(actor)</p>
<pre><code>
### 获取actor名称</code></pre>
<p>player:get_ACTOR_NAME(actor)</p>
<pre><code>
### 获取actor当前血量</code></pre>
<p>player:get_actor_hp(actor)</p>
<pre><code>
### 获取actor最大血量</code></pre>
<p>player:get_actor_max_hp(actor)</p>
<pre><code>
### 获取actor当前魔法值</code></pre>
<p>player:get_actor_mp(actor)</p>
<pre><code>
### 获取actor最大魔法值</code></pre>
<p>player:get_actor_max_mp(actor)</p>
<pre><code>
### 获取actor等级</code></pre>
<p>player:get_actor_level(actor)</p>
<pre><code>
### 获取actor职业</code></pre>
<p>player:get_actor_job(actor)</p>
<pre><code>
### 获取actor性别</code></pre>
<p>player:get_actor_gender(actor)</p>
<pre><code>
### 是否死亡</code></pre>
<p>player:is_actor_die(actor)</p>
<pre><code>
### 获取actor归属ID</code></pre>
<p>player:get_owner_id(actor)</p>
<pre><code>
### 获取actor归属名字</code></pre>
<p>player:get_owner_name(actor)</p>
<pre><code>
### 获取怪物大图标ID</code></pre>
<p>player:get_mon_icon(actor)</p>
<pre><code>
### 获取攻击状态</code></pre>
<p>player:get_attack_state(actor)</p>
<pre><code>
### 获取actor组队状态 0.未组队;1.组队中;</code></pre>
<p>player:get_team_state(actor)</p>
<pre><code>
### 获取actor行会名字</code></pre>
<p>player:get_actor_guild_name(actor)</p>
<pre><code>
###直接购买商场某物品</code></pre>
<p>storeIndex 商品index cfg_store商城表配置的id
limitStr 超出限制购买的提示</p>
<pre><code></code></pre>
<p>player:open_store_box(storeIndex, limitStr)</p>
<pre><code>
### 请求购买商品 [3.40.3版本]</code></pre>
<p>player:buy_store_item_by_id(id, count)</p>
<pre><code>
### 获取装备颜色</code></pre>
<p>player:get_equip_color(itemdata)</p>
<pre><code>
### 获取当前在第几大陆</code></pre>
<p>player:get_cur_dalu()</p>
<pre><code>
### 获取当前大陆解锁</code></pre>
<p>player:get_cur_max_dalu()</p>
<pre><code>
###通知显示道具信息</code></pre>
<p>name 名称
num 数量
color 颜色</p>
<pre><code></code></pre>
<p>player:notice_item_info(name, num, color)</p>
<pre><code>
### 是否是跨服</code></pre>
<p>player:is_kuafu()</p>
<pre><code>
### 向后端推送</code></pre>
<p>player:push_lua_table(name, data)</p>
<pre><code>
| param参数 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| name | string | 模块名 |
| data | table | 数据 |
### 查看目标装备</code></pre>
<p>player:look_target_equip(data)</p>
<pre><code>
### 是否在坐骑上</code></pre>
<p>player:is_mount_up(actor)</p>
<pre><code></code></pre>