Solucionar problemas comunes con plugins CS2

Problemas con Metamod

"Unknown command: meta"

Causa: Metamod no está cargando correctamente.

Solución:

1. Verificá que addons/metamod.vdf exista y tenga el formato correcto
2. Revisá que la carpeta addons/metamod/bin/linux64/ contenga server.so
3. Verificá permisos: chmod +x addons/metamod/bin/linux64/server.so

Server crash al iniciar con Metamod

Causa: Versión incompatible con la build actual de CS2.

Solución:

# Descargá la última versión dev (no stable)
wget https://mms.alliedmods.net/mmsdrop/2.0/mmsource-latest-linux.tar.gz

Problemas con CounterStrikeSharp

CSS no aparece en "meta list"

Causa: No está registrado en Metamod.

Solución:

# Verificá que metaplugins.ini contenga:
cat addons/metamod/metaplugins.ini
# Debe decir: counterstrikesharp

Error: "Failed to load .NET runtime"

Causa: Descargaste la versión sin runtime.

Solución: Descargá la versión with-runtime:

# Buscar el archivo que diga "with-runtime" en el nombre
counterstrikesharp-with-runtime-build-XXX-linux.zip

Plugins no cargan (css_plugins list vacío)

Causa: Estructura de carpetas incorrecta.

Solución: Cada plugin debe estar en su propia subcarpeta:

plugins/
├── MatchZy/
│   └── MatchZy.dll    ✅ Correcto
├── MatchZy.dll        ❌ Incorrecto (no está en subcarpeta)

Problemas con plugins específicos

"Database connection failed"

Causa: Credenciales incorrectas o MySQL no accesible.

Diagnóstico:

# Probar conexión manual
mysql -u cs2admin -p -h localhost cs2_admin

Soluciones:

• Verificá host, puerto, usuario y password
• Asegurate de que MySQL esté corriendo: systemctl status mysql
• Verificá que el usuario tenga permisos: SHOW GRANTS FOR 'cs2admin'@'localhost';

Plugin carga pero comandos no funcionan

Causa: Permisos de admin no configurados.

Solución:

1. Verificá tu SteamID64 en configs/admins.json
2. Asegurate de usar el formato correcto: 76561198XXXXXXXXX
3. Verificá que los flags sean correctos para el comando que intentás usar

MatchZy: ".ready" no funciona

Causas posibles:

• Otro plugin intercepta el chat
• MatchZy no está en modo PUG

Solución:

# Verificar modo
matchzy_autostart_mode
# Debe ser 1 para PUG automático

WeaponPaints: Skins no se ven

Causa: Bug de visibilidad de CS2.

Solución: Activá SkinVisibilityFix en la configuración del plugin.

Herramientas de diagnóstico

Ver logs de CSS

# Logs en tiempo real
tail -f addons/counterstrikesharp/logs/latest.log

Verificar versiones

# En la consola del servidor
meta version
meta list
css_plugins list

Verificar permisos de archivos

# Todos los .so deben ser ejecutables
find addons/ -name "*.so" -exec ls -la {} \;

# Corregir permisos
find addons/ -name "*.so" -exec chmod +x {} \;

Orden de diagnóstico recomendado

1. ¿Metamod carga? → meta version
2. ¿CSS carga? → meta list (debe aparecer CounterStrikeSharp)
3. ¿El plugin carga? → css_plugins list
4. ¿Hay errores en logs? → Revisar logs/latest.log
5. ¿Permisos correctos? → Verificar admins.json
6. ¿Base de datos conectada? → Probar conexión manual

Recomendaciones

• Siempre revisá los logs antes de buscar ayuda
• Instalá plugins de a uno y verificá que carguen
• Mantené un servidor de pruebas separado del de producción
• Uní al Discord de CounterStrikeSharp para soporte de la comunidad