WeaponPaints for CS2 — a skin changer plugin on CSSharp

[CS2] WeaponPaints — a full C# skin changer with a web interface

Platform: CounterStrikeSharp (C# / .NET).

Software type: standalone skin changer (weapons, knives, gloves, agents, patches, pins, music kits).

Data storage: local MySQL database or the built-in global web service (GlobalShare).

Author: Nereziel

WeaponPaints is one of the most popular and polished server-side skin changers for Counter-Strike 2. It lets players fully customize their inventory right during a match, with fine control over wear, pattern (seed), name tags and stickers. Its main feature is a full web interface for picking skins comfortably in the browser.

🚀 Key features:

Two ways to manage it: standard chat menu commands (!knife, !gloves, !agents, !pins, !music, !wp to refresh) or the advanced web interface (!ws), where the player signs in via Steam on your website and sets up a custom inventory.

Full customization: change wear and pattern, apply up to 4 stickers per weapon, pick charms, agents and music.

Data sync: the player's inventory is saved automatically and loaded instantly every time they join the server.

📦 Important dependencies:

For the in-game menus to work and settings to be saved correctly, install these libraries on the server:

➔ AnyBaseLibCS2 — https://github.com/NickFox007/AnyBaseLibCS2 (base library)

➔ PlayerSettings — https://github.com/NickFox007/PlayerSettingsCS2 (player settings storage)

➔ MenuManagerCS2 — https://github.com/NickFox007/MenuManagerCS2 (server menu manager)

📂 Official project resources:

➔ Main WeaponPaints repository on GitHub: https://github.com/Nereziel/cs2-WeaponPaints

🛠️ Installation:

1. Make sure CounterStrikeSharp is deployed and all three dependency libraries are installed (see the dependencies block).

2. Open the Releases section of the project repository and download the latest WeaponPaints build.

3. Unpack the archive. Move the WeaponPaints plugin folder to the server directory:

game/csgo/addons/counterstrikesharp/plugins/

4. Move the weaponpaints.json gamedata file from the archive to the shared CSSharp gamedata folder:

game/csgo/addons/counterstrikesharp/gamedata/

5. Start the server once to generate the default config files. The plugin creates the required tables in your MySQL automatically.

6. Open the generated connection config at:

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

Enter your MySQL database details there. If you don't want to run your own website, you can set "GlobalShare": true to use the free shared web service.

⚠️ Important engine setting: so the plugin can replace default models and skins, open game/csgo/addons/counterstrikesharp/configs/core.json, find "FollowCS2ServerGuidelines" and set its value to false.

7. Fully restart the game server.