♡ Valorant Match Assistant ♡

･ﾟ✧ uwu edition ✧･ﾟ

  ╔═══════════════════════════════════════════════════════╗
  ║                                                       ║
  ║   ♡  VALORANT MATCH ASSISTANT  ♡                     ║
  ║         ･ﾟ✧ uwu edition ✧･ﾟ                          ║
  ║                                                       ║
  ╚═══════════════════════════════════════════════════════╝
           ૮ ˶ᵔ ᵕ ᵔ˶ ა   let's get that dub~

---

✨ What is this?

A cute little tool that helps you in the agent select screen~ It shows you info about your teammates and enemies before the game starts!

Works with: Competitive, Unrated, Swiftplay, Spike Rush, and all other modes!

---

💕 Features

Feature	Description
👥 Pre-Game Info	See all players, their agents, and which side you're starting on
🎯 Current Game Info	View players while in an active match
⚡ Instalock	Lock your agent instantly when match is found
🔮 Dodge Checker	Analyze your teammates and get a "slay or nay" verdict
🌍 Auto Region	Automatically detects your region (EU, NA, AP, etc.)

---

📦 Installation

Requirements

• Python 3.7 or higher
• Valorant installed on your PC

Setup

# 1. Clone or download this repo
git clone https://github.com/yourusername/valorant-match-assistant.git
cd valorant-match-assistant

# 2. Install requirements
pip install -r requirements.txt

# 3. Run the tool (make sure Valorant is open!)
python valorant_match_assistant.py

Or just:

pip install requests
python valorant_match_assistant.py

---

🎮 How to Use

1. Open Valorant and get to the lobby
2. Run the script
3. Queue up for a match
4. Use the menu to see player info or set up instalock

  ╭───────────────────────────────────────╮
  │         ♡ MAIN MENU ♡                │
  ├───────────────────────────────────────┤
  │  [1] 👥 see pre-game players~        │
  │  [2] 🎯 see current game players     │
  │  [3] ⚡ instalock an agent hehe      │
  │  [4] 🔮 dodge checker (slay or nay?) │
  │  [5] 🚪 exit (╥﹏╥)                   │
  ╰───────────────────────────────────────╯

---

📸 Screenshots

Pre-Game Info

  ╭──────────────────────────────────────────────────────╮
  │  ♡ MATCH FOUND ♡                                    │
  ├──────────────────────────────────────────────────────┤
  │  🗺️  map: Ascent                                     │
  │  🎮 mode: Competitive                                │
  │  🎯 side: 🔴 ATTACKERS (u go first!)                 │
  ╰──────────────────────────────────────────────────────╯

  ╭─ ♡ UR TEAM (slay together~) ─────────────────────────╮
  │  🔒 UwUPrincess#666      │ Neon       │ Platinum 2 ♡ │
  │  ⏳ xXSlayerXx#1234      │ Jett       │ Gold 3       │
  │  👆 CutiePatootie#uwu    │ Sage       │ Platinum 1   │
  ╰────────────────────────────────────────────────────────╯

Dodge Checker

  ╔═══════════════════════════════════════════╗
  ║  📊 TEAM SCORE: 72/100                    ║
  ╠═══════════════════════════════════════════╣
  ║  ✧･ﾟ✧ VERDICT: SLAY ✧･ﾟ✧                 ║
  ║  ur teammates look good! let's get it~   ║
  ║           ૮ ˶ᵔ ᵕ ᵔ˶ ა                    ║
  ╚═══════════════════════════════════════════╝

---

⚠️ Disclaimer

This tool uses Riot's unofficial local API.

While viewing player info is generally safe, the instalock feature is against Riot's Terms of Service. Use at your own risk! The tool is provided for educational purposes.

This project is not affiliated with or endorsed by Riot Games.

---

🔧 How it Works

The tool connects to Valorant's local client API (runs on 127.0.0.1) while the game is open. It reads:

• Lockfile → Gets authentication tokens
• ShooterGame.log → Auto-detects your region
• Local API → Fetches match and player data

No external servers, no data collection, everything runs locally! ♡

---

💖 Credits

• Valorant API Docs - Unofficial API documentation
• valorant-api.com - Game assets and agent data
• Made with love and sparkles ✧･ﾟ

---

📝 License

MIT License - do whatever u want with it~ ♡

---

✧･ﾟ good luck in ur games! ･ﾟ✧

૮ ˶ᵔ ᵕ ᵔ˶ ა