# Actor管理接口 Actor

在使用Actor接口前需先创建Actor管理对象,方法如下:

local Actor = class.Actor.new()

具体函数名及描述如下:

序号 函数名 函数描述
1 isPlayer(...) 检测是否是玩家
2 isMob(...) 检测是否是怪物
3 getObjType(...) 获取对象类型(玩家、生物、投掷物、掉落物等^)
4 isInAir(...) 是否在空中
5 getPosition(...) 获取actor位置
6 setPosition(...) 设置actor位置
7 jump(...) 跳跃
8 killSelf(...) 杀死自己
9 getCurPlaceDir(...) 获取当前朝向
10 tryMoveToActor(...) 向目标行动者移动
11 tryMoveToPos(...) 向目标位置移动
12 addBuff(...) 增加指定BUFF
13 hasBuff(...) 是否已经有了指定BUFF
14 removeBuff(...) 移除指定BUFF
15 clearAllBuff(...) 清除全部BUFF
16 clearAllBadBuff(...) 清除全部减益BUFF
17 getBuffList(...) 获取已有BUFF
18 getBuffLeftTick(...) 获取BUFF剩余tick
19 addHP(...) 增加当前生命量
20 getHP(...) 获取当前生命量
21 getMaxHP(...) 获取最大生命量
22 addOxygen(...) 增加当前氧气值
23 getOxygen(...) 获取当前氧气值
24 addEnchant(...) 增加装备附魔
25 removeEnchant(...) 移除装备附魔
26 findNearestBlock(...) 寻找附近方块
27 setFaceYaw(...) 设置actor原地旋转偏移角度
28 getFaceYaw(...) 获取actor原地旋转偏移角度
29 turnFaceYaw(...) 转动actor横向偏移角度
30 setFacePitch(...) 设置actor视角仰望角度
31 getFacePitch(...) 获取actor视角仰望角度
32 turnFacePitch(...) 转动actor仰望偏移角度
33 playBodyEffect(...) 播放特效
34 stopBodyEffect(...) 停止特效
35 playBodyEffectByFile(...) 播放文件特效
36 stopBodyEffectByFile(...) 停止文件特效
37 playSound(...) 播放声音
38 playSoundSpecial(...) 播放声音(特定类型:GSOUND_TYPE)
39 clearActorWithId(...) 清除生物ID为actorid的生物
40 setAttackType(...) 设置伤害类型
41 setImmuneType(...) 设置免疫伤害类型
42 mountActor(...) 登上、脱离载具
43 setActionAttrState(...) 设置生物行为属性状态
44 getActionAttrState(...) 获取生物特殊属性的状态
45 tryNavigationToPos(...) 寻路到目标位置
46 randomActorID(...) 在资源库里随机创建一个生物
47 getRidingActorObjId(...) 获取骑乘生物的objid
48 playBodyEffectById(...) 在指定玩家身上播放特效 1.2+
49 stopBodyEffectById(...) 停止指定玩家身上的特效 1.2+
50 setBodyEffectScale(...) 设置指定玩家身上的特效大小 1.2+
51 playSoundEffectById(...) 在指定Actor身上播放音效 1.3+
52 stopSoundEffectById(...) 停止指定Actor身上的音效 1.3+
53 appendSpeed(...) 给actor附加一个速度 1.3+
54 getFaceDirection(...) 获取actor朝向 1.3+
55 calcDirectionByDirection(...) x,y,z : number : 坐标 1.3+
56 calcDirectionByAngle(...) pitch : number : 垂直偏移夹角 1.3+
57 calcDirectionByYawDirection(...) x,y,z : number : 坐标 1.3+
58 calcDirectionByYawAngle(...) yaw : number : 水平偏移夹角 1.3+
59 getEyeHeight(...) objid : number : 唯一ID 1.3+
60 getEyePosition(...) objid : number : 唯一ID 1.3+
61 getBodySize(...) objid : number : 唯一ID 1.3+

# isPlayer

  • 参数及类型:objid
  • 返回值及类型:
  • 该方法的主要作用:检测是否是玩家
  • 具体使用案例如下:
local result = Actor:isPlayer(objid)

# isMob

  • 参数及类型:objid
  • 返回值及类型:
  • 该方法的主要作用:检测是否是怪物
  • 具体使用案例如下:
local result = Actor:isMob(objid)

# getObjType

  • 参数及类型:objid
  • 返回值及类型:
  • 该方法的主要作用:获取对象类型(玩家、生物、投掷物、掉落物等^)
  • 具体使用案例如下:
local result = Actor:getObjType(objid)

# isInAir

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:是否在空中
  • 具体使用案例如下:
local result = Actor:isInAir(objid)

# getPosition

  • 参数及类型:objid
  • 返回值及类型:
  • 该方法的主要作用:获取actor位置
  • 具体使用案例如下:
local result = Actor:getPosition(objid)

# setPosition

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:设置actor位置
  • 具体使用案例如下:
local result = Actor:setPosition(objid, x, y, z)

# jump

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:跳跃
  • 具体使用案例如下:
local result = Actor:jump(objid)

# killSelf

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:杀死自己
  • 具体使用案例如下:
local result = Actor:killSelf(objid)

# getCurPlaceDir

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取当前朝向
  • 具体使用案例如下:
local result = Actor:getCurPlaceDir(objid)

# tryMoveToActor

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:向目标行动者移动
  • 具体使用案例如下:
local result = Actor:tryMoveToActor(self_objid, target_objid, speed)

# tryMoveToPos

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:向目标位置移动
  • 具体使用案例如下:
local result = Actor:tryMoveToPos(objid, x, y, z, speed)

# addBuff

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:增加指定BUFF
  • 具体使用案例如下:
local result = Actor:addBuff(objid, buffid, bufflv, customticks)

# hasBuff

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:是否已经有了指定BUFF
  • 具体使用案例如下:
local result = Actor:hasBuff(objid, buffid)

# removeBuff

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:移除指定BUFF
  • 具体使用案例如下:
local result = Actor:removeBuff(objid, buffid)

# clearAllBuff

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:清除全部BUFF
  • 具体使用案例如下:
local result = Actor:clearAllBuff(objid)

# clearAllBadBuff

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:清除全部减益BUFF
  • 具体使用案例如下:
local result = Actor:clearAllBadBuff(objid)

# getBuffList

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取已有BUFF
  • 具体使用案例如下:
local result = Actor:getBuffList(objid)

# getBuffLeftTick

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取BUFF剩余tick
  • 具体使用案例如下:
local result = Actor:getBuffLeftTick(objid, buffid)

# addHP

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:增加当前生命量
  • 具体使用案例如下:
local result = Actor:addHP(objid, hp)

# getHP

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取当前生命量
  • 具体使用案例如下:
local result = Actor:getHP(objid)

# getMaxHP

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取最大生命量
  • 具体使用案例如下:
local result = Actor:getMaxHP(objid)

# addOxygen

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:增加当前氧气值
  • 具体使用案例如下:
local result = Actor:addOxygen(objid, oxygen)

# getOxygen

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取当前氧气值
  • 具体使用案例如下:
local result = Actor:getOxygen(objid)

# addEnchant

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:增加装备附魔
  • 具体使用案例如下:
local result = Actor:addEnchant(objid, slot, enchantId, enchantLevel)

# removeEnchant

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:移除装备附魔
  • 具体使用案例如下:
local result = Actor:removeEnchant(objid, slot, enchantId)

# findNearestBlock

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:寻找附近方块
  • 具体使用案例如下:
local result = Actor:findNearestBlock(objid, blockid, blockRange)

# setFaceYaw

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:设置actor原地旋转偏移角度
  • 具体使用案例如下:
local result = Actor:setFaceYaw(objid, yaw)

# getFaceYaw

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取actor原地旋转偏移角度
  • 具体使用案例如下:
local result = Actor:getFaceYaw(objid)

# turnFaceYaw

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:转动actor横向偏移角度
  • 具体使用案例如下:
local result = Actor:turnFaceYaw(objid, offset)

# setFacePitch

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:设置actor视角仰望角度
  • 具体使用案例如下:
local result = Actor:setFacePitch(objid, pitch)

# getFacePitch

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取actor视角仰望角度
  • 具体使用案例如下:
local result = Actor:getFacePitch(objid)

# turnFacePitch

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:转动actor仰望偏移角度
  • 具体使用案例如下:
local result = Actor:turnFacePitch(objid, offset)

# playBodyEffect

local result = Actor:playBodyEffect(objid, type)

# stopBodyEffect

local result = Actor:stopBodyEffect(objid, type)

# playBodyEffectByFile

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:播放文件特效
  • 具体使用案例如下:
local result = Actor:playBodyEffectByFile(objid, filename, sync)

# stopBodyEffectByFile

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:停止文件特效
  • 具体使用案例如下:
local result = Actor:stopBodyEffectByFile(objid, filename)

# playSound

local result = Actor:playSound(objid, name, volume, pitch, flag)

# playSoundSpecial

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:播放声音(特定类型:GSOUND_TYPE)
  • 具体使用案例如下:
local result = Actor:playSoundSpecial(objid, name, type)

# clearActorWithId

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:清除生物ID为actorid的生物
  • 具体使用案例如下:
local result = Actor:clearActorWithId(actorid, bkill)

# setAttackType

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:设置伤害类型
  • 具体使用案例如下:
local result = Actor:setAttackType(objid, attacktype)

# setImmuneType

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:设置免疫伤害类型
  • 具体使用案例如下:
local result = Actor:setImmuneType(objid, immunetype, isadd)

# mountActor

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:登上、脱离载具
  • 具体使用案例如下:
local result = Actor:mountActor(objid, mountobjid, posindex)

# setActionAttrState

local result = Actor:setActionAttrState(objid, actionattr, switch)

# getActionAttrState

local result = Actor:getActionAttrState(objid, actionattr)

# tryNavigationToPos

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:寻路到目标位置
  • 具体使用案例如下:
local result = Actor:tryNavigationToPos(objid, x, y, z, cancontrol)

# randomActorID

  • 参数及类型:nil
  • 返回值及类型:
  • 该方法的主要作用:在资源库里随机创建一个生物
  • 具体使用案例如下:
local result = Actor:randomActorID()

# getRidingActorObjId

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取骑乘生物的objid
  • 具体使用案例如下:
local result = Actor:getRidingActorObjId(objid)

# playBodyEffectById 1.2+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:在指定玩家身上播放特效
  • 具体使用案例如下:
local result = Actor:playBodyEffectById(objid, particleId, scale)

# stopBodyEffectById 1.2+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:停止指定玩家身上的特效
  • 具体使用案例如下:
local result = Actor:stopBodyEffectById(objid, particleId)

# setBodyEffectScale 1.2+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:设置指定玩家身上的特效大小
  • 具体使用案例如下:
local result = Actor:setBodyEffectScale(objid, particleId, scale)

# playSoundEffectById 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:在指定Actor身上播放音效
  • 具体使用案例如下:
local result = Actor:playSoundEffectById(objid, soundId, volume, pitch, isLoop)

# stopSoundEffectById 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:停止指定Actor身上的音效
  • 具体使用案例如下:
local result = Actor:stopSoundEffectById(objid, soundId)

# appendSpeed 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:给actor附加一个速度
  • 具体使用案例如下:
local result = Actor:appendSpeed(objid, x, y, z)

# getFaceDirection 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:获取actor朝向
  • 具体使用案例如下:
local result = Actor:getFaceDirection(objid)

# calcDirectionByDirection 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:x,y,z : number : 坐标
  • 具体使用案例如下:
local result = Actor:calcDirectionByDirection(objid, vx, vy, vz)

# calcDirectionByAngle 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:pitch : number : 垂直偏移夹角
  • 具体使用案例如下:
local result = Actor:calcDirectionByAngle(objid, yaw, pitch)

# calcDirectionByYawDirection 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:x,y,z : number : 坐标
  • 具体使用案例如下:
local result = Actor:calcDirectionByYawDirection(objid, vx, vy, vz)

# calcDirectionByYawAngle 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:yaw : number : 水平偏移夹角
  • 具体使用案例如下:
local result = Actor:calcDirectionByYawAngle(objid, yaw, pitch)

# getEyeHeight 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:objid : number : 唯一ID
  • 具体使用案例如下:
local result = Actor:getEyeHeight(objid)

# getEyePosition 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:objid : number : 唯一ID
  • 具体使用案例如下:
local result = Actor:getEyePosition(objid)

# getBodySize 1.3+

  • 参数及类型:
  • 返回值及类型:
  • 该方法的主要作用:objid : number : 唯一ID
  • 具体使用案例如下:
local result = Actor:getBodySize(objid)
上次更新: 2019-11-22 11:51:08