跳到主要内容

CreateActor

注意

这个函数是在SA-MP 0.3.7中添加的，在以前的版本中不起作用！

描述​

创建具有基础功能的静态角色实体。该实体类似 NPC 但功能受限，不会占用服务器玩家槽位。

参数名说明
skin角色使用的皮肤模型 ID
Float:x生成坐标 X 轴值
Float:y生成坐标 Y 轴值
Float:z生成坐标 Z 轴值
Float:angle角色初始朝向角度（单位：度）

返回值​

成功返回角色 ID（从 0 开始计数），当达到角色数量上限（1000）时返回 INVALID_ACTOR_ID（65535）。

应用示例​

new gActorCJ;

public OnGameModeInit()
{
    // 在蓝莓镇（地图中心）创建CJ角色
    gActorCJ = CreateActor(0, 0.0, 0.0, 3.0, 0.0);
}

public OnGameModeExit()
{
    // 销毁已创建的角色
    DestroyActor(gActorCJ);
}

注意事项​

提示

角色实体适用于静态场景元素（如收银员、酒保），可通过ApplyActorAnimation执行单次或循环动画

注意
  • 角色系统独立于 NPC 系统，不占用玩家槽位且操作方式不同（最大数量 1000）
  • 角色会被车辆推动，建议使用定时器重置位置
  • 默认处于无敌状态

关联函数​

关联回调​