135 lines
5.7 KiB
Plaintext
135 lines
5.7 KiB
Plaintext
API do gestor
|
|
=============
|
|
|
|
As funcionalidades do gestor estao descritas com foco para desenvolvimento de mods de apoio
|
|
|
|
|
|
======================================> Lugares Avulsos <======================================
|
|
Esses lugares sao estruturas que precisam ser montadas para o funcionamento de uma aventura ou
|
|
tarefa dos jogadores. O gestor pode informar essa estrutura e seu status de atividade
|
|
(OK ou PENDENTE) para o administrador acompanhada de um texto sobre a estrutura que pode ser
|
|
usado para informar um comando ou metodo facil para o administrador criar a estrutura.
|
|
|
|
Sintaxe
|
|
gestor.lugares_avulsos.definir(nome, status, texto)
|
|
|
|
* Todas as variaveis sao obrigatorias (nome, status, texto)
|
|
|
|
* Variavel nome deve ser uma cadeia de caracteres para o nome do lugar
|
|
|
|
* Variavel status deve ser do tipo boleano para definir o estado do lugar onde true serve
|
|
para OK e false serve para PENDENTE
|
|
|
|
* Variavel texto deve ser uma cadeia de caracteres que serve para definir um texto sobre o
|
|
lugar e como criar o lugar por meio de comandos ou qualquer outro metodo que quiser informar.
|
|
Jamais use a barra invertida ("\") nesse texto pois isso corrompe o banco de dados do gestor.
|
|
Exemplo:
|
|
Esse lugar se trata de uma vila onde o jogador troca madeira por qualquer outra coisa. Use o
|
|
comando /montar e aguarde o termino
|
|
|
|
Exemplo de uso:
|
|
|
|
-- Nome da estrutura acompanha o nome do mod (para evitar nomes iguais entre os mods)
|
|
local nome_estrutura = minetest.get_current_modname() .. "_castelo"
|
|
|
|
-- Texto explicativo da estrutura
|
|
local texto = "Castelo do norte. Use /"..nome_estrutura.."_instalar par montar a estrutura"
|
|
|
|
-- Verifica se ja existe o se nao existir, cria
|
|
if not gestor.registros.lugares["avulsos"][nome_estrutura] then
|
|
gestor.lugares_avulsos.definir(nome_estrutura, false, texto)
|
|
end
|
|
|
|
-- Verifica se ja foi criada e toma uma atitude
|
|
if gestor.registros.lugares["avulsos"][nome_estrutura].status == false then
|
|
|
|
-- Bloco de algoritimos
|
|
|
|
gestor.lugares_avulsos.definir(nome_estrutura, false, "Castelo do mal")
|
|
end
|
|
|
|
===============================================================================================
|
|
|
|
|
|
|
|
================================> Serializar/Salvar estrutura <================================
|
|
Esse método é usado para serializar uma estrutura dentro da pasta estruturas de um mod que a
|
|
executa
|
|
|
|
Sintaxe
|
|
gestor.estruturador.salvar(pos, nome, largura, altura, modp, silencio)
|
|
|
|
* Variaveis pos, nome, largura e altura sao obrigatorias e caso as outros 3 (largura, altura,
|
|
modp) não sejam definidas, elas serão pesquisadas com base na tabela de estruturas do proprio
|
|
gestor
|
|
|
|
* Variavel pos é uma coordenada do ponto onde a estrutura vai ser lida sendo que ela sempre
|
|
é lida a partir dessa coordenada e vai para os valores positivos
|
|
|
|
* Variavel nome é uma string do nome do arquivo que vai ser gerado na pasta estruturas do mod
|
|
que a executa.
|
|
|
|
* As variaveis largura e altura são valores numéricos para definir as dimensoes da estrutura
|
|
que o metodo vai ler para salvar
|
|
|
|
* Variavel modp é uma string com o caminho do diretório do mod que executa esse metodo
|
|
|
|
* Variavel silencio é um valor boleano caso queira evitar mensagens no console do servidor
|
|
(usado para operar de forma sistemica)
|
|
===============================================================================================
|
|
|
|
|
|
|
|
======================================> Criar estrutura <======================================
|
|
Esse metodo é usado para criar estruturas a partir de arquivos de estruturas previamente
|
|
serializadas pelo mod gestor.
|
|
|
|
Sintaxe
|
|
gestor.estruturador.carregar(pos, nome, largura, altura, modp, silencio)
|
|
|
|
* Variaveis pos e nome sao obrigatorias e caso as outros 3 (largura, altura, modp) não sejam
|
|
definidas, elas serão pesquisadas com base na tabela de estruturas do proprio gestor
|
|
|
|
* Variavel pos é uma coordenada do ponto onde a estrutura vai ser montada sendo que ela sempre
|
|
é montada a partir dessa coordenada e vai para os valores positivos
|
|
|
|
* Variavel nome é uma string para um nome do arquivo da estrutura serializada que deve
|
|
obrigatóriamente estar em uma pasta chamada estruturas dentro da pasta do mod que usar esse
|
|
metodo
|
|
|
|
* As variaveis largura e altura são valores numéricos para definir as dimensoes da estrutura
|
|
que o metodo vai montar
|
|
|
|
* Variavel modp é uma string com o caminho do diretório do mod que executa esse metodo
|
|
|
|
* Variavel silencio é um valor boleano caso queira evitar mensagens no console do servidor
|
|
(usado para operar de forma sistemica)
|
|
===============================================================================================
|
|
|
|
|
|
|
|
======================================> Proteger Areas <======================================
|
|
Primeiramente esse metodo precisa so funciona com mod areas. Esse metodo protege uma area e
|
|
caso ocorra alguma falha ao proteger uma area ele retorna uma string explicando a falha e caso
|
|
de tudo certo ele retorna boleano verdadeiro (true)
|
|
|
|
Sintaxe
|
|
gestor.proteger_area(NomeAdmin, NomeDono, NomeArea, pos1, pos2, silencio)
|
|
|
|
* Todas as variaveis sao obrigatorias
|
|
|
|
* Variavel NomeAdmin deve ser string do nome de um jogador com privilegios para registrar areas
|
|
|
|
* Variavel NomeDono deve ser string do nome de um jogador que vai poder interagir na area e
|
|
adicionar uma subarea para outro jogador
|
|
|
|
* Variavel NomeArea deve ser string de uma nome qualquer para a area criada e vai aparecer na
|
|
lista de areas com esse nome (pode ser um nome igual ao de outras areas)
|
|
|
|
* As variaveis pos1 e pos2 são tabelas de vetores de cordenadas ({x,y,z}) que delimitam a area
|
|
a ser protegida (tanto faz qual tem o menor valor de x, y ou z)
|
|
|
|
* Variavel silencio é um valor boleano caso queira evitar mensagens no console do servidor
|
|
(usado para operar de forma sistemica)
|
|
===============================================================================================
|