mpg-coach-bot

MPG (Mon Petit Gazon) coach bot, to automate and optimize weekly league actions

• Concept
• Usage
• Sample output
  • Principal
  • Team Update
  • Transaction proposal
• Usage (advanced)
  • Configuration
  • Proxy http
  • Team update
  • Focus on recent efficiency
  • Use bonus
  • Leagues inclusion / exclusion
  • Tactical substitutes
  • Transactions proposal
  • Efficiency coefficient
  • SSL check
  • Requests successive wait time
  • Logs debug
  • Execution
• Roadmap
  • v1
  • v2
  • v3
• Development process
  • Build and release
  • Documentation format

Concept

Automate and optimize your MPG weekly league actions, using external data like mpgstats and sportsgambler.

The common features are:

• Displaying your teams, line by line, ordered by players efficiency (with injured players)
• Updating your team
• Proposing some players to buy, better than the one you have (if option transactions.proposal is enabled and MPG expert mode is bought)
• When league not started (aka: mercato), the best players to buy with good turn 1 auction (since v1.9) for your incoming team (since v1.10 long auction is used if season not started or current auction not representative)

NB: Your tactical organization and selected bonus are not updated and let as configured (but selected if some will be lost or no captain).

The efficiency algorithm used to calculate players efficiency score is:

player.matchs / championshipDays * player.average * (1 + player.goals() * efficiency.coeff)

With efficiency coeff : Attacker = 1.2 ; Midfielder = 1.05 ; Defender = 1.025 ; Goalkeeper = 1.

This efficiency is focused on recent days (8 by default), current season notation can be used by disabling option efficiency.recent.focus.

Usage

Prerequisite: java should be installed and on your PATH.

Download package mpg-coach-bot-X.Y.zip file from releases (or development SNAPSHOT from packages), extract ZIP files and update the given mpg.properties file with your MPG credentials and main options:

email = firstName.lastName@gmail.com
password = foobar

Depending your environment system, run mpg-coach-bot.bat (Windows) or mpg-coach-bot.sh (Linux).

To fully automate update your weekly actions on your MPG leagues, you can use a Linux crontab (daily at 6pm, for sample).

Disclaimer: MPG credentials are used to connect on MPG website API, to retrieve your leagues informations. These credentials are not stored outside the configuration file, but are in memory during the program execution.

Sample output

Principal

The main output is displaying:

• Injured players, to remove of your team
• Your team composition as remind
• Your team line by line, ordered by efficiency score (Eff.), with the players quotation/prices (Q.):

========== Your league name (leagueId) ==========
Out: Aouar Houssem (M - 34.88) - INJURY_ORANGE - Inconnu (depuis 12/11) - Inconnu
Out: Ambroise Oyongo (D - 11.85) - INJURY_ORANGE - Blessure au genou (depuis 04/11) - Inconnu

Optimized team (Compo: 343):
+---+--------------------+-------+----+
| P |    Player name     | Eff.  | Q. |
+---+--------------------+-------+----+
| G | Costil Benoit      |  5.58 | 20 |
| G | Prior Jerome       |  0.00 | 7  |
+---+--------------------+-------+----+
| D | Le Tallec Damien   | 17.35 | 23 |
| D | Meunier Thomas     | 13.13 | 24 |
| D | Marquinhos         | 10.43 | 25 |
| D | Kamara Boubacar    |  4.15 | 11 |
| D | Dubois Léo         |  2.27 | 11 |
+---+--------------------+-------+----+
| M | Thauvin Florian    | 41.47 | 38 |
| M | Tielemans Youri    | 17.73 | 13 |
| M | Nkunku Christopher |  8.75 | 13 |
| M | Lucas Evangelista  |  7.10 | 8  |
| M | Luiz Gustavo       |  4.42 | 15 |
| M | Lienard Dimitri    |  3.16 | 12 |
+---+--------------------+-------+----+
| A | Sala Emiliano      | 74.84 | 30 |
| A | Neymar             | 73.48 | 52 |
| A | Pepe Nicolas       | 65.61 | 36 |
| A | Laborde Gaetan     | 44.12 | 24 |
| A | Diony Lois         | 23.55 | 15 |
| A | Ripart Renaud      | 18.19 | 17 |
| A | Leya Iseka Aaron   | 11.38 | 10 |
+---+--------------------+-------+----+

Team Update

When option team.update is enabled and MPG expert mode is bought, you will have in addition:

Updating team ...

NB: Injured players are not taken into account to compose your team during an update.

Transaction proposal

When option transactions.proposal is enabled, you will have in addition:

Transactions proposal ...
Budget: 2
Budget if last players by line sold: 69
Player(s) to buy (3 best choice by line):
+---+----------------------------+-------+----+
| P |        Player name         | Eff.  | Q. |
+---+----------------------------+-------+----+
| D | Badiashile Mukinayi Benoit |  9.62 | 9  |
| D | Eboa Eboa Félix            |  5.89 | 11 |
| D | Alakouch Sofiane           |  5.89 | 11 |
| M | Lopez Maxime               | 11.27 | 15 |
| M | Sarr Bouna                 | 10.64 | 14 |
| M | Fulgini Angelo             | 10.64 | 13 |
| A | Otero Juan Ferney          |  9.14 | 13 |
| A | Kalifa Coulibaly           |  3.96 | 11 |
| A | Skuletic Petar             |  3.50 | 12 |
+---+----------------------------+-------+----+

Usage (advanced)

Configuration

Environments variable with MPG_ and key name in upper case + '_' (ex: MPG_EMAIL, MPG_PASSWORD, ...) could be used (override configuration file in this case).

The mpg.properties file could be used to change the program behavior on multiple items. Here the option with default values for information (except for proxy).

Proxy http

If you are using this program the Friday @work, you can have to configure the company proxy (since v1.1):

# Usage behind a company proxy
proxy.uri = http://company.proxy.com:80
proxy.user = foo
proxy.password = bar

Team update

To update team automatically ('true' by default since v1.6):

# Enable auto-update team
team.update = true

Focus on recent efficiency

To focus on recent efficiency, about team proposal and buy transaction (since v1.3, 'true' by default since v1.6):

# Focus on recent efficiency
efficiency.recent.focus = true
efficiency.recent.days = 8

Use bonus

To use bonus if not already selected and some would be lost (since v1.6, captain selection since v1.8):

# Use bonus
use.bonus = true

Leagues inclusion / exclusion

To include only some leagues or remove some of them, leagues id separated by comma (since v1.5):

# Include/exclude leagues
leagues.include = KX24XMUJ,KLGXSSUM
leagues.exclude = LJT3FXDX

Tactical substitutes

To enable/disable and change default notes for tactical substitutes (since v1.1):

# Notes for tactical substitutes
tactical.substitutes = true
tactical.substitute.attacker = 6.0
tactical.substitute.midfielder = 5.0
tactical.substitute.defender = 5.0

Transactions proposal

To enable/disable and change default notes for proposal of selling players (since v1.2):

# Enable sell/buy players proposal
transactions.proposal = true

# Notes for proposal of selling players
efficiency.sell.attacker = 3.0
efficiency.sell.midfielder= 3.0
efficiency.sell.defender = 3.0
efficiency.sell.goalkeeper = 3.0

Efficiency coefficient

To change default efficiency coefficient for players (since v1.2):

# Efficiency coefficient
efficiency.coefficient.attacker = 1.2
efficiency.coefficient.midfielder = 1.05
efficiency.coefficient.defender = 1.025
efficiency.coefficient.goalkeeper = 1.0

SSL check

To enable/disable SSL certificates check (since v1.7):

# Check SSL certificates of third part Website
ssl.certificates.check = true

Requests successive wait time

To avoid any temporary ban on some third-party websites, wait a little before between successive requests (since v1.7.1):

# Wait time (in seconds) for successive requests on URLs (list separated by comma)
request.wait.urls=https://www.sportsgambler.com
request.wait.time=1

Logs debug

To add some debug logs about execution (since v1.2):

# Enable debug logs
logs.debug = false

Execution

You can execute in command line:

java -jar mpg-coach-bot-x.y.z.jar your-mpg-config.properties

Note : If no file provided as parameter, a mpg.properties file will be used in working directory (if exist).

Roadmap

Details of working progress in milestones (and issues).

v1

Simple Java auto-executable batch (which jersey 2, jackson, ...), which include feature like:

• List your league players by efficiency (titular's regularity, score, ...) for current formation, to establish the best team for next match
• Propose changes to reach the probable best team
• Update team automatically
• Propose to sell and buy some players to optimize team
• ...

v2

Web application with friendly UI (Spring boot, docker container, JS Frontend, ...) to facilitate usage.

v3

Data mining on media resources to optimize team (injuries, coach announcements, ...).

Development process

Build and release

This project is using Maven as integration tool.

For development/SNAPSHOT build, use:

mvn package

Locally on your computer, you can improve end2end tests by providing file src/test/resources/mpg.properties file (which is not a symlink!) with real data (see mpg.properties.here file in directory for details):

email = firstName.lastName@gmail.com
password = foobar

For release build, use:

git reset --hard origin/master 
git branch -m next-version 
mvn -B clean release:clean release:prepare -Dusername=yourGitHubLogin -Dpassword=yourGitHubPasswordOrToken

After that, you would have to create pull-request from 'next-version' branch and rebase it on master for next version development.

Documentation format

This project is using NPM as complementary tool for documentation formatting.

For format documentation, use (see package.json for details):

npm run format-all