Este guia cobre como instalar e configurar o mod de admin ULX no seu servidor de Garry's Mod hospedado na Legion Hosting, incluindo instalação, concessão de permissões de admin, comandos comuns e gerenciamento de grupos de permissão.
Índice
- Instalando ULX e ULib
- Concedendo Superadmin a Si Mesmo
- Comandos Comuns do ULX
- Grupos de Permissão
- Comandos de Chat
- Arquivos de Configuração
1. Instalando ULX e ULib
O ULX é o mod de admin mais amplamente usado para Garry's Mod. Ele requer dois addons instalados juntos:
| Addon | Workshop ID | Notas |
|---|---|---|
| ULib | 557962280 | Biblioteca necessária para o ULX. Deve ser instalada primeiro. |
| ULX | 557962238 | O mod de admin em si. Depende do ULib. |
Opção A — Coleção da Workshop (Recomendado)
Adicione ambos os Workshop IDs à coleção da Workshop do seu servidor. Se você já tem uma coleção configurada via +host_workshop_collection no GPanel, simplesmente adicione o ULib e o ULX a essa coleção existente no Steam. O servidor irá baixá-los automaticamente na próxima reinicialização.
Opção B — Upload Manual via SFTP
- Baixe ambos os addons da Workshop ou do GitHub do Team Ulysses.
- Faça upload deles via SFTP para o seu servidor de forma que a estrutura de pastas fique assim:
garrysmod/addons/ulib/
garrysmod/addons/ulx/
Cada pasta deve conter o diretório lua/ do addon diretamente dentro dela.
2. Concedendo Superadmin a Si Mesmo
Após o ULX ser instalado e o servidor ter reiniciado, você precisa conceder a si mesmo o rank de superadmin. Abra o console do servidor no GPanel e execute:
ulx adduser "YourSteamName" superadmin
Se seu nome do Steam contém caracteres especiais ou espaços, use seu Steam ID de 64 bits para maior precisão:
ulx adduserid "STEAM_0:1:12345678" superadmin
STEAM_0:X:XXXXXXXX ou o formato de 64 bits 7656119XXXXXXXXXX.
Após concedido, reconecte ao servidor. Você pode verificar seu rank digitando !menu no chat para abrir a interface de admin do ULX.
3. Comandos Comuns do ULX
Os comandos do ULX podem ser executados pelo console do servidor no GPanel, pelo console do jogo ou como comandos de chat (prefixados com !). Abaixo estão os comandos mais utilizados.
Gerenciamento de Jogadores
| Comando | Atalho de Chat | Descrição |
|---|---|---|
ulx kick "Player" reason | !kick Player reason | Expulsar um jogador do servidor |
ulx ban "Player" minutes reason | !ban Player 60 reason | Banir um jogador (0 = permanente) |
ulx unban STEAMID | !unban STEAMID | Desbanir um jogador pelo Steam ID |
ulx slay "Player" | !slay Player | Matar um jogador instantaneamente |
ulx slap "Player" damage | !slap Player 10 | Dar um tapa em um jogador causando o dano especificado |
Controles de Comunicação
| Comando | Atalho de Chat | Descrição |
|---|---|---|
ulx gag "Player" | !gag Player | Impedir um jogador de usar o chat de voz |
ulx ungag "Player" | !ungag Player | Restaurar o chat de voz de um jogador |
ulx mute "Player" | !mute Player | Impedir um jogador de usar o chat de texto |
ulx unmute "Player" | !unmute Player | Restaurar o chat de texto de um jogador |
Comandos Utilitários
| Comando | Atalho de Chat | Descrição |
|---|---|---|
ulx noclip "Player" | !noclip Player | Alternar noclip (voar através de paredes) |
ulx god "Player" | !god Player | Alternar modo deus (invencibilidade) |
ulx teleport "Player" | !tp Player | Teleportar um jogador para sua mira |
ulx bring "Player" | !bring Player | Teleportar um jogador até você |
ulx goto "Player" | !goto Player | Teleportar-se até um jogador |
ulx return "Player" | !return Player | Retornar um jogador à posição anterior |
ulx cloak "Player" | !cloak Player | Tornar um jogador invisível |
4. Grupos de Permissão
O ULX usa um sistema de permissões baseado em grupos. Por padrão, o ULX inclui estes grupos, ordenados do mais ao menos privilegiado:
| Grupo | Herda De | Uso Típico |
|---|---|---|
superadmin | admin | Dono do servidor. Acesso total a todos os comandos. |
admin | operator | Equipe confiável. Pode banir, expulsar e gerenciar jogadores. |
operator | user | Moderadores juniores. Comandos de moderação limitados. |
user | nenhum | Grupo padrão para todos os jogadores. |
Gerenciando Usuários e Grupos
// Add a user to a group
ulx adduser "Player" admin
// Remove a user from their group (reverts to "user")
ulx removeuser "Player"
// Create a custom group that inherits from "operator"
ulx groupallow "moderator" "ulx kick"
ulx addgroup "moderator" "operator"
// Grant a specific command to a group
ulx groupallow "admin" "ulx ban"
// Deny a specific command from a group
ulx groupdeny "operator" "ulx ban"
Usando a Interface Gráfica
Como superadmin, digite !menu no chat para abrir o painel de admin do ULX. A aba Groups fornece uma interface visual para criar grupos, atribuir permissões e gerenciar usuários sem comandos de console.
garrysmod/data/ulib/groups.txt e os dados de usuário em garrysmod/data/ulib/users.txt. Esses arquivos são gerenciados automaticamente pelo ULX, mas você pode fazer backup deles via SFTP.
5. Comandos de Chat
O ULX suporta atalhos de comando por chat para administração rápida no jogo. Todos os comandos usam o prefixo ! por padrão. Alguns padrões úteis:
| Comando de Chat | Efeito |
|---|---|
!menu | Abre a interface de admin do ULX |
!motd | Exibe a Mensagem do Dia |
!kick Player reason | Expulsa o jogador mencionado |
!ban Player 60 reason | Bane por 60 minutos |
!hp Player 100 | Define a vida de um jogador |
!armor Player 100 | Define a armadura de um jogador |
@ como alvo para aplicar um comando em si mesmo. Por exemplo, !god @ alterna o modo deus em você mesmo.
6. Arquivos de Configuração
O ULX armazena sua configuração e dados em garrysmod/data/ulib/. Arquivos importantes a conhecer:
| Arquivo | Finalidade |
|---|---|
data/ulib/users.txt | Todas as atribuições de usuário para grupo e Steam IDs |
data/ulib/groups.txt | Definições de grupo, herança e permissões |
data/ulib/bans.txt | Lista de bans ativos com tempos de expiração |
data/ulx/config.txt | Configurações do ULX (MOTD, mensagem de boas-vindas, logs, etc.) |
data/ulib/ e data/ulx/ via SFTP como backup. Um arquivo de grupos mal configurado pode bloquear todos os admins.
Artigos Relacionados
- Guia de Configuração do Servidor Garry's Mod — Server.cfg, Workshop, gamemodes, DarkRP, FastDL
- Solução de Problemas do Garry's Mod — Texturas faltando, erros da Workshop e mais
- Como Enviar Arquivos via SFTP