Este guia cobre configuração de admin, comandos de console, o sistema de pacotes Lua, gerenciamento de jogadores e veículos, e configuração de banco de dados para seu servidor dedicado de Onset na Legion Hosting. Para a configuração inicial do servidor, veja nosso Guia de Configuração do Servidor Onset.
Configuração de Admin
O Onset gerencia privilégios de administrador através de scripts Lua dentro dos pacotes do seu modo de jogo. Diferente de muitos jogos com sistemas de admin integrados, o Onset depende dos seus pacotes para definir quem tem permissões elevadas e o que essas permissões permitem.
A maioria dos pacotes de modo de jogo da comunidade inclui um sistema de admin. Normalmente, a configuração de admin envolve:
- Abra o File Manager no GPanel
- Navegue até o diretório do seu pacote (ex.:
packages/mygamemode/) - Localize o arquivo de configuração de admin (geralmente
config.lua,admins.luaou um arquivo de configuração JSON) - Adicione seu Steam64 ID ou ID de jogador in-game à lista de admins
- Salve o arquivo e reinicie o servidor
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Comandos do Console do Servidor
O Onset fornece comandos de console integrados que funcionam independentemente dos pacotes instalados. Eles podem ser inseridos diretamente no console do GPanel.
| Comando | Descrição |
|---|---|
help |
Lista todos os comandos de console disponíveis |
stop |
Para o servidor de forma segura |
restart |
Reinicia o servidor |
players |
Lista todos os jogadores conectados com seus IDs |
kick <playerid> [reason] |
Expulsa um jogador do servidor |
ban <playerid> [reason] |
Bane um jogador do servidor |
unban <steamid> |
Remove o banimento do Steam ID especificado |
package reload <name> |
Recarrega um pacote sem reiniciar o servidor |
package start <name> |
Inicia um pacote que não está em execução |
package stop <name> |
Para um pacote em execução |
package list |
Lista todos os pacotes carregados e seus status |
Sistema de Pacotes (Scripts Lua)
A jogabilidade do Onset é definida inteiramente por pacotes escritos em Lua. Cada pacote é uma pasta dentro do diretório packages/ contendo scripts Lua que executam no lado do servidor e/ou do cliente.
Estrutura do Pacote
packages/
mygamemode/
package.json <-- Package metadata and file declarations
server/
main.lua <-- Server-side entry point
commands.lua <-- Custom command handlers
client/
main.lua <-- Client-side entry point
ui.lua <-- User interface scriptsInstalando Pacotes
- Baixe o pacote dos fóruns da comunidade Onset ou repositórios do GitHub
- Conecte-se ao seu servidor via SFTP
- Faça upload da pasta do pacote para o diretório
packages/ - Abra o
server_config.jsonno File Manager - Adicione o nome da pasta do pacote ao array
"packages" - Reinicie o servidor pelo GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" são carregados na ordem em que estão listados. Se um pacote depende de outro, certifique-se de que a dependência esteja listada primeiro.
Gerenciamento de Jogadores
Além dos comandos integrados de kick e ban, a maioria dos pacotes de modo de jogo fornece recursos adicionais de gerenciamento de jogadores. Comandos comuns fornecidos por pacotes incluem:
| Comando (Dependente do Pacote) | Descrição |
|---|---|
/tp <player> |
Teleportar até outro jogador |
/bring <player> |
Teleportar outro jogador até sua localização |
/goto <x> <y> <z> |
Teleportar para coordenadas específicas do mundo |
/setadmin <player> <level> |
Definir o nível de admin de um jogador (se o pacote suportar níveis) |
/announce <message> |
Enviar um anúncio para todo o servidor |
Gerenciamento de Veículos
O Onset possui um sistema de veículos integrado que os pacotes podem estender. Admins frequentemente precisam gerenciar veículos spawnados para evitar acúmulo no servidor.
- Spawn de veículos — A maioria dos pacotes de RP permite que admins spawnem veículos via comandos como
/car <model> - Limpeza de veículos — Alguns pacotes incluem despawn automático para veículos abandonados ou comandos de admin como
/destroyvehicles - Limites de veículos — Configure o máximo de veículos por jogador para evitar lag por muitas entidades spawnadas
Banco de Dados (MariaDB)
O Onset suporta conexões de banco de dados MariaDB/MySQL para armazenamento persistente de dados. Isso é usado por pacotes de roleplay e outros modos de jogo para armazenar dados de jogadores, inventários, propriedades e mais.
A configuração do banco de dados é feita nos arquivos de configuração do seu pacote. Uma configuração típica:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Solução de Problemas
| Problema | Solução |
|---|---|
| Servidor inicia mas não há jogabilidade disponível | Você precisa de pelo menos um pacote de modo de jogo instalado e listado no server_config.json. Um servidor Onset básico não possui jogabilidade integrada. |
| Pacote falha ao carregar | Verifique o console do GPanel para mensagens de erro Lua. Causas comuns: package.json ausente, erros de sintaxe em arquivos Lua ou dependências faltando. |
| Erros de conexão com o banco de dados | Verifique suas credenciais do banco de dados, certifique-se de que o banco de dados existe e verifique se o serviço MariaDB está em execução. Teste a conectividade nos logs do console. |
| Servidor não visível no navegador | Certifique-se de que "visible": true está definido no server_config.json. Também verifique se a porta 7776 (TCP) está acessível para a porta de consulta. |
| Alta latência ou lag | Diminua o valor de streamdistance, reduza o tickrate se o uso de CPU estiver alto e verifique se há scripts Lua ineficientes nos seus pacotes. |
Artigos Relacionados
- Guia de Configuração do Servidor Onset
- Como Encontrar o IP e a Porta do Seu Servidor
- Como Fazer Upload de Arquivos via SFTP
- Primeiros Passos com Seu Novo Servidor
Precisa de Ajuda?
Se você está enfrentando problemas com seu servidor Onset ou precisa de assistência adicional, nossa equipe de suporte está aqui para ajudar. Envie um ticket de suporte e retornaremos o mais breve possível.
