cs2inspect

Overview

cs2inspect is a python package used for creating and working with counter-strike inspect links and gen codes.

Features

• Creating 'unmasked' inspect links (containing the owners steam id)
• Creating 'masked' (XOR-capable) inspect links
• Decoding/Parsing inspect links back into data or protobuf objects
• Schema Enrichment (Parsing): Resolve numeric IDs to human-readable names (Weapon, Skin, Rarity, Origin, Quality, etc.)
• Creating gen codes
• Creating console pasteable inspect links
• Checking inspect link validity (robust regex supporting modern CS2 formats)

Installation

pip install cs2inspect

Quick Start

Link Creation

import cs2inspect

# Create a modern 'masked' link using the Builder
proto = cs2inspect.Builder(
    defindex=7,
    paintindex=941,
    paintseed=0,
    paintwear=0.15,
    rarity=5
)
link = cs2inspect.link(proto.build())
print(link) # steam://run/730//+csgo_econ_action_preview%2000180720AD072805389AB3E6F00340006F59908E

Basic Parsing

import cs2inspect

# Parse a modern 'masked' inspect link
link = "steam://run/730//+csgo_econ_action_preview%206A7AC7C6BEDED06B72704ACE6F426F5A635296868780692AAC6C226A3A6A02E9EAEAEA661A625E7EE646"
data = cs2inspect.parse(link)

print(data['defindex'])    # 26 (PP-Bizon)
print(data['floatvalue'])  # 0.05357979

Schema Enrichment

import cs2inspect

# Resolve IDs to names using an external schema
cs2inspect.download_schema()
info = cs2inspect.parse(link, enrich=True)

print(info['full_item_name']) # StatTrak™ PP-Bizon | High Roller (Factory New)

Documentation

For detailed information, please refer to the following docs:

• Example Usage: Comprehensive examples for link creation, parsing, and enrichment.
• Output Model: Detailed specification of the dictionary structure returned by parse().

Technical Limitations (Parsing)

cs2inspect is a local, offline decoder. Masked/Modern links (binary Protobuf payload) are fully supported with offline enrichment of stickers, floats, and charms. Unmasked/Legacy links (S/M A D pointers) have only minimal support as they contain no binary property data; resolving their attributes requires a call to the GameCoordinator (GC), which is outside the scope of this offline library.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for development setup and guidelines.

License

GPLv3 License. See the LICENSE file for details.

Acknowledgements

Special thanks to these projects for their foundational work and metadata tracking:

• csfloat/inspect - Foundational skin inspect library
• ByMykel/CSGO-API - Primary source for the schema files
• SteamTracking/GameTracking-CS2 - Source for Rarity and Quality enums
• SteamDatabase/SteamTracking - Source for Origin enum