Este guia abrange a configuração de administração, comandos de consola, o sistema de pacotes Lua, gestão de jogadores e veículos, e configuração de base de dados para o seu servidor dedicado Onset na Legion Hosting. Para a configuração inicial do servidor, consulte o nosso Guia de Configuração do Servidor Onset.
Configuração de Administração
O Onset gere privilégios de administração através de scripting Lua dentro dos pacotes do seu modo de jogo. Ao contrário de muitos jogos com sistemas de administração 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 administração. Normalmente, a configuração de administração envolve:
- Abra o File Manager no GPanel
- Navegue até ao diretório do seu pacote (ex.:
packages/mygamemode/) - Localize o ficheiro de configuração de administração (geralmente
config.lua,admins.luaou um ficheiro de configuração JSON) - Adicione o seu Steam64 ID ou ID de jogador no jogo à lista de administradores
- Guarde o ficheiro e reinicie o servidor
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Comandos de Consola do Servidor
O Onset fornece comandos de consola do servidor integrados que funcionam independentemente dos pacotes instalados. Estes podem ser introduzidos diretamente na consola do GPanel.
| Comando | Descrição |
|---|---|
help |
Lista todos os comandos de consola disponíveis |
stop |
Para o servidor de forma controlada |
restart |
Reinicia o servidor |
players |
Lista todos os jogadores conectados com os 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á atualmente em execução |
package stop <name> |
Para um pacote em execução |
package list |
Lista todos os pacotes carregados e o seu estado |
Sistema de Pacotes (Scripting 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 são executados 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 scriptsInstalar Pacotes
- Descarregue o pacote dos fóruns da comunidade Onset ou repositórios GitHub
- Conecte-se ao seu servidor via SFTP
- Carregue a 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 através do GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" são carregados pela ordem em que estão listados. Se um pacote depende de outro, certifique-se de que a dependência é listada primeiro.
Gestão de Jogadores
Para além dos comandos integrados de expulsão e banimento, a maioria dos pacotes de modo de jogo fornece funcionalidades adicionais de gestão de jogadores. Comandos comuns fornecidos por pacotes incluem:
| Comando (Dependente do Pacote) | Descrição |
|---|---|
/tp <player> |
Teletransportar para outro jogador |
/bring <player> |
Teletransportar outro jogador para a sua localização |
/goto <x> <y> <z> |
Teletransportar para coordenadas específicas do mundo |
/setadmin <player> <level> |
Definir o nível de administrador de um jogador (se o pacote suportar níveis) |
/announce <message> |
Enviar um anúncio para todo o servidor |
Gestão de Veículos
O Onset possui um sistema de veículos integrado que os pacotes podem expandir. Os administradores frequentemente precisam de gerir veículos gerados para evitar desordem no servidor.
- Geração de veículos — A maioria dos pacotes RP permite que os administradores gerem veículos através de comandos como
/car <model> - Limpeza de veículos — Alguns pacotes incluem desaparecimento automático de veículos abandonados ou comandos de administrador como
/destroyvehicles - Limites de veículos — Configure o máximo de veículos por jogador para evitar lag causado por demasiadas entidades geradas
Base de Dados (MariaDB)
O Onset suporta conexões a bases de dados MariaDB/MySQL para armazenamento persistente de dados. Isto é utilizado por pacotes de roleplay e outros modos de jogo para guardar dados de jogadores, inventários, propriedades e mais.
A configuração da base de dados é feita nos ficheiros 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"
}Resolução de Problemas
| Problema | Solução |
|---|---|
| O servidor inicia mas não há jogabilidade disponível | Precisa de pelo menos um pacote de modo de jogo instalado e listado no server_config.json. Um servidor Onset básico não tem jogabilidade integrada. |
| O pacote não carrega | Verifique a consola do GPanel para mensagens de erro Lua. Causas comuns: package.json em falta, erros de sintaxe nos ficheiros Lua ou dependências em falta. |
| Erros de conexão à base de dados | Verifique as credenciais da base de dados, certifique-se de que a base de dados existe e confirme que o serviço MariaDB está em execução. Teste a conectividade nos registos da consola. |
| O servidor não é visível no navegador | Certifique-se de que "visible": true está definido no server_config.json. Verifique também se a porta 7776 (TCP) está acessível para a porta de consulta. |
| Alta latência ou lag | Reduza o valor de streamdistance, diminua 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 Carregar Ficheiros via SFTP
- Começar com o Seu Novo Servidor
Precisa de Ajuda?
Se está a ter problemas com o seu servidor Onset ou precisa de mais assistência, a nossa equipa de suporte está aqui para ajudar. Submeta um ticket de suporte e responderemos o mais brevemente possível.
