Skip to content

Valorant Instalocker is an application that uses Riot Games' Valorant API to automatically lock agents (instalock) on the agent selection screen in seconds. The program stands out with features such as automatic agent selection, mode determination, one-click match disruption, desktop shortcut creation, and automatic agent updates.

License

Notifications You must be signed in to change notification settings

Berkwe/Valorant-instalocker

Repository files navigation

🌐 English | Türkçe

🛠️ Valorant Instalocker

Promotional Video

output.mp4
FULL VIDEO

Valorant Instalocker is a fast and reliable auto agent locker for Riot Games’ Valorant. Often called a Valorant instalock tool or agent picker, it automatically selects and locks your chosen agent using the official Valorant API. The program is written in Python, includes a simple CLI, and works as a lightweight instalocker script that speeds up the agent selection phase dramatically.

❗IMPORTANT

This version is still in the testing phase. Please report any issues you encounter in the issues section.


🆕 Whats New v1.8

  • General Bugs Fixed
  • Source Code Refactored
  • Code Was Modularized And Made Independent From Global Variables
  • In Short Only The Source Code Was Refactored And Bugs Were Fixed No New Features Were Added (Since There Was Nothing Specific To Mention A More Detailed Explanation Was Provided)

🚀 Key Features

  • Commands: Instalocker allows you to use some customized commands.
  • Agent Lock Mode: Locks the selected agent — classic instalock behavior.
  • Pick Only Mode: Selects the agent without locking. You do not need to be at the computer while the match is being found.
  • Break Game Protection: If the match is breaked, Instalocker detects this and selects the same agent in the same mode again.
  • Match Cancel Mechanic: After an agent is locked, you can cancel the match with a single key press and return to the main menu.
  • Desktop Shortcut Creation: You can create desktop shortcuts for specific agents and modes. Running the shortcut allows a quick instalock.
  • Language Support: Instalocker now supports multiple languages. However, this is an experimental feature, so please report any bugs in the Issues section.
  • Automatic Language Detection: The language support includes automatic detection, which may vary depending on your Valorant settings. You can still change it manually using specific commands.
  • Agent Name Shortening: Shortens long agent names so they can be selected quickly.
  • Automatic Agent Updates: New agents are added automatically when released.
  • Logging System: Records errors and makes it easy to report them to the developer.

📦 Installation

💾 With the EXE:

  1. Download the EXE: Instalocker.exe
  2. Run it: Double-click to start.

🐍 With Python:

Requirements

  • Python 3.9+
  • Additional packages (see requirements.txt)
  • Note: Some features may not work

Steps

  1. Download the project:

    OR

    • Clone with Git:

      git clone https://github.com/Berkwe/Valorant-instalocker
      cd Valorant-instalocker
  2. Install dependencies:

    pip install -r requirements.txt
  3. Run:

    python instalocker.py

🛠️ Usage

⚙️ Agent Selection and Modes

  • Agent Lock Mode: Locks the agent — classic instalock.

  • Pick Only Mode: Picks the agent but does not lock it. This allows the match to be found while you are away from the computer.

⏩ Using Shortcuts

  • To create a desktop shortcut, type E/H at the agent selection screen.

  • A shortcut will appear on the desktop according to the agent name and the chosen mode.

🚫 Canceling a match through Instalocker:

  • After the agent is locked, type e or y in the console to cancel. If you cancel, Instalocker restarts. After the agent is locked, simply type e or y on the console. If you break it, Instalocker will restart, and penalties will still be imposed.

⚙️ Commands

You can use the following commands in the mode selection section :

- 1 : Selects and locks the agent. This is the normal (default) mode. 
      Press Enter to skip quickly.

- 2 : Selects the agent but does not lock it. 
      Useful for Competitive or Ranked games — you don’t need to be at your computer during the agent selection screen.

- 3 yardım / help : Displays this help message.

You can use the following commands in the agent name determination section :

- ajanlar / agents
  → Returns the agent list in a readable format.

- ajanlar-l / agents-l
  → Returns the agent list in a 'list' format.

- güncelle / update
  → Updates the agent list and language file.

- yb / re
  → Quickly restarts the application.

- liste-konumu / agents-folder
  → Returns the location of the agent list.

- kayıt-konumu / logs-folder
  → Returns the location of the log files.

- yardım / help
  → Displays this help message.

- türkçe / english
  → Changes the language to Turkish or English.

✂️ Agent Name Shortening

  • A simple mechanic was added so agents can be selected quickly. You may shorten agent names longer than 5 characters, but the typed name must be at least 4 characters.

Example:

✅ brim → valid
❌ reyn → invalid

🔄 Server Detection

  • Server is detected automatically; manual input is available for exceptional cases. (If this is unclear, skip it.)

⬇️ Automatic Agent Updates

  • Instalocker now continuously updates the agent list automatically. However, since this is done by a human, mistakes may occur — in that case, manual update may be required. If so, follow the steps below:

    Step 1:

    • Open the CMD (Command Prompt).

    Step 2:

    • Paste the following command:

      curl "https://raw.githubusercontent.com/Berkwe/Valorant-instalocker/refs/heads/main/agents.json" > %LOCALAPPDATA%\VALORANT\agents.json

🪲 Log system

  • Instalocker continuously logs to facilitate debugging and management. To detail the logs, type ‘debug’ in the console while in the mode selection section. This way, if you send the log file to the developer, it will be easier to understand the error.

  • You can find the Instalocker.log file by entering the following command in the ‘Run’ program opened with the Windows+R combination.

  • %LOCALAPPDATA%/VALORANT
    

ⓘ Performance and Feedback

  • For performance issues or suggestions, please use the Issues page.

🖤 Acknowledgements

  • I would like to thank techchrism for documenting the Valorant API and colinhartigan for packaging this API into a module, even though they did not contribute directly to the project.

🌟 Other Projects


📞 Contact

Berkwe


📝 License

This project is licensed under the MIT License.

🔑 Keywords

valorant instalocker, valorant auto lock, valorant agent locker, valorant instalock script, valorant agent picker, valorant instalocker tui

About

Valorant Instalocker is an application that uses Riot Games' Valorant API to automatically lock agents (instalock) on the agent selection screen in seconds. The program stands out with features such as automatic agent selection, mode determination, one-click match disruption, desktop shortcut creation, and automatic agent updates.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages