e7_optimizer

This is a rough demo/WIP of a constraint programming based approach for optimising gear in the game Epic 7.

This tool requires a gear file from the Fribbels Epic 7 Gear Optimizer, notably using the auto importer. You can still play around with it using the provided sample_gear.txt file however.

Install Python (only tested on version 3.9.7).
(Optional) Create a virtual environment.
Clone the repo with git clone https://github.com/HD23me/e7_optimizer.git.
Install the requirements with pip install -r requirements.txt.
Start the streamlit app using from the project root with streamlit run ./e7_optimizer/app.py.
Your browser should open up, or if not just click on the address shown in your terminal.

Load in your gear.txt file.
Select the hero you wish to add to the optimizer using the sidebar dropdown menu.
In the main window you should see a two expandable sections, a guide which goes into some detail about the optimizer options, and a constraint window.
In the second column of the table you can see the current stats of your selected hero including their gear. The stats will be slightly off as additional sources such as the artifact, imprint, and exclusive equipment haven't been added. To include these fill out the sidebar form and click submit. The stats in the constraint table should update accordingly.
After setting the desired constraints/weights (follow the expander guide), select the Add Hero to Optimizer button to add your first hero.
More tables should be generated showing the constraints you've set, as you add more heroes, they will also be shown here.
When you're satisfied with your set up click the Optimize button and wait for the solver to finish.
If you want you can play around with the displayed solver settings to add more time or workers to the solver.
If the solver is successful you should see more tables pop up showing a comparison between the loaded stats and optimized stats.
You can also view the gear used and click the Download equipment table as csv button to prepare yourself for the tedious process of regearing all your heroes.

There's no handling for changing the item file mid-session, if you do just clear the cache/restart the session.
No handling for additional stats from speciality changes or character specific bonuses.
While I haven't stress tested it much it usually finds some sort of solution in under a minute or decides that there is no solution. In cases where a solution can be reached but it's not the optimal one, you can try adding more time to the solver.
There are probably quite a few bugs, submit an issue if you find any though I can't promise they'll be fixed.

HD23me/e7_optimizer