Instalar WeaponPaints — Skins y cuchillos (!ws !knife)

¿Qué es WeaponPaints?

WeaponPaints es uno de los plugins más populares de CS2. Permite a los jugadores elegir skins de armas, cuchillos, guantes y agentes directamente en el servidor usando comandos como !ws, !knife y !gloves. Los skins se guardan por jugador en base de datos.

Requisitos previos

• Metamod:Source + CounterStrikeSharp instalados
• Base de datos MySQL/MariaDB
• Servidor CS2 apagado

Paso 1 — Descargar WeaponPaints

cd /home/container/game/csgo/addons/counterstrikesharp/plugins
wget https://github.com/Nereziel/cs2-WeaponPaints/releases/latest/download/WeaponPaints-v3.X.zip
unzip WeaponPaints-v3.X.zip

Paso 2 — Crear la base de datos

CREATE DATABASE cs2_weaponpaints;
CREATE USER 'cs2skins'@'localhost' IDENTIFIED BY 'password_segura';
GRANT ALL PRIVILEGES ON cs2_weaponpaints.* TO 'cs2skins'@'localhost';
FLUSH PRIVILEGES;

Paso 3 — Configurar el plugin

Iniciá el servidor una vez para generar la configuración, luego editá:

addons/counterstrikesharp/configs/plugins/WeaponPaints/WeaponPaints.json

{
  "DatabaseHost": "localhost",
  "DatabasePort": 3306,
  "DatabaseUser": "cs2skins",
  "DatabasePassword": "password_segura",
  "DatabaseName": "cs2_weaponpaints",
  "Give": {
    "Knife": true,
    "Gloves": true,
    "Agents": true,
    "Music": true,
    "Pins": true
  },
  "Additional": {
    "SkinVisibilityFix": true,
    "KnifeStatTrak": true,
    "GloveStatTrak": false
  },
  "CommandPrefix": "!",
  "CommandCooldown": 5
}

Paso 4 — Descargar la base de datos de skins

WeaponPaints necesita un archivo con todos los skins disponibles. Descargalo:

cd addons/counterstrikesharp/plugins/WeaponPaints/
wget https://raw.githubusercontent.com/Nereziel/cs2-WeaponPaints/main/website/data/skins.json
wget https://raw.githubusercontent.com/Nereziel/cs2-WeaponPaints/main/website/data/gloves.json
wget https://raw.githubusercontent.com/Nereziel/cs2-WeaponPaints/main/website/data/agents.json
wget https://raw.githubusercontent.com/Nereziel/cs2-WeaponPaints/main/website/data/music.json

Paso 5 — Comandos para jugadores

Paso 6 — Panel web (opcional)

WeaponPaints incluye un panel web donde los jugadores eligen skins desde el navegador:

1. Subí la carpeta website/ a un servidor web con PHP
2. Configurá la conexión a la misma base de datos
3. Los jugadores inician sesión con Steam y eligen skins visualmente
4. Los cambios se aplican la próxima vez que se conecten al servidor

Paso 7 — Configuración avanzada

Limitar skins por permisos

Podés restringir ciertos skins a VIPs:

{
  "VIPOnly": {
    "Knives": ["butterfly", "karambit", "skeleton"],
    "Permission": "@css/vip"
  }
}

Cooldown entre cambios

Para evitar spam:

{
  "CommandCooldown": 10,
  "SkinChangeCooldown": 30
}

Solución de problemas

• Skins no se ven: Activá SkinVisibilityFix en la configuración
• "No skins available": Los archivos JSON de datos no están descargados o están vacíos
• Error de base de datos: Verificá credenciales y que el usuario tenga permisos sobre la DB
• Cuchillo no cambia: Asegurate de que Knife: true esté en la configuración

Recomendaciones

• Actualizá los archivos JSON de skins después de cada actualización de CS2 (Valve agrega skins nuevos)
• El panel web mejora mucho la experiencia del jugador
• Podés usar WeaponPaints como incentivo VIP (skins exclusivos para donadores)
• Hacé backup de la base de datos periódicamente