Verificar o CounterStrikeSharp após a atualização de setembro

CounterStrikeSharp v1.0.374, de 7 de setembro de 2026 acrescenta a API CustomHudLayout, corrige um erro no DropActivePlayerWeapon e atualiza as definições do esquema para 1.41.7.7. O lançamento, por si só, não confirma a compatibilidade de cada plugin no teu servidor.

Faz uma cópia de segurança dos ficheiros existentes da framework e dos plugins e, depois da atualização controlada, verifica a cadeia de carregamento: meta list, depois css_plugins list e, por fim, as funções do MatchZy que utilizas. Testa também a mudança de mapa e os teus próprios plugins de HUD ou de armas. Regista a versão testada da framework juntamente com as versões dos plugins.

Não instales sem verificação um pacote MatchZy mais antigo que inclua o CounterStrikeSharp por cima de uma framework já atualizada. Verifica primeiro as versões incluídas ou usa o pacote apenas com o plugin, se os requisitos já estiverem cumpridos. Os lançamentos do MatchZy distinguem explicitamente estes pacotes.

O que depende do quê?

A ordem é importante: o MetaMod:Source carrega extensões nativas, o CounterStrikeSharp disponibiliza a framework de plugins em C# e o MatchZy funciona como um plugin do CounterStrikeSharp. Depois de uma atualização do CS2, as versões da framework têm de corresponder à build atual do servidor.

Esta estrutura também explica por que os erros quase sempre se propagam de baixo para cima: se o MetaMod não carregar, o CounterStrikeSharp nem sequer chega a iniciar, e o MatchZy não aparece em nenhuma lista de plugins. Quem, nesta situação, reinstala primeiro o MatchZy está a reparar a camada errada. Por isso, trabalha sempre da camada mais baixa para a mais alta.

Requisitos

Antes de começares, verifica três coisas:

  • Acesso ao servidor: precisas de acesso ao gestor de plugins no painel ou à gestão de ficheiros. Para a variante manual é necessário um acesso SFTP aos ficheiros do servidor de jogo.
  • Uma cópia de segurança atual: as instalações de plugins alteram game/csgo/addons/. Uma cópia de segurança antes do primeiro acesso de escrita poupa-te, em caso de erro, uma reinstalação completa.
  • Um servidor parado: nunca escrevas em addons/ enquanto o servidor estiver a funcionar. Ficheiros escritos apenas a meio provocam erros de carregamento difíceis de distinguir de verdadeiros conflitos de versão.

Instalação no painel

  1. Faz uma cópia de segurança e para o servidor.
  2. Abre o gestor de plugins e instala primeiro o MetaMod:Source.
  3. De seguida, instala o CounterStrikeSharp.
  4. Inicia o servidor uma vez. No registo, o MetaMod e o CounterStrikeSharp têm de aparecer sem erros de carregamento.
  5. Para novamente o servidor, instala o MatchZy e volta a iniciá-lo.
  6. Verifica com css_plugins list na consola do servidor se o MatchZy está carregado.

Na instalação manual, o MetaMod e o CounterStrikeSharp ficam em game/csgo/addons/; o MatchZy fica em game/csgo/addons/counterstrikesharp/plugins/MatchZy/. Sempre que possível, usa o gestor de plugins, para que os caminhos e as versões compatíveis sejam escolhidos automaticamente.

O arranque intermédio depois do passo 3 não é um passo extra opcional. Ele separa claramente duas fontes de erro: se o servidor já falhar aqui, o problema está na framework e não no MatchZy. Se instalares tudo de uma vez e o servidor deixar de iniciar, depois tens de adivinhar qual dos três componentes é o culpado.

Comandos básicos para uma partida

Os jogadores utilizam os seguintes comandos de chat:

.ready       marcar como pronto
.unready     retirar o estado de pronto
.pause       pausar a partida
.unpause     retomar a partida

Consoante a configuração do MatchZy, os mesmos comandos também podem começar com !. Os administradores carregam uma configuração de partida através do comando de carregamento disponibilizado pelo MatchZy; verifica antecipadamente o nome exato do ficheiro na tua configuração do MatchZy.

Comandos úteis do servidor:

status
mp_warmup_end
mp_restartgame 1
changelevel de_mirage
bot_kick

Se quiseres iniciar partidas regularmente e sem trabalho na consola, o CS2 Match Center com MatchZy é a forma mais cómoda: aí podes definir equipas, mapa, formato e GOTV através de um formulário, em vez de teres de escrever cada definição por comando.

Isolar erros

Os três sintomas mais frequentes têm causas claramente distintas:

  • O css_plugins list não reconhece o comando. Nesse caso, o CounterStrikeSharp não está carregado. Verifica no registo de arranque se o MetaMod chegou sequer a ser inicializado — sem o MetaMod não há CounterStrikeSharp.
  • O css_plugins list funciona, mas o MatchZy não aparece na lista. A framework e a camada de plugins estão corretas, mas o MatchZy está na pasta errada ou não é compatível com a versão instalada do CounterStrikeSharp.
  • O servidor deixa de iniciar depois da instalação. Normalmente é um conflito de versões após uma atualização do CS2. Remove o MatchZy a título experimental, inicia o servidor e volta a subir camada a camada.

Lê sempre o registo de arranque de cima para baixo. O primeiro bloco Failed, Error ou Exception indica a camada afetada; tudo o que vem depois costuma ser erros consequentes que desaparecem por si só assim que a causa for resolvida.

Depois de uma atualização do CS2

Se, de repente, faltarem plugins, não reinstales todo o servidor de jogo. Verifica primeiro se o MetaMod e o CounterStrikeSharp ainda carregam, atualiza ambas as frameworks e só depois o MatchZy. O primeiro bloco Failed, Error ou Exception no registo de arranque costuma indicar a camada afetada.

A Valve lança atualizações do CS2 sem ter em conta as frameworks de terceiros. Por isso, entre uma atualização e a versão correspondente do MetaMod ou do CounterStrikeSharp podem passar-se horas ou até dias. Para jogos de liga com data marcada, vale a pena controlar as atualizações automáticas de forma específica, para que um servidor não mude, mesmo imediatamente antes da partida, para uma build para a qual ainda não existem plugins compatíveis.

FAQ

Também tenho de instalar o SourceMod? Para o MatchZy, não. O MatchZy assenta no CounterStrikeSharp. O SourceMod é um ecossistema de plugins independente e paralelo, e não é necessário para esta stack.

Em que ordem devo atualizar? Sempre de baixo para cima: primeiro o MetaMod:Source, depois o CounterStrikeSharp e, por último, o MatchZy. Ao contrário, o plugin superior carrega contra uma framework que ainda não corresponde à build do servidor.

Por que motivo os comandos de chat não respondem? Ou o MatchZy não está carregado — isso é indicado por css_plugins list — ou a tua configuração utiliza um prefixo de comando diferente. São comuns tanto .ready como !ready.

Posso instalar plugins com o servidor em funcionamento? Não. Para o servidor antes. Os acessos de escrita a addons/ com o processo em execução geram ficheiros incompletos e erros de carregamento que parecem conflitos de versão.

Onde encontro a documentação oficial? Os passos de instalação e as opções de configuração do MatchZy estão na documentação do MatchZy. Para questões de versões relacionadas com a família Metamod/SourceMod, a referência é a visão geral das versões necessárias no AlliedModders.

O servidor funciona, mas o desempenho cai durante a partida. Isso não é, em rigor, um problema de plugins. Verifica a tickrate e a carga do servidor separadamente da stack de plugins — para isso existe um guia próprio sobre tickrate e desempenho em servidores CS2.