# Gaming Configuration Context

## Technology Overview
Steam Tinker Launch (STL) provides advanced configuration options for running Windows games on Linux through Steam's Proton compatibility layer. This directory contains configurations, scripts, and documentation for gaming setups.

## Key Components

### Steam Tinker Launch (STL)
- **Purpose**: Advanced Proton configuration and game-specific tweaks
- **Config Location**: `~/.config/steamtinkerlaunch/`
- **Game Configs**: `~/.config/steamtinkerlaunch/gamecfgs/`
- **Global Settings**: `~/.config/steamtinkerlaunch/global.conf`

### Ready or Not Specific
- **Game ID**: 1144200
- **Engine**: Unreal Engine 4
- **Anti-Cheat**: EasyAntiCheat (requires `-noeac` for modifications)
- **Common Issues**: Menu freezes, audio crackling, GPU compatibility

## Hardware

- **CPU**: AMD Ryzen 7 7800X3D (8C/16T)
- **GPU**: NVIDIA GeForce RTX 4080 SUPER (16GB VRAM)
- **Display (primary)**: 2560x1440 @ 120Hz OLED with HDR
- **Display (secondary)**: 2560x1440 @ 60Hz (no HDR)

## Configuration Patterns

### Standard Baseline (all games)
```bash
PROTON_ENABLE_NVAPI="1"           # Required for GPU detection
PROTON_HIDE_NVIDIA_GPU="0"        # MUST be 0 - do NOT hide GPU
DXVK_ASYNC="1"                    # Reduce shader compilation stuttering
USEGAMEMODERUN="1"                # Enable GameMode
USEMANGOHUD="1"                   # Performance monitoring
WAITEDITOR="0"                    # Skip STL popup - edit configs via Claude Code
```

For per-game settings (RT, DLSS, HDR, retro games), see the **steam-game-setup** skill:
`.claude/skills/steam-game-setup/SKILL.md`

## Directory Structure
```
/gaming/
├── CONTEXT.md              # This file - technology overview
├── troubleshooting.md      # Error handling and debugging
├── examples/               # Working configurations and templates
│   ├── ready-or-not/      # Ready or Not specific configs
│   └── nvidia-optimized/  # NVIDIA-specific game configs
└── scripts/               # Gaming automation scripts
    ├── CONTEXT.md         # Script-specific documentation
    └── steam-helpers/     # Steam and STL helper scripts
```

## Best Practices

### Configuration Management
- Keep per-game configs in `examples/[game-name]/`
- Document hardware-specific settings clearly
- Test one setting at a time when troubleshooting
- Backup working configurations before changes

### Performance Optimization
- Start with GE-Proton for best compatibility
- Enable GameMode for CPU scheduling
- Use GameScope for resolution/scaling control
- Monitor GPU usage with MangoHUD

### Troubleshooting Approach
1. Verify base Proton compatibility
2. Test without STL modifications first
3. Add settings incrementally
4. Document working combinations
5. Check hardware-specific requirements

## Integration Points
- **Monitoring**: Use MangoHUD for performance metrics
- **Scripts**: Automate common gaming tasks
- **Networking**: Configure for multiplayer gaming