Os plugins e os mods ampliam muitos jogos, mas costumam deixar de funcionar após uma atualização do jogo ou quando falta um ficheiro. As secções abaixo tratam mensagens típicas de CS2 com CounterStrikeSharp, Valheim com BepInEx, Conan Exiles, SCP: Secret Laboratory, Project Zomboid e The Forest, bem como erros gerais de plugins .NET. Cada secção mostra uma mensagem, explica-a e indica os passos seguintes.

Encontras a mensagem completa na Consola e nos ficheiros de registo do jogo em Ficheiros. Muitos erros são compostos por várias linhas. O stacktrace por baixo, a lista das partes do programa chamadas, indica muitas vezes o plugin afetado; uma exception é um erro de programa comunicado pelo .NET ou pelo Unity. Antes de substituíres plugins, mods ou ficheiros de configuração, cria uma cópia de segurança em Cópias de segurança.

„Missing required weapons definition file“: o plugin de skins do CS2 não encontra o weapons.json

Este é o aspeto da mensagem:

System.InvalidOperationException: Missing required weapons definition file: <Plugin folder>/weapons.json

O que está por trás disto: Os plugins de skins para CS2 precisam de uma lista de todas as armas e dos respetivos identificadores. Essa lista está no ficheiro obrigatório weapons.json, na pasta de dados do plugin. Se este ficheiro não existir, o plugin não consegue inicializar, ou seja, nem sequer arranca: a função de skins fica completamente inoperacional. Isto acontece, por exemplo, quando no carregamento só foi enviado o ficheiro principal do plugin e não o pacote completo.

Como resolver:

  1. Lê o caminho indicado na mensagem. Ele mostra em que pasta o plugin espera encontrar o ficheiro.
  2. Descarrega novamente o plugin na mesma versão e instala-o de novo por completo, com todas as pastas do pacote.
  3. Em alternativa, copia o weapons.json do pacote da mesma versão do plugin, em Ficheiros, para a pasta indicada. Não uses um ficheiro de outra versão.
  4. Reinicia o servidor e verifica na Consola se o plugin carrega sem erros.

Bom saber: Para mais detalhes sobre plugins de CS2: Plugins de CS2: MetaMod, CounterStrikeSharp e MatchZy.

„Method … not found in gamedata.json“: o WeaponPaints não consegue arrancar

Este é o aspeto da mensagem:

Method CAttributeList_SetOrAddAttributeValueByName not found in gamedata.json

O que está por trás disto: O WeaponPaints encontra determinadas funções no programa do CS2 através de assinaturas, isto é, elementos de reconhecimento que constam do ficheiro gamedata.json. Após uma atualização do CS2, uma dessas assinaturas deixa de corresponder e o plugin não encontra a função. Nesse caso, não consegue arrancar. Isto não se deve às tuas definições, mas ao facto de o jogo e o plugin já não serem compatíveis.

Como resolver:

  1. Verifica se o CS2 recebeu uma atualização recentemente. Esse é o motivo habitual.
  2. Atualiza o CounterStrikeSharp e o WeaponPaints em conjunto para a versão mais recente e usa o gamedata.json atual do WeaponPaints.
  3. Se ainda não existir uma versão adaptada, remove temporariamente o WeaponPaints até o autor o atualizar.
  4. Reinicia o servidor e verifica se a mensagem desapareceu.

Bom saber: Após grandes atualizações do CS2, por vezes demora algum tempo até os autores dos plugins publicarem versões adaptadas. Mais sobre atualizações do jogo: Atualizar o servidor de CS2: detetar build drift e reiniciar em segurança.

„PreLogin failure“: o Conan Exiles rejeita uma lista de mods diferente

Este é o aspeto da mensagem:

[<Date>-<Time of day>][<No.>]LogNet: PreLogin failure: <Mod A> (<Workshop ID>), <Mod B> (<Workshop ID>), <Mod C> (<Workshop ID>).

O que está por trás disto: Um jogador quis entrar e foi recusado porque os mods que tem ativos não correspondem exatamente à lista de mods do teu servidor. Importante: os mods na linha são a lista pretendida do servidor, não os mods errados do jogador. Os mods que o jogador realmente tem ativos não constam do log. O Conan Exiles exige uma correspondência exata, e tanto um mod em falta como um mod adicional bloqueiam a entrada. O jogador não vê qualquer motivo: o jogo fica parado em "A tentar entrar no jogo". Parece um tempo limite excedido, mas é uma recusa imediata.

Como resolver:

  1. Compara a lista do log com os mods que o jogador ativou no launcher do Conan. A composição tem de ser igual, sem extras.
  2. Se o jogador desativar todos os mods que não estão na lista e ativar os que faltam, consegue voltar a ligar-se.
  3. Se quiseres permitir um mod adicional, instala-o no servidor em Mods e reinicia o servidor.
  4. Após cada alteração aos mods do servidor, todos os jogadores têm de acertar a sua lista de mods.

„Error invoking callback“: plugin do CounterStrikeSharp falha durante um evento

Este é o aspeto da mensagem:

<Time of day> [EROR] (cssharp:…) Error invoking callback

O que está por trás disto: O CounterStrikeSharp é uma plataforma de plugins para CS2. Os plugins associam-se a eventos como „jogador liga-se“ ou „a ronda começa“; a função que é então chamada designa-se callback. Num desses callbacks, um plugin provocou um erro, uma chamada exception. O servidor continua a funcionar, mas a função do plugin afetada não correu bem. Qual foi o plugin e porquê, consta do stacktrace por baixo, a lista das partes do programa que foram chamadas.

Como resolver:

  1. Lê o stacktrace completo por baixo da mensagem. O nome do plugin aparece normalmente aí, como parte dos nomes das classes ou como nome de ficheiro.
  2. Atualiza esse plugin e o CounterStrikeSharp para versões compatíveis entre si. A página do plugin indica a versão do CounterStrikeSharp suportada.
  3. Reinicia o servidor por completo, não apenas o plugin.
  4. Se o erro continuar a ocorrer, remove o plugin e comunica o erro ao respetivo autor.

„A parameterless default constructor …“: a base de dados do CS2-SimpleAdmin não é compatível

Este é o aspeto da mensagem:

A parameterless default constructor or one matching signature (…) is required for CS2_SimpleAdmin.<Class> materialization

O que está por trás disto: O CS2-SimpleAdmin guarda bans, mutes e o histórico de IPs numa base de dados MySQL. A mensagem significa que as colunas das tabelas não correspondem à versão que o plugin espera. É típico acontecer após uma atualização do plugin cuja migração da base de dados (a adaptação automática das tabelas) não foi executada, ou quando se continua a usar uma base de dados de uma instalação mais antiga. As funções de administração do plugin deixam então de funcionar de forma fiável, mas o próprio servidor de CS2 continua a correr.

Como resolver:

  1. Faz uma cópia do conteúdo da base de dados antes de alterares algo, por exemplo através de uma exportação.
  2. Atualiza o CS2-SimpleAdmin para a versão mais recente e reinicia o servidor uma vez, para que a migração seja executada.
  3. Se a mensagem persistir, compara as tabelas da tua base de dados com o esquema, isto é, a estrutura das tabelas, da versão instalada do plugin.
  4. Se puderes dispensar os dados antigos de bans, cria uma base de dados nova em Bases de dados, introduz as respetivas credenciais na configuração do plugin e reinicia.

„TypeInitializationException“: o WeaponPaints não arranca

Este é o aspeto da mensagem:

TypeInitializationException: The type initializer for 'WeaponPaints.WeaponPaints' threw an exception.
 ---> <inner exception>: <Cause>

O que está por trás disto: No primeiro acesso, o WeaponPaints executa uma rotina de arranque estática (Type Initializer). Esta falhou, por isso o plugin não arranca. A mensagem em si é apenas o invólucro: a verdadeira causa é indicada pela exception interna logo a seguir, por exemplo uma configuração incorreta, um ficheiro de dados em falta ou uma dependência incompatível.

Como resolver:

  1. Lê a primeira exception interna por baixo desta mensagem, normalmente introduzida por --->.
  2. Atualiza o WeaponPaints e o CounterStrikeSharp em conjunto para versões compatíveis entre si.
  3. Depois, corrige apenas o que a exception interna indicar em concreto: o ficheiro de configuração, um ficheiro de dados em falta como o weapons.json ou a ligação à base de dados. Encontras as credenciais da tua base de dados em Bases de dados.
  4. Reinicia o servidor e verifica a Consola.

„Could not load file or assembly“: falta uma dependência de um plugin .NET

Este é o aspeto da mensagem:

System.IO.FileNotFoundException: Could not load file or assembly '<Name>, Version=<Version>, Culture=neutral, PublicKeyToken=<…>' or one of its dependencies. The system cannot find the file specified.
 ---> System.IO.FileNotFoundException: Could not load file or assembly '<Name>, Version=<Version>, Culture=neutral, PublicKeyToken=null'. The system cannot find the file specified.

O que está por trás disto: Muitos jogos carregam plugins através de .NET, por exemplo o CS2 com CounterStrikeSharp, o Valheim com BepInEx ou o SCP: Secret Laboratory. Uma assembly é um ficheiro de programa .NET, normalmente uma .dll. A mensagem significa: um plugin precisa de uma determinada assembly que não está instalada, ou as versões das suas dependências não são compatíveis entre si. O plugin afetado não arranca ou só arranca parcialmente.

Como resolver:

  1. Lê o nome e a versão entre aspas. Essa é a dependência em falta.
  2. Consulta na página do plugin quais as dependências necessárias e em que versão. Muitas vezes estão incluídas como ficheiros .dll adicionais no pacote de transferência.
  3. Instala a dependência na versão exigida em Ficheiros, na pasta indicada pela página do plugin.
  4. Reinicia o servidor e verifica se a mensagem desapareceu.

Bom saber: ---> antes da linha marca a causa interna de uma mensagem de erro mais longa. O nome entre aspas é, mesmo assim, a dependência em falta.

TargetInvocationException / TypeInitializationException: componente .NET falha

É assim que a mensagem é apresentada:

System.TypeInitializationException: The type initializer for '<Class>' threw an exception
System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.

O que está por trás disto: Uma componente .NET, ou seja, um plugin, um mod ou uma parte do loader, falhou na sua rotina de inicialização ou num callback. Um callback é uma função que é chamada quando ocorre um determinado evento. Estas mensagens são apenas invólucros em torno do erro real: a inner exception que surge imediatamente a seguir contém a causa. A componente afetada deixa de funcionar ou passa a funcionar de forma limitada.

Como resolver:

  1. Determina qual a componente afetada. O nome da classe entre aspas e o stacktrace, a lista de chamadas abaixo do erro, ajudam a identificá-la.
  2. Atualiza essa componente e o mod ou plugin loader utilizado, por exemplo BepInEx ou CounterStrikeSharp.
  3. Reinicia o servidor e lê no log a primeira inner exception, normalmente introduzida por --->. Em jogos Unity, a exceção original surge muitas vezes diretamente acima de uma linha com Rethrow as.
  4. Corrige o que essa inner exception indica, por exemplo um ficheiro em falta ou uma definição incorreta.

„ReflectionTypeLoadException“: o plugin .NET não consegue carregar as suas classes

Este é o aspeto da mensagem:

System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested types.
System.Exception: Unable to find plugin in assembly

O que está por trás disto: O loader de plugins abriu o ficheiro do plugin, mas não conseguiu carregar as suas classes ou encontrar o ponto de entrada, ou seja, o local onde inicia o plugin. Ou o ficheiro do plugin não é compatível com a versão instalada do loader ou do jogo, ou está na pasta de plugins o ficheiro errado, por exemplo uma simples biblioteca auxiliar em vez do próprio plugin. O plugin fica então inativo.

Como resolver:

  1. Atualiza o plugin e o loader em conjunto, de modo a que ambos sejam compatíveis com a versão atual do jogo.
  2. Verifica em Ficheiros se o ficheiro correto do plugin está na pasta indicada na página do plugin.
  3. Apaga cópias mais antigas do mesmo plugin, para que seja carregada apenas uma versão.
  4. Reinicia o servidor e verifica a Consola.

Valheim: o mod não é compatível com a versão do jogo e fica sem efeito

Este é o aspeto da mensagem:

Rethrow as TypeInitializationException: The type initializer for '<Mod-Class>' threw an exception.

O que está por trás disto: O BepInEx, o loader de mods do Valheim, carregou o mod, mas este falhou logo ao inicializar. Tenta aceder a algo no jogo que não existe, ou já não existe, na versão do Valheim em execução. O servidor arranca na mesma normalmente e é totalmente jogável. O mod continua a aparecer como instalado, mas não faz nada, e no jogo não surge qualquer mensagem de erro a esse respeito. A causa mais frequente é uma atualização do Valheim: o servidor atualiza-se sozinho a cada arranque, mas o mod mantém-se na sua versão. O nome do mod aparece na linha acima.

Como resolver:

  1. Anota o nome do mod que aparece na linha acima da mensagem.
  2. Verifica em Mods se existe uma versão mais recente compatível com a versão atual do Valheim. Se sim, instala-a e reinicia o servidor.
  3. Se não existir uma versão compatível, desinstala o mod por agora. Caso contrário, ocupa apenas espaço e dá a impressão de estar ativo.
  4. Os mods que são importantes para o teu servidor só os voltas a ativar quando o respetivo autor os tiver atualizado para a nova versão do jogo.

Pormenores: Valheim 1.0: verificar com segurança a atualização do servidor, o mundo antigo e os mods

„ZRoutedRpc.Everybody“: o mod de Valheim não é compatível com a versão do jogo

É assim que a mensagem aparece:

MissingFieldException: Field not found: .ZRoutedRpc.Everybody Due to: Using static instructions with literal field
  at ServerSync.CustomSyncedValueBase.set_BoxedValue (…)
  at AzuCraftyBoxes.AzuCraftyBoxesPlugin..cctor ()

O que está por trás disto: ZRoutedRpc é a parte de Valheim através da qual o servidor e os jogadores trocam mensagens. Um mod do BepInEx foi criado para outra versão de Valheim e espera aí o campo Everybody, que não existe na versão instalada. O mod não consegue executar a sua função neste ponto e não funciona, ou funciona apenas em parte.

Como resolver:

  1. Procura no stacktrace, a lista das partes do programa chamadas por baixo da mensagem, o primeiro mod. Se aparecer primeiro ServerSync, continua a procurar pelo nome do mod, no exemplo AzuCraftyBoxes.
  2. Atualiza-o em Mods para uma versão compatível com a build atual de Valheim, ou seja, a versão do jogo em execução.
  3. Se ainda não existir nenhuma, desinstala o mod por agora e reinicia o servidor.
  4. Se o mod também estiver a ser usado pelos teus colegas de jogo, todos devem usar a mesma versão.

Com mais detalhe: Valheim 1.0: verificar com segurança a atualização do servidor, o mundo antigo e os mods

SCP: Secret Laboratory: não é possível carregar o plugin

Este é o aspeto da mensagem:

[LabApi] System.BadImageFormatException: <Plugin file details>

O que está por trás disto: O LabApi é a interface de plugins do SCP: Secret Laboratory. Não conseguiu carregar um ficheiro de plugin porque o seu formato não é compatível com a versão do servidor. É típico depois de uma atualização do jogo, quando um plugin ainda foi criado para a versão anterior, ou quando o ficheiro foi danificado durante o carregamento. O plugin afetado fica inativo e o servidor arranca sem ele.

Como resolver:

  1. Verifica se a mensagem indica o nome do ficheiro do plugin.
  2. Carrega novamente o plugin numa versão para a tua versão atual do SCP:SL e reinicia o servidor. A página do plugin indica as versões suportadas.
  3. Se não souberes qual é o plugin, remove em Ficheiros o último ficheiro adicionado à pasta de plugins e reinicia.
  4. Depois do carregamento, compara o tamanho do ficheiro com o original. Se for diferente, a transferência ficou incompleta.

Bom saber: encontras os fundamentos sobre o servidor em Configurar um servidor de SCP Secret Laboratory.

Project Zomboid: o mapa ou o mod usa uma propriedade de tile desconhecida

Este é o aspeto da mensagem:

IsoPropertyTypeNotFoundException: Property Name not found: <Property>

O que está por trás disto: Os mapas do Project Zomboid são compostos por tiles (mosaicos). Cada tile tem propriedades que definem, por exemplo, se algo é um contentor, uma porta ou um obstáculo. Um mapa ou mod está a usar aqui uma propriedade que a tua versão do Project Zomboid não conhece. Os objetos afetados podem faltar ou funcionar mal, mas o servidor normalmente continua a funcionar. Muitas vezes, o mapa ou o mod foi criado para outra versão do jogo, por exemplo depois da mudança para a Build 42.

Como resolver:

  1. Descobre qual é o mapa ou o mod afetado. Se a mensagem é nova, o último instalado ou atualizado é o primeiro suspeito.
  2. Atualiza o mapa ou o mod para uma versão compatível com a versão do Project Zomboid que tens instalada.
  3. Se o problema começou depois de uma atualização de um mod, repõe a versão compatível anterior desse mod.
  4. Se quiseres remover totalmente um mod de mapa, cria antes uma cópia de segurança em Cópias de segurança. Se faltar um mapa que o teu jogo guardado já utiliza, isso pode alterar o mundo.

Bom saber: Para a mudança para a Build 42, consulta Project Zomboid Build 42 no teu próprio servidor.

«Bolt is already running»: The Forest inicia o Bolt duas vezes

É assim que a mensagem se apresenta:

BoltException: Bolt is already running, you must call BoltLauncher.Shutdown() before starting a new instance of Bolt.
  at BoltCore.BeginStart (…)

O que está por trás disto: The Forest usa a biblioteca de rede Bolt para o modo multijogador. A mensagem significa: o servidor tentou iniciar uma segunda instância do Bolt, apesar de a primeira ainda estar em execução. Isto pode acontecer após um soft-restart com falha, ou seja, um reinício dentro do programa em execução em vez de um reinício real do processo. A nova sessão não consegue assim arrancar corretamente.

Como resolver:

  1. Para o servidor no painel e espera até que esteja completamente desligado.
  2. Inicia-o novamente depois. Um processo novo inicia o Bolt apenas uma vez.
  3. Para reiniciar, não usa nenhuma função dentro do jogo nem uma recarga em funcionamento, mas sim sempre o reinício através do painel.
  4. Para reinícios regulares, configura um reinício agendado em Tarefas.

Bom saber: Como fazer isto está explicado em Agendar reinícios automáticos para o teu servidor.

«NetworkInformationException»: The Forest não consegue ler os adaptadores de rede

É assim que a mensagem se apresenta:

NetworkInformationException: File not found.
  at CoopDedicatedServerStarter.getMachineIp ()

O que está por trás disto: No arranque, o servidor dedicado de The Forest tenta identificar os seus adaptadores de rede e, assim, o seu próprio endereço IP. A interface do sistema operativo que é consultada para esse fim não está disponível no ambiente do servidor. Se o servidor continuar acessível, a mensagem não tem qualquer efeito adicional.

Como resolver:

  1. Verifica se o servidor está acessível: aparece na lista de servidores e os jogadores conseguem entrar?
  2. Se sim, podes ignorar a mensagem.
  3. Se não, atualiza o servidor para o build atual, ou seja, a versão mais recente do servidor do jogo, e reinicia-o.
  4. Se continuar inacessível, abre um ticket e indica a hora da mensagem. O ambiente de arranque do servidor não pode ser alterado por ti próprio.

Bom saber: Encontras os fundamentos sobre o servidor em Configurar um servidor The Forest.

A mod comunica «CS0246: tipo ou espaço de nomes não encontrado»

Assim se apresenta a mensagem:

<File>.cs(<Line>,<Column>): error CS0246: The type or namespace name '<Type>' could not be found

O que está por trás: O compilador, que traduz o código-fonte C# em partes executáveis do programa, não encontra um tipo utilizado. O nome não pode ser resolvido nem no código-fonte existente nem através das bibliotecas incluídas. Por isso, não é possível carregar a mod afetada. No caso de ficheiros de mods fornecidos ou personalizados, o código-fonte e as bibliotecas têm de corresponder à versão do jogo.

Como resolver:

  1. Lê a mensagem de erro completa na Consola. Ela indica o ficheiro, a linha e o tipo em falta.
  2. Guarda as tuas alterações próprias em Ficheiros antes de substituíres ficheiros de mods.
  3. Instala uma versão da mod afetada que corresponda à versão do jogo, juntamente com as dependências necessárias. No caso de código-fonte próprio, verifica a grafia, o espaço de nomes e as referências às bibliotecas.
  4. Reinicia o servidor e verifica se o compilador comunica mais erros.

O RustCore não encontra os campos necessários nos ficheiros do servidor Rust

Como surge a mensagem:

Failed to initialize plugin 'RustCore v<Version>' (MissingFieldException: Field not found: <Field>)
Failed to call hook '<Hook>' on plugin 'RustCore v<Version>' (MissingFieldException: Field not found: <Field>)

O que está por trás: O Oxide liga o Rust aos plugins instalados. O seu componente principal, o RustCore, espera campos, ou seja, elementos de dados internos, que não existem nas bibliotecas do Rust carregadas. Por isso, a sua inicialização ou o processamento de comandos do servidor falha, e as funções dos plugins afetados deixam de funcionar.

Como resolver:

  1. Cria uma cópia de segurança do teu mundo e dos dados dos plugins em Cópias de segurança. Depois, pára o servidor por completo.
  2. Verifica se a versão do Oxide utilizada corresponde à versão do servidor Rust. Atualiza os ficheiros do servidor Rust e, de seguida, instala por completo a versão do Oxide correspondente.
  3. Reinicia o servidor. Na Consola, verifica se o RustCore carrega agora e se os comandos afetados funcionam.
  4. Se o erro persistir, abre um ticket e indica a hora, bem como as versões do Rust e do Oxide utilizadas.

O DayZ não consegue substituir um item do inventário

É assim que a mensagem aparece:

ReplaceItemWithNewLambdaBase Step D) ABORT - wanted to create=<Item> at loc={<Slot>}, but failed

O que está por trás disto: O DayZ interrompe a substituição de um item do inventário; no exemplo detalhado, uma peça de veículo danificada não pode ser criada no local previsto. A alteração de inventário em causa falha, enquanto o servidor continua a funcionar. A linha curta OnAbort é a mensagem de interrupção correspondente; a linha detalhada antes dela indica o passo que falhou.

Como resolver:

  1. Verifica na consola as linhas antes da interrupção e anota qual o mod de veículos ou inventário envolvido.
  2. Cria uma cópia de segurança em Cópias de segurança e compara os mods instalados, incluindo as suas dependências, com as respetivas indicações de compatibilidade.
  3. Após uma atualização adequada do mod e um reinício completo, testa novamente a mesma ação de inventário; se o erro persistir, reporta-o aos desenvolvedores do mod com o log completo.

MatchZy: o comando de pausa falha devido a uma sequência de dados vazia

É assim que a mensagem é apresentada:

System.InvalidOperationException: Sequence contains no elements
   at System.Linq.ThrowHelper.ThrowNoElementsException()
   at MatchZy.MatchZy.IsTacticalTimeoutActive()

O que está por trás disto: O MatchZy verifica, ao pausar, se já existe um tempo-limite tático ativo. Nesse processo, o plugin espera uma entrada numa sequência de dados, mas não encontra nenhuma. O comando de pausa é cancelado com um erro; o servidor de CS2 continua a funcionar. As linhas de chamada seguintes chamam-se stacktrace e mostram o caminho até ao erro.

Como resolver:

  1. Lê o rasto de erro completo na Consola. Anota o comando que o despoletou e o estado do jogo, por exemplo se já havia uma pausa ativa.
  2. Faz uma cópia de segurança das definições do MatchZy em Ficheiros. Verifica se o MatchZy e o CounterStrikeSharp suportam o build de CS2 utilizado e atualiza para versões compatíveis entre si.
  3. Reinicia o servidor por completo e testa novamente a pausa. Se o erro persistir, envia ao autor do MatchZy o rasto de erro limpo, as versões e os passos para o reproduzir.

«Unable to connect to any of the specified MySQL hosts»: o plugin do CS2 não consegue aceder à base de dados

É assim que a mensagem se apresenta:

MySqlConnector.MySqlException (0x80004005): Unable to connect to any of the specified MySQL hosts.
   at MySqlConnector.Core.ServerSession.OpenTcpSocketAsync(...)

O que está por trás disto: Um plugin CounterStrikeSharp, por exemplo para administradores, patentes ou skins, liga-se a uma base de dados MySQL através da biblioteca MySqlConnector. Nenhum dos hosts indicados responde. Normalmente o endereço ou a porta estão incorretos na configuração do plugin, ou ainda não existe nenhuma base de dados criada. Tudo o que o plugin guarda ou lê na base de dados deixa de funcionar; o servidor de CS2 continua a funcionar.

Como resolver:

  1. Cria uma base de dados em Bases de dados, caso ainda não exista nenhuma, e abre os respetivos dados de acesso.
  2. Abre em Ficheiros o ficheiro de configuração do plugin mencionado no stacktrace.
  3. Introduz o host, a porta, o nome da base de dados, o utilizador e a palavra-passe exatamente como aparecem em Bases de dados.
  4. Reinicia o servidor e verifica a Consola.

Bom saber: O stacktrace é a lista de linhas «at»; mais abaixo encontra-se normalmente o nome do plugin.

„The given key … was not present“: um módulo do CS2 não encontra o seu plugin principal

É assim que a mensagem aparece:

System.Collections.Generic.KeyNotFoundException: The given key '<plugin>:api' was not present in the dictionary.
   at CounterStrikeSharp.API.Core.Capabilities.PluginCapability`1.Get()

O que está por trás disto: Muitos plugins do CounterStrikeSharp consistem num plugin principal e em módulos. Um módulo obtém, através de uma interface (capability), as funções do plugin principal ao ser carregado. Se o plugin principal não estiver carregado ou tiver falhado ao iniciar, essa interface fica indisponível. O módulo deixa então de funcionar, mas o servidor continua a funcionar.

Como resolver:

  1. Procura na Consola, mais acima, por erros do plugin principal, por exemplo uma DLL em falta („Could not load file or assembly“).
  2. Resolve primeiro esse erro, por exemplo instalando a dependência em falta.
  3. Instala o plugin principal e os módulos em versões compatíveis entre si, de acordo com a página do plugin.
  4. Reinicia o servidor por completo e verifica novamente a Consola.

„Assembly with same name is already loaded“: um plugin do CS2 está duplicado

É assim que a mensagem aparece:

System.IO.FileLoadException: Could not load file or assembly '<Plugin>, Version=<Version>, Culture=neutral, PublicKeyToken=null'. Assembly with same name is already loaded

O que está por trás disto: O CounterStrikeSharp carrega cada plugin a partir de um ficheiro DLL (assembly). Já existe uma DLL carregada com esse nome, geralmente porque o mesmo plugin está duplicado na pasta de plugins, por exemplo depois de uma atualização numa segunda subpasta. A segunda cópia não é carregada.

Como resolver:

  1. Cria uma cópia de segurança em Cópias de segurança.
  2. Abre em Ficheiros a pasta addons/counterstrikesharp/plugins.
  3. Procura subpastas que contenham uma DLL com o nome indicado.
  4. Mantém apenas a versão atual e elimina as restantes cópias.
  5. Reinicia o servidor por completo.

Bom saber: Se dois plugins diferentes trouxerem uma DLL com o mesmo nome, pergunta aos respetivos autores quais as versões compatíveis entre si.

A tua mensagem não está aqui?

Lê a mensagem completa na Consola ou no ficheiro de registo do jogo, incluindo as linhas anteriores. Nos jogos .NET e Unity, a verdadeira causa está muitas vezes na exception interna. Os nomes das pastas e dos ficheiros no stacktrace revelam que plugin ou mod está envolvido. Antes de cada substituição, cria uma cópia de segurança em Cópias de segurança. Falhas e atualizações que não funcionam são tratadas em O servidor de jogo falha ou a atualização do Steam não funciona. Se não conseguires avançar, abre um ticket e indica a hora da mensagem.