Setting up the FF4FE generator

Initial Requirements

Clone the FF4FE repo - https://github.com/HungryTenor/FreeEnterprise4
Set up site URLs and secrets in the .env file
- EMBEDDED_REPORT_KEY must be 16, 24, or 32 bytes
Set up a Python ENV (from project root dir): python -m venv ENV
- Make sure to use the desired Python version for this
Create the file fe.pth at the specified location:
- Windows: ENV\Lib\site-packages\fe.pth
- Linux: ENV/lib/python3.xx/site-packages/fe.pth (adjust for the actual Python version used)
- The contents of the file should be the path of the project root (relative or absolute, with no trailing slash)
Activate the Python virtual environment
- Windows: ENV\Scripts\activate.bat
- Linux: source ENV/bin/activate
Run pip install -r requirements.txt

Activate the Python virtual environment (only needs to be done if it's not currently active)
- Windows: ENV\Scripts\activate.bat
- Linux: source ENV/bin/activate
Run python -m FreeEnt /path/to/rom make <arguments>
- Pass -h or –help as an argument for a list of command line generation flags
  - See Using the Generator for a breakdown

Install MongoDB
- Windows: https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-windows/
- Linux: https://www.mongodb.com/docs/manual/administration/install-on-linux/
  - You may also need to run ulimit -n 64000 to raise the limit on number of open files
Download Floating IPS and extract the appropriate executable to FreeEnt/server/bin/ (the directory will need to be created)
- Windows and Mac: https://www.romhacking.net/utilities/1040/
- Linux: The code can be found at https://github.com/Alcaro/Flips
  - Set the executable bit (chmod +x) on the flips-linux executable

Activate the Python virtual environment (only needs to be done if it's not currently active)
- Windows: ENV\Scripts\activate.bat
- Linux: source ENV/bin/activate
Run python -m FreeEnt /path/to/rom server <arguments>
- Pass -h or –help as an argument for a list of server flags
  - See Using the Generator#web_server for a breakdown
- The server can be run without any additional arguments, in which case it will be available at http://localhost:8080/