CS2 Inventory Simulator Plugin

A CounterStrikeSharp plugin for integrating with CS2 Inventory Simulator

This plugin features all current (and public) knowledge on how to give economy items to players from the server-side.

Caution

Your server can be banned by Valve for using this plugin (see their server guidelines). Use at your own risk.

Current Features

• Select Team
• Team Intro
• Weapon
  • Paint Kit, Wear, Seed, Name tag, StatTrak (with increment), and Stickers.
• Knife
  • Paint Kit, Wear, Seed, Name tag, and StatTrak (with increment).
• Gloves
  • Paint Kit, Wear, Seed.
• Agent
  • Patches.
• Music Kit
  • StatTrak (with increment).
• Pin
• Graffiti

Known Issues

Submit a PR or open an issue if you happen to know a workaround for them.

• When using !ws, the wear of skins may get worse over time if player doesn't reconnect.
• When using !ws, gloves are only updated when rejoining the game or switching teams (#21).
  • You can use invsim_ws_gloves_fix ConVar for a workaround on this issue.

Warning

Currently, I'm accepting issue reports, but please refrain from opening feature requests or suggestion issues as they will be closed. While I may consider your comments, the issue will remain closed.

Installation

1. Install the latest release of Metamod and CounterStrikeSharp.
2. Make sure FollowCS2ServerGuidelines is false in addons/counterstrikesharp/configs/core.json.
3. Download the latest release of CS2 Inventory Simulator Plugin.
4. Extract the ZIP file contents into addons/counterstrikesharp.

Configuration

invsim_protocol ConVar

• Inventory Simulator API's protocol.
• Type: string
• Default: https

invsim_hostname ConVar

• Inventory Simulator API's hostname.
• This will be combined with the invsim_protocol to form the full URL.
• For example, these two default values will combine to https://inventory.cstrike.app.
• Type: string
• Default: inventory.cstrike.app

invsim_apikey ConVar

• Inventory Simulator API's key.
• Type: string
• Default: empty

invsim_wslogin ConVar

• Not recommended, but allows authenticating into Inventory Simulator and printing login URL to the player.
• Type: bool
• Default: false

invsim_compatibility_mode ConVar

• Whether enable compatibility mode to try to work with other frameworks and/or MetaMod plugins (e.g. CS2Fixes).
• Type: bool
• Default: false

invsim_stattrak_ignore_bots ConVar

• Whether to ignore StatTrak increments for bot kills.
• Type: bool
• Default: true

invsim_require_inventory ConVar

• Require the player's inventory to be fetched before allowing them to connect to the game.
• Type: bool
• Default: false

invsim_fallback_team ConVar

• Allows giving other team equipped skin when the current team doesn't have a skin equipped (e.g. giving AK-47 for a CT player will give their equipped T skin).
• Type: bool
• Default: false

invsim_minmodels ConVar

• Allows agents or use specific models for each team.
• Type: int
• Default: 0
• Values:
  • 0 - All agents allowed.
  • 1 - Default agents for the current map. Note: Same as 2 as Valve has not yet added them back.
  • 2 - Only SAS and Phoenix agents allowed.

invsim_ws_enabled ConVar

• Whether players can refresh their inventory using !ws command.
• Type: bool
• Default: false

invsim_ws_cooldown ConVar

• Cooldown in seconds between player inventory refreshes.
• Type: int
• Default: 30

invsim_ws_gloves_fix ConVar

• Applies a fix for the issue where the gloves aren't updated after the player uses !ws command. Please report any issue with this fix.
• Type: bool
• Default: false

invsim_ws_immediately ConVar

• Applies weapon skins changes immediately after issuing !ws command. Please report any issue with this feature.
• Type: bool
• Default: false

invsim_ws_print_full_url ConVar

• Whether print full URL when the player uses !ws command.
• Type: bool
• Default: true

invsim_spraychanger_enabled ConVar

• Whether to change player vanilla spray if they have a graffiti equipped.
• Type: bool
• Default: false

invsim_spray_on_use ConVar

• Whether to try to apply spray when player presses use.
• Type: bool
• Default: false

invsim_spray_cooldown ConVar

• Cooldown in seconds between player sprays.
• Type: int
• Default: 30

Commands

!ws Command

• Prints Inventory Simulator's website and refreshes player's inventory if invsim_ws_enabled ConVar is true.

!spray Command

• Sprays player's graffiti in the nearest wall if possible. Players can bind to T key using bind t css_spray.

!wslogin Command

• Prints an authentication URL for the player if invsim_wslogin ConVar is true and invsim_apikey has the permissive scope for authenticating the user.

See also

If you are looking for a plugin that gives you more control, please see cs2-WeaponPaints.