Como instalar gamemodes e filterscripts no SA-MP — guia completo

Customizar um servidor SA-MP (San Andreas Multiplayer) começa pela escolha e instalação do gamemode — o script principal que define o modo de jogo — e dos filterscripts, que adicionam features modulares como comandos administrativos, anti-cheat ou eventos especiais. Sem essa parte configurada corretamente, o servidor sobe vazio (rodando o grandlarc padrão) ou simplesmente fecha logo após o boot.

Este tutorial cobre o fluxo completo: organizar a estrutura de pastas, compilar arquivos .pwn em .amx, editar o server.cfg corretamente, carregar plugins requeridos e diagnosticar os erros que aparecem no server_log.txt. É voltado para owners de servidor que já têm o SA-MP instalado e querem subir um gamemode personalizado.

Tempo estimado: 25–40 minutos, dependendo se você precisa compilar do zero ou usar .amx pré-compilados.

Pré-requisitos

Conhecimento básico de Pawn ajuda a entender erros de compilação, mas não é obrigatório se você for usar gamemodes já compilados em .amx.

Estrutura de pastas do SA-MP

Antes de copiar qualquer arquivo, vale entender onde cada coisa vive. A pasta raiz do servidor (samp03 no Linux, geralmente samp-server no Windows) tem uma estrutura fixa que o executável espera:

• gamemodes/ — arquivos .amx dos modos de jogo (apenas um é ativado por vez)
• filterscripts/ — arquivos .amx de scripts auxiliares
• plugins/ — bibliotecas nativas (.so no Linux, .dll no Windows) como sscanf, streamer, mysql
• scriptfiles/ — arquivos lidos/escritos em runtime (logs, JSON, bancos SQLite, configs do gamemode)
• pawno/ (opcional) — pasta com o compilador Pawn e includes (.inc)
• server.cfg — configuração principal do servidor
• server_log.txt — log gerado em runtime (essencial pra debug)

Os arquivos .pwn (código-fonte) podem ficar em gamemodes/ ou filterscripts/ durante desenvolvimento, mas o executável só carrega o .amx compilado.

Instalando um gamemode

A maioria dos gamemodes públicos vem como um pacote .zip ou .rar contendo o .pwn, o .amx já compilado, includes específicos e às vezes uma pasta scriptfiles/ com configs default.

scp meu-gamemode.amx user@seu-servidor:/samp03/gamemodes/

scp includes/*.inc user@seu-servidor:/samp03/pawno/include/

nano /samp03/server.cfg

gamemode0 lvdm-edit 1

cd /samp03
./samp03svr

Compilando um gamemode do .pwn

Quando você precisa editar o gamemode (mudar comandos, ajustar economia, corrigir bugs), o fluxo é editar o .pwn, recompilar pra gerar um novo .amx e substituir o arquivo no servidor.

./pawncc meu-gamemode.pwn -o meu-gamemode.amx

Header size:           1234 bytes
Code size:            56789 bytes
Data size:           123456 bytes
Stack/heap size:      16384 bytes
Total requirements:  197853 bytes

Instalando filterscripts

Filterscripts seguem o mesmo padrão do gamemode, com duas diferenças: ficam em filterscripts/ e o servidor pode carregar vários simultaneamente.

scp anti-flood.amx user@seu-servidor:/samp03/filterscripts/
scp admin-cmds.amx user@seu-servidor:/samp03/filterscripts/

filterscripts anti-flood admin-cmds gl_actions

Filterscript 'anti-flood.amx' loaded.
Filterscript 'admin-cmds.amx' loaded.

Configurando plugins necessários

Muitos gamemodes e filterscripts modernos dependem de plugins externos — bibliotecas compiladas que estendem o que o Pawn consegue fazer. Os mais comuns são sscanf2 (parsing de comandos), streamer (objetos/checkpoints sem limite), mysql (banco de dados) e crashdetect (debug).

scp sscanf.so streamer.so user@seu-servidor:/samp03/plugins/

plugins sscanf streamer crashdetect

Verificação

Pra confirmar que tudo subiu corretamente, faça duas verificações:

tail -f /samp03/server_log.txt

Você deve ver, na ordem: carregamento de plugins, carregamento do gamemode (Loaded 1 gamemodes.), carregamento de cada filterscript e finalmente Number of vehicle models: NN indicando que o servidor está pronto.

Em seguida, abra o SA-MP no cliente e conecte no IP do servidor. Se o gamemode carregou de fato, você verá o nome customizado dele (e não Grand Larceny) na lista de jogadores e nas mensagens de spawn.

Resolução de problemas

Erro “Failed to load gamemode”

Aparece quando o .amx não está na pasta gamemodes/ ou o nome no server.cfg está errado. Verifique se o arquivo existe (ls gamemodes/) e se a linha gamemode0 aponta pro nome correto sem extensão.

Erro “Plugin failed to load”

Causa comum: arquitetura do plugin não bate com o executável (32-bit vs 64-bit) ou o plugin foi compilado pra uma versão diferente do SA-MP. Baixe a versão compatível com seu servidor — 0.3.7-R2 e 0.3.DL exigem plugins diferentes.

Servidor reinicia em loop

Geralmente é um filterscript que crasha no OnFilterScriptInit. Comente todos os filterscripts no server.cfg, reinicie e adicione um por vez até achar o culpado. Use crashdetect pra pegar o stack trace.

”Symbol already defined” ao compilar

Você incluiu o mesmo .inc duas vezes ou tem uma função duplicada entre o gamemode e um include. Procure pelo nome do símbolo no .pwn e nos includes — só pode existir uma definição.

Próximos passos

Com gamemode e filterscripts rodando, alguns caminhos de aprofundamento valem investir:

• Configurar backup automático da pasta scriptfiles/ (onde ficam os dados persistentes do gamemode)
• Implementar um sistema de banco de dados com plugin MySQL pra escalar além dos arquivos .ini
• Configurar RCON com senha forte e limitar acesso por IP
• Monitorar uso de CPU e memória — gamemodes mal otimizados podem consumir 100% de um core sob carga
• Estudar hooks (ALS hooks) pra estender filterscripts sem modificar o gamemode original

Se você está rodando SA-MP em produção e quer latência baixa pra jogadores brasileiros, uma hospedagem de jogos Hostini já vem com servidores em São Paulo, proteção DDoS na borda e painel pra gerenciar plugins sem precisar de SSH.