Lua接口/服务端/SetPos

首页 · 服务端接口 · 角色属性与物品 · 调用约定

角色的同场景转移

Lua 调用

SetPos(sceneId, selfId, x, z)

服务端脚本中共出现 19 处调用，实参个数出现过：4 个（19 处）。

实现位于 LuaFnTbl_Attr.h。

参数

序号	参数 / 类型	说明
1	sceneId number	当前调用所在的场景 ID。 脚本中的实参：sceneId（19 处）
2	selfId number	当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：selfId（15 处）、TankManFirst（2 处）、checkHumanId
3	x number	需要warp到的新位置的X坐标值 脚本中的实参：x600052_g_DefaultTankPos[1+intbase][1]（3 处）、172（2 处）、opx（2 处）
4	z number	需要warp到的新位置的Z坐标值 脚本中的实参：x600052_g_DefaultTankPos[1+intbase][2]（3 处）、141（2 处）、opy（2 处）

返回值

无返回值。赋值接收时得到 nil；这与返回数字 0 不同。

用法补充

角色的同场景转移
设置角色(玩家和怪物)跳转到当前地图上的某点

脚本中的调用

以下是服务端脚本里的真实调用点，按实参形态去重后列出 8 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。

-- event/caoyun/ecaoyun.lua
SetPos(sceneId, selfId, Scene_Info[i].Exit_Position.x, Scene_Info[i].Exit_Position.y)

-- event/chuansong/team.lua
SetPos(sceneId, checkHumanId, posX, posY)

-- event/dali/edali_0237.lua
SetPos(sceneId, selfId, mp[6], mp[7])

-- event/guild/ExchangeTank.lua
SetPos(sceneId, TankManFirst, x600052_g_DefaultTankPos[1+intbase][1], x600052_g_DefaultTankPos[1+intbase][2])

-- event/guild/ExchangeTank.lua
SetPos(sceneId, tankobjID, x600052_g_DefaultTankPos[1+intbase][1], x600052_g_DefaultTankPos[1+intbase][2])

-- event/huashan/ehuashan_3.lua
SetPos(sceneId, selfId, nPos_X, nPos_Z)

-- event/huodong/GodOfFire_Lighten.lua
SetPos(sceneId, selfId, nScenePosTmp1.posX, nScenePosTmp1.posY)

-- obj/commonitem/340001.lua
SetPos(sceneId, selfId, x, z)

注意事项

• 调用对象必须是当前场景中的有效角色对象，可包括玩家、怪物或珍兽。