Weapons Skins Ultimate

Full Documentation

Last Updated @ 09/24/2025

Back to Plugin Page

Description

WSU 1 WSU 2 WSU 3 WSU 4 WSU 5 WSU 6

Weapons Skins Ultimate is an advanced ReAPI-based system that lets you add unlimited skins for every weapon. Each skin can have custom attributes like speed, gravity, health on kill, and more. Skins can be restricted by level (when used with any rank system) or by admin flags—you can even restrict the entire menu.


The system supports v_, p_ and w_ models. A standout feature is that multiple variants of the same weapon can lie on the ground at once; when picked up, the player receives that exact skin—just like in CS2.


In the menu, your current weapon is marked with *, your selected skin is shown with < SELECT >, and the currently equipped skin with < CURRENT >. The menu and pagination update in real time.


Everything is simple to configure via two files: wsu_settings.ini for global options, and wsu_skins.ini for defining skins. A lang file is also included, translated into all languages supported by CS 1.6.

Core Features

ReAPI Integration

Built on ReAPI for maximum performance and flexibility.

Unlimited Skins

Add as many skins as you want for any weapon.

v_/p_/w_ Models

Full support for view, player, and world models for each skin.

Live Menu

Menus refresh in real time, with per-weapon shortcuts like /ak47, /m4a1, /knife.

CS2-like Pickups

Multiple skins of the same weapon can be dropped on the ground; pick up the exact variant you see.

Access Control

Restrict skins or menus by level or admin flags.

Save Modes

Supports nVault or SQLite; save by Name, IP, or SteamID.

Multi-language

Comes with a translated lang file for all CS 1.6 languages.

Settings (wsu_settings.ini)

Main configuration options for behavior, saving, access, and UX.

General Settings

SKINS_COMMANDS = say /skins, say_team /skins, say /skin...
SAVE_SKINS = 1
SAVE_TYPE = 0
... and 5 more settings

Options and default values with brief descriptions.

SKINS_COMMANDS = say /skins, say_team /skins, say /skin, say_team /skin, nightvision
Commands to open the skins menu. You can also open directly for a weapon using its name: /knife, /ak47, /deagle, /m4a1, /usp, ...
SAVE_SKINS = 1
Whether to save selected skins (0 = don't save | 1 = nVault | 2 = SQLite)
SAVE_TYPE = 0
Save method if SAVE_SKINS is enabled (0 = Name | 1 = IP | 2 = SteamID)
MENU_FLAGS =
Only players with these admin flags can open the menu. Leave empty for everyone.
HIDE_ONLY_SKIN = 0
Hide weapons in the menu that have only a single skin defined.
MENU_REOPEN = 1
Automatically re-open the menu after selecting a skin.
SPAWN_ONLY = 0
When enabled, selected skins are applied on next spawn only.
CHAT_PREFIX = $3[$4Weapons Skins Ultimate$3]
Prefix for all chat messages ($1 normal | $3 team | $4 green)

Adding Skins (wsu_skins.ini)

Define skins per weapon using the syntax: Skin Name = path/to/model.mdl. Place models inside the models folder.

Rules & Tips

Don't rename weapon section headers [weapon]
Each skin on its own line
Use @ to replace v_/p_/w_
Do not rename/delete weapon names inside brackets [ ] or the plugin won't work properly.
Models must be inside the models directory.
Each skin must be on a new line under its weapon section.
Only weapons with at least one skin are shown in the menu.
You can use colors in skin names: \r, \y, \w, \d.
It's recommended to add a default skin for each weapon.
Prefixing the model name with @ (e.g., models/skins/ak47/@cool_ak.mdl) will replace the v_, p_ and w_ models for that skin (useful and often required when you need p_/w_ models).
Attributes are added on new lines under the skin using the syntax - ATTRIBUTE = value(s). See full list below.

Complete Attribute Reference

- DESCRIPTION = text
- LEVEL = number
- DAMAGE = +25%, *2, -5, ...
... and 9 more attributes
- DESCRIPTION = <text>
Adds a short description line in the menu, e.g. "[Speed | Gravity | Health on Kill]".
- LEVEL = <level>
Make the skin available only for players with at least this level (requires a rank system).
- FLAGS = <flags>
Restrict skin access to players with specific admin flags.
- DAMAGE = <value>
Change outgoing damage while the skin is held. Supports +, -, *, /, %. Examples: +25%, *2, +30, -5%, 10, /3.
- PROTECTION = <value>
Change damage taken while the skin is held. Supports +, -, *, /, %.
- GRAVITY = <value>
Change player gravity (same scale as sv_gravity, default 800).
- SPEED = <value>
Change player max speed (default 250.0).
- SILENTSTEPS = <0/1>
Enable silent footsteps when set to 1.
- HEALTH = <amount> <max>
Give health on kill up to a max cap (default max 100 if omitted).
- ARMOR = <amount> <max>
Give armor on kill up to a max cap (default max 100 if omitted).
- MONEY = <amount> <max>
Give money on kill up to a max cap (default max 16000 if omitted).
- GLOW = <R> <G> <B> <alpha> <effect> <render>
Change player glow; first 3 values are required.
- KNOCKBACK = <power> <velocity>
Push enemies away on hit while holding this skin.
- REGENERATION = <hp> <max hp> <interval sec>
Regenerate health periodically until the max is reached (defaults: max 100, interval 1s).

Example wsu_skins.ini (with Attributes)

[knife] Speed Beast with attributes
[deagle] Damage dealers with modifiers
[ak47] Advanced combat effects
... complete configuration example
[knife]
Default = models/@knife.mdl

Speed Beast = models/knifes/@speedknife.mdl
- DESCRIPTION = \d[\rSpeed Beast \d| \yFast Movement\d]
- SPEED = 320.0
- SILENTSTEPS = 1

Cool Knife = models/knifes/@coolknife.mdl

Vampire Blade = models/knifes/@vampireknife.mdl
- DESCRIPTION = \d[\rVampire \d| \yHealth Regen\d]
- REGENERATION = 2 150 1
- GLOW = 255 0 0 150

Golden Knife = models/knifes/@goldenknife.mdl
- DESCRIPTION = \d[\rGolden Touch \d| \yMoney Maker\d]
- MONEY = 500 20000
- DAMAGE = +15%

[glock18]
Default = models/@glock18.mdl

Night Glock = models/pistols/@nightglock.mdl

Silent Glock = models/pistols/@silentglock.mdl
- DESCRIPTION = \d[\rSilent Steps \d| \yNinja Mode\d]
- SILENTSTEPS = 1
- SPEED = 280.0

[usp]
Classic USP = models/usp/@classic.mdl

[p228]

[deagle]
Default = models/@deagle.mdl

Power Deagle = models/guns/deagle/@powerdeagle.mdl
- DESCRIPTION = \d[\rHigh Damage \d| \yOne Shot Power\d]
- DAMAGE = +50%
- LEVEL = 10

Urban Deagle = models/guns/deagle/@urbandeagle.mdl

Tank Deagle = models/guns/deagle/@tankdeagle.mdl
- DESCRIPTION = \d[\rTank Mode \d| \yHeavy Protection\d]
- PROTECTION = -30%
- SPEED = 180.0
- FLAGS = a

Millionaire = models/guns/deagle/@golddeagle.mdl
- DESCRIPTION = \d[\rMoney Rain \d| \yRich Kills\d]
- MONEY = 800 25000

[fiveseven]

[elite]

[m3]

[xm1014]

[tmp]

[mac10]

[mp5navy]

[ump45]

[p90]

[m249]

[galil]

[famas]

[ak47]
Default = models/@ak47.mdl

Elite AK = models/guns/ak47/@eliteak.mdl

Berserker AK = models/guns/ak47/@berserak.mdl
- DESCRIPTION = \d[\rBerserker Rage \d| \yDamage & Speed\d]
- DAMAGE = +35%
- SPEED = 300.0
- HEALTH = 10 120

Healing AK = models/guns/ak47/@healak.mdl
- DESCRIPTION = \d[\rMedic AK \d| \yAuto Heal\d]
- REGENERATION = 3 200 2
- LEVEL = 8

Stealth AK = models/guns/ak47/@steakak.mdl
- SILENTSTEPS = 1

[m4a1]
Default = models/@m4a1.mdl

Combat M4 = models/guns/m4a1/@combatm4.mdl

Sniper M4 = models/guns/m4a1/@sniperm4.mdl
- DESCRIPTION = \d[\rSniper Mode \d| \yHigh Precision\d]
- DAMAGE = +40%
- LEVEL = 12

Medic M4 = models/guns/m4a1/@medicm4.mdl
- DESCRIPTION = \d[\rField Medic \d| \yTeam Healer\d]
- HEALTH = 25 150
- REGENERATION = 1 100 3

Rainbow M4 = models/guns/m4a1/@rainbowm4.mdl
- DESCRIPTION = \d[\rRainbow Glow \d| \yColorful Warrior\d]
- GLOW = 255 0 255 200 2 3

[sg552]

[aug]

[scout]

[awp]
Default = models/@awp.mdl

Pro AWP = models/guns/awp/@proawp.mdl

Lightning AWP = models/guns/awp/@lightningawp.mdl
- DESCRIPTION = \d[\rLightning Speed \d| \yFast Sniper\d]
- SPEED = 400.0
- DAMAGE = +60%
- LEVEL = 15

Vampire AWP = models/guns/awp/@vampireawp.mdl
- DESCRIPTION = \d[\rVampire Sniper \d| \yLife Steal\d]
- HEALTH = 40 200
- DAMAGE = +25%

Ghost AWP = models/guns/awp/@ghostawp.mdl
- SILENTSTEPS = 1
- GRAVITY = 100

[g3sg1]

[sg550]

[hegrenade]

[flashbang]

[smokegrenade]

[c4]

Contact & Support

For support, custom modifications, or any questions about the Weapons Skins Ultimate system:

Discord Steam AMXX-BG
Purchase Now - €4.99