claude-home/gaming/examples/ready-or-not/README.md
Cal Corum edc78c2dd6 CLAUDE: Add comprehensive gaming-aware Tdarr management system
- Created complete gaming detection and priority system
- Added gaming schedule configuration and enforcement
- Implemented Steam library monitoring with auto-detection
- Built comprehensive game process detection for multiple platforms
- Added gaming-aware Tdarr worker management with priority controls
- Created emergency gaming mode for immediate worker shutdown
- Integrated Discord notifications for gaming state changes
- Replaced old bash monitoring with enhanced Python monitoring system
- Added persistent state management and memory tracking
- Implemented configurable gaming time windows and schedules
- Updated .gitignore to exclude logs directories

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 15:17:52 -05:00

159 lines
5.6 KiB
Markdown

# 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