Repository files navigation

OpenFoot Manager (temporary name) is a free and open source football/soccer manager game, licensed under theGPLv3, inspired by the famous franchise Football Manager™, and based on the source code ofBygfoot, an abandoned manager game.

The purpose of this project is to provide an interesting and fun game for simulating a manager's life in a simple way: managing a team, dealing with players, finances and many other features. Resembling the gameplay of Football Manager, FIFA Manager, Championship Manager, Elifoot, Bygfoot, Brasfoot etc. this game aims to become a complete alternative for these games.

The game is still under development and it is not even close to ready for gameplay action. However, we already have a debug version of the game for testing purposes.

To run the debug build, ensure that you have Python 3.10 or higher.

Clone the repository using:

git clone https://github.com/openfootmanager/openfootmanager.git

We don't use external git repositories, so there's no need for a--recursive clone.

This project usesPipenv orPoetry to manage virtual environments and dependencies.

To install Pipenv and install the project's dependencies, run the following commands:

pip install pipenv

After cloning the repository, install the virtualenv and its dependencies using:

pipenv install

For contributors, you might also need development dependencies (black, isort, flake8, pytest, pre-commit):

pipenv install --dev

If you want to commit to the repo, install pre-commit:

pipenv run python -m pre-commit install

To run the tests:

pipenv run pytest

To run the debug version of the project, use therun.py file at the root of this project folder:

pipenv run python run.py

Poetry is a standard in most Python projects. It uses thepyproject.toml, introduced inPEP 518, to managethe project's dependencies and virtualenvs. It's a little more convenient than Pipenv, so you can use it to run the project as well.

To install Poetry:

pip install poetry

Then you can just install the dependencies with:

poetry install

This will also install the development dependencies. If you only wish to run the project and do not want to contribute,install it using the following command:

poetry install --without dev

Similar to Pipenv, you can run things inside poetry's virtualenv with thepoetry run command. If you wish to contribute,you must install thepre-commit package to allow pre-commit hooks:

poetry run pre-commit install

We use them to ensure code standards and formatting used throughout the project, so we don't need to nitpick on littleissues with formatting and following PEP8.

To run the tests, usepytest:

poetry run pytest

And to run the current version of the project, run:

poetry run python run.py

Check theCONTRIBUTING file for more information on how to contribute.

The game will have a number of features inspired by other established games on the market. The following features are planned:

• Choose any team and any league to manage
• Manage the team's finances
• Manage team's roster, being able to hire/fire players, choose team's formations and which players are going to play
• Organize practice sections, developing players even further
• Find new talents from Youth Academy
• Qualify for major leagues and championships, win important trophies
• Get the chance to become a national team's manager
• Simulation of games with Match Live Events (Descriptions of most important match events)
• Simulate results of other games
• Talk to the press
• Database of fictitious players

• 3D simulation of matches
• Expand database
• Sponsorship with products that boost player's performances
• Mod support

OpenFoot Manager - A free and open source soccer management gameCopyright (C) 2020-2025  Pedrenrique G. GuimarãesThis program is free software: you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe Free Software Foundation, either version 3 of the License, or(at your option) any later version.This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See theGNU General Public License for more details.You should have received a copy of the GNU General Public Licensealong with this program.  If not, see <http://www.gnu.org/licenses/>.

CheckLICENSE for more information.