CreateActor
atenção
This function was added in SA-MP 0.3.7 and will not work in earlier versions!
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 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
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
dica
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.
atenção
- 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.
- Atores são invulneráveis por padrão.
Funções Relacionadas
- DestroyActor: Destrói um ator.
- SetActorPos: Define a posição de um ator.
- GetActorPos: Obtém a posição de um ator.
- GetActorSpawnInfo: Obtém o ponto de spawn inicial do ator.
- SetActorFacingAngle: Define o ângulo de direção de um ator.
- GetActorFacingAngle: Obtém o ângulo de direção de um ator.
- SetActorVirtualWorld: Define o mundo virtual de um ator.
- GetActorVirtualWorld: Obtém o mundo virtual de um ator.
- ApplyActorAnimation: Aplica uma animação a um ator.
- ClearActorAnimations: Limpa todas as animações aplicadas a um ator.
- GetActorAnimation: Obtém a animação que o ator está executando atualmente.
- GetPlayerCameraTargetActor: Obtém o ID do ator (se houver) que um jogador está olhando.
- IsActorStreamedIn: Verifica se um ator está transmitido para um jogador.
- SetActorSkin: Define a skin do ator.
- GetActorSkin: Obtém a skin do ator.
- SetActorHealth: Define a vida de um ator.
- GetActorHealth: Obtém a vida de um ator.
- SetActorInvulnerable: Define o ator como invulnerável.
- IsActorInvulnerable: Verifica se o ator é invulnerável.
- IsValidActor: Verifica se o ID do ator é válido.
- GetActorPoolSize: Obtém o maior actorid criado no servidor.
- GetPlayerTargetActor: Obtém o ID de um ator que está sendo mirado por um determinado jogador.
Callbacks Relacionados
- OnActorStreamIn: Chamado quando um ator é transmitido para um jogador.
- OnActorStreamOut: Chamado quando um ator para de ser transmitido para um jogador.
- OnPlayerGiveDamageActor: Este callback é chamado quando um jogador causa dano a um ator.