跳到主要内容

玩家

获取​

  • 参数
    • id (integer) - 玩家ID
  • 返回
    • player (player) - 玩家
local player = base.player(id)

本地玩家​

  • 返回
    • player (player) - 玩家
local player = base.local_player()

controller​

获取玩家控制者

  • 返回
    • controller (string) - 会是以下值中的一个
      • human - 用户
      • none - 空位
      • computer - 电脑
      • ai - AI
local controller = player:controller()

each_player​

遍历玩家

  • 参数
    • type (string) - 玩家类型
  • 返回
    • player (player) - 玩家

当设置了type后，会遍历所有该类型的玩家（根据config中的玩家定义）；否则会遍历所有玩家。按照玩家ID从小到大的顺序遍历。

for player in base.each_player 'user' do
    -- 你的代码
end

event​

注册事件

  • 参数
    • name (string) - 事件名
    • callback (function) - 事件函数
  • 返回
    • trigger (trigger) - 触发器
  • 事件参数
    • trigger (trigger) - 触发器
    • ... (...) - 自定义数据

这是对base.event_register方法的封装，你可以在这里看到详细说明。

local trigger = player:event('玩家-选择英雄', function (trigger, player, name)
    -- 你的代码
end)

event_dispatch​

触发事件

  • 参数
    • name (string) - 事件名
    • ... (...) - 自定义数据

这是对base.event_dispatch方法的封装，你可以在这里看到详细说明。

player:event_dispatch('自定义事件', ...)

event_notify​

触发事件

  • 参数
    • name (string) - 事件名
    • ... (...) - 自定义数据

这是对base.event_notify方法的封装，你可以在这里看到详细说明。

player:event_notify('自定义事件', ...)

game_state​

获取游戏状态

  • 返回
    • state (string) - 会是以下值中的一个
      • none - 空位
      • online - 在线
      • offline - 离线
local state = player:game_state()

get​

获取属性

  • 参数
    • state (string) - 属性名称
  • 返回
    • value (number/string) - 数值或字符串

玩家属性说明见这里

local value = player:get '金钱'

get_hero​

获取英雄

如果玩家没有英雄，则返回nil。

local hero = player:get_hero()

set_hero_upper_body_facing​

设置英雄上半身朝向

  • 参数

    • angle (number) 朝向角度，世界坐标系，范围 0 - 360。如果传一个小于0的值，表示取消上半身单独朝向
    • sync_to_server (bool) 是否同步给服务器

  • 返回

    • result (bool) 是否成功

cancel_hero_upper_body_facing​

取消英雄上半身单独朝向

  • 参数

    • time (number) 花time的时间(单位ms)逐渐使上半身接近下半身的朝向，时间到了之后上半身不再有单独朝向。时间未到时如再次调用set_hero_upper_body_facing或cancel_hero_upper_body_facing，会被后面的调用的效果覆盖。

  • 返回

    • result (bool) 是否成功

get_hero_name​

获取英雄名字

如果玩家没有英雄，则返回空字符串。

local name = player:get_hero_name()

get_slot_id​

获取槽位ID

  • 返回
    • id (integer) - 槽位ID
local id = player:get_slot_id()

get_team_id​

获取队伍ID

  • 返回
    • id (integer) - 队伍ID
local id = player:get_team_id()

user_name​

获取用户名

  • 返回
    • name (string) - 用户名

若该玩家是空位，则返回空字符串。

local name = player:user_name()

user_title​

获取用户称号

  • 返回
    • title (string) - 用户的称号

若该玩家是空位，则返回空字符串。

local title = player:user_title()