Skip to content
This repository was archived by the owner on Dec 30, 2025. It is now read-only.

tomstetson/FieldTuner-2.0

FieldTuner V2.0 - 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 Build Status Code Quality

๐ŸŽฏ 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

  • ๐ŸŽฎ Enhanced Config Detection - Auto-detect + manual profile selection
  • โšก Optimized Quick Settings - 3 performance presets with modern UI
  • ๐Ÿ–ฅ๏ธ Modular Graphics Management - Separate tab for graphics settings
  • ๐Ÿ’พ Bulletproof Backup System - Enhanced backup with validation
  • ๐Ÿ”ง Advanced Settings - Technical settings with search and favorites
  • ๐Ÿ› Real-time Debug Tools - Comprehensive logging and troubleshooting
  • ๐Ÿš€ Portable Design - No installation required, runs anywhere
  • โš™๏ธ User Preferences - Customizable application settings
  • โญ Favorites System - Save and manage favorite settings
  • ๐ŸŽฏ Profile Selector - Manual profile selection when auto-detect fails

๐Ÿš€ Quick Start

๐Ÿ“ฆ Download & Run (Recommended)

  1. Download the latest release from Releases
  2. Download FieldTuner-2.0.exe (~45MB)
  3. Right-click โ†’ "Run as administrator"
  4. Start configuring your Battlefield 6 settings!

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

๐Ÿ”ง From Source Code

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

# Install dependencies
pip install -r requirements.txt

# Run the application
python src/main_v2.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 2.0/
โ”œโ”€โ”€ ๐Ÿ“ src/                          # Main source code
โ”‚   โ”œโ”€โ”€ main_v2.py                   # Main entry point (V2.0)
โ”‚   โ”œโ”€โ”€ main.py                      # Legacy entry point
โ”‚   โ”œโ”€โ”€ debug.py                     # Debug utilities
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ core/                     # Core functionality
โ”‚   โ”‚   โ”œโ”€โ”€ config_manager.py        # Config file management
โ”‚   โ”‚   โ”œโ”€โ”€ favorites_manager.py     # Favorites system
โ”‚   โ”‚   โ”œโ”€โ”€ app_state.py             # Application state
โ”‚   โ”‚   โ”œโ”€โ”€ user_preferences.py      # User settings
โ”‚   โ”‚   โ”œโ”€โ”€ bf6_features.py          # BF6-specific features
โ”‚   โ”‚   โ””โ”€โ”€ path_config.py           # Path configuration
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ ui/                       # User interface
โ”‚   โ”‚   โ”œโ”€โ”€ main_window.py           # Main window
โ”‚   โ”‚   โ”œโ”€โ”€ theme.py                 # Theme management
โ”‚   โ”‚   โ”œโ”€โ”€ error_handler.py         # Error handling
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ tabs/                 # Application tabs
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ quick_settings_v2.py # Quick settings (V2.0)
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ bf6_features.py      # BF6 features
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ graphics.py          # Graphics settings
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ input.py             # Input settings
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ advanced.py          # Advanced settings
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ backup.py            # Backup management
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ code_view.py         # Raw config view
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ debug.py             # Debug info
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ preferences.py        # User preferences
โ”‚   โ”‚   โ””โ”€โ”€ ๐Ÿ“ components/            # UI components
โ”‚   โ”‚       โ””โ”€โ”€ custom_widgets.py    # Custom widgets
โ”‚   โ””โ”€โ”€ ๐Ÿ“ utils/                     # Utilities
โ”‚       โ”œโ”€โ”€ config_parser.py         # Config parsing
โ”‚       โ”œโ”€โ”€ file_utils.py            # File operations
โ”‚       โ”œโ”€โ”€ process_utils.py         # Process monitoring
โ”‚       โ””โ”€โ”€ performance.py           # Performance utilities
โ”œโ”€โ”€ ๐Ÿ“ assets/                       # Application assets
โ”‚   โ”œโ”€โ”€ icon.ico                     # Application icon
โ”‚   โ”œโ”€โ”€ logo.png                     # Professional logo
โ”‚   โ””โ”€โ”€ scaled_icon.png              # GitHub logo
โ”œโ”€โ”€ ๐Ÿ“ docs/                         # Documentation
โ”‚   โ”œโ”€โ”€ INSTALLATION.md              # Installation guide
โ”‚   โ”œโ”€โ”€ development-notes/            # Development notes
โ”‚   โ””โ”€โ”€ ...                          # Additional docs
โ”œโ”€โ”€ ๐Ÿ“ tests/                        # Test suite
โ”œโ”€โ”€ ๐Ÿ“ dist/                         # Built executables (gitignored)
โ”œโ”€โ”€ ๐Ÿ“ releases/                     # Release packages
โ”œโ”€โ”€ ๐Ÿ“„ build.py                      # Build script
โ”œโ”€โ”€ ๐Ÿ“„ pyproject.toml                # Project configuration
โ”œโ”€โ”€ ๐Ÿ“„ requirements.txt               # Python dependencies
โ””โ”€โ”€ ๐Ÿ“„ README.md                     # This file

๐Ÿ”ง Tech Stack

FieldTuner 2.0 is built with modern Python technologies:

  • Python 3.11+ - Modern Python with type hints and performance improvements
  • PyQt6 6.5+ - Cross-platform GUI framework for professional interfaces
  • psutil 5.9+ - Process and system utilities for runtime monitoring
  • PyInstaller - Packaging tool for creating portable executables

Architecture Highlights

  • Modular Design - Separated core, UI, and utilities for maintainability
  • Type Hints - Full type annotations for better code quality
  • Error Handling - Comprehensive error handling and logging
  • Portable Builds - Single-file executable with no installation needed

๐Ÿ”ง 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-2.0.git
cd FieldTuner-2.0

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python src/main_v2.py

# Run tests
python -m pytest tests/ -v

# Build executable
python build.py

๐Ÿ“š 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
  • ๐Ÿ”„ V2.0 - Initial release available

๐Ÿ“„ License

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

๐Ÿ™ Acknowledgments

  • Nobody621 - For the original idea
  • PyQt6 - For the excellent GUI framework
  • Python Community - For the amazing ecosystem
  • Cursor - For the incredible AI-powered development experience

Made with Love by SneakyTom โค๏ธ

Making Battlefield 6 configuration as smooth as butter

GitHub Download

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages