Skip to main content

A module for creating CS:GO inventory shuffle config files

Project description


PyPI version GitHub license GitHub issues PyPI - Downloads Tests


csgoinvshuffle is a Python package designed to generate inventory shuffle config files for the game CS:GO.

With this package you can easily shuffle between different weapon types (e.g. M4A4 and M4A1-S) and have less limits in customizing the shuffle experience than with the in-game settings.


CS:GO never really queues your items in a random order. The items are arranged in one simple, predefined cycle. This package aims to creating shuffles to your liking with ease

You can use the config file it creates and replace <path_to_your_steam>/userdata/<your_steam_3id>/730/remote/cfg/csgo_saved_item_shuffles.txt with it to apply your config.


CS:GO needs to be closed while replacing the file

How to install

The package requires at least Python 3.9: pip install csgoinvshuffle

Basic usage

Your steam inventory needs to be public!

Basic shuffle for everything in your inventory with randomness

from csgoinvshuffle import ShuffleConfig, get_inventory

with ShuffleConfig() as sc:

Give items a certain order in the cycle

from csgoinvshuffle import ShuffleConfig, get_inventory
from csgoinvshuffle.enums import TagsInternalName

# This example only works if you have at least 4 music kits in your inventory
sc = ShuffleConfig()
inv = get_inventory("YOUR_STEAM_ID_64")
music_kits = inv.filter(TagsInternalName.MUSIC_KITS)
sc.set_item(0 , music_kits[3])
sc.set_item(1, music_kits[1])

As you can see in the last example, an inventory is equipped with a filter attribute and can be handled like a list. You can filter for enums and the filter uses the TagsInternalName by default, as it is the most useful one. Otherwise using the built-in filter() function on the Inventory Object is suggested. To get an overview of what values the attributes of an Item can have, you can lookup<YOUR_STEAM_ID_64>/730/2 or lookup the typing definitions inside the item class. As mentioned, typical values for the property tags_internal_name are provided by the TagsInternalName enum.

Create a shuffle cycle for only one team side

from csgoinvshuffle import ShuffleConfig, get_inventory
from csgoinvshuffle.enums import TagsInternalName, TeamSide

with ShuffleConfig() as sc:
    inv = get_inventory("YOUR_STEAM_ID_64")
    knives = inv.filter(TagsInternalName.KNIVES)
    classic_knife = knives.filter(TagsInternalName.CLASSIC_KNIFE)[0]
    karambit = knives.filter(TagsInternalName.KARAMBIT_KNIFE)[0]
    butterfly = knives.filter("crypto is for n00bs")[0]
    # First map karambit, second map classic knife, third map butterfly, next map karambit again...
    # On T side only
    my_shuffle_cycle = [karambit, classic_knife, butterfly] 
    sc.add_items(my_shuffle_cycle, TeamSide.T)

By default, the attribute methods from ShuffleConfig do everything for both teams. If you want to have different shuffle cycles on the opposing sides, you have to state it with a parameter.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for csgoinvshuffle, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size csgoinvshuffle-1.2.1-py3-none-any.whl (27.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size csgoinvshuffle-1.2.1.tar.gz (26.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page