Este guia cobre problemas comuns que você pode encontrar ao executar um servidor dedicado de Garry's Mod com a Legion Hosting, junto com suas causas e soluções.
Configuração do servidor: Se você ainda não configurou seu servidor, veja o Guia de Configuração do Servidor Garry's Mod primeiro. Para problemas com mod de administração, veja Garry's Mod Admin Setup (ULX).
Índice
- Texturas Faltando / Quadriculado Rosa e Preto
- Addons da Workshop Não Baixando
- Servidor Não Aparece no Navegador de Servidores
- Profissões do DarkRP Não Aparecem
- Comandos do ULX Não Funcionam
- Ping Alto / Lag
- Servidor Crasha na Inicialização
- Clientes Travados em "Downloading" ou Conexão Lenta
1. Texturas Faltando / Quadriculado Rosa e Preto
Causa: O Garry's Mod não inclui assets de outros jogos da Valve (Counter-Strike: Source, Half-Life 2, etc.). Muitos mapas e addons da comunidade usam texturas do CS:S.
Correções no Lado do Servidor
- Montar Counter-Strike: Source: No GPanel, verifique se seu plano inclui a montagem de conteúdo adicional de jogos. Se disponível, ative a montagem do CS:S nas configurações do seu servidor.
- Addon de Conteúdo CSS: Adicione um pacote de conteúdo CSS da comunidade pela Workshop do Garry's Mod à coleção da Workshop do seu servidor. Pesquise por "Counter-Strike: Source Content" e adicione.
- Upload Manual: Se nenhuma das opções acima estiver disponível, você pode fazer upload manualmente dos arquivos de conteúdo do CS:S via SFTP para
garrysmod/addons/css-content/. Veja o guia de upload via SFTP para instruções.
Correção no Lado do Cliente
Jogadores que possuem Counter-Strike: Source podem montá-lo no GMod em Options → Game Content. Isso resolve as texturas faltando do lado deles sem necessidade de alterações no servidor.
2. Addons da Workshop Não Baixando
Se o seu servidor não está carregando addons da Workshop na inicialização, verifique o seguinte:
| Verificação | Correção |
|---|---|
| Chave da API do Steam ausente ou inválida | No GPanel em Startup, defina a variável STEAM_API_KEY com uma chave válida de steamcommunity.com/dev/apikey. |
| Coleção não é pública | Sua coleção da Workshop deve estar definida como Public. Coleções não listadas ou privadas não serão baixadas em um servidor dedicado. |
| ID da coleção no lugar errado | O parâmetro +host_workshop_collection deve estar na linha de comando do GPanel em Startup, não no server.cfg. |
| Erro 403 / erro de autenticação no console | Sua chave da API do Steam é inválida ou foi revogada. Gere uma nova e atualize no GPanel. |
Dica: Verifique a saída do console do servidor no GPanel após uma reinicialização. Erros de download da Workshop aparecem no início do log de inicialização com os IDs específicos da Workshop que falharam.
3. Servidor Não Aparece no Navegador de Servidores
Se o seu servidor está rodando 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 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 levar vários minutos para um novo servidor aparecer na lista do servidor mestre do Steam após a primeira inicialização.
- Teste com conexão direta: Tente conectar via IP direto primeiro (veja as instruções de conexão) para confirmar que o servidor está realmente rodando.
Banimentos de GSLT: O Steam pode banir um GSLT se detectar abuso ou certas modificações no lado do servidor. Se seu token for banido, você precisará gerar um novo e pode precisar entrar em contato com o suporte do Steam.
4. Profissões do DarkRP Não Aparecem
Se as profissões personalizadas não estão aparecendo no menu F4 após configurar o DarkRP:
- Verifique a localização 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 o console do servidor no GPanel e procure por erros de Lua durante a inicialização. Um erro de sintaxe no
jobs.luaimpedirá que todas as profissões personalizadas sejam carregadas. - Verifique o gamemode: Confirme que
sv_gamemode "darkrp"está definido noserver.cfge que o servidor foi completamente reiniciado (não apenas mudança de mapa). - Verifique a codificação do arquivo: Se você editou arquivos Lua no Windows, certifique-se de que estão salvos como UTF-8 sem BOM. Alguns editores de texto adicionam um BOM (byte order mark) que pode quebrar a interpretação do 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 do ULX Não Funcionam
Se os comandos do ULX retornam erros ou não fazem nada após a instalação:
- Ambos os addons instalados? O ULX requer tanto o ULib quanto o ULX. O ULX não funcionará sem o ULib. Verifique se ambos estão presentes em
garrysmod/addons/ou na sua coleção da Workshop. - Verifique o console para erros: Veja a saída do console do servidor no GPanel durante a inicialização para erros mencionando ULib ou ULX.
- Verifique a atribuição do seu usuário: Execute
ulx addusercom seu nome exato de exibição do Steam, ou useulx adduserid "STEAM_0:1:12345678" superadmincom seu Steam ID para maior confiabilidade. - Conflitos de addons: Alguns addons podem conflitar 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, veja o guia Garry's Mod Admin Setup (ULX).
6. Ping Alto / Lag
Se o seu servidor está com ping alto ou picos de lag:
- Muitos addons: Coleções grandes da Workshop aumentam o uso de memória e o tempo de carregamento. Revise sua coleção e remova addons que não estão sendo usados ativamente.
- Sobrecarga de entidades (DarkRP): Servidores DarkRP com muitas entidades spawná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 podem suportar. Considere diminuir
maxplayersnoserver.cfgse você está próximo dos limites de recursos. - Complexidade do mapa: Alguns mapas da comunidade são mal otimizados. Se o lag começou após trocar de mapa, tente voltar para um mapa mais simples para isolar o problema.
7. Servidor Crasha na Inicialização
Se o seu servidor crasha ou falha ao iniciar:
- Verifique o log do console: No GPanel, revise a saída do console antes do crash. As últimas linhas geralmente indicam a causa.
- Addon problemático: Um addon adicionado recentemente pode estar causando o crash. Remova o último addon que você adicionou e tente reiniciar. Se o servidor iniciar, o addon é o problema.
- Arquivos de gamemode corrompidos: Se estiver usando DarkRP ou outro gamemode de terceiros, tente reinstalá-lo do zero pela Workshop ou GitHub.
- Sem memória: Muitos addons podem exceder a alocação de memória do seu plano. Verifique o uso de recursos no GPanel e considere reduzir sua lista de addons.
Isolando um addon problemático: Se você não consegue identificar qual addon está crashando o servidor, remova todos os addons da sua coleção da Workshop e adicione-os de volta um por vez, reiniciando entre cada um, até encontrar o culpado.
8. Clientes Travados em "Downloading" ou Conexão Lenta
Se os jogadores ficam travados baixando conteúdo por muito tempo ao entrar:
- Configure o FastDL: Sem FastDL, os clientes baixam arquivos diretamente pelo servidor de jogo, o que é muito lento. Veja a seção FastDL do guia de configuração do servidor.
- Use a Workshop para addons: Addons entregues via Workshop são baixados pela CDN do Steam, que é mais rápida que o download direto do servidor. Prefira coleções da Workshop em vez de uploads manuais de addons quando possível.
- Reduza a quantidade de addons: Cada addon adiciona tempo ao download do cliente. Remova addons que não são essenciais para a jogabilidade do seu servidor.
- Verifique o uso de
resource.AddFile: Se você está forçando clientes a baixar muitos arquivos viaresource.lua, revise a lista e remova entradas de arquivos que não são realmente necessários no lado do cliente.
Artigos Relacionados
- Guia de Configuração do Servidor Garry's Mod — Server.cfg, Workshop, gamemodes, DarkRP, FastDL
- Garry's Mod Admin Setup (ULX) — Instalar ULX/ULib, comandos de admin, grupos de permissão
- Como Enviar Arquivos via SFTP
- Como Encontrar o IP e a Porta do Seu Servidor
Ainda com problemas? Se nenhuma das correções acima resolver seu problema, abra um ticket de suporte e inclua o IP do seu servidor, uma descrição do problema e qualquer saída relevante do console ou mensagens de erro.
