cs2-WeaponPaints/README.md

	 	     __    __                               ___      _       _       
		    / / /\ \ \___  __ _ _ __   ___  _ __   / _ \__ _(_)_ __ | |_ ___ 
		    \ \/  \/ / _ \/ _` | '_ \ / _ \| '_ \ / /_)/ _` | | '_ \| __/ __|
		     \  /\  /  __/ (_| | |_) | (_) | | | / ___/ (_| | | | | | |_\__ \
		      \/  \/ \___|\__,_| .__/ \___/|_| |_\/    \__,_|_|_| |_|\__|___/
        		 	       |_|
                                     

📖 Releases • 💬 Discord

---

📝 Description

Unfinished, unoptimized and not fully functional ugly demo weapon paints plugin for CSSharp.

💸 Consider to donate instead of buying from unknown sources.

or

✨ Features

• Changes only paint, seed and wear on weapons, knives, gloves and agents
• MySQL based
• Data syncs on player connect
• Added command !wp to refresh skins (with cooldown in seconds can be configured)
• Added command !ws to show website
• Added command !knife to show menu with knives
• Added command !stattrak to enable stattrak on weapon
• Added command !gloves to show menu with gloves
• Added command !agents to show menu with agents
• Added command !pins to show menu with pins
• Added command !music to show menu with music
• Translations support, submit a PR if you want to share your translation

⚙️ Requirements

Ensure all the following dependencies are installed before proceeding

• CounterStrikeSharp
• PlayerSettings - Required by MenuManagerCS2
• AnyBaseLibCS2 - Required by PlayerSettings
• MenuManagerCS2
• MySQL database

🗄️ CS2 Server

• Have working CounterStrikeSharp (with RUNTIME!)
• Download from Release and copy plugin to plugins
• Run server with plugin, it will generate config if installed correctly!
• Edit addons/counterstrikesharp/configs/plugins/WeaponPaints/WeaponPaints.json include database credentials
• In addons/counterstrikesharp/configs/core.json set FollowCS2ServerGuidelines to false
• Copy from plugins folder gamedata file weaponpaints.json to folder addons/counterstrikesharp/gamedata/

🛠️ Plugin Configuration

Click to expand

{
  "ConfigVersion": 10, // Don't touch
  "SkinsLanguage": "en", // Language
  "DatabaseHost": "", // MySQL host
  "DatabasePort": 3306, // MySQL Port
  "DatabaseUser": "", // MySQL Username
  "DatabasePassword": "", // MySQL User password
  "DatabaseName": "", // MySQL Database name
  "CmdRefreshCooldownSeconds": 3, // Cooldown time in refreshing skins (!wp command)
  "Website": "example.com/skins", // Website used in WebsiteMessageCommand (!ws command)
  "Additional": {
    "KnifeEnabled": true, // If knives are enabled
    "GloveEnabled": true, // If gloves are enabled
    "MusicEnabled": true, // If music kits are enabled
    "AgentEnabled": true, // If agents are enabled
    "SkinEnabled": true, // If skins are enabled
    "PinsEnabled": true, // If pins are enabled
    "CommandWpEnabled": true, // If command !wp is enabled
    "CommandKillEnabled": true, // If command !kill is enabled
    "CommandKnife": [ // Command for knives
      "knife"
    ],
    "CommandMusic": [ // Command for music kits
      "music"
    ],
    "CommandPin": [  // Command for pins
      "pin",
      "pins",
      "coin",
      "coins"
    ],
    "CommandGlove": [  // Command for gloves
      "gloves"
    ],
    "CommandAgent": [ // Command for agents
      "agents"
    ],
    "CommandStattrak": [  // Command for stattrak
      "stattrak",
      "st"
    ],
    "CommandSkin": [  // Command for skins
      "ws"
    ],
    "CommandSkinSelection": [  // Command for skin selection
      "skins"
    ],
    "CommandRefresh": [  // Command for refreshing your skins
      "wp"
    ],
    "CommandKill": [  // Command for death
      "kill"
    ],
    "GiveRandomKnife": false, // If it should give you Random Knife
    "GiveRandomSkin": false, // If it should give you Random Skin
    "ShowSkinImage": true // When you select a skin if it should show skins image
  },
  "MenuType": "selectable" // Menu type commands. Can be: selectable, dynamic, center, chat, console
}

🖥️ Web install

• Requires PHP >= 7.4 with curl and pdo_mysql (Tested on php ver 8.2.3 and nginx webserver)
• Before using website, make sure the plugin is correctly loaded in cs2 server! Mysql tables are created by plugin not by website.
• Copy website to web server (Folder img not needed)
• Get Steam API Key
• Fill in database credentials and api key in class/config.php
• Visit website and login via steam

🧩 Web Features

Warning

We recommend you to use any third-party website for WeaponPaints. Website by us doesn't get updated!

• Basic website
• Steam login/logout
• Change knife, paint, seed and wear

🌐 Third-party websites

• CSS-Bans
• CS2-WeaponPaints-Website
• cs2-WeaponPaints-website > This webiste is different from the one above!
• CS2-WeaponPaints-Web

🤔 Troubleshooting

Skins are not changing: Set FollowCSGOGuidelines to false in cssharp’s core.jcon config

Database error table does not exists: Plugin is not loaded or configured with mysql credentials. Tables are auto-created by plugin.

An error occured in Get....FromDatabase: If you used WeaponPaints and you update to newer version you could get this error. You need to add this queries to Database:

ALTER TABLE wp_player_skins
ADD COLUMN weapon_nametag VARCHAR(128) DEFAULT NULL,
ADD COLUMN weapon_stattrak tinyint(1) NOT NULL,
ADD COLUMN weapon_stattrak_count int(10) NOT NULL,
ADD COLUMN weapon_sticker_0 VARCHAR(128) DEFAULT '0;0;0;0;0;0;0' COMMENT 'id;schema;x;y;wear;scale;rotation',
ADD COLUMN weapon_sticker_1 VARCHAR(128) DEFAULT '0;0;0;0;0;0' COMMENT 'id;schema;x;y;wear;scale;rotation',
ADD COLUMN weapon_sticker_2 VARCHAR(128) DEFAULT '0;0;0;0;0;0' COMMENT 'id;schema;x;y;wear;scale;rotation',
ADD COLUMN weapon_sticker_3 VARCHAR(128) DEFAULT '0;0;0;0;0;0' COMMENT 'id;schema;x;y;wear;scale;rotation',
ADD COLUMN weapon_sticker_4 VARCHAR(128) DEFAULT '0;0;0;0;0;0' COMMENT 'id;schema;x;y;wear;scale;rotation',
ADD COLUMN weapon_keychain VARCHAR(128) DEFAULT '0;0;0;0;0' COMMENT 'id;x;y;z;seed';

Use this plugin at your own risk! Using this may lead to GSLT ban or something else Valve come with. Valve Server guidelines

Website Preview