Ir para o conteúdo principal
Version: bleeding-edge 🩸

Tela de carregamento

In nanos world it is possible to add a customized and dynamic Loading Screen to your Server using WebUI.

Criando uma tela de carregamento

Para isso, você precisará criar um novo pacote do tipo carregando tela, e adicione seus arquivos HTML/CSS/JS na pasta raiz do pacote. Seu arquivo HTML principal deve ser chamado de index.html. Vai se parecer com isso:

Packages/
└── my-loading-screen/
├── Package.toml
├── index.html
├── style.css
└── ...

Obtendo Carregamento/Download em Progresso

Para ser capaz de exibir informações dinâmicas na tela, você pode ouvir o evento Atualização de tela (que irá acionar a cada alguns ms):

Evento Atualização da tela

ParameterDescription
MensagemExibir o estado atual (carregando, validando, baixando...)
mensagem_secundáriaExibir o arquivo/conteúdo atual a ser carregado ou baixado
progresso_pequenoProgresso pequeno atual
progresso_pequeno_totalProgresso máximo pequeno
ProgressoProgresso atual
progresso_totalValor máximo do progresso
estágio_atualA etapa atual da carga (carregando, baixando)
tip

DICA: Você pode usar progresso e progress_total para preencher a barra de carregamento principal, e progressos_small para uma barra de carregamento pequeno/sub.

info

Sempre usar de progresso / progress_total para obter a porcentagem atual % , como progresso_total pode representar a quantidade total de arquivos que estão sendo baixados, por exemplo.

Packages/my-loading-screen/index.js
Events.Subscribe("UpdateScreen", function(mensagem, message_secondary, progress_small, progress_small_total, progress, progress_total, current_stage) {
// Atualize seu HTML aqui
});

Player Information

Além disso, é possível buscar informações do jogador acessando uma variável global chamada LoadingScreen:

var LoadingScreen = {
server_ip,
server_name,
server_description,
server_port,
player_nanos_id,
player_nanos_username
};

Stop Menu Music

It is possible to turn off the built-in menu music by calling an event from Loading Screen JS:

Events.Call("StopMenuMusic")

Configurar seu servidor para usar a tela de carregamento

After creating your loading-screen package, you will need to configure your server to load it in your Config.toml. Basta definir a configuração loading_screen para o nome da pasta do seu pacote.

# pacote de carregamento da tela para carregar (a tela de carregamento será exibida quando os jogadores entrarem no servidor)
carregando_tela = "minha-carregando-tela"