Ir para o conteúdo principal
Version: latest - a1.7.0 ⚖️

Guia de pacotes

Os pacotes são pedaços/componentes de seu servidor que executarão scripts Lua para interagir com o jogo.

Cada pacote está isolado e tem sua própria Máquina Virtual Lua, Isto significa que cada um tem o seu próprio âmbito global e que não pode aceder directamente a outros dados.

Estrutura da pasta

Todos os Pacotes devem estar sob a pasta Servidor/Pacotes/ , cada Pacote é uma pasta sob isso.

Eles podem conter as seguintes pastas: Servidor, Cliente e Compartilhados. Somente Clientes e Compartilhados pastas serão enviadas e carregadas pelos clientes quando se conectarem.

Cada pacote deve ter um arquivo chamado Index. ua dentro de Servidor, Cliente ou pastas compartilhadas Este é o único arquivo que será acionado quando o pacote for carregado, desta forma este arquivo é responsável por incluir outros arquivos e iniciar suas funcionalidades.

Server Folder
NanosWorldServer.exe
Packages/
├── My_Package_01/
│ ├── Server/
│ │ ├── Index.lua
│ │ └── *.lua
│ ├── Client/
│ │ └── *.lua
│ ├── Shared/
│ │ └── *.lua
│ └── Package.toml
├── My_Package_02/
│ ├── Package.toml
│ └── ...
Ativos/
Config.toml

Configuração do pacote

Os pacotes têm um arquivo de configuração na raiz da pasta de pacotes, chamado de pacote. oml, neste arquivo, podemos configurar todas as configurações pertinentes relacionadas ao Pacote:

Package.toml
loading...

Configurações Detalhadas

ConfiguraçãoDescription
NomeNome amigável do pacote
autorAutor(s) do pacote
VersãoVersão do pacote - por favor, consulte o SemVer
ImagemURL da imagem a ser exibida no Cofre
TipoTipo de pacote - por favor consulte Tipos de pacote
forçar_nenhum_roteador_de_mapaAo ativar irá forçar o script do mapa (se houver) a NÃO carregar
limpeza_automáticaAtivando isto irá destruir todas as entidades criadas por este pacote quando ele descarrega
requisitos_pacotesLista de pacotes que precisam ser carregados primeiro
requisitos_ativosLista de Pacotes de Conteúdo a serem carregados quando este pacote carrega

Tipos de Pacotes

Em nanos mundo temos 3 tipos de pacotes: script, modo de jogo e tela de carregamento, cada um com uma funcionalidade específica e propósitos exclusivos.

TypeDescription
scriptPacote normal, irá executar seus scripts e iniciar um novo Lua VM quando iniciado.
modo-jogoComo script , mas você só pode carregar um pacote modo de jogo de uma só vez.
Útil quando você está criando jogos completos, que não podem correr o risco de ser
carregados com outros pacotes de jogos completos.
carregando-telaSpecial Package which will be loaded during player's loading screen.
Those packages must have an Index.html in the root.
Please refer to Loading Screen for more information.
tip

Se você estiver criando uma Biblioteca, uma Ferramenta ou algum pacote Utilitário , torná-lo script!

Se você estiver criando um jogo único e completo com várias funcionalidades que você não quer que sejam implicadas se alguém carregar dois jogos completos, torná-lo modo de jogo!