Entidade
Nomes e procura. As entidades são ids numéricos; o nome é opcional e não tem de ser único.
Namespace: caffeine.entity · Dryad prefix: caffeine_entity_
name#
Lua: caffeine.entity.name · Dryad: caffeine_entity_name
name(entity) -> string
Lê o nome de editor de uma entidade.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
Devolve: string. O nome, ou texto vazio se não tiver nome ou estiver morta.
Exemplo
print(caffeine.entity.name(eid))
setName#
Lua: caffeine.entity.setName · Dryad: caffeine_entity_set_name
setName(entity, name) -> boolean
Dá um nome a uma entidade para a poder encontrar depois.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
name | string | Novo nome, até 63 caracteres. |
Devolve: boolean. false se a entidade não estiver viva.
Exemplo
caffeine.entity.setName(eid, "Boss")
find#
Lua: caffeine.entity.find · Dryad: caffeine_entity_find
find(name) -> number
Encontra uma entidade pelo nome.
| Parâmetros | Tipo | Descrição |
|---|---|---|
name | string | Nome exato a procurar. |
Devolve: number. O menor id que corresponde, ou 0 se nenhum.
Exemplo
local boss = caffeine.entity.find("Boss")
findAll#
Lua: caffeine.entity.findAll · Dryad: caffeine_entity_find_all
findAll(name) -> table
Encontra todas as entidades com um nome.
| Parâmetros | Tipo | Descrição |
|---|---|---|
name | string | Nome exato a procurar. |
Devolve: table. Array de ids que correspondem, por ordem crescente (vazio se nenhum).
Exemplo
for _, id in ipairs(caffeine.entity.findAll("Coin")) do caffeine.world.destroy(id) end
isAlive#
Lua: caffeine.entity.isAlive
isAlive(entity) -> boolean
Indica se um id ainda refere uma entidade viva. Dryad: usar caffeine_world_is_alive.
| Parâmetros | Tipo | Descrição |
|---|---|---|
entity | number | O id da entidade. |
Devolve: boolean. true se a entidade existir.
Exemplo
if caffeine.entity.isAlive(target) then end