# Ready or Not - NVIDIA Gaming Setup

## Overview
This configuration is optimized for:
- **NVIDIA GPU** (adapted from AMD config)
- **4K Monitor with 1440p Gaming** (performance optimization)
- **Steam Tinker Launch** with GameScope scaling
- **DLSS Support** for enhanced performance

## Key Changes from AMD Config

### GPU-Specific Changes
| Setting | AMD (Original) | NVIDIA (Adapted) | Reason |
|---------|---------------|------------------|---------|
| `VK_ICD_FILENAMES` | RADV driver paths | NVIDIA driver path | GPU driver selection |
| `PROTON_HIDE_NVIDIA_GPU` | Not applicable | `"0"` (disabled) | Allow DLSS detection |
| `PROTON_ENABLE_NVAPI` | Not applicable | `"1"` (enabled) | Enable NVIDIA APIs |
| `USEDLSS` | Not applicable | `"1"` (enabled) | DLSS support |
| `STLRAD_PFTST` | AMD-specific flags | `"none"` | Remove AMD optimizations |

### Display Configuration
| Setting | Original | Adapted | Reason |
|---------|----------|---------|---------|
| Resolution | 3440x1440 @ 240Hz | 2560x1440 @ 165Hz | Better performance on 4K monitor |
| GameScope Args | Ultrawide focus | Standard 16:9 + scaling | 4K monitor compatibility |
| Audio Latency | 120ms | 60ms | NVIDIA typically has lower latency |

### Performance Optimizations
- **DXVK Async**: Enabled for NVIDIA shader optimization
- **HDR Support**: Enabled for compatible setups  
- **Memory Management**: Optimized for NVIDIA VRAM handling
- **GameScope**: Configured for 1440p→4K scaling

## Files Included

### `1144200-nvidia-1440p.conf`
Main Steam Tinker Launch configuration file. Copy to `~/.config/steamtinkerlaunch/gamecfgs/1144200.conf`.

**Key Features**:
- Game arguments: `-noeac -USEALLAVAILABLECORES -dx12`
- GameScope: 1440p gaming with 4K scaling
- DLSS and NVAPI enabled
- Optimized audio latency (60ms)

### `nvidia-environment.conf`
Environment variables for NVIDIA optimization. Reference for manual setup.

### `setup-ready-or-not.sh`
Automated setup script that:
- Checks dependencies (STL, GameScope, NVIDIA drivers)
- Backs up existing configurations
- Installs optimized config files
- Creates DXVK configuration
- Sets up launch helper script

## Quick Setup

### 1. Run the Setup Script
```bash
cd /mnt/NV2/Development/claude-home/gaming/examples/ready-or-not/
./setup-ready-or-not.sh
```

### 2. Verify Steam Tinker Launch
- Open Steam
- Go to Ready or Not → Properties → Launch Options
- Leave empty or add `%command%` if needed
- STL should automatically detect the game configuration

### 3. Test Launch
```bash
# Option 1: Use the helper script
~/.local/bin/launch-ready-or-not

# Option 2: Launch through Steam normally
# STL will automatically apply the configuration
```

## Expected Performance

### With This Configuration
- **Resolution**: 1440p gaming scaled to 4K display
- **Performance**: 60-120+ FPS depending on settings
- **Features**: DLSS enabled, HDR support, optimized audio
- **Compatibility**: EasyAntiCheat disabled (offline/modded play)

### Performance vs Quality Settings
| Game Setting | Expected FPS | Notes |
|--------------|--------------|--------|
| Ultra + DLSS Quality | 60-80 FPS | Best visual quality |
| High + DLSS Balanced | 80-100 FPS | Good balance |
| Medium + DLSS Performance | 100-120+ FPS | Competitive gaming |

## Troubleshooting

### Game Won't Launch
1. Check Steam Tinker Launch is installed and working
2. Verify NVIDIA drivers: `nvidia-smi`
3. Test without STL first (disable in Steam properties)
4. Check logs: `~/.config/steamtinkerlaunch/logs/`

### Poor Performance
1. Verify DLSS is enabled in-game settings
2. Check GameScope is working: look for scaling indicator
3. Monitor GPU usage: `watch nvidia-smi`
4. Try disabling GameScope temporarily (`USEGAMESCOPE="0"`)

### Display Issues
1. Verify monitor resolution: `xrandr`
2. Test different GameScope refresh rates
3. Try windowed mode first, then fullscreen
4. Check HDR settings if applicable

### Audio Problems
1. Increase latency: Change `STL_PULSE_LATENCY_MSEC` to `"120"`
2. Check PipeWire configuration
3. Test with different audio devices
4. Disable audio enhancements in game

## Advanced Configuration

### Custom Monitor Refresh Rates
Edit the GameScope arguments in `1144200.conf`:
```bash
# For 144Hz monitors
GAMESCOPE_ARGS="-W 2560 -H 1440 -w 2560 -h 1440 -r 144 -f --immediate-flips --rt --mangoapp --force-grab-cursor --adaptive-sync --"

# For 120Hz monitors  
GAMESCOPE_ARGS="-W 2560 -H 1440 -w 2560 -h 1440 -r 120 -f --immediate-flips --rt --mangoapp --force-grab-cursor --adaptive-sync --"
```

### DLSS Quality Settings
In-game DLSS options will be available with this configuration:
- **DLSS Quality**: Best visual quality, ~20% performance boost
- **DLSS Balanced**: Good balance, ~30% performance boost  
- **DLSS Performance**: Maximum FPS, ~50% performance boost
- **DLSS Ultra Performance**: Competitive gaming, ~100% performance boost

### Ray Tracing (Experimental)
To enable ray tracing support:
```bash
# In the config file
USERAYTRACING="1"
STL_VKD3D_CONFIG="dxr11"
```
**Note**: Ray tracing requires RTX series GPUs and may significantly impact performance.

## File Backup Locations
The setup script automatically creates backups:
- Config backup: `~/.config/steamtinkerlaunch/gamecfgs/1144200.conf.backup.[timestamp]`
- Logs: `~/.config/steamtinkerlaunch/logs/`
- DXVK cache: `/tmp/dxvk-cache/`

## Integration with Home Lab
This gaming setup integrates with your existing infrastructure:
- **Monitoring**: MangoHUD provides performance metrics
- **Logging**: STL logs are available for troubleshooting
- **Scripts**: Helper scripts follow your existing patterns
- **Documentation**: Follows your established documentation structure