https://github.com/tejashah88/mk8d-combo-playground

A playground to explore optimal Mario Kart 8 combos via Pareto Optimization and fancy plots.
https://github.com/tejashah88/mk8d-combo-playground

data-visualization jupyter mario-kart mario-kart-8-deluxe panel pareto-efficiency plotly

Last synced: about 1 month ago
JSON representation

A playground to explore optimal Mario Kart 8 combos via Pareto Optimization and fancy plots.

• Host: GitHub
• URL: https://github.com/tejashah88/mk8d-combo-playground
• Owner: tejashah88
• License: mit
• Created: 2023-08-11T15:20:43.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-10T01:58:02.000Z (about 1 year ago)
• Last Synced: 2023-12-16T16:13:13.246Z (11 months ago)
• Topics: data-visualization, jupyter, mario-kart, mario-kart-8-deluxe, panel, pareto-efficiency, plotly
• Language: Jupyter Notebook
• Homepage: https://app.mk8d-combo-playground.com
• Size: 3.43 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Mario Kart 8 Deluxe - Combo Playground

Live Website: https://app.mk8d-combo-playground.com

![Screenshot of Kart Combo Playground - 3D View](images/playground-3d-view.png)

A playground to explore optimal Mario Kart 8 build via Pareto Optimization and fancy plots. This repository contains 2 notebooks, one for scraping the in-game stats from http://japan-mk.blog.jp/ (*as of August 16th, 2023*) and one for setting up the combo playground visualizer.

*NOTICE*: The plots on the live website will take a few seconds to regenerate when changing the parameters or controls. **PLEASE. BE. PATIENT.**

## Features

Let's say you want to find the best kart build based on 2 or 3 in-game stats. With this playground you can...

* Visualize all possible builds and see how they stack against each other based on selected stats.

    ![Screenshot of Kart Combo Playground - All Combos View](images/playground-all-combos-view.png)

* View all pareto-optimal combos and find the best one based on what stats matter to you (via the importance weights).

    ![Screenshot of Kart Combo Playground - Pareto Combos View](images/playground-pareto-combos-view.png)

* Click on any scatterpoint to see a table of all the possible builds matching the selected stats.

    ![Screenshot of Kart Combo Playground - Selected Point Lookup Table](images/selected-point-lookup-table.png)

* Choose your preferred build and see how it stacks up against the rest.

    ![Screenshot of Kart Combo Playground - Your Combo View](images/playground-your-combo-view.png)

* Compare in-game statistics for each part category (characters, frames, tires, and gliders) via the comparision heatmap.

    ![Screenshot of in-game statistics for each part category](images/game-stat-heatmap.png)

### Notes

* The coloring for all combos is defined such that the middle color (yellow) is defined at the 70th percentile point to exaggerate the differences for near-meta builds.

## Setup

### Option 1: Commandline (recommended)

1. (Setup & activate virtual python 3.x environment)

2. `pip install -U pip`

3. `pip install -r requirements.txt`

4. `jupyter nbconvert --execute --debug --clear-output notebooks/01_scrape_data.ipynb`

5. `panel serve notebooks/02_analyze_combos.ipynb --warm --reuse-sessions --global-loading-spinner`

### Option 2: Jupyter Lab

1. (Setup & activate virtual python 3.x environment)

2. `pip install -U pip`

3. `pip install -r requirements.txt`

4. `jupyter lab`

5. (Run all cells in `notebooks/01_scrape_data.ipynb`)

6. (Run all cells in `notebooks/02_analyze_combos.ipynb`)

## More resources / Credits

* Japan's Mario Kart Blog - http://japan-mk.blog.jp/

* Mario Kart 8 Deluxe Builder (Tobias Mattsson) - https://mk8dxbuilder.com/

* Bayesic's Original Build Optimizer (Bayesic) - https://bayesicmk8dx.shinyapps.io/mk8_build_optimizer/