Este guia abrange os comandos da consola headless, gestão de mundos, funções de utilizador, o NeosModLoader e resolução de problemas para o seu servidor dedicado NeosVR. O 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 ligação, consulte o Guia de Configuração do Servidor NeosVR.
1. Aceder à Consola
Gira o seu servidor headless NeosVR através do separador Console no GPanel. Todos os comandos são digitados diretamente na consola.
2. Comandos da Consola Headless
Gestão de Mundos
| Comando | Descrição |
|---|---|
worlds | Listar todos os mundos em execução com os seus índices. |
focus <world_index> | Mudar o foco para um mundo específico por índice. |
startWorldURL <record_url> | Iniciar um novo mundo a partir de um URL de registo Neos. |
startWorldTemplate <template> | Iniciar um mundo a partir de um modelo integrado (ex.: SpaceWorld). |
save | Guardar o mundo atualmente focado. |
close | Fechar o mundo atualmente focado. |
restart | Reiniciar o mundo atualmente focado. |
Gestão de Sessões
| Comando | Descrição |
|---|---|
sessionURL | Mostrar o URL da sessão para o mundo focado. |
sessionID | Mostrar o ID da sessão para o mundo focado. |
name <new_name> | Alterar o nome da sessão do mundo focado. |
accessLevel <level> | Alterar o nível de acesso: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Definir o número máximo de utilizadores para a sessão. |
hideFromListing <true/false> | Alternar a visibilidade no navegador de sessões públicas. |
description <text> | Definir a descrição da sessão. |
Gestão de Utilizadores
| Comando | Descrição |
|---|---|
users | Listar todos os utilizadores no mundo focado. |
kick <username> | Expulsar um utilizador do mundo. |
ban <username> | Banir um utilizador do mundo. |
silence <username> | Silenciar um utilizador (desativar a sua voz). |
unsilence <username> | Reativar o som de um utilizador previamente silenciado. |
respawn <username> | Reaparecer um utilizador no ponto de spawn do mundo. |
role <username> <role> | Atribuir uma função a um utilizador (ver Secção 3). |
Controlo do Servidor
| Comando | Descrição |
|---|---|
status | Mostrar o estado do servidor e utilização de recursos. |
shutdown | Encerrar o servidor headless de forma graciosa. |
gc | Forçar a recolha de lixo para libertar memória. |
tickRate <rate> | Alterar a taxa de ticks do servidor em tempo de execução. |
3. Funções de Utilizador
O NeosVR utiliza uma hierarquia de funções para permissões de mundo:
| Função | Descrição |
|---|---|
Admin | Controlo total do mundo. Pode modificar tudo, gerir utilizadores e alterar definições do mundo. |
Builder | Pode criar e editar objetos no mundo. |
Moderator | Pode expulsar/banir utilizadores e gerir definições da sessão. |
Guest | Acesso básico. Pode interagir com objetos existentes, mas não pode construir. |
Spectator | Acesso apenas de visualização. Não pode interagir com o mundo. |
Atribua funções através da consola: role <username> Admin
Também pode definir funções predefinidas no Config.json utilizando a definiçã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. - Transfira mods a partir do GitHub do NeosModLoader.
- Carregue os ficheiros
.dlldos mods para o diretórionml_mods/via SFTP. - Reinicie o servidor para carregar os mods.
5. Resoluçã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 (palavra-passe beta do headless) está atualizado a partir do Discord Patreon do Neos.
- Se estiver a utilizar Steam Guard 2FA, forneça o código em STEAM_AUTH e reinicie rapidamente.
Mundo Não Carrega
- Verifique se o
Config.jsoné JSON válido (sem vírgulas finais, parênteses corretos). - Verifique se o
loginCredentiale ologinPasswordestão definidos corretamente emConfig/Config.json. - Certifique-se de que o URL do mundo ou o nome do preset é válido.
Utilizadores 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á com sessão iniciada (verifique a saída da consola 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 Carregar Ficheiros via SFTP
Precisa de Ajuda?
Se 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 da consola do GPanel.
