Este guia aborda os comandos do console headless, gerenciamento de mundos, funções de usuário, o NeosModLoader e solução de problemas para o seu servidor dedicado NeosVR. NeosVR é um metaverso social de VR com poderosas ferramentas de criação. Para configuração inicial, configuração do Config.json e instruções de conexão, consulte o Guia de Configuração do Servidor NeosVR.
1. Acessando o Console
Gerencie seu servidor headless NeosVR através da aba Console no GPanel. Todos os comandos são digitados diretamente no console.
2. Comandos do Console Headless
Gerenciamento de Mundos
| Comando | Descrição |
|---|---|
worlds | Lista todos os mundos em execução com seus índices. |
focus <world_index> | Alterna o foco para um mundo específico pelo índice. |
startWorldURL <record_url> | Inicia um novo mundo a partir de uma URL de registro do Neos. |
startWorldTemplate <template> | Inicia um mundo a partir de um template integrado (ex.: SpaceWorld). |
save | Salva o mundo atualmente em foco. |
close | Fecha o mundo atualmente em foco. |
restart | Reinicia o mundo atualmente em foco. |
Gerenciamento de Sessão
| Comando | Descrição |
|---|---|
sessionURL | Exibe a URL da sessão do mundo em foco. |
sessionID | Exibe o ID da sessão do mundo em foco. |
name <new_name> | Altera o nome da sessão do mundo em foco. |
accessLevel <level> | Altera o nível de acesso: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Define o número máximo de usuários para a sessão. |
hideFromListing <true/false> | Alterna a visibilidade no navegador público de sessões. |
description <text> | Define a descrição da sessão. |
Gerenciamento de Usuários
| Comando | Descrição |
|---|---|
users | Lista todos os usuários no mundo em foco. |
kick <username> | Expulsa um usuário do mundo. |
ban <username> | Bane um usuário do mundo. |
silence <username> | Silencia um usuário (muta a voz dele). |
unsilence <username> | Remove o silenciamento de um usuário previamente mutado. |
respawn <username> | Reaparece um usuário no ponto de spawn do mundo. |
role <username> <role> | Atribui uma função a um usuário (veja a Seção 3). |
Controle do Servidor
| Comando | Descrição |
|---|---|
status | Exibe o status do servidor e uso de recursos. |
shutdown | Desliga o servidor headless de forma segura. |
gc | Força a coleta de lixo para liberar memória. |
tickRate <rate> | Altera a taxa de tick do servidor em tempo de execução. |
3. Funções de Usuário
O NeosVR utiliza uma hierarquia de funções para permissões do mundo:
| Função | Descrição |
|---|---|
Admin | Controle total do mundo. Pode modificar qualquer coisa, gerenciar usuários e alterar configurações do mundo. |
Builder | Pode criar e editar objetos no mundo. |
Moderator | Pode expulsar/banir usuários e gerenciar configurações da sessão. |
Guest | Acesso básico. Pode interagir com objetos existentes, mas não pode construir. |
Spectator | Acesso somente visualização. Não pode interagir com o mundo. |
Atribua funções pelo console: role <username> Admin
Você também pode definir funções padrão no Config.json usando a configuração defaultUserRoles.
4. NeosModLoader
O NeosModLoader permite carregar mods feitos pela comunidade no servidor headless.
- Defina ENABLE_MODLOADER como
truenas variáveis de Startup do GPanel. - Baixe os mods do GitHub do NeosModLoader.
- Envie os arquivos
.dlldos mods para o diretórionml_mods/via SFTP. - Reinicie o servidor para carregar os mods.
5. Solução de Problemas
Servidor Não Inicia
- Verifique se o seu STEAM_USER e STEAM_PASS estão corretos.
- Certifique-se de que o SRCDS_BETAPASS (senha beta do headless) está atualizado a partir do Discord do Patreon do Neos.
- Se estiver usando Steam Guard 2FA, forneça o código em STEAM_AUTH e reinicie prontamente.
Mundo Não Carrega
- Verifique se o
Config.jsoné um JSON válido (sem vírgulas extras, colchetes corretos). - Verifique se o
loginCredentiale ologinPasswordestão definidos corretamente emConfig/Config.json. - Certifique-se de que a URL do mundo ou o nome do preset é válido.
Usuários Não Conseguem Entrar
- Verifique se o
accessLevelnão está definido comoPrivate, a menos que seja intencional. - Verifique se o
maxUsersnão foi atingido. - Certifique-se de que o headless está logado (verifique a saída do console para confirmação de login).
Artigos Relacionados
- Guia de Configuração do Servidor NeosVR
- Como Encontrar o IP e a Porta do Seu Servidor
- Como Enviar Arquivos via SFTP
Precisa de Ajuda?
Se você encontrar problemas com o seu servidor NeosVR que não estão cobertos aqui, abra um ticket de suporte e inclua o IP do seu servidor, uma descrição do problema e quaisquer mensagens de erro relevantes do console do GPanel.
