node-cs2

Modern CS2/CS:GO Game Coordinator integration with the latest GameTracking-CS2 protobuf definitions. This package provides a simple API for interacting with the Counter-Strike 2 and CS:GO Game Coordinator, with full support for all modern CS2 features.

Note: Large portions of this library were generated with the assistance of AI. While core functionality has been verified, some features — particularly around volatile items — may not have been thoroughly tested and could behave unexpectedly. If you discover a bug or have a working fix for an open issue, I'd appreciate it if you could submit a Pull Request or leave a comment on the GitHub Issue with your solution. Community contributions help make this project better for everyone.

Features

• Latest Protobuf Definitions - Always up-to-date with GameTracking-CS2
• Complete Field Support - All modern CS2 fields including highlight_reel, wrapped_sticker, variations
• Promise-Based API - Modern async/await support with backward-compatible callbacks
• Volatile Items - Support for rental items and temporary items
• XP Shop & Rewards - Redeem rewards and track XP progress
• Recurring Missions - Request and track mission schedules
• Premier Season - Access premier season data and leaderboards
• Enhanced Error Handling - Comprehensive error detection and validation
• 100% Backward Compatible - Drop-in replacement for globaloffensive

Installation

npm install node-cs2

Quick Start

const SteamUser = require('steam-user');
const NodeCS2 = require('node-cs2');

const user = new SteamUser();
const cs2 = new NodeCS2(user);

user.logOn({
	accountName: 'your_username',
	password: 'your_password'
});

user.on('loggedOn', () => {
	user.gamesPlayed([730]); // CS2/CS:GO app ID
});

user.on('appLaunched', (appid) => {
	if (appid == 730) {
		cs2.helloGC();
	}
});

cs2.on('connectedToGC', async () => {
	// Inspect an item
	const item = await cs2.inspectItem('76561198057249394', '2569415699', '7115007497');
	console.log('Item:', item);
});

Core Features

Item Inspection

// Promise style
const item = await cs2.inspectItem(owner, assetid, classid);

// Embedded/masked CS2 inspect links are decoded locally, without a GC connection.
const embeddedItem = await cs2.inspectItem(inspectLink);

// Callback style
cs2.inspectItem(owner, assetid, classid, (item) => {
	console.log(item);
});

September 2026 protocol support

Synced with GameTracking-CS2 through September 25, 2026. Inspection results now include customnames (all names), pet_food_expiration_date, and opaque blobdata bytes. The existing customname remains the last name, or null, for compatibility. Direct protobuf consumers must encode names using customnames.

cs2.ackPetEvent(petItemId) sends the new pet-event acknowledgement using a decimal string item ID. This is a fire-and-forget protocol helper, with no defined GC response; live pet behavior has not been verified.

Volatile Items

// Load volatile item contents
const items = await cs2.loadVolatileItemContents(volatileItemId);

// Claim volatile item reward
await cs2.claimVolatileItemReward(defindex);

XP Shop & Rewards

// Redeem free reward
await cs2.redeemFreeReward(generationTime, redeemableBalance, items);

// Listen for XP shop updates
cs2.on('xpShopNotification', (data) => {
	console.log('XP:', data.current_xp, 'Level:', data.current_level);
});

Recurring Missions

// Request mission schedule
const schema = await cs2.requestRecurringMissionSchedule();

Premier Season

// Set leaderboard safe name
cs2.setLeaderboardSafeName('MySafeName');

// Listen for premier season data
cs2.on('premierSeasonSummary', (summary) => {
	console.log('Premier season:', summary);
});

Crate Opening & Item Customization

// Open a crate
await cs2.openCrate(toolItemId, subjectItemId);
await cs2.openCrate(toolItemId, subjectItemId, false, 100, 1);

// Extract/encapsulate stickers
await cs2.extractSticker(itemId, stickerSlot);
await cs2.encapsulateSticker(stickerId);

// Apply/remove patches
await cs2.applyPatch(itemId, patchId, patchSlot);
await cs2.removePatch(itemId, patchSlot);

// Apply/remove keychains
await cs2.applyKeychain(itemId, keychainId, keychainSlot);
cs2.removeKeychain(itemId);

// Commend a player
cs2.commendPlayer(accountId, { cmd_friendly: true, cmd_teaching: true, cmd_leader: true });

Commendation note: commendPlayer() is a low-level GC request. The protobuf payload is supported, but Valve may reject or silently ignore it unless the target is eligible. Use the target's 32-bit account ID, and expect a real recent/live match ID involving the sender and target to be required in practice. The tokens value may also depend on GC-side eligibility state, so it should not be treated as an arbitrary counter. Profile commendation totals may not update immediately.

Documentation

• EXAMPLES.md - Comprehensive usage examples
• DETAILED_DOCUMENTATION.md - Complete API reference and technical details
• CHANGELOG.md - Version history and release changes

Migration from globaloffensive

This package is 100% API compatible with the original globaloffensive package:

// Old
const GlobalOffensive = require('globaloffensive');

// New - just change the require!
const NodeCS2 = require('node-cs2');

// All your existing code works unchanged!
const cs2 = new NodeCS2(steamUser);

What's Fixed

• Missing Fields - highlight_reel and wrapped_sticker now properly extracted
• Modern CS2 Support - All new CS2 fields and arrays supported
• Error Handling - Comprehensive error detection and validation
• Code Quality - Deduplication, better maintainability

Requirements

• Node.js >= 14.0.0
• steam-user >= 4.2.0

License

MIT License - see LICENSE file for details.

Credits

• Original Author: DoctorMcKay - Original globaloffensive package
• Protobuf Definitions: SteamDatabase GameTracking-CS2
• Fork Maintainer: sak0a

Support

• Issues: GitHub Issues
• Examples: See EXAMPLES.md
• Documentation: See DETAILED_DOCUMENTATION.md

Development environment

Use Node.js 24+ for the current lint and test tooling. The published library retains Node.js 14+ runtime support. The development dependency uses steam-user 5; consumers may continue using the supported steam-user 4 API.

To refresh protocols, run npm run update-protos. Each download uses one upstream commit; set PROTO_REF=<commit> to reproduce a specific snapshot.

Verification and request lifecycle

See the feature support matrix and migration notes for separate payload, decoding, offline lifecycle, and live evidence. Version 2.6 adds cancelPendingRequests(), dispose(), typed response events, and structured NodeCS2.RequestError failures. Sent failures quarantine their correlation key; mutations are never automatically retried. Existing callback and Promise signatures are retained.

Run npm test, npm run test:types, and npm run test:consumer for offline verification. Authenticated checks are explicitly opt-in through npm run test:live; see the matrix for credential setup and individual mutation selection. No live behavior is claimed here.