---
title: "CreateActor | open.mp"
description: "Cria um 'ator' estático no mundo."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/CreateActor
language: pt-BR
---

# CreateActor

aviso

Esta função foi adicionada no SA-MP 0.3.7 e não funcionará em versões anteriores!

## Descrição

Cria um 'ator' estático no mundo. Estes 'atores' são como NPCs, porém têm funcionalidade limitada. Eles não ocupam slots de jogadores do servidor.

| Nome | Descrição |
| --- | --- |
| skin | O [ID do modelo](https://omp.itsneufox.com/pt-BR/docs/scripting/resources/skins) que o ator deve ter. |
| Float:x | A coordenada X onde criar o ator. |
| Float:y | A coordenada Y onde criar o ator. |
| Float:z | A coordenada Z onde criar o ator. |
| Float:angle | O ângulo de direção (rotação) que o ator deve ter. |

## Retorno

O ID do ator criado (começando em 0).

INVALID\_ACTOR\_ID (65535) se o limite de atores (1000) for atingido.

## Exemplos

```c
new gActorCJ;

public OnGameModeInit()
{
    // Cria um ator (CJ) em Blueberry Acres (Centro do mapa SA)
    gActorCJ = CreateActor(0, 0.0, 0.0, 3.0, 0.0);
}

public OnGameModeExit()
{
    // Destrói nosso querido ator (CJ)
    DestroyActor(gActorCJ);
}
```

## Notas

nota

-   Atores são projetados para apenas ficar em algum lugar, por exemplo caixas e bartenders. Eles podem executar animações (uma vez ou em loop) usando [ApplyActorAnimation](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/ApplyActorAnimation).
-   Atores são invulneráveis por padrão.

aviso

-   Atores são completamente separados dos NPCs. Eles NÃO usam IDs/slots de jogadores no servidor e NÃO PODEM ser manipulados como NPCs. Atores são limitados a 1000 (MAX\_ACTORS).
-   Atores podem ser empurrados por veículos, use um timer para colocá-los de volta em suas posições.

## Funções Relacionadas

-   [DestroyActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DestroyActor): Destrói um ator.
-   [SetActorPos](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorPos): Define a posição de um ator.
-   [GetActorPos](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorPos): Obtém a posição de um ator.
-   [GetActorSpawnInfo](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorSpawnInfo): Obtém o ponto de spawn inicial do ator.
-   [SetActorFacingAngle](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorFacingAngle): Define o ângulo de direção de um ator.
-   [GetActorFacingAngle](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorFacingAngle): Obtém o ângulo de direção de um ator.
-   [SetActorVirtualWorld](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorVirtualWorld): Define o mundo virtual de um ator.
-   [GetActorVirtualWorld](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorVirtualWorld): Obtém o mundo virtual de um ator.
-   [ApplyActorAnimation](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/ApplyActorAnimation): Aplica uma animação a um ator.
-   [ClearActorAnimations](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/ClearActorAnimations): Limpa todas as animações aplicadas a um ator.
-   [GetActorAnimation](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorAnimation): Obtém a animação que o ator está executando atualmente.
-   [GetPlayerCameraTargetActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerCameraTargetActor): Obtém o ID do ator (se houver) que um jogador está olhando.
-   [IsActorStreamedIn](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsActorStreamedIn): Verifica se um ator está transmitido para um jogador.
-   [SetActorSkin](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorSkin): Define a skin do ator.
-   [GetActorSkin](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorSkin): Obtém a skin do ator.
-   [SetActorHealth](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorHealth): Define a vida de um ator.
-   [GetActorHealth](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorHealth): Obtém a vida de um ator.
-   [SetActorInvulnerable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorInvulnerable): Define o ator como invulnerável.
-   [IsActorInvulnerable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsActorInvulnerable): Verifica se o ator é invulnerável.
-   [IsValidActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsValidActor): Verifica se o ID do ator é válido.
-   [GetActorPoolSize](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorPoolSize): Obtém o maior actorid criado no servidor.
-   [GetPlayerTargetActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerTargetActor): Obtém o ID de um ator que está sendo mirado por um determinado jogador.

## Callbacks Relacionados

-   [OnActorStreamIn](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnActorStreamIn): Chamado quando um ator é transmitido para um jogador.
-   [OnActorStreamOut](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnActorStreamOut): Chamado quando um ator para de ser transmitido para um jogador.
-   [OnPlayerGiveDamageActor](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerGiveDamageActor): Este callback é chamado quando um jogador causa dano a um ator.