Este guia aborda problemas comuns que pode encontrar ao executar um servidor dedicado de Garry's Mod com a Legion Hosting, juntamente com as suas causas e soluções.
Configuração do servidor: Se ainda não configurou o seu servidor, consulte primeiro o Guia de Configuração do Servidor Garry's Mod. Para problemas com o mod de administração, consulte Garry's Mod Admin Setup (ULX).
Índice
- Texturas em Falta / Quadrados Rosa e Pretos
- Addons do Workshop Não Descarregam
- Servidor Não Aparece no Navegador de Servidores
- Profissões do DarkRP Não Aparecem
- Comandos ULX Não Funcionam
- Ping Alto / Lag
- Servidor Crasha ao Iniciar
- Clientes Presos em "Downloading" ou Entradas Lentas
1. Texturas em Falta / Quadrados Rosa e Pretos
Causa: O Garry's Mod não inclui recursos de outros jogos da Valve (Counter-Strike: Source, Half-Life 2, etc.). Muitos mapas e addons da comunidade utilizam texturas do CS:S.
Soluções do Lado do Servidor
- Montar Counter-Strike: Source: No GPanel, verifique se o seu plano inclui montagem de conteúdo de jogos adicionais. Se disponível, ative a montagem do CS:S nas definições do seu servidor.
- Addon de Conteúdo CSS: Adicione um pacote de conteúdo CS:S da comunidade a partir do Workshop do Garry's Mod à coleção Workshop do seu servidor. Pesquise por "Counter-Strike: Source Content" e adicione-o.
- Upload Manual: Se nenhuma das opções acima estiver disponível, pode carregar manualmente ficheiros de conteúdo CS:S via SFTP para
garrysmod/addons/css-content/. Consulte o guia de upload via SFTP para instruções.
Solução do Lado do Cliente
Os jogadores que possuem Counter-Strike: Source podem montá-lo no GMod em Options → Game Content. Isto resolve as texturas em falta do lado deles sem necessidade de alterações no servidor.
2. Addons do Workshop Não Descarregam
Se o seu servidor não estiver a carregar addons do Workshop ao iniciar, verifique o seguinte:
| Verificação | Solução |
|---|---|
| Chave da API Steam em falta ou inválida | No GPanel, em Startup, defina a variável STEAM_API_KEY com uma chave válida de steamcommunity.com/dev/apikey. |
| A coleção não é pública | A sua coleção do Workshop deve estar definida como Public. Coleções não listadas ou privadas não serão descarregadas num servidor dedicado. |
| ID da coleção no local errado | O parâmetro +host_workshop_collection deve estar na linha de comando Startup do GPanel, não no server.cfg. |
| Erro 403 / erro de autenticação na consola | A sua chave da API Steam é inválida ou foi revogada. Gere uma nova e atualize-a no GPanel. |
Dica: Verifique a saída da consola do servidor no GPanel após um reinício. Os erros de download do Workshop aparecem no início do registo de arranque com os IDs específicos do Workshop que falharam.
3. Servidor Não Aparece no Navegador de Servidores
Se o seu servidor está em execução mas não aparece no navegador de servidores do Steam:
- Verifique
sv_lan: Certifique-se de quesv_lan 0está definido noserver.cfg. Um valor de1torna o servidor apenas LAN. - Verifique o seu GSLT: Certifique-se de que um Game Server Login Token válido está definido via
sv_setsteamaccount. Um token expirado ou revogado impedirá a listagem pública. Gere um novo em steamcommunity.com/dev/managegameservers. - Aguarde alguns minutos: Pode demorar vários minutos para um novo servidor aparecer na lista do servidor mestre do Steam após o primeiro arranque.
- Teste com conexão direta: Tente conectar-se via IP direto primeiro (consulte as instruções de conexão) para confirmar que o servidor está realmente em execução.
Banimentos de GSLT: O Steam pode banir um GSLT se detetar abuso ou certas modificações do lado do servidor. Se o seu token for banido, terá de gerar um novo e poderá precisar de contactar o suporte do Steam.
4. Profissões do DarkRP Não Aparecem
Se as profissões personalizadas não estão a aparecer no menu F4 após configurar o DarkRP:
- Verifique as localizações das pastas: O DarkRP em si deve estar em
garrysmod/gamemodes/darkrp/, não emaddons/. O DarkRPModification deve estar emgarrysmod/addons/darkrpmodification/. Este é o erro mais comum. - Verifique erros de Lua: Abra a consola do servidor no GPanel e procure erros de Lua durante o arranque. Um erro de sintaxe no
jobs.luaimpedirá o carregamento de todas as profissões personalizadas. - Verifique o gamemode: Confirme que
sv_gamemode "darkrp"está definido noserver.cfge que o servidor foi totalmente reiniciado (não apenas mudança de mapa). - Verifique a codificação dos ficheiros: Se editou ficheiros Lua no Windows, certifique-se de que estão guardados como UTF-8 sem BOM. Alguns editores de texto adicionam um BOM (byte order mark) que pode quebrar a análise Lua.
Passos Rápidos de Depuração
// Run these in the server console to check gamemode status:
lua_run print(engine.ActiveGamemode())
// Should output: darkrp
lua_run PrintTable(RPExtraTeams)
// Should list all custom jobs if DarkRP loaded correctly5. Comandos ULX Não Funcionam
Se os comandos ULX retornam erros ou não fazem nada após a instalação:
- Ambos os addons instalados? O ULX requer tanto o ULib como o ULX. O ULX não funcionará sem o ULib. Verifique se ambos estão presentes em
garrysmod/addons/ou na sua coleção do Workshop. - Verifique a consola para erros: Observe a saída da consola do servidor no GPanel durante o arranque para erros que mencionem ULib ou ULX.
- Verifique a atribuição do seu utilizador: Execute
ulx addusercom o seu nome de exibição exato do Steam, ou useulx adduserid "STEAM_0:1:12345678" superadmincom o seu Steam ID para maior fiabilidade. - Conflitos de addons: Alguns addons podem entrar em conflito com o ULX. Se os comandos pararam de funcionar após adicionar um novo addon, tente removê-lo e reiniciar para isolar o problema.
Para instruções detalhadas de configuração do ULX, consulte o guia Garry's Mod Admin Setup (ULX).
6. Ping Alto / Lag
Se o seu servidor está a experienciar ping alto ou picos de lag:
- Demasiados addons: Coleções grandes do Workshop aumentam o uso de memória e o tempo de carregamento. Reveja a sua coleção e remova addons que não estão a ser utilizados ativamente.
- Sobrecarga de entidades (DarkRP): Servidores DarkRP com muitas entidades geráveis (impressoras de dinheiro, laboratórios de drogas, etc.) podem ser intensivos em CPU. Defina limites razoáveis de entidades em
darkrpmodification/lua/darkrp_config/settings.lua. - Picos de lag por auto-save: Se os picos de lag ocorrem em intervalos regulares (a cada poucos minutos), pode ser o auto-save do servidor. Este é um comportamento normal, mas o intervalo pode ser ajustado.
- Contagem de jogadores vs. plano: Certifique-se de que a contagem de jogadores não excede o que os recursos do seu plano conseguem suportar. Considere reduzir
maxplayersnoserver.cfgse estiver perto dos limites de recursos. - Complexidade do mapa: Alguns mapas da comunidade são mal otimizados. Se o lag começou após mudar de mapa, tente reverter para um mapa mais simples para isolar o problema.
7. Servidor Crasha ao Iniciar
Se o seu servidor crasha ou não consegue iniciar:
- Verifique o registo da consola: No GPanel, reveja a saída da consola antes do crash. As últimas linhas geralmente indicam a causa.
- Addon problemático: Um addon adicionado recentemente pode estar a causar o crash. Remova o último addon que adicionou e tente reiniciar. Se o servidor iniciar, o addon é o problema.
- Ficheiros de gamemode corrompidos: Se estiver a usar DarkRP ou outro gamemode de terceiros, tente reinstalá-lo de raiz a partir do Workshop ou GitHub.
- Sem memória: Demasiados addons podem exceder a alocação de memória do seu plano. Verifique o uso de recursos no GPanel e considere reduzir a sua lista de addons.
Isolar um addon problemático: Se não consegue identificar qual addon está a causar o crash no servidor, remova todos os addons da sua coleção do Workshop e adicione-os de volta um de cada vez, reiniciando entre cada um, até encontrar o culpado.
8. Clientes Presos em "Downloading" ou Entradas Lentas
Se os jogadores ficam presos a descarregar conteúdo durante muito tempo ao entrar:
- Configure o FastDL: Sem FastDL, os clientes descarregam ficheiros diretamente do servidor de jogo, o que é muito lento. Consulte a secção FastDL do guia de configuração do servidor.
- Use o Workshop para addons: Addons entregues via Workshop são descarregados através do CDN do Steam, que é mais rápido do que o download direto do servidor. Prefira coleções do Workshop em vez de uploads manuais de addons quando possível.
- Reduza a quantidade de addons: Cada addon aumenta o tempo de download do cliente. Remova addons que não são essenciais para a jogabilidade do seu servidor.
- Verifique o uso de
resource.AddFile: Se está a forçar os clientes a descarregar muitos ficheiros viaresource.lua, reveja a lista e remova entradas de ficheiros que não são realmente necessários do lado do cliente.
Artigos Relacionados
- Garry's Mod Server Setup Guide — Server.cfg, Workshop, gamemodes, DarkRP, FastDL
- Garry's Mod Admin Setup (ULX) — Instalar ULX/ULib, comandos de admin, grupos de permissões
- How to Upload Files via SFTP
- How to Find Your Server IP and Port
Ainda com problemas? Se nenhuma das soluções acima resolver o seu problema, abra um ticket de suporte e inclua o IP do seu servidor, uma descrição do problema e quaisquer mensagens de erro ou saída da consola relevantes.
