Este guia aborda comandos do console headless, gerenciamento de sessões, configuração do mod loader e solução de problemas para seu servidor Resonite. Para a configuração inicial, consulte o Guia de Configuração do Servidor Headless Resonite.
1. Comandos do Console Headless
O servidor headless Resonite aceita comandos via console do GPanel. O servidor responde ao comando shutdown para desligamento gracioso.
| Comando | Descrição |
|---|---|
worlds |
Listar todas as sessões de mundo ativas. |
focus <world_index> |
Focar em um mundo específico para comandos. |
status |
Mostrar o status do mundo em foco. |
users |
Listar usuários no mundo em foco. |
kick <username> |
Expulsar um usuário do mundo em foco. |
ban <username> |
Banir um usuário do mundo em foco. |
silence <username> |
Silenciar um usuário no mundo em foco. |
unsilence <username> |
Remover o silenciamento de um usuário. |
respawn <username> |
Reaparecer um usuário na origem do mundo. |
role <username> <role> |
Definir o cargo de um usuário (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Renomear a sessão em foco. |
accessLevel <level> |
Alterar quem pode entrar (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Alterar o número máximo de usuários do mundo em foco. |
save |
Salvar o mundo em foco. |
close |
Fechar o mundo em foco. |
restart |
Reiniciar o mundo em foco. |
invite <username> |
Convidar um usuário para o mundo em foco. |
message <text> |
Enviar uma mensagem para o mundo em foco. |
shutdown |
Desligar graciosamente todo o servidor headless. |
2. Níveis de Acesso
Controle quem pode entrar nas sessões do seu mundo com a configuração accessLevel:
| Nível | Descrição |
|---|---|
| Anyone | Aberto a todos os usuários do Resonite. |
| RegisteredUsers | Apenas contas registradas do Resonite. |
| Contacts | Apenas usuários na lista de contatos da conta headless. |
| ContactsPlus | Contatos e contatos de contatos. |
| Private | Apenas por convite. |
3. Cargos de Usuários
Atribua cargos para controlar o que os usuários podem fazer no seu mundo:
| Cargo | Descrição |
|---|---|
| Admin | Controle total sobre o mundo. |
| Builder | Pode construir e modificar objetos. |
| Moderator | Pode expulsar/banir usuários e moderar o chat. |
| Guest | Acesso padrão de usuário. |
| Spectator | Pode observar mas não interagir. |
Defina cargos padrão no Config.json usando defaultUserRoles ou atribua-os por usuário com o comando role no console.
4. Múltiplos Mundos
O servidor headless pode hospedar múltiplos mundos simultaneamente. Adicione entradas adicionais ao array startWorlds no 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"
}
]Use focus 0 e focus 1 no console para alternar entre mundos.
5. Mod Loader
Resonite suporta mods através do ResoniteModLoader. Para habilitar:
- Defina
ENABLE_MODLOADERcomotruena aba Startup. - Reinstale ou reinicie o servidor -- os DLLs do mod loader serão baixados automaticamente.
- Coloque os DLLs dos mods no diretório
rml_mods/via SFTP. - Reinicie o servidor para carregar os mods.
Arquivos do mod loader:
Libraries/ResoniteModLoader.dll-- O mod loader principal.rml_libs/0Harmony.dll-- Dependência necessária.rml_mods/-- Coloque seus DLLs de mods aqui.
6. Solução de Problemas
- Servidor não inicia: Verifique se as credenciais de login no
Config.jsonestão corretas. O headless deve se autenticar 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 usuários que estão pesquisando. - "World running..." não aparece: Verifique se há erros no console. O nome do preset de mundo pode estar incorreto.
- Mods não carregam: Verifique se
ENABLE_MODLOADERestá comotruee se os DLLs dos mods estão emrml_mods/. Verifique o console para erros do mod loader. - Alto uso de recursos: Reduza o
tickRatenoConfig.jsonou diminua omaxConcurrentAssetTransfers. Conteúdo complexo criado por usuários 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 Arquivos via SFTP
Precisa de Ajuda?
Se precisar de mais assistência, abra um ticket de suporte com os detalhes do seu servidor e quaisquer mensagens de erro do console do GPanel.
