沙盘引擎 (SEngine)

创意诞生沙盘世界,不止如此想象!

用户工具

站点工具


scripting:client:player

这是本文档旧的修订版!




📚 Client/Player

📒 Event

📘 OnPlayerEntityLogin( player, entity )

当某个玩家注册绑定了一个实体对象(开始控制角色)时调用。

📘 OnPlayerEntityLogout( player, entity )

当某个玩家取消绑定了一个实体对象(开始控制角色)时调用。

📒 Static Property

📘 Player.Local

获取本地玩家实例对象(本地玩家自身)。

注意:在专用服务器模式(BatchMode)下,如果通过服务器自身脚本访问此属性,将会得到一个空值Null,因为专用服务器本身并不包含本地玩家。

if(Player.Local) DLog(Player.Local.Name); //Output self player name

📒 Property

📘 player.ID

获取玩家序列ID。

player.ID: int

📘 player.Name

获取玩家用户昵称

player.Name: string

📘 player.IsLocal

获取玩家是否为本地玩家(自身用户)。

player.IsLocal: bool

📘 player.Entity

获取玩家绑定的实体对象(角色)。

player.Entity: Character

📘 player.Character

获取玩家绑定的实体对象(角色),作用与player.Entity完全相同。

player.Character: Character

📘 player.Pos

获取玩家世界坐标位置(通常是玩家屏幕中心位置),如果玩家正在控制角色,则返回角色坐标位置。

player.Pos: Vector

📘 player.FocusPos

获取玩家操作焦点位置(鼠标世界坐标),高度Y轴总是为0

player.FocusPos: Vector

📘 player.RaycastPos

获取玩家焦点实时位置(鼠标世界坐标),受视角碰撞遮挡影响,包含高度Y轴信息。

player.RaycastPos: Vector

📒 Static Function

📘 Player.Find()

寻找一个玩家实例(通过ID),不存在则返回null

function Player.Find( id: int ): Player

📘 Player.Search()

寻找一个玩家实例(通过模糊查找,通常根据玩家名称,不区分大小写),不存在则返回null

function Player.Search( any: string ): Player
//Players: "Alnny", "Tommy", "Tom"
Player.Search("Tom"); //Tom(完整匹配)
Player.Search("Tomm"); //Tommy(相似匹配)
Player.Search("To"); //Tommy(以最先搜索到的为主)

📘 Player.FindByUUID()

寻找一个玩家实例(通过UUID),不存在则返回null

function Player.FindByUUID( uuid: string ): Player

📘 Player.GetCount()

获取当前所有存在玩家数量。

function Player.GetCount(): int

📘 Player.Get()

获取当前存在的指定索引玩家,通常搭配GetCount()遍历使用。

function Player.Get( index: int ): Player

scripting/client/player.1711251640.txt.gz · 最后更改: 2024/03/24 11:40 由 bibiboxs