Hierarquia
Ligações pai e filho entre entidades. O transform do filho compõe-se com o do pai.
Namespace: caffeine.hierarchy · Dryad prefix: caffeine_hierarchy_
parent#
Lua: caffeine.hierarchy.parent · Dryad: caffeine_hierarchy_parent
parent(entity) -> number
Devolve o pai de uma entidade.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
Devolve: number. O id do pai, ou 0 se não tiver.
Exemplo
local p = caffeine.hierarchy.parent(eid)
setParent#
Lua: caffeine.hierarchy.setParent · Dryad: caffeine_hierarchy_set_parent
setParent(entity, parent) -> boolean
Liga uma entidade por baixo de outra.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O filho. |
parent | number | O novo pai; 0 desliga. |
Devolve: boolean. false se uma das entidades estiver morta, o pai for a própria entidade ou a ligação criar um ciclo.
Exemplo
caffeine.hierarchy.setParent(wheel, car)
detach#
Lua: caffeine.hierarchy.detach · Dryad: caffeine_hierarchy_detach
detach(entity) -> boolean
Remove a ligação ao pai.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
Devolve: boolean. false se a entidade estiver morta.
Exemplo
caffeine.hierarchy.detach(wheel)
children#
Lua: caffeine.hierarchy.children · Dryad: caffeine_hierarchy_children
children(entity) -> table
Lista os filhos diretos de uma entidade.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
Devolve: table. Array de ids dos filhos diretos, por ordem crescente.
Exemplo
for _, c in ipairs(caffeine.hierarchy.children(car)) do end
childCount#
Lua: caffeine.hierarchy.childCount · Dryad: caffeine_hierarchy_child_count
childCount(entity) -> number
Conta os filhos diretos.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
Devolve: number. Número de filhos diretos.
Exemplo
local n = caffeine.hierarchy.childCount(car)
root#
Lua: caffeine.hierarchy.root · Dryad: caffeine_hierarchy_root
root(entity) -> number
Sobe até ao topo da hierarquia.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
Devolve: number. O antepassado de topo (a própria entidade se não tiver pai).
Exemplo
local top = caffeine.hierarchy.root(wheel)