Este guia abrange os comandos da consola headless, gestão de sessões, configuração do mod loader e resolução de problemas para o seu servidor Resonite. Para a configuração inicial, consulte o Guia de Configuração do Servidor Headless Resonite.
1. Comandos da Consola Headless
O servidor headless Resonite aceita comandos através da consola do GPanel. O servidor responde ao comando shutdown para encerramento gracioso.
| Comando | Descrição |
|---|---|
worlds |
Listar todas as sessões de mundo ativas. |
focus <world_index> |
Focar num mundo específico para executar comandos. |
status |
Mostrar o estado do mundo focado. |
users |
Listar utilizadores no mundo focado. |
kick <username> |
Expulsar um utilizador do mundo focado. |
ban <username> |
Banir um utilizador do mundo focado. |
silence <username> |
Silenciar um utilizador no mundo focado. |
unsilence <username> |
Remover silêncio de um utilizador. |
respawn <username> |
Reaparecer um utilizador na origem do mundo. |
role <username> <role> |
Definir a função de um utilizador (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Renomear a sessão focada. |
accessLevel <level> |
Alterar quem pode entrar (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Alterar o número máximo de utilizadores para o mundo focado. |
save |
Guardar o mundo focado. |
close |
Fechar o mundo focado. |
restart |
Reiniciar o mundo focado. |
invite <username> |
Convidar um utilizador para o mundo focado. |
message <text> |
Enviar uma mensagem para o mundo focado. |
shutdown |
Encerrar graciosamente todo o servidor headless. |
2. Níveis de Acesso
Controle quem pode entrar nas suas sessões de mundo com a definição accessLevel:
| Nível | Descrição |
|---|---|
| Anyone | Aberto a todos os utilizadores Resonite. |
| RegisteredUsers | Apenas contas Resonite registadas. |
| Contacts | Apenas utilizadores na lista de contactos da conta headless. |
| ContactsPlus | Contactos e contactos de contactos. |
| Private | Apenas por convite. |
3. Funções de Utilizador
Atribua funções para controlar o que os utilizadores podem fazer no seu mundo:
| Função | Descrição |
|---|---|
| Admin | Controlo total sobre o mundo. |
| Builder | Pode construir e modificar objetos. |
| Moderator | Pode expulsar/banir utilizadores e moderar o chat. |
| Guest | Acesso padrão de utilizador. |
| Spectator | Pode observar mas não interagir. |
Defina funções predefinidas no Config.json utilizando defaultUserRoles ou atribua-as por utilizador com o comando role na consola.
4. Múltiplos Mundos
O servidor headless pode alojar múltiplos mundos simultaneamente. Adicione entradas adicionais ao array startWorlds em Headless/Config/Config.json:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]Utilize focus 0 e focus 1 na consola para alternar entre mundos.
5. Mod Loader
O Resonite suporta mods através do ResoniteModLoader. Para ativar:
- Defina
ENABLE_MODLOADERcomotrueno separador Startup. - Reinstale ou reinicie o servidor -- os DLLs do mod loader serão descarregados automaticamente.
- Coloque os DLLs dos mods no diretório
rml_mods/via SFTP. - Reinicie o servidor para carregar os mods.
Ficheiros do mod loader:
Libraries/ResoniteModLoader.dll-- O mod loader principal.rml_libs/0Harmony.dll-- Dependência necessária.rml_mods/-- Coloque os DLLs dos seus mods aqui.
6. Resolução de Problemas
- Servidor não inicia: Verifique se as credenciais de login no
Config.jsonestão corretas. O headless deve autenticar-se com uma conta Resonite válida. - Mundo não aparece no navegador: Verifique se
hideFromPublicListingnão está definido comotrue. Certifique-se de que oaccessLevelpermite os utilizadores que estão a pesquisar. - "World running..." não aparece: Verifique a consola para erros. O nome do mundo predefinido pode estar incorreto.
- Mods não carregam: Verifique se
ENABLE_MODLOADERestá comotruee se os DLLs dos mods estão emrml_mods/. Verifique a consola para erros do mod loader. - Uso elevado de recursos: Reduza o
tickRatenoConfig.jsonou diminuamaxConcurrentAssetTransfers. Conteúdo complexo criado pelos utilizadores pode consumir muitos recursos.
Artigos Relacionados
- Guia de Configuração do Servidor Headless Resonite
- Como Encontrar o IP e a Porta do Seu Servidor
- Como Enviar Ficheiros via SFTP
Precisa de Ajuda?
Se precisar de assistência adicional, abra um ticket de suporte com os detalhes do seu servidor e quaisquer mensagens de erro da consola do GPanel.
