steamdata-lib

Steam Ban Tracker

Overview

The Steam Ban Tracker is a Node.js module that interacts with the Steam API to track Steam users, retrieve their friend lists, and check their ban status. It is useful for communities and administrators who want to monitor Steam accounts for bans and violations.

Features

• Steam ID Validation: Checks if a Steam ID is valid.
• User Details Retrieval: Fetches detailed information about a Steam user.
• Friend List Tracking: Retrieves a list of a user's friends.
• Ban Status Check: Determines if a user has a VAC or community ban.
• Rate-Limited API Requests: Prevents exceeding Steam API request limits.

Installation

To use this module, ensure you have Node.js installed, then install dependencies:

npm install axios steamdata-lib

Usage

Importing the Module (https://steamcommunity.com/dev/apikey)

const SteamBanTracker = require('steamdata-lib');
const tracker = new SteamBanTracker(client, 'YOUR_STEAM_API_KEY');

Validating a Steam ID

const isValid = await tracker.validateSteamId("76561199156037493");
console.log(isValid); // true or false

Retrieving User Details

const userDetails = await tracker.userDetails("76561199156037493");
console.log(userDetails);

Checking Ban Status

const banStatus = await tracker.checkUserBanStatus("76561199156037493");
console.log(banStatus);

Fetching a User's Friends List

const friends = await tracker.fetchUserFriends("76561199156037493");
console.log(friends);

Tracking Friends and Bans

const { friendsList, bannedList } = await tracker.userFrinds("76561199156037493");
console.log("Friends:", friendsList);
console.log("Banned Users:", bannedList);

API Methods

validateSteamId(steamId)

• Description: Verifies if a Steam ID is valid.
• Returns: true if valid, false otherwise.

userDetails(steamId)

• Description: Retrieves detailed user information from the Steam API.
• Returns: An object containing user details (Steam ID, avatar, name, etc.).

checkUserBanStatus(steamId)

• Description: Checks if a user has a VAC or community ban.
• Returns: An object { isBanned, banType, daysSinceLastBan }.

fetchUserFriends(steamId)

• Description: Fetches a list of a user's friends.
• Returns: An array of Steam IDs of the user's friends.

userFrinds(steamId, discoveredUserIds = new Set())

• Description: Fetches a user's friends and tracks banned users.
• Returns: An object { friendsList, bannedList }.

License

This project is licensed under the MIT License.

Notes

• Ensure your Steam API key is valid and has sufficient access.
• The module respects Steam API rate limits to prevent bans or throttling.
• Always check Steam's API terms before deploying in production.

---

Created by Filip Janásek (Earning Crew x CryptoN PRO)