cs2pattern 0.5.0

CS2 pattern utility

cs2pattern

Overview

cs2pattern is a python package used to identify different rare pattern from counter-strike skins given a pattern number.

Installation

pip install cs2pattern

Usage

Quick start

To check if your skin has a rare pattern:

from cs2pattern import check_rare

# Provide full item name and pattern number
is_rare, details = check_rare("★ Karambit | Case Hardened (Factory New)", 269)
if is_rare:
    rare_name, rank = details
    print(f"Rare pattern: {rare_name} (rank {rank})")

#=> Rare pattern: gem_blue (rank 5)

Modular helpers

When you already know the skin family you care about, import the helper functions:

from cs2pattern import gem_black

patterns, ordered = gem_black("skeleton knife")
print(f"Patterns: {patterns} / Ordered: {ordered}")

#=> Patterns: [446, 791, 497, 28] / Ordered: True

Raw catalog access

Helper names match the pattern groups inside pattern.json, so you can discover what is available by calling get_pattern_dict() and inspecting the keys.

from cs2pattern import get_pattern_dict

catalog = get_pattern_dict()
scorched_ursus = catalog["scorched"]["ursus knife"][0]
print(scorched_ursus["pattern"])

#=> [446, 791]

Contributing

Contributions are welcome! Open an issue or submit a pull request.

License

GPLv3 License. See the LICENSE file for details.