Navegação
Agentes de navegação: destinos, pontos de patrulha, alvos a seguir e scripts de comportamento.
Namespace: caffeine.navigation
setDestination#
Lua: caffeine.navigation.setDestination
setDestination(entity, x, y, z) -> boolean
Define o destino do agente no espaço do mundo.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | Id da entidade. |
x | number | X no mundo. |
y | number | Y no mundo. |
z | number | Z no mundo. |
Devolve: boolean. true em caso de sucesso.
Exemplo
caffeine.navigation.setDestination(npc, 10, 0, 5)
setMode#
Lua: caffeine.navigation.setMode
setMode(entity, mode) -> boolean
Define o modo de navegação do agente.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | Id da entidade. |
mode | string | "patrol", "follow" ou "scripted"; qualquer outro valor significa idle. |
Devolve: boolean. true em caso de sucesso.
Exemplo
caffeine.navigation.setMode(npc, 'patrol')
addPatrolPoint#
Lua: caffeine.navigation.addPatrolPoint
addPatrolPoint(entity, x, y, z) -> boolean
Acrescenta um ponto à rota de patrulha do agente.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | Id da entidade. |
x | number | X no mundo. |
y | number | Y no mundo. |
z | number | Z no mundo. |
Devolve: boolean. true em caso de sucesso.
Exemplo
caffeine.navigation.addPatrolPoint(npc, 0, 0, 0)
setFollowTarget#
Lua: caffeine.navigation.setFollowTarget
setFollowTarget(entity, targetId) -> boolean
Define a entidade que o agente segue.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | Id da entidade. |
targetId | number | Id da entidade a seguir. |
Devolve: boolean. true em caso de sucesso.
Exemplo
caffeine.navigation.setFollowTarget(npc, player)
setBehaviorScript#
Lua: caffeine.navigation.setBehaviorScript
setBehaviorScript(entity, path) -> boolean
Define o script que controla o agente no modo scripted.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | Id da entidade. |
path | string | Caminho do script de comportamento. |
Devolve: boolean. true em caso de sucesso.
Exemplo
caffeine.navigation.setBehaviorScript(npc, 'scripts/ai.lua')