/cs2-inventory-simulator-plugin

A CounterStrikeSharp plugin for integrating with CS2 Inventory Simulator

Primary LanguageC#MIT LicenseMIT

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

  • 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).

Feature Roadmap

  • Select Team
  • Team Intro

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_hostname ConVar

  • Inventory Simulator API's hostname.
  • Type: string
  • Default: inventory.cstrike.app

invsim_apikey ConVar

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

invsim_stattrak_ignore_bots ConVar

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

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_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.

See also

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