{"id":17254997,"url":"https://github.com/tejashah88/mk8d-combo-playground","last_synced_at":"2025-03-26T08:15:44.180Z","repository":{"id":188677155,"uuid":"677439972","full_name":"tejashah88/mk8d-combo-playground","owner":"tejashah88","description":"A playground to explore optimal Mario Kart 8 combos via Pareto Optimization and fancy plots.","archived":false,"fork":false,"pushed_at":"2023-11-10T01:58:02.000Z","size":3593,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-12-16T16:13:13.246Z","etag":null,"topics":["data-visualization","jupyter","mario-kart","mario-kart-8-deluxe","panel","pareto-efficiency","plotly"],"latest_commit_sha":null,"homepage":"https://app.mk8d-combo-playground.com","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tejashah88.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-11T15:20:43.000Z","updated_at":"2023-08-20T18:43:07.000Z","dependencies_parsed_at":"2023-12-01T00:44:32.366Z","dependency_job_id":null,"html_url":"https://github.com/tejashah88/mk8d-combo-playground","commit_stats":{"total_commits":12,"total_committers":1,"mean_commits":12.0,"dds":0.0,"last_synced_commit":"4a52e9fe286d9bdf5fb83e16c4184ffc5a53fced"},"previous_names":["tejashah88/mk8d-combo-playground"],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejashah88%2Fmk8d-combo-playground","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejashah88%2Fmk8d-combo-playground/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejashah88%2Fmk8d-combo-playground/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tejashah88%2Fmk8d-combo-playground/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tejashah88","download_url":"https://codeload.github.com/tejashah88/mk8d-combo-playground/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245615009,"owners_count":20644376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-visualization","jupyter","mario-kart","mario-kart-8-deluxe","panel","pareto-efficiency","plotly"],"created_at":"2024-10-15T07:10:25.525Z","updated_at":"2025-03-26T08:15:44.160Z","avatar_url":"https://github.com/tejashah88.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mario Kart 8 Deluxe - Combo Playground\n\nLive Website: https://app.mk8d-combo-playground.com\n\n![Screenshot of Kart Combo Playground - 3D View](images/playground-3d-view.png)\n\nA 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.\n\n*NOTICE*: The plots on the live website will take a few seconds to regenerate when changing the parameters or controls. **PLEASE. BE. PATIENT.**\n\n## Features\nLet's say you want to find the best kart build based on 2 or 3 in-game stats. With this playground you can...\n* Visualize all possible builds and see how they stack against each other based on selected stats.\n    ![Screenshot of Kart Combo Playground - All Combos View](images/playground-all-combos-view.png)\n* View all pareto-optimal combos and find the best one based on what stats matter to you (via the importance weights).\n    ![Screenshot of Kart Combo Playground - Pareto Combos View](images/playground-pareto-combos-view.png)\n* Click on any scatterpoint to see a table of all the possible builds matching the selected stats.\n    ![Screenshot of Kart Combo Playground - Selected Point Lookup Table](images/selected-point-lookup-table.png)\n* Choose your preferred build and see how it stacks up against the rest.\n    ![Screenshot of Kart Combo Playground - Your Combo View](images/playground-your-combo-view.png)\n* Compare in-game statistics for each part category (characters, frames, tires, and gliders) via the comparision heatmap.\n    ![Screenshot of in-game statistics for each part category](images/game-stat-heatmap.png)\n\n### Notes\n* 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.\n\n## Setup\n\n### Option 1: Commandline (recommended)\n\n1. (Setup \u0026 activate virtual python 3.x environment)\n2. `pip install -U pip`\n3. `pip install -r requirements.txt`\n4. `jupyter nbconvert --execute --debug --clear-output notebooks/01_scrape_data.ipynb`\n5. `panel serve notebooks/02_analyze_combos.ipynb --warm --reuse-sessions --global-loading-spinner`\n\n### Option 2: Jupyter Lab\n\n1. (Setup \u0026 activate virtual python 3.x environment)\n2. `pip install -U pip`\n3. `pip install -r requirements.txt`\n4. `jupyter lab`\n5. (Run all cells in `notebooks/01_scrape_data.ipynb`)\n6. (Run all cells in `notebooks/02_analyze_combos.ipynb`)\n\n## More resources / Credits\n* Japan's Mario Kart Blog - http://japan-mk.blog.jp/\n* Mario Kart 8 Deluxe Builder (Tobias Mattsson) - https://mk8dxbuilder.com/\n* Bayesic's Original Build Optimizer (Bayesic) - https://bayesicmk8dx.shinyapps.io/mk8_build_optimizer/","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftejashah88%2Fmk8d-combo-playground","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftejashah88%2Fmk8d-combo-playground","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftejashah88%2Fmk8d-combo-playground/lists"}