玩家实体组件

Player

组合:

游戏中的玩家实体，每位用户一个

属性

名称	类型	描述	脚本名称
当前血量	整数	\	HP
最大血量	整数	\	MaxHP
是否是AI	布尔	`只读`	IsMonster
玩家状态	玩家状态类型枚举	`只读` `玩家` 玩家状态，活跃、击倒、死亡	PlayerStatus
存活时间	整数	`只读`	LastSurvivalTime
无敌	布尔	\	Invincible
所属队伍	队伍实体组件	`只读` `队伍`	HostTeam
当前检查点ID	整数	`检查点`	LastCheckPointID
目标检查点ID	整数	`检查点`	TargetCheckpointID
出生点	方向点[已废弃]	`只读` `关卡物件`	BornPosition_Deprecated
复活点	方向点[已废弃]	\	RevivePosition_Deprecated
阵营（感染模式）	整数	玩家的阵营，1 人类，2 僵尸	Faction_ForInfection
伤害倍率	浮点数	`战斗`	WeaponDamageRate
人物模型	人形模型ID	\	HumanModel
移动速度缩放比	浮点数	\	RunSpeedScale
跳跃高度缩放比	浮点数	\	JumpHeightScale
身份	整数		Identity_ForInfection
表示当前的僵尸等级	整数		MonsterLevel
方向点	方向点[已废弃]	`只读`	DirectPosition_Deprecated
昵称	字符串	`只读` 玩家的昵称	NickName
受到伤害百分比	浮点数	`战斗`	DamageTakenPercent
EP	整数	\	EP
EPMAX	整数	\	EPMAX
当前主武器	武器组件	`只读` `物品`	MainWeapon
死亡时遗失所有装备	布尔	`物品`	IsDropOnEliminated
倒地是否直接死亡	布尔	\	SkipKnockdown
瞄准辅助类型	瞄准辅助类型	`战斗`	AimAssistType
是否可被辅助瞄准锁定	布尔	`战斗`	AllowLockbyAimAssist
开关语音聊天	布尔	`只读` `聊天频道`	MuteVoiceChat
开关快捷聊天	布尔	`只读` `聊天频道`	MuteQuickChat
频道实体	聊天频道	`只读` `聊天频道`	ChatChannel
移动状态	玩家行为状态类型	`只读` `玩家`	MovementStatus_Deprecated
冲刺状态	玩家行为状态类型	`只读` `玩家`	SprintStatus_Deprecated
攻击状态	玩家行为状态类型	`只读` `玩家`	AttackStatus_Deprecated
跳跃状态	玩家行为状态类型	`只读` `玩家`	JumpStatus_Deprecated
是否禁止拾取物品	布尔	`物品`	DisableItemPickup
是否禁止丢弃物品	布尔	`物品`	DisableItemDrop
敌对玩家	玩家列表	`只读` `队伍`	AttackableTargets
友好玩家	玩家列表	`只读` `队伍`	FriendPlayers
阵营实体	阵营	`只读` `队伍`	Faction
玩家在阵营中的序号	整数	`只读` `队伍` 玩家在阵营中的序号	NumberInFaction
主相机	相机	`摄像机` 玩家正在使用的相机	MainCamera
重力	浮点数	\	Gravity
当前头盔	头盔组件	`只读` `物品` 当前头盔	Helmet
当前防弹衣	防弹衣组件	`只读` `物品` 当前防弹衣	Vest
移动速度缩放比	浮点数	\	CrouchWalkSpeedScale
移动速度缩放比	浮点数	\	SprintSpeedScale
移动速度缩放比	浮点数	\	DownedCrawlSpeedScale
移动速度缩放比	浮点数	\	CrawlSpeedScale
头骨缩放	三维向量	\	HeadBonesScale_Deprecated
身体缩放	三维向量	\	BodyBonesScale_Deprecated
四肢缩放	三维向量	\	LimbBonesScale_Deprecated
UserUID	UUID	`只读`	UserUID
爆头减伤率	浮点数	`战斗`	HeadshotDamageReduction
玩家服饰	玩家服饰	`只读` `藏品` 玩家绑定的AVATAR	Outfit
性別	性别	`只读` `玩家` 性別	Gender
玩家枪皮		`只读` `藏品` 玩家枪皮	WeaponSkinIDs
出生点	三维向量	`只读` 玩家的出生点	SpawnPoint
复活点	三维向量	玩家的复活点，如果没有检查点记录则使用出生点，否则使用检查点	RevivalPoint
位置	三维向量	`只读` 玩家当前的位置	Position
前方	三维向量	`只读` 玩家当前的朝向	Forward
骨骼	骨架	`只读` `玩家` 用来访问蒙皮骨骼的节点	Skeleton
玩家背包	玩家背包实体	`只读` `物品` 玩家背包	Backpack
临时护盾值	整数	临时护盾值	TemporaryShieldPoints
车皮ID	整数列表	`只读` `藏品`	VehicleSkinIDs
跳过坠落时的僵直动画	布尔	\	IsSkipStaggerAnimation
是否坠落时免伤	布尔	\	DisableFallDamage
当前手持物品	实体类	`只读` 当前手持物品	CurrentItemInHand
禁止拾取物品列表	物品列表	禁止拾取物品列表	ItemPickupBanlist
预设玩家类型	预设角色类型	玩家资源ID	CustomCharacterResource
请求购买目标	请求购买类型	`经济` 想指定目标，发送请求购买消息	AskBuyTarget
当前播放的Emote动画资源ID	动画资源ID	`只读` 当前播放的Emote动画资源ID	CurrentAnimationResource
当前播放的Emote动画是否循环	布尔	`只读` 当前播放的Emote动画是否循环	IsCurrentAnimationLoop
击倒设置	击倒状态处理方式枚举	`玩家` 在被击杀时对击倒状态的处理方式设置	KnockdownStatus
开启FF伤害跳字	布尔	`玩家` 默认为true，开启FF伤害跳字	ShowDamageNumber
背包皮肤ID	整数	`只读` `藏品`	BackpackSkinID
能否中途退出	布尔	`只读` `客户端`	CanQuitMdiway
	玩家变身后或NPC服饰	`只读` `藏品`	TransformClothInfo

事件

名称	描述
当装备防具时	在装备头盔、防弹衣或者背包时触发
当装备武器时	在手持主武器、副武器或近战武器时触发，包括切换为拳头时
当获得装备时	在获得SwitchEquipSlot枚举下的槽位对应的物品时触发
当切换手持物品时	在切换手持物品时触发，包括切换为拳头时
当玩家被击倒[已废弃]	当玩家进入击倒跪姿时调用
当玩家被击倒	在玩家进入击倒状态时触发
当使用道具时	在使用道具后触发，需要使用时间的道具会在完成使用后触发此事件
当获得物品时	在获得物品时触发
玩家进入载具时[已废弃]	实体进入载具时触发，包括作为司机和乘客
当进入载具时	在实体进入载具时触发，作为司机或乘客都可以触发此事件
玩家离开载具时[已废弃]	实体离开载具时触发
当离开载具时	在实体离开载具时触发
玩家驾驶载具时[已废弃]	实体驾驶载具时触发，在车上为司机时
当驾驶载具时	在实体驾驶载具时触发
玩家传送后[已废弃]	实体使用传送门发生传送后触发（已废弃，请使用OnBouncesOffTire）
当使用传送门时	在实体使用传送门发生传送后触发
玩家被轮胎击飞时[已废弃]	实体发生弹跳行为时触发
当被轮胎弹起时	在实体被轮胎弹起后触发
玩家与机关碰撞时[已废弃]	实体被机关击飞时触发
当被击飞时	在实体被机关击飞时触发
当复活时	在该玩家复活时触发
当获得武器时	在获得武器实体时触发
当玩家切换场景时	在玩家切换场景时触发
当丢弃武器时	在玩家丢弃武器时触发
当丢弃道具时	在玩家丢弃武器以外的物品时触发
当瞄准时	在瞄准一个可瞄准实体时触发
当断开连接时	在玩家断开连接时触发
当重新连接时	在玩家重新连接时触发
当开始开火时	在玩家按下开火键时触发
当玩家跳起	在玩家跳起时触发
当跳跃结束时	在玩家跳跃结束时触发
当坠落时	在玩家坠落时触发
当坠落结束时	在玩家坠落结束时触发
当玩家蹲下	在玩家蹲下时触发
当玩家趴下	在玩家趴下时触发
当疾跑时	在玩家疾跑时触发
当投掷命中并爆炸时	在掷出投掷物后投掷物爆炸时触发
当移动时	在玩家移动时触发
当待机时	在玩家待机时触发
当使用玩家技能时	在玩家使用技能时触发
当玩家站起	在玩家从其他姿态站起时触发
当水上滑板时	在玩家使用水上滑板时触发
当结束水上滑板时	在玩家停止使用水上滑板时触发
当结束疾跑时	在玩家结束冲刺时触发
当好友关系更新时	在玩家新增、删除好友时触发
当剧情对话开始时	在剧情对话开始播放时触发
当剧情对话结束时	在剧情对话结束时触发
当触发剧情对话选项时	在剧情对话中选择了选项后触发

API

名称	描述
添加物品	为玩家添加物品，返回发放的物品列表
设置特殊物品状态	为玩家设置特殊物品状态，特殊物品只能拥有一个
给玩家加血量	为指定玩家回复血量，不会超过血量上限
销毁物品	删除玩家一定数量的物品
获取物品数量	获取玩家持有的指定物品数量
创建内置UI	创建内置UI，只有指定的玩家可以看到该UI
创建图标[已废弃]	使用指定的图标类型创建一个图标，有更多需要设置的属性时则通过实体进一步设置它的实体属性（已废弃，请使用CreateLevelObject）
创建文本[已废弃]	使用指定的文本内容创建一个文本，有更多需要设置的属性时则通过实体进一步设置它的实体属性（已废弃，请使用CreateLevelObject）
创建特效[已废弃]	使用指定的特效类型创建一个图标，有更多需要设置的属性时则通过实体进一步设置它的实体属性（已废弃，请使用CreateEffect）
创建特效[已废弃]	使用指定的特效类型创建一个图标，有更多需要设置的属性时则通过实体进一步设置它的实体属性
创建自定义UI	创建自定义UI，只有指定的玩家可以看到该UI
获取控件	从自定义UI中获取UI控件
播放音效[已废弃]	播放指定的音效，有更多需要设置的属性时则通过实体进一步设置它的实体属性（已废弃，请使用CreateSound）
通知客户端播放音效	通知目标玩家的客户端播放音效
通知客户端显示飘字	通知目标玩家的客户端显示飘字
传送[已废弃]	把玩家传送到具体坐标（已废弃，请使用Teleport）
获得附近队友位置[已废弃]	获得队友附近位置，会规避开无法站立玩家的位置（已废弃，请使用GetTeammateNearPosition）
获得队友附近的位置	获得随机队友附近位置，没有队友时返回自身附近的坐标，会规避开无法站立玩家的位
获取随机出生点坐标[已废弃]	获取当前可用没有完全占满的随机出生点内可用坐标（已废弃，请使用GetRandomSpawnPosition）
获取玩家积分[已废弃]	获取玩家指定积分类型的总分值
设置玩家回合积分[已废弃]	设置玩家指定积分类型的回合分值
获取玩家回合分[已废弃]	获取玩家指定回合、积分类型的分值
获取玩家排名[已废弃]	获取玩家游戏总排名
获取玩家回合排名[已废弃]	获取玩家指定回合排名
获取随机出生点	获取随机出生点坐标，只会从没有完全占满的可用出生点中随机
检测玩家是否按顺序触发levelobeject	检测玩家是否可触发当前检查点
复活	复活指定玩家
切换玩家武器	切换玩家武器为指定槽位的武器
摧毁玩家物品[已废弃]	摧毁玩家物品（已废弃，请使用DeleteEquipment）
销毁装备	摧毁玩家指定槽位内的武器
创建钱包	为目标玩家创建钱包，若玩家已有钱包则无效
获取玩家当前频道	获取指定玩家当前所在的聊天频道实体
玩家加入频道	使玩家加入指定聊天频道，玩家已经处于其他聊天频道时会切换至目标频道
玩家退出频道	使玩家退出当前所在频道，之后处于不在任何聊天频道的状态
设置行为状态	设置玩家的行为状态
切换玩家区域	将玩家切换至指定场景的指定位置，未加载的场景会自动加载，不会自动卸载已经加载的场景
替换球衣	更换球衣
清除球衣	将玩家球衣恢复成初始状态
设置玩家语音聊天状态	开关玩家语音聊天
设置玩家快捷聊天状态	开关玩家快捷聊天
玩家变身为某个场景物件	将目标玩家的外形替换为指定场景物件的外形
播放角色动画片段	播放角色动画，支持自定义动画资源
播放角色动画片段	播放角色动画片段，可以选择是否覆盖游戏默认动画
设置角色	设置指定玩家的角色资源
复原为原来形象	取消玩家的伪装状态
分身为某个场景物件	在目标玩家处创建一个场景实体外形的分身
获取变身实体	获取玩家的伪装实体
通过路径获取控件	从自定义UI中使用路径获取一个UI控件
设置拾取状态	设置目标玩家是否可以拾取物品
设置丢弃状态	设置目标玩家是否可以丢弃物品
设置玩家是否可攻击[已废弃]	设置可攻击玩家
获取可攻击玩家[已废弃]	已废弃
获取当前相机	获取目标玩家当前使用的摄像机实体
切换相机	将目标玩家的相机切换为目标相机，
清空背包	清空目标玩家背包中所有物品，包括已装备物品
设置朝向	设置玩家朝向
设置技能	设置目标玩家的技能列表
获取技能	获取目标玩家的技能列表
获取背包道具栏中物品	获取目标玩家背包道具栏中的道具
添加武器配件	为指定槽位的武器添加配件，与该槽位不匹配的配件会添加失败；匹配但重复的配件会替换掉原有的配件，原配件会送入玩家背包，玩家背包已满时原配件会掉落在玩家当时的位置
获取背包装备栏中物品	获取背包装备栏中的装备
上传结算信息[已废弃]	已废弃
退出游戏	将目标玩家踢出游戏
骨骼缩放[已废弃]	（已废弃，请勿使用，相关信息见属性:Skeleton）
设置玩家是否可以中途退出	设置玩家是否可以自由退出
击飞	给予玩家击飞效果，目标玩家会以固定的加速度下坠、并且空中发生撞击后会强制停止击飞
恢复默认服装	恢复目标玩家的默认服装，无法作用于NPC
恢复默认枪皮	恢复目标玩家的默认武器皮肤，无法作用于NPC
设置套装	设置玩家的套装
设置默认界面状态	设置目标玩家默认界面显隐状态
创建小地图图标	创建小地图图标
创建小地图像素	为目标物件在地图上生成静态像素，静态像素不会随着目标物件移动
获得小地图	获得目标玩家的小地图实体
怪物释放技能	目标AI释放指定技能
获取车皮	获取目标玩家的载具皮肤
设置车皮	设置目标玩家的载具皮肤
去除车皮	清除目标玩家指定载具的皮肤
恢复默认车皮	恢复目标玩家默认的载具皮肤
强制玩家上车	强制目标玩家进入指定载具
请求匹配	目标玩家请求匹配指定地图
创建音效[已废弃]	播放指定的音效，有更多需要设置的属性时则通过实体进一步设置它的实体属性
设置坠落伤害	设置玩家坠落伤害，可根据高度分段设置不同伤害
销毁Bot	销毁指定Bot
强制下车	强制目标玩家离开载具
丢弃物品	使目标玩家丢弃物品
上传游戏结算信息	上传自定义结算信息
创建音效	播放指定的音效，有更多需要设置的属性时可设置它的实体属性
创建特效	创建指定视觉特效，有更多需要设置的属性时可设置它的实体属性
恢复背包皮肤	恢复目标玩家的背包皮肤为默认局外配置
判断好友关系	判断目标玩家与当前客户端玩家的好友关系，当前客户端自身不是当前客户端的好友
开启跳伞	开启跳伞
添加AOI特别关注	添加AOI特别关注，无视距离始终同步
移除AOI特别关注	移除AOI特别关注，取消视距外AOI同步
是否存在AOI特别关注	判断是否存在AOI特别关注
切换AOI代理观察者	切换玩家的代理观察者
开始播放剧情	使触发玩家开始播放指定剧情对话