createCheckpoint
De IV:MP Brasil Wiki
| Função server-side Esta função pode ser utilizada somente no servidor. Consulte o artigo principal para mais informações sobre funções client-side e server-side. |
| A função createCheckpoint foi incluída na versão 0.1 Beta 1 do IV:MP. Esta função não irá funcionar em versões anteriores do IV:MP. |
Esta função é usada para criar um checkpoint. Para saber quando um jogador entra ou sai de um checkpoint, usamos os eventos playerEnterCheckpoint e playerLeaveCheckpoint.
Note que esta função apenas cria o checkpoint. Para mostrá-lo a um jogador, é preciso usar a função showCheckpointForPlayer ou showCheckpointForAll.
Consequentemente, para ocultar um checkpoint de um jogador, usamos hideCheckpointForPlayer ou hideCheckpointForAll.
Para verificar se um jogador está no checkpoint, usamos isPlayerInCheckpoint.
E finalmente, para destruir um checkpoint, usamos a função deleteCheckpoint.
Tabela de conteúdo |
Sintaxe
int createCheckpoint(int type, float x, float y, float z, float nextx, float nexty, float nextz, float radius)
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| type | integer | Tipo do checkpoint |
| x | float | Coordenada X do objeto |
| y | float | Coordenada Y do objeto |
| z | float | Coorenada Z do objeto |
| nextx | float | Coordenada X para onde a seta do checkpoint é apontada |
| nexty | float | Coordenada Y para onde a seta do checkpoint é apontada |
| nextz | float | Coordenada Z para onde a seta do checkpoint é apontada |
| radius | float | O tamanho do checkpoint |
Retorno
Esta função retorna um valor do tipo integer contendo o ID do checkpoint caso ele tenha sido criado. Caso o checkpoint não seja criado, retorna um valor booleano false.
Exemplo
Primeiramente criamos o checkpoint:
function onPlayerSpawn(playerid) { local id = createCheckpoint(CHECKPOINT_TYPE_ARROW_TUBE, 123.0, 123.0, 12.0, 123.0, 123.0, 12.0, 5.0); showCheckpointForPlayer(playerid, id); sendPlayerMessage(playerid, "Vá ao checkpoint para iniciar a missão."); return 1; }
Para depois então verificar quando o jogador entra no checkpoint (note que estamos usando eventos aqui. Para saber como validar um evento, veja a função addEvent):
function onPlayerEnterCheckpoint(playerid, checkpoint) { sendPlayerMessage(playerid, "Você iniciou a primeira missão."); return 1; }
Tipos
| Tipo | Constante | Descrição |
|---|---|---|
| 2 | CHECKPOINT_TYPE_ARROW_TUBE | Checkpoint cilíndrico com uma seta |
| 3 | CHECKPOINT_TYPE_FLAG_TUBE | Checkpoint cilíndrico de linha de chegada |
| 4 | CHECKPOINT_TYPE_ARROW_CORONA | Checkpoint circular (coroa/corona) com uma seta |
| 5 | CHECKPOINT_TYPE_FLAG_CORONA | Checkpoint circular (coroa/corona) de linha de chegada |
| 6 | CHECKPOINT_TYPE_ARROW | Checkpoint com apenas uma seta |
| 7 | CHECKPOINT_TYPE_CORONA | Checkpoint com apenas a bandeira de linha de chegada |
Relacionado
Conteúdo relacionado a esta página.
- deleteCheckpoint: Remove um checkpoint anteriormente criado.
- showCheckpointForPlayer: Mostra um checkpoint anteriormente criado para um jogador.
- showCheckpointForAll: Mostra um checkpoint anteriormente criado para os jogadores.
- hideCheckpointForPlayer: Oculta um checkpoint de um determinado jogador.
- hideCheckpointForAll: Oculta um checkpoint para os jogadores do servidor.
- isPlayerInCheckpoint: Verifica se um jogador está dentro de um checkpoint.
- playerEnterCheckpoint: Evento chamado quando um jogador entra em um checkpoint.
- playerLeaveCheckpoint: Evento chamado quando um jogador sai de um checkpoint.
