@test137e29b/csgo-case-data

CS:GO/CS2 Case and Drop Data library for Roblox-TS applications.

Installation

npm install @test137e29b/csgo-case-data

Usage

import { 
  Rarity,
  WearCondition,
  SkinCollection,
  ItemType,
  StickerEffect,
  CASE_DROP_RATES,
  STATTRAK_CHANCE,
  getWearCondition,
  generateWear,
  generatePaintSeed,
} from '@test137e29b/csgo-case-data';

// Get wear condition from float value
const condition = getWearCondition(0.15); // WearCondition.FieldTested

// Generate random wear within item's range
const wear = generateWear(0.0, 0.5);

// Check rarity drop rates
const milSpecChance = CASE_DROP_RATES[Rarity.MilSpec]; // 0.7992

Exports

Types & Enums

| Export | Description | |--------|-------------| | ItemType | Item type: "skin", "knife", "glove", "sticker" | | Rarity | Rarity levels (ConsumerGrade to RareSpecial) | | WearCondition | Wear conditions (FactoryNew to BattleScarred) | | StickerEffect | Sticker effects (Paper, Foil, Holo, Gold, etc.) | | StickerType | Sticker types (Team, Autograph, Other) | | SkinCollection | All case/capsule collection identifiers |

Helper Functions

| Export | Description | |--------|-------------| | getWearCondition(wear) | Get condition enum from float value | | getWearAbbreviation(condition) | Get abbreviation (FN, MW, FT, WW, BS) | | generateWear(min, max) | Generate random wear in range | | generatePaintSeed() | Generate random paint seed (0-999) | | formatWear(wear) | Format wear to 4 decimal places | | getFullItemName(name, condition, isStatTrak) | Get full display name |

Case Data

| Export | Description | |--------|-------------| | CASE_DROP_RATES | Official drop rate percentages | | CASE_RARITY_THRESHOLDS | Cumulative thresholds for rarity selection | | STATTRAK_CHANCE | StatTrak chance (0.1 = 10%) | | CASE_CONFIG | Case configurations by collection |

Development

This package uses scripts to generate item data from CS:GO/CS2 source data.

# Type check
npm run build

# Generate items (from scripts folder)
cd scripts
npm run generate-items

License

ISC