Caffeine

Entidade

Reference Core Última atualização: Lua 5 · Dryad 4

Nomes e procura. As entidades são ids numéricos; o nome é opcional e não tem de ser único.

Todos os namespaces

Namespace: caffeine.entity · Dryad prefix: caffeine_entity_

name#

Lua: caffeine.entity.name · Dryad: caffeine_entity_name

text
name(entity) -> string

Lê o nome de editor de uma entidade.

ParâmetrosTipoDescrição
entitynumberO id da entidade.

Devolve: string. O nome, ou texto vazio se não tiver nome ou estiver morta.

Exemplo

lua
print(caffeine.entity.name(eid))

setName#

Lua: caffeine.entity.setName · Dryad: caffeine_entity_set_name

text
setName(entity, name) -> boolean

Dá um nome a uma entidade para a poder encontrar depois.

ParâmetrosTipoDescrição
entitynumberO id da entidade.
namestringNovo nome, até 63 caracteres.

Devolve: boolean. false se a entidade não estiver viva.

Exemplo

lua
caffeine.entity.setName(eid, "Boss")

find#

Lua: caffeine.entity.find · Dryad: caffeine_entity_find

text
find(name) -> number

Encontra uma entidade pelo nome.

ParâmetrosTipoDescrição
namestringNome exato a procurar.

Devolve: number. O menor id que corresponde, ou 0 se nenhum.

Exemplo

lua
local boss = caffeine.entity.find("Boss")

findAll#

Lua: caffeine.entity.findAll · Dryad: caffeine_entity_find_all

text
findAll(name) -> table

Encontra todas as entidades com um nome.

ParâmetrosTipoDescrição
namestringNome exato a procurar.

Devolve: table. Array de ids que correspondem, por ordem crescente (vazio se nenhum).

Exemplo

lua
for _, id in ipairs(caffeine.entity.findAll("Coin")) do caffeine.world.destroy(id) end

isAlive#

Lua: caffeine.entity.isAlive

text
isAlive(entity) -> boolean

Indica se um id ainda refere uma entidade viva. Dryad: usar caffeine_world_is_alive.

ParâmetrosTipoDescrição
entitynumberO id da entidade.

Devolve: boolean. true se a entidade existir.

Exemplo

lua
if caffeine.entity.isAlive(target) then end