Metadata-Version: 2.1
Name: bdo-empire
Version: 0.1.3
Summary: Worker empire optimizer for BDO using HiGHS mip solver.
Author-Email: Thell 'Bo' Fowler <thell@tbfowler.net>
License: Unlicense
Requires-Python: >=3.12
Requires-Dist: certifi>=2024.8.30
Requires-Dist: CTkToolTip>=0.8
Requires-Dist: customtkinter>=5.2.2
Requires-Dist: highspy>=1.7.2
Requires-Dist: natsort>=8.4.0
Requires-Dist: networkx>=3.3
Requires-Dist: psutil>=6.0.0
Requires-Dist: pulp>=2.9.0
Requires-Dist: tabulate>=0.9.0
Description-Content-Type: text/markdown

# bdo-empire

## About

Given a contribution point limit and price list this program will find the
optimum allocation of the points to maximize a Worker Node Empire's value.

It
  - generates a json file to import into [Workerman][workerman]
  - uses workers of level 40.
  - uses workers with optimum skills learned.
  - assumes all drops are sent to storage with zero cp cost (Calpheon).

It does not
  - account for cp spent outside of the Node Empire.
  - account for grind nodes or 'fixed' nodes. (TODO)

This program uses the HiGHS High Performance Optimization Software to solve
the MIP using branch and cut. The parameters chosen guarantee the result is
within 0.01% of the optimum value but in practice it is optimum for all test
cases used during the development and testing of the model.

## Installation

Using pipx: `pipx install bdo-empire`  
Using pip: `pip install bdo-empire`

## Usage

**Requirements**
  - python
  - an exported price list* from [Workerman settings page][settings].
  - optionally; an exported modifiers list from [Workerman modifiers page][modifiers]
    (click `▶Advanced`).

\* Use the 'reload' button on workerman's setting page prior to exporting.

**Start the program**

Installed using pipx: `optimize-empire.exe`  
Installed using pip: `pip -m bdo-empire.main`


Fill in the required fields, click **Optimize** and then wait.

All test instances using a variety of input parameters solved in under an hour
but each combination of CP, pricing, purchased lodging and region modifiers
will alter solution time.


[workerman]:https://shrddr.github.io/workerman
[settings]:https://shrddr.github.io/workerman/settings
[modifiers]:https://shrddr.github.io/workerman/modifiers
[release]:https://github.com/thell/bdo-empire/releases/latest