mirror of
https://github.com/Nereziel/cs2-WeaponPaints.git
synced 2026-02-22 19:54:27 +00:00
170 lines
7.4 KiB
Markdown
170 lines
7.4 KiB
Markdown
```
|
||
|
||
__ __ ___ _ _
|
||
/ / /\ \ \___ __ _ _ __ ___ _ __ / _ \__ _(_)_ __ | |_ ___
|
||
\ \/ \/ / _ \/ _` | '_ \ / _ \| '_ \ / /_)/ _` | | '_ \| __/ __|
|
||
\ /\ / __/ (_| | |_) | (_) | | | / ___/ (_| | | | | | |_\__ \
|
||
\/ \/ \___|\__,_| .__/ \___/|_| |_\/ \__,_|_|_| |_|\__|___/
|
||
|_|
|
||
|
||
```
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/Nereziel/cs2-WeaponPaints/releases">📖 Releases</a> •
|
||
<a href="https://discord.gg/d9CvaYPSFe">💬 Discord</a>
|
||
<br /><br />
|
||
</p>
|
||
<hr />
|
||
|
||
## 📝 Description
|
||
Unfinished, unoptimized and not fully functional ugly demo weapon paints plugin for **[CSSharp](https://docs.cssharp.dev/docs/guides/getting-started.html)**.
|
||
|
||
|
||
### 💸 Consider to donate instead of buying from unknown sources.
|
||
[](https://ko-fi.com/E1E2G0P2O) or [](https://steamcommunity.com/tradeoffer/new/?partner=41515647&token=gW2W-nXE)
|
||
|
||
## ✨ 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](https://github.com/roflmuffin/CounterStrikeSharp)
|
||
- [PlayerSettings](https://github.com/NickFox007/PlayerSettingsCS2) - Required by MenuManagerCS2
|
||
- [AnyBaseLibCS2](https://github.com/NickFox007/AnyBaseLibCS2) - Required by PlayerSettings
|
||
- [MenuManagerCS2](https://github.com/NickFox007/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
|
||
<details>
|
||
<summary>Click to expand</summary>
|
||
<code><pre>{
|
||
"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
|
||
}
|
||
</pre></code>
|
||
</details>
|
||
|
||
## 🖥️ 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](https://steamcommunity.com/dev/apikey)
|
||
- 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](https://github.com/counterstrikesharp-panel/css-bans)**
|
||
- **[CS2-WeaponPaints-Website](https://github.com/LielXD/CS2-WeaponPaints-Website)**
|
||
- **[cs2-WeaponPaints-website](https://github.com/L1teD/cs2-WeaponPaints-website)** > This webiste is different from the one above!
|
||
- **[CS2-WeaponPaints-Web](https://github.com/rogeraabbccdd/CS2-WeaponPaints-Web)**
|
||
## 🤔 Troubleshooting
|
||
<details>
|
||
|
||
**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';
|
||
```
|
||
</details>
|
||
|
||
### Use this plugin at your own risk! Using this may lead to GSLT ban or something else Valve come with. [Valve Server guidelines](https://blog.counter-strike.net/index.php/server_guidelines/)
|
||
|
||
## Website Preview
|
||
|