Use the power of Python to traverse the cosmos and scout for players within the Football Manager game
Project description
PyScoutFM
Use the power of Python to traverse the cosmos and scout for players within the Football Manager game
Inspired by the fantastic work of @squirrel_plays and the contributors on this thread at FM-Arena
:sparkles: Features
- :mag: Generate scout reports from your squad and scouting screens within FM
- :bar_chart: Uses a customisable rating system to score players out of 100
- :wrench: Tweak or create your own weightings to evaluate players
- :file_folder: Exports the scout report into a pretty HTML file
- :mag_right: Easily search and sort the players in the scout report
- :rocket: Easily export from the game using the provided views
:zap: Requirements
- Python >= 3.10
- Football Manager (any version that supports the supplied views)
- Windows/MacOS
:package: Installation
- Check if you have Python installed by opening up a Command Prompt/Terminal and typing
python -V
- Install Python if you don't.
Note: If you're on Windows, follow this guide and if you're on Mac, I suggest using Homebrew
- Once installed, in the Command Prompt/Terminal, run:
pip install pyscoutfm
- To verify the installation, run:
pyscoutfm -v
:video_game: Generating a Scout Report
Let's get down to business and show you how quickly you can generate a scouting report for your current squad from the command line.
- Firstly, and for reference, to see a list of the commands and options available to you at any step of the way with PyScoutFM, append
--help
to a command:
pyscoutfm generate --help
Export data from FM
The tool requires an extract of data from Football Manager. To make this easy, we can use the views that come supplied with PyScoutFM.
- To save you hunting for them, run:
pyscoutfm copy-views-to --path="MY_LOCATION"
Where
MY_LOCATION
is the path you wish to copy the views to
- Import these views into FM; we'll start with the main squad screen of the team you're managing but note that you could go into your scouting screen as well:
- In the squad screen, use Ctrl+a (Windows) or ⌘+a (Mac) to select all of the players in the screen (this can be laggy!), followed by Ctrl+p/⌘+p, selecting Web Page as the print format:
- Save the printed file into your chosen location:
Generating the Scout Report
By default, the tool comes with a default config file along with some sensible attribute weightings. We will use those but tweak the import-path
option to match the location from step 5:
- In your terminal application run the command:
pyscoutfm generate --import-path=MY_LOCATION --export-path=MY_LOCATION
Where MY_LOCATION
is the path from step 5.
Note: The tool is smart enough to only load the most recent html file in the directory you specify
- You should see a Success message confirming the generation of the report.
Using the Scout Report
So you have a Scout Report, now what?
- Open up
latest.html
in your browser and you should see your players from the squad screen alongside their positional ratings which have been calculated with the tool:
-
Clicking on the arrows next to the column headings allows you to sort by that column. Also, a helpful search box makes it easier to find specific players.
-
Each of the rating columns represents a score out of 100. That is, how well suited a player is to a particular position based on the attribute weightings defined in the default weightings file
Hints and Tips
You may find yourself tweaking your search results in Football Manager and re-generating scouting reports often. Below are some tips for doing this optimally:
-
Always export your Football Manager data to the same location. The tool is smart enough to be able to load the most recent HTML file in a directory if you don't pass it an
import_path
parameter. -
You don't need to re-type your command in the Command Prompt/Terminal. Instead use the Up key to scroll through historical commands.
-
Once the report has been generated, just refresh the webpage in the Browser. The tool will always overwrite the
latest.html
. Don't worry though...it also saves a datetime stamped copy of the report as well.
:rocket: Commands
To get started, run:
pyscoutfm --help
The available options are:
Usage: pyscoutfm [OPTIONS] COMMAND [ARGS]...
Options:
--version -V Show the version and exit.
--help Show this message and exit.
Commands:
copy-views-to Copy the included views to a specified path before importing into FM
generate Generate a scouting report from the data exported from FM
Copy Views Command
Usage: pyscoutfm copy-views-to [OPTIONS]
Copy the included views to a specified path before importing into FM
Options:
--path -p TEXT The paths to copy the views to
--help Show this message and exit.
Generate Command
Usage: pyscoutfm generate [OPTIONS]
Generate a scouting report from the data exported from FM
Options:
--config-path TEXT The path to the config file to use
--import-path TEXT The path to the directory to import from [default: None]
--export-path TEXT The path to the directory to export to [default: None]
--weightings-path TEXT The path to the weightings file to use [default: None]
--weightings-set TEXT The weightings set to use [default: None]
--help Show this message and exit.
:hammer: Advanced usage
To be updated
:telescope: How does it work?
To be updated
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pyscoutfm-1.0.0b1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91e552dfd094a5d9234664222e4123beb3a790743f0559eb3dcd8ee163187563 |
|
MD5 | 73ccace46ea78d75101063dd1af186c4 |
|
BLAKE2b-256 | 25cf90f81d64777ff36b4b7b5a09723a49e561ec9fe9ff5eb7daa7668b771bcf |