Skip to content

Ominousx/mapspec

Repository files navigation

🇬🇧 MapSpec – Veto Prep Tool for Valorant (with JP support)

MapSpec is a pre-match map confidence spectrum generator for Valorant. It helps analysts make smart pick/ban decisions by comparing historical map performance between two teams.

You can run it via:

  • ✅ Python CLI (local use)
  • ✅ Google Colab (with Japanese support via japanize-matplotlib)

📊 Example: Confidence Spectrum


👤 Authors

Name GitHub Role
Sushant Jha @Ominousx 🧠 Project Lead / CLI Developer
nolozy @nolozy 🇪・ Colab Notebook + 🇯🇵 Localization

🛠️ Installation (Local CLI)

git clone https://github.com/Ominousx/mapspec.git
cd mapspec
pip install -r requirements.txt

Then run:

python3 spectrum_cli.py --wolves wolves.csv --opponent geng.csv --output spectrum.png

☁️ Google Colab (JP-ready)

If you're using Google Colab:

  1. Create this folder structure in your Google Drive:
/My Drive
└── Colab Notebooks
    ├── Map-Confidence-Spectrum-for-GoogleColab.ipynb
    └── mapspec/
        ├── wolves.csv
        └── teams/
            └── blg/
                └── blg.csv

📌 Important: Folder name and CSV file name (excluding .csv) must match exactly.
Example: /teams/blg/blg.csv, /teams/drg/drg.csv, /teams/xlg/xlg.csv

  1. Open Map-Confidence-Spectrum-for-GoogleColab.ipynb
    from @nolozy’s fork

  2. Run the notebook to generate a spectrum chart with Japanese labels.


🌐 Language Support

Language Interface Notes
English ✅ CLI + README Default
Japanese ✅ Colab notebook (japanize-matplotlib) Developed by @nolozy

About

A command-line tool built for Valorant analysts to visualize map matchup confidence between their team and any opponent. It calculates and ranks each map based on win rate, pick frequency, and ban frequency — then outputs a 7-box spectrum from your team's point of view.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors