Qu’est-ce qui dépend de quoi ?

L’ordre est important : MetaMod:Source charge les extensions natives, CounterStrikeSharp fournit le framework de plugins C#, et MatchZy fonctionne comme plugin CounterStrikeSharp. Après une mise à jour de CS2, les versions des frameworks doivent correspondre au build actuel du serveur.

Cette structure explique aussi pourquoi les erreurs se propagent presque toujours de bas en haut : si MetaMod ne se charge pas, CounterStrikeSharp ne démarre même pas, et MatchZy n’apparaît alors dans aucune liste de plugins. Si tu réinstalles d’abord MatchZy dans cette situation, tu répares la mauvaise couche. Avance donc toujours du niveau le plus bas vers le haut.

Prérequis

Avant de commencer, vérifie trois choses :

  • Accès au serveur : Tu as besoin d’un accès au gestionnaire de plugins dans le panel ou à la gestion des fichiers. Pour la variante manuelle, un accès SFTP aux fichiers du serveur de jeu est nécessaire.
  • Une sauvegarde récente : Les installations de plugins modifient game/csgo/addons/. Une sauvegarde avant le premier accès en écriture évite une réinstallation complète en cas d’erreur.
  • Un serveur arrêté : N’écris jamais dans addons/ pendant que le serveur tourne. Des fichiers écrits partiellement entraînent des erreurs de chargement difficiles à distinguer de vrais conflits de versions.

Installation dans le panel

  1. Crée une sauvegarde et arrête le serveur.
  2. Ouvre le gestionnaire de plugins et installe d’abord MetaMod:Source.
  3. Installe ensuite CounterStrikeSharp.
  4. Démarre le serveur une fois. Dans le log, MetaMod et CounterStrikeSharp doivent apparaître sans erreur de chargement.
  5. Arrête à nouveau le serveur, installe MatchZy et démarre-le.
  6. Vérifie avec css_plugins list dans la console du serveur si MatchZy est chargé.

En installation manuelle, MetaMod et CounterStrikeSharp vont dans game/csgo/addons/ ; MatchZy se trouve dans game/csgo/addons/counterstrikesharp/plugins/MatchZy/. Utilise le gestionnaire de plugins si possible, afin que les chemins et les versions compatibles soient choisis automatiquement.

Le démarrage intermédiaire après l’étape 3 n’est pas une étape optionnelle. Il sépare proprement deux sources d’erreur : si le serveur bloque déjà à ce stade, le problème vient du framework et non de MatchZy. Si tu installes tout d’un coup et que le serveur ne démarre plus, tu devras ensuite deviner lequel des trois composants est responsable.

Commandes de base pour un match

Les joueurs utilisent les commandes de chat :

.ready       se déclarer prêt
.unready     retirer son statut prêt
.pause       mettre le match en pause
.unpause     reprendre le match

Selon la configuration de MatchZy, les mêmes commandes peuvent aussi commencer par !. Les admins chargent une configuration de match via la commande de chargement fournie par MatchZy ; vérifie au préalable le nom exact du fichier dans ta configuration MatchZy.

Commandes serveur utiles :

status
mp_warmup_end
mp_restartgame 1
changelevel de_mirage
bot_kick

Si tu veux lancer régulièrement des matchs sans travailler dans la console, le CS2 Match Center avec MatchZy est la solution la plus pratique : équipes, map, format et GOTV peuvent y être définis dans un formulaire, au lieu de saisir chaque réglage par commande.

Identifier les erreurs

Les trois symptômes les plus fréquents ont des causes clairement distinctes :

  • css_plugins list ne connaît pas la commande. Dans ce cas, CounterStrikeSharp n’est pas chargé. Vérifie dans le log de démarrage si MetaMod a bien été initialisé — sans MetaMod, il n’y a pas de CounterStrikeSharp.
  • css_plugins list fonctionne, mais MatchZy manque dans la sortie. Le framework et la couche plugin sont corrects, mais MatchZy se trouve dans le mauvais répertoire ou ne correspond pas à la version installée de CounterStrikeSharp.
  • Le serveur ne démarre plus après l’installation. Il s’agit le plus souvent d’un conflit de versions après une mise à jour de CS2. Retire MatchZy à titre de test, démarre le serveur puis remonte progressivement les couches.

Lis toujours le log de démarrage de haut en bas. Le premier bloc Failed, Error ou Exception indique la couche concernée ; tout ce qui suit correspond généralement à des erreurs consécutives qui disparaissent d’elles-mêmes dès que la cause est corrigée.

Après une mise à jour de CS2

Si des plugins disparaissent soudainement, ne réinstalle pas tout le serveur de jeu. Vérifie d’abord si MetaMod et CounterStrikeSharp se chargent encore, mets à jour ces deux frameworks puis MatchZy. Le premier bloc Failed, Error ou Exception dans le log de démarrage indique normalement la couche concernée.

Valve publie des mises à jour CS2 sans tenir compte des frameworks tiers. Il peut donc s’écouler de quelques heures à plusieurs jours entre une mise à jour et la version MetaMod ou CounterStrikeSharp compatible. Pour les matchs de ligue à horaire fixe, il vaut la peine de contrôler précisément les mises à jour automatiques, afin qu’un serveur ne passe pas juste avant le match sur un build pour lequel aucun plugin compatible n’existe encore.

FAQ

Dois-je aussi installer SourceMod ? Pas pour MatchZy. MatchZy s’appuie sur CounterStrikeSharp. SourceMod est un écosystème de plugins indépendant et parallèle, et il n’est pas nécessaire pour cette stack.

Dans quel ordre dois-je mettre à jour ? Toujours de bas en haut : d’abord MetaMod:Source, puis CounterStrikeSharp, et enfin MatchZy. Dans l’autre sens, le plugin du haut se charge contre un framework qui ne correspond pas encore au build du serveur.

Pourquoi les commandes de chat ne réagissent-elles pas ? Soit MatchZy n’est pas chargé — css_plugins list te l’indique — soit ta configuration utilise un autre préfixe de commande. .ready et !ready sont tous deux courants.

Puis-je installer des plugins pendant que le serveur tourne ? Non. Arrête le serveur avant. Les accès en écriture à addons/ pendant que le processus tourne créent des fichiers incomplets et des erreurs de chargement qui ressemblent à des conflits de versions.

Où trouver la documentation officielle ? Les étapes d’installation et les options de configuration de MatchZy se trouvent dans la documentation MatchZy. Pour les questions de version autour de la famille Metamod/SourceMod, la vue d’ensemble des versions requises chez AlliedModders fait référence.

Le serveur tourne, mais les performances chutent pendant le match. Ce n’est pas un problème de plugin au sens strict. Vérifie séparément le tickrate et la charge du serveur, indépendamment de la stack de plugins — il existe pour cela un guide dédié sur le tickrate et les performances des serveurs CS2.