Skip to content

tomstetson/FieldTuner-Desktop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

35 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

FieldTuner - Battlefield 6 Configuration Tool

FieldTuner Logo

A professional-grade configuration tool for Battlefield 6 with an intuitive interface and powerful features.

License: MIT Python 3.11+ PyQt6 Windows Release

๐ŸŽฏ Overview

FieldTuner is a comprehensive configuration tool designed specifically for Battlefield 6. It provides an intuitive, WeMod-inspired interface for managing all aspects of your game settings, from graphics optimization to advanced technical configurations.

โœจ Key Features

  • ๐ŸŽฎ Automatic Config Detection - Finds your BF6 config files automatically
  • โšก Quick Settings Presets - 5 optimized presets for different playstyles
  • ๐Ÿ–ฅ๏ธ Graphics Management - Comprehensive graphics settings control
  • ๐Ÿ’พ Smart Backup System - Automatic backups with easy restoration
  • ๐Ÿ”ง Advanced Settings - Technical settings with user-friendly descriptions
  • ๐Ÿ› Debug Tools - Real-time logging and troubleshooting
  • ๐Ÿš€ Portable Design - No installation required, runs anywhere

๐Ÿ†• V1.1 Enhanced Features

  • ๐Ÿ“Š Progress Indicators - Visual feedback during configuration changes
  • โŒจ๏ธ Keyboard Shortcuts - Ctrl+S (save), F5 (refresh), Ctrl+B (backup), Ctrl+R (restore)
  • ๐Ÿ›ก๏ธ Enhanced Error Handling - Robust error recovery and clear user feedback
  • ๐Ÿงช Comprehensive Testing - 24 new test cases with 100% pass rate
  • ๐Ÿ”ง Developer Tools - Type hints, centralized constants, and utility functions
  • โšก Performance Optimizations - Faster startup and better memory management

๐ŸŒ FieldTuner Web (NEW!)

A browser-based version with a tactical command center UI:

  • ๐Ÿ–ฅ๏ธ No Installation - Works in any modern browser
  • โšก 150+ Settings - Complete settings database
  • ๐ŸŽฏ 5 Pro Presets - Quick optimization profiles
  • ๐Ÿ” Real-time Search - Find settings instantly
  • ๐Ÿ“Š Change Tracking - Visual diff of modifications

See fieldtuner-web/ for details or try it online.

๐Ÿ™ Acknowledgments

Hans Yolo - For the original idea

๐Ÿš€ Quick Start

๐Ÿ“ฆ Download & Run (Recommended)

  1. Go to Releases
  2. Download FieldTuner-V1.1-Improved.exe (~40.5MB)
  3. Right-click โ†’ "Run as administrator"
  4. Start configuring your Battlefield 6 settings!

Note: No installation required! The executable is completely portable.

๐ŸŽฏ System Requirements

  • OS: Windows 10/11 (64-bit)
  • RAM: 4GB minimum, 8GB recommended
  • Storage: 50MB free space
  • Battlefield 6: Must be installed and run at least once

๐ŸŽฎ How to Use

  1. Launch FieldTuner (run as administrator)
  2. Select your BF6 config file (auto-detected)
  3. Choose a preset or customize settings
  4. Click "Apply Changes" to save (or use Ctrl+S)

Keyboard Shortcuts:

  • Ctrl+S - Save/Apply changes
  • F5 - Refresh settings
  • Ctrl+B - Create quick backup
  • Ctrl+R - Restore from backup

๐Ÿ†˜ Troubleshooting

"Config file not found"

  • Make sure Battlefield 6 is installed
  • Run the game at least once to create config files
  • Check that config files exist in your Documents folder

"Permission denied"

  • Run FieldTuner as administrator
  • Ensure you have administrator privileges

"Application won't start"

  • Check Windows version compatibility
  • Use the portable executable version
  • Check antivirus software isn't blocking the executable

๐Ÿ”ง From Source Code

# Clone the repository
git clone https://github.com/tomstetson/FieldTuner.git
cd FieldTuner

# Install dependencies
pip install PyQt6

# Run the application
python src/main.py

๐ŸŽฎ Quick Settings Presets

Preset Description Use Case
Esports Pro Maximum performance for competitive play Professional gaming, tournaments
Competitive Balanced performance and quality Ranked matches, competitive play
Balanced Good performance with decent quality Casual gaming, mixed use
Quality High quality settings Single-player, cinematic experience
Performance Maximum performance settings Low-end hardware, high FPS

๐Ÿ›ก๏ธ Safety & Reliability

  • โœ… Automatic Backups - Creates backups before any changes
  • โœ… Confirmation Dialogs - Prevents accidental modifications
  • โœ… Error Recovery - Robust error handling and recovery
  • โœ… Comprehensive Logging - Detailed logs for troubleshooting
  • โœ… Admin Privileges - Secure file modification with proper permissions

๐Ÿ“ Project Structure

FieldTuner/
โ”œโ”€โ”€ ๐Ÿ“ src/                          # Main source code
โ”‚   โ”œโ”€โ”€ main.py                      # Core application (4,300+ lines)
โ”‚   โ”œโ”€โ”€ settings_database.py         # BF6 settings database
โ”‚   โ””โ”€โ”€ debug.py                     # Debug utilities
โ”œโ”€โ”€ ๐Ÿ“ assets/                       # Application assets
โ”‚   โ”œโ”€โ”€ icon.ico                     # Application icon
โ”‚   โ”œโ”€โ”€ logo.png                     # Professional logo
โ”‚   โ””โ”€โ”€ scaled_icon.png              # GitHub logo
โ”œโ”€โ”€ ๐Ÿ“ docs/                         # Documentation
โ”œโ”€โ”€ ๐Ÿ“ tests/                        # Test suite
โ”œโ”€โ”€ ๐Ÿ“ dist/                         # Built executables
โ”œโ”€โ”€ ๐Ÿ“ releases/                     # Release packages
โ”œโ”€โ”€ ๐Ÿ“„ build.py                      # Build script
โ”œโ”€โ”€ ๐Ÿ“„ pyproject.toml                # Project configuration
โ””โ”€โ”€ ๐Ÿ“„ README.md                     # This file

๐Ÿ”ง System Requirements

Minimum Requirements

  • OS: Windows 10/11 (64-bit)
  • RAM: 4GB minimum
  • Storage: 50MB free space
  • Battlefield 6: Must be installed and run at least once

Recommended Requirements

  • OS: Windows 11 (64-bit)
  • RAM: 8GB or more
  • Storage: 100MB free space
  • Battlefield 6: Latest version

๐Ÿ“ Config File Locations

FieldTuner automatically detects config files in:

  • %USERPROFILE%\Documents\Battlefield 6\settings\steam\PROFSAVE_profile
  • %USERPROFILE%\Documents\Battlefield 6\settings\PROFSAVE_profile
  • %USERPROFILE%\OneDrive\Documents\Battlefield 6\settings\steam\PROFSAVE_profile

๐Ÿ’พ Data Storage

  • Backups: %APPDATA%\FieldTuner\backups\
  • Logs: %APPDATA%\FieldTuner\logs\
  • Settings: Portable data storage

๐Ÿ†˜ Troubleshooting

Common Issues

"Config file not found"

  • โœ… Make sure Battlefield 6 is installed
  • โœ… Run the game at least once to create config files
  • โœ… Check that config files exist in your Documents folder

"Permission denied"

  • โœ… Run FieldTuner as administrator
  • โœ… Ensure you have administrator privileges

"Application won't start"

  • โœ… Check Windows version compatibility
  • โœ… Use the portable executable version
  • โœ… Check antivirus software isn't blocking the executable

Debug Mode

  1. Open the Debug tab in FieldTuner
  2. Check the real-time logs for error messages
  3. Look for specific error patterns
  4. Report issues with log details

๐Ÿค Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

# Clone the repository
git clone https://github.com/tomstetson/FieldTuner.git
cd FieldTuner

# Install dependencies
pip install PyQt6

# Run the application
python src/main.py

# Run tests
python -m pytest tests/ -v

๐Ÿ“š Documentation

๐Ÿ† Project Status

  • โœ… Core Features - Complete and tested
  • โœ… UI/UX - Professional, WeMod-inspired design
  • โœ… Backup System - Robust backup and restore functionality
  • โœ… Portable Build - Self-contained executable ready
  • โœ… Documentation - Comprehensive guides
  • โœ… Testing - Test coverage with automated testing
  • โœ… V1.1 Enhanced - Latest release with improvements
  • ๐Ÿ”„ V1.0 - Initial release available

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Created by Tom with Love from Cursor โค๏ธ

Making Battlefield 6 configuration as smooth as butter

GitHub Download

About

BattleField 6 Configuration Tool

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •