Este guia aborda como instalar e configurar o mod de administração ULX no seu servidor de Garry's Mod alojado na Legion Hosting, incluindo instalação, atribuição de permissões de admin, comandos comuns e gestão de grupos de permissões.
Índice
- Instalar ULX e ULib
- Atribuir Superadmin a Si Próprio
- Comandos ULX Comuns
- Grupos de Permissões
- Comandos de Chat
- Ficheiros de Configuração
1. Instalar ULX e ULib
O ULX é o mod de administração mais utilizado para Garry's Mod. Requer dois addons instalados em conjunto:
| Addon | Workshop ID | Notas |
|---|---|---|
| ULib | 557962280 | Biblioteca necessária para o ULX. Deve ser instalada primeiro. |
| ULX | 557962238 | O mod de administração 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 já tem uma coleção configurada via +host_workshop_collection no GPanel, basta adicionar o ULib e o ULX a essa coleção existente no Steam. O servidor irá descarregá-los automaticamente no próximo reinício.
Opção B — Upload Manual via SFTP
- Descarregue ambos os addons da Workshop ou do GitHub do Team Ulysses.
- Carregue-os via SFTP para o seu servidor de forma a 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. Atribuir Superadmin a Si Próprio
Após o ULX estar instalado e o servidor ter reiniciado, precisa de atribuir a si próprio o rank de superadmin. Abra a consola do servidor no GPanel e execute:
ulx adduser "YourSteamName" superadmin
Se o seu nome Steam contém caracteres especiais ou espaços, use o 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.
Depois de atribuído, reconecte-se ao servidor. Pode verificar o seu rank escrevendo !menu no chat para abrir a interface de administração do ULX.
3. Comandos ULX Comuns
Os comandos ULX podem ser executados a partir da consola do servidor no GPanel, da consola do jogo ou como comandos de chat (prefixados com !). Abaixo estão os comandos mais utilizados.
Gestão 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 | Bater num jogador com o dano especificado |
Controlos 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 | Teletransportar um jogador para a sua mira |
ulx bring "Player" | !bring Player | Teletransportar um jogador até si |
ulx goto "Player" | !goto Player | Teletransportar-se até um jogador |
ulx return "Player" | !return Player | Devolver um jogador à sua posição anterior |
ulx cloak "Player" | !cloak Player | Tornar um jogador invisível |
4. Grupos de Permissões
O ULX utiliza um sistema de permissões baseado em grupos. Por predefinição, o ULX inclui estes grupos, ordenados do mais privilegiado para o menos privilegiado:
| Grupo | Herda De | Utilização Típica |
|---|---|---|
superadmin | admin | Dono do servidor. Acesso total a todos os comandos. |
admin | operator | Staff de confiança. Pode banir, expulsar e gerir jogadores. |
operator | user | Moderadores juniores. Comandos de moderação limitados. |
user | nenhum | Grupo predefinido para todos os jogadores. |
Gerir Utilizadores 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"
Usar a Interface Gráfica
Como superadmin, escreva !menu no chat para abrir o painel de administração ULX. O separador Groups fornece uma interface visual para criar grupos, atribuir permissões e gerir utilizadores sem comandos de consola.
garrysmod/data/ulib/groups.txt e os dados dos utilizadores em garrysmod/data/ulib/users.txt. Estes ficheiros são geridos automaticamente pelo ULX, mas pode fazer backup via SFTP.
5. Comandos de Chat
O ULX suporta atalhos de comandos via chat para administração rápida dentro do jogo. Todos os comandos usam o prefixo ! por predefinição. Alguns padrões úteis:
| Comando de Chat | Efeito |
|---|---|
!menu | Abre a interface de administração ULX |
!motd | Mostra a Mensagem do Dia |
!kick Player reason | Expulsa o jogador indicado |
!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 a si próprio. Por exemplo, !god @ alterna o modo deus em si próprio.
6. Ficheiros de Configuração
O ULX armazena a sua configuração e dados em garrysmod/data/ulib/. Ficheiros importantes a ter em conta:
| Ficheiro | Finalidade |
|---|---|
data/ulib/users.txt | Todas as atribuições de utilizadores a grupos e Steam IDs |
data/ulib/groups.txt | Definições de grupos, herança e permissões |
data/ulib/bans.txt | Lista de bans ativos com tempos de expiração |
data/ulx/config.txt | Definições do ULX (MOTD, mensagem de boas-vindas, registos, etc.) |
data/ulib/ e data/ulx/ via SFTP como backup. Um ficheiro de grupos mal configurado pode bloquear o acesso a todos os admins.
Artigos Relacionados
- Garry's Mod Server Setup Guide — Server.cfg, Workshop, gamemodes, DarkRP, FastDL
- Garry's Mod Troubleshooting — Texturas em falta, erros da Workshop e mais
- How to Upload Files via SFTP