Skip to content

sak0a/cs2inspect-web

BranchesTags

Repository files navigation

CS2 Loadout Manager

A comprehensive web application for managing Counter-Strike 2 weapon loadouts, built with Nuxt 3.

CS2 Loadout Manager

🚀 Overview

This application allows users to:

  • Create and manage multiple CS2 weapon loadouts
  • Customize weapons with skins, stickers, and keychains
  • Configure team-specific equipment (T/CT sides)
  • Authenticate via Steam

🔄 Application Flow

Server-side

  1. Initialization: Fetches latest CS2 item data from the CSGO-API
  2. Authentication: Handles Steam authentication and user sessions
  3. Database: Manages user loadouts and weapon configurations

Client-side

  1. Authentication: User logs in via Steam
  2. Loadout Management:
    • Fetches user loadouts from /api/loadouts?steamid=[id]
    • Displays loadout selection interface
  3. Weapon Customization:
    • Fetches weapon data for selected loadout via /api/weapons/[type]?loadoutid=[id]&steamid=[id]
    • Provides interface for skin, sticker, and keychain selection

📊 Data Models

Core Interfaces

APISkin

Represents weapon skins from the CS2 API:

interface APISkin {
    id: string;
    name: string;
    description?: string;
    weapon: {
        id: string;
        name: string;
        weapon_id: string;
    }
    category: {
        id: string;
        name: string
    }
    pattern: {
        id: string;
        name: string;
    }
    min_float: number;
    max_float: number;
    rarity: {
        id: string;
        name: string;
        color: string;
    }
    stattrak?: boolean
    souvenir?: boolean
    paint_index: string
    wears?: any[]
    collections?: any[]
    crates?: any[]
    team?: {
        id: string;
        name: string;
    }
    image: string;
}

APISticker

Represents stickers from the CS2 API:

interface APISticker {
    id: string;
    name: string;
    description?: string;
    rarity: {
        id: string;
        name: string;
        color: string
    }
    crates?: any[]
    tournament_event: string
    tournament_team: string
    type: string
    market_hash_name?: string
    effect?: string
    image: string
}

APIKeychain

Represents weapon charms from the CS2 API:

interface APIKeychain {
    id: string;
    name: string;
    description?: string;
    rarity: {
        id: string;
        name: string;
        color: string;
    }
    market_hash_name?: string;
    image: string;
}

APIMusicKit

Represents music kits from the CS2 API:

interface APIMusicKit {
    id: string
    name: string
    description?: string
    rarity: {
        id: string
        name: string
        color: string
    }
    market_hash_name?: string
    exclusive?: boolean
    image: string
}

APIAgent

Represents player models from the CS2 API:

interface APIAgent {
  id: string;
  name: string;
  description?: string;
  rarity: {
    id: string;
    name: string;
    color: string;
  }
  collections?: any[];
  team: {
    id: string;
    name: string;
  }
  market_hash_name?: string;
  image: string;
}

DBLoadout

Represents a user's loadout in the database:

interface DBLoadout {
    id: string;
    steamid: string;
    name: string;
    selected_knife_t: number | null;
    selected_knife_ct: number | null;
    selected_glove_t: number | null;
    selected_glove_ct: number | null;
    created_at: string;
    updated_at: string;
}

DBKnife

Represents a user's knife entry in the database:

interface DBKnife {
    id: string;
    steamid: string;
    loadoutid: string;
    active: boolean;
    team: number;
    defindex: number;
    paintindex: number;
    paintseed: string;
    paintwear: string;
    stattrak_enabled: boolean;
    stattrak_count: number;
    nametag: string;
    created_at: string;
    updated_at: string;
}

DBGlove

Represents a user's glove entry in the database:

interface DBGlove {
    id: string;
    steamid: string;
    loadoutid: string;
    active: boolean;
    team: number;
    defindex: number;
    paintindex: number;
    paintseed: string;
    paintwear: string;
    created_at: string;
    updated_at: string;
}

DBWeapon

Represents a user's weapon entry in the database:

interface DBWeapon {
    id: string;
    steamid: string;
    loadoutid: string;
    active: boolean;
    team: number;
    defindex: number;
    paintindex: number;
    paintseed: string;
    paintwear: string;
    stattrak_enabled: boolean;
    stattrak_count: number;
    nametag: string;
    sticker_0: string;
    sticker_1: string;
    sticker_2: string;
    sticker_3: string;
    sticker_4: string;
    keychain: string;
    created_at: string;
    updated_at: string;
}

DBPin

Represents a user's pin entry in the database:

interface DBPin {
    id: string;
    steamid: string;
    loadoutid: string;
    active: boolean
    team: number
    pinid: number;
    created_at: string;
    updated_at: string;
}

DBMusicKit

Represents a user's music kit entry in the database:

interface DBMusicKit {
    id: string;
    steamid: string;
    loadoutid: string;
    active: boolean
    team: number;
    musicid: number;
    created_at: string;
    updated_at: string;
}

DBAgent

Represents a user's agent entry in the database:

interface DBAgent {
    id: string;
    steamid: string;
    loadoutid: string;
    active: boolean
    team: number;
    defindex: number;
    agent_name: string;
    created_at: string;
    updated_at: string;
}

Frontend Data Structures

StickerData

Represents a sticker applied to a weapon:

interface IEnhancedWeaponSticker {
  id: number;
  x: number;
  y: number;
  wear: number;
  scale: number;
  rotation: number;
  api: {
    name: string;
    type: string;
    image: string;
    effect: string;
    rarity: {
      name: string;
      id: string;
      color: string;
    };
    tournament_team: string;
    tournament_event: string;
  };
}

KeychainData

Represents a keychain attached to a weapon:

interface IEnhancedWeaponKeychain {
  id: number;
  x: number;
  y: number;
  z: number;
  seed: number;
  api: {
    name: string;
    image: string;
    rarity: {
      name: string;
      id: string;
      color: string;
    };
  };
}

WeaponData

IMappedDBWeapon represents a weapon's database information with mapped Keychain and Sticker data:

interface IMappedDBWeapon {
  active: boolean;
  team: number;
  defindex: number;
  statTrak: boolean;
  statTrakCount: number;
  paintIndex: number;
  paintWear: number;
  pattern: number;
  nameTag: string;
  stickers: any;
  keychain: IEnhancedWeaponKeychain | null;
}

IDefaultItem represents default weapon information used from /server/utils/constants.ts to display default weapons

interface IDefaultItem {
  weapon_defindex: number;
  defaultName: string;
  paintIndex: number;
  defaultImage: string;
  weapon_name: string;
  category: string;
  availableTeams: string;
}

IEnhancedItem extends IDefaultItem and uses DBKnife or IMappedDBWeapon or DBGlove for database information:

interface IEnhancedItem extends IDefaultItem {
  name: string;
  image: string;
  minFloat: number;
  maxFloat: number;
  rarity?: {
    name: string;
    id: string;
    color: string;
  };
  databaseInfo?: DBKnife | IEnha | IMappedDBWeapon;
}

🗄️ Database Structure

The application uses the following database tables:

Table Description
wp_player_loadouts Stores user loadout configurations
wp_player_knifes Knife configurations for each loadout
wp_player_gloves Glove configurations for each loadout
wp_player_rifles Rifle configurations for each loadout
wp_player_smgs SMG configurations for each loadout
wp_player_pistols Pistol configurations for each loadout
wp_player_heavys Heavy weapon configurations for each loadout
wp_player_agents Agent (player model) configurations
wp_player_pins Pin configurations
wp_player_music Music kit configurations

🔌 API Endpoints

All endpoints require authentication.

Loadout Management

GET /api/loadouts?steamId=[id]

Fetches all loadouts for a user.

Response:

{
  "loadouts": [
    {
      "id": 1,
      "steamid": "1234567890",
      "name": "Example Name",
      "selected_knife_t": 500,
      "selected_knife_ct": 505,
      "selected_glove_t": null,
      "selected_glove_ct": null,
      "created_at": "2025-01-30T15:48:11.000Z",
      "updated_at": "2025-03-15T01:20:21.000Z"
    }
  ],
  "message": "Loadouts fetched successfully!"
}

POST /api/loadouts?steamId=[id]

Creates a new loadout.

Request:

{
  "name": "Example Name"
}

Response:

{
  "loadout": {
    "id": 1,
    "steamid": "1234567890",
    "name": "Example Name",
    "selected_knife_t": 500,
    "selected_knife_ct": 505,
    "selected_glove_t": null,
    "selected_glove_ct": null,
    "created_at": "2025-01-30T15:48:11.000Z",
    "updated_at": "2025-03-15T01:20:21.000Z"
  },
  "message": "Loadout created successfully"
}

PUT /api/loadouts?steamId=[id]&id=[id]

Updates a loadout (currently only name updates are supported).

Request:

{
  "name": "New Name"
}

Response:

{
  "loadout": {
    "id": 1,
    "steamid": "1234567890",
    "name": "New Name",
    "selected_knife_t": 500,
    "selected_knife_ct": 505,
    "selected_glove_t": null,
    "selected_glove_ct": null,
    "created_at": "2025-01-30T15:48:11.000Z",
    "updated_at": "2025-03-15T01:20:21.000Z"
  },
  "message": "Loadout updated successfully"
}

DELETE /api/loadouts?steamId=[id]&id=[id]

Deletes a loadout.

Response:

{
  "message": "Loadout deleted successfully"
}

POST /api/loadouts/select?steamId=[id]&loadoutId=[id]&type=[type]

Updates the selected knife/glove for a loadout.

Request:

{
  "team": 1,  // 1 = Terrorists, 2 = Counter Terrorists
  "defindex": 503  // Weapon defindex, or null to unselect
}

Knives Management

GET /api/knifes?steamId=[id]&loadoutId=[id]

Fetches all knives for a specific loadout.

Response:

{
  "knifes": [
    {
      "weapon_defindex": 500,
      "defaultName": "Bayonet",
      "paintIndex": 38,
      "defaultImage": "https://example.com/bayonet.png",
      "weapon_name": "Bayonet",
      "category": "knife",
      "availableTeams": "both",
      "name": "Bayonet | Fade",
      "image": "https://example.com/bayonet_fade.png",
      "minFloat": 0.01,
      "maxFloat": 0.08,
      "rarity": {
        "name": "Covert",
        "id": "covert",
        "color": "#eb4b4b"
      },
      "databaseInfo": {
        "active": true,
        "team": 1,
        "defindex": 500,
        "paintIndex": 38,
        "pattern": 661,
        "wear": 0.01,
        "statTrak": true,
        "statTrakCount": 1337,
        "nameTag": "My Knife"
      }
    }
  ]
}

POST /api/knifes/save?steamId=[id]&loadoutId=[id]

Saves or updates a knife configuration.

Request:

{
  "defindex": 500,
  "active": true,
  "paintIndex": 38,
  "wear": 0.01,
  "pattern": 661,
  "statTrak": true,
  "statTrakCount": 1337,
  "nameTag": "My Knife",
  "team": 1,
  "reset": false
}

Response:

{
  "success": true,
  "message": "Knifes updated successfully"
}

Gloves Management

GET /api/gloves?steamId=[id]&loadoutId=[id]

Fetches all gloves for a specific loadout.

Response:

{
  "knifes": [
    {
      "weapon_defindex": 5027,
      "defaultName": "Specialist Gloves",
      "paintIndex": 10006,
      "defaultImage": "https://example.com/specialist_gloves.png",
      "weapon_name": "Specialist Gloves",
      "category": "glove",
      "availableTeams": "both",
      "name": "Specialist Gloves | Crimson Kimono",
      "image": "https://example.com/specialist_gloves_crimson.png",
      "minFloat": 0.06,
      "maxFloat": 0.8,
      "rarity": {
        "name": "Extraordinary",
        "id": "extraordinary",
        "color": "#eb4b4b"
      },
      "databaseInfo": {
        "active": true,
        "team": 1,
        "defindex": 5027,
        "paintIndex": 10006,
        "pattern": 661,
        "wear": 0.15
      }
    }
  ]
}

POST /api/gloves/save?steamId=[id]&loadoutId=[id]

Saves or updates a glove configuration.

Request:

{
  "defindex": 5027,
  "active": true,
  "paintIndex": 10006,
  "wear": 0.15,
  "pattern": 661,
  "team": 1,
  "reset": false
}

Response:

{
  "success": true,
  "message": "Gloves updated successfully"
}

Weapons Management

GET /api/weapons/[type]?steamId=[id]&loadoutId=[id]

Fetches weapons of a specific type (rifles, pistols, smgs, heavys) for a loadout.

Response:

{
  "weapons": [
    {
      "weapon_defindex": 7,
      "defaultName": "AK-47",
      "paintIndex": 490,
      "defaultImage": "https://example.com/ak47.png",
      "weapon_name": "AK-47",
      "category": "rifle",
      "availableTeams": "t",
      "name": "AK-47 | Asiimov",
      "image": "https://example.com/ak47_asiimov.png",
      "minFloat": 0.05,
      "maxFloat": 0.7,
      "rarity": {
        "name": "Covert",
        "id": "covert",
        "color": "#eb4b4b"
      },
      "databaseInfo": {
        "active": true,
        "team": 1,
        "defindex": 7,
        "paintIndex": 490,
        "pattern": 661,
        "wear": 0.05,
        "statTrak": true,
        "statTrakCount": 1337,
        "nameTag": "My AK",
        "stickers": [
          {
            "id": 4,
            "x": 0,
            "y": 0,
            "wear": 0,
            "scale": 1,
            "rotation": 0,
            "api": {
              "name": "Sticker | Crown (Foil)",
              "type": "sticker",
              "image": "https://example.com/crown_foil.png",
              "effect": "foil",
              "rarity": {
                "name": "Extraordinary",
                "id": "extraordinary",
                "color": "#eb4b4b"
              },
              "tournament_team": "",
              "tournament_event": ""
            }
          }
        ],
        "keychain": {
          "id": 4187,
          "x": 0,
          "y": 0,
          "z": 0,
          "seed": 0,
          "api": {
            "name": "Chicken Capsule",
            "image": "https://example.com/chicken_capsule.png",
            "rarity": {
              "name": "Extraordinary",
              "id": "extraordinary",
              "color": "#eb4b4b"
            }
          }
        }
      }
    }
  ]
}

POST /api/weapons/save?steamId=[id]&loadoutId=[id]

Saves or updates a weapon configuration.

Request:

{
  "defindex": 7,
  "active": true,
  "paintIndex": 490,
  "wear": 0.05,
  "pattern": 661,
  "statTrak": true,
  "statTrakCount": 1337,
  "nameTag": "My AK",
  "team": 1,
  "stickers": [
    {
      "slot": 0,
      "stickerId": 4,
      "wear": 0,
      "scale": 1,
      "rotation": 0
    }
  ],
  "keychain": {
    "id": 4187,
    "seed": 0
  },
  "reset": false
}

Response:

{
  "success": true,
  "message": "Weapon updated successfully"
}

🛠️ Setup and Development

Prerequisites

  • Node.js (v16+)
  • MySQL/MariaDB database

Installation

# Install dependencies
npm install
# or
yarn install
# or
pnpm install
# or
bun install

Development Server

# Start development server on http://localhost:3000
npm run dev
# or
yarn dev
# or
pnpm run dev
# or
bun run dev
# or
nuxt dev

Production Build

# Build for production
npm run build
# or
yarn build
# or
pnpm run build

# Preview production build
npm run preview
# or
yarn preview
# or
pnpm run preview

📚 Documentation

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

Languages