Metadata-Version: 2.1
Name: bdo-empire
Version: 0.1.2
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.

## Usage

Start the program and fill in the required fields, click "Optimize" and then
wait. All test instances using a variety of CP limits solved in under an hour
but each combination of CP, pricing, purchased lodging and region modifiers
will alter solution time.

### Requirements

You will need:

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

[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