Troubleshooting
Diagnostic checklist and quick fixes for common issues
⚡ Quick Diagnosis Checklist
📂 Important Paths (Windows)
game:
C:\Program Files (x86)\Steam\steamapps\common\Upload Labs mods:
C:\Program Files (x86)\Steam\steamapps\workshop\content\3606890 config:
%APPDATA%\Upload Labs\tajs_mod_config.json logs:
%APPDATA%\Upload Labs\logs saves:
%APPDATA%\Upload Labs\ Show Linux / macOS paths
Linux
game:
~/.steam/steam/steamapps/common/Upload Labs mods:
~/.steam/steam/steamapps/workshop/content/3606890 config:
~/.config/app_userdata/Upload Labs/tajs_mod_config.json logs:
~/.local/share/app_userdata/Upload Labs/logs macOS
game:
? mods:
? config:
? 🔧 Common Issues
Mod not loading after subscription
- Fully close the game and Steam
- Restart Steam to force Workshop sync
- Launch Upload Labs
- Look for the puzzle piece icon (⚙️) in the HUD
Game crashes on startup
- Disable all other mods first
- Enable Debug Logging in mod settings (if accessible)
- Check logs folder for error details
- Report the issue with logs attached
Settings not saving
- Ensure the game isn't running from a read-only location
- Try running as administrator once
- Use "Reset All Settings" in Debug tab
📎 When Reporting an Issue
Help us help you! Include these when reporting:
- ✓ Log files from the logs folder
- ✓ settings.cfg if settings-related
- ✓ Screenshots of the issue or error
- ✓ Steps to reproduce the problem
- ✓ Mod version (check in mod settings)