Skip to content

SuppliedOrange/VALORANT-Instalocker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

64 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

⚠ Unmaintained, won't work.

You may choose to lose the outdated valclient library and use something else to make it work for yourself. If you're a developer yourself and you're interested in this, please check out #29

image

VALORANT Instalocker

A VALORANT Instalocker with a clean GUI


GitHub Downloads (all assets, all releases) GitHub Downloads (all assets, latest release)

🎑 Features

  • Select an agent, hop into a game and it instalocks before you even know it!
  • Works separately from the game through the VALORANT API using valclient
  • Allows you to stop the application from waiting for pre-game whenever
  • Allows you to switch between characters while instalocking
  • Stops instalocking and sending API requests as soon as an error is found
  • Clean and straightforward UI
  • Fixed 3 second refresh limit to better prevent API abuse
  • Agent banners, agent previews and other stuff i put in because memes

πŸ“© Installation

Button Icon


❔ How to use

  • Start VALORANT and this app.
  • Select any agent from the left-hand-side.
  • Instalocking should begin automatically, that's it!
  • Optionally, it's recommended to have Google Chrome installed. The .exe will simply open in your default browser otherwise, but it will still work.

❌ Windows protected your PC

The application might refuse to run because Windows will assume this is malicious.
The fix is pretty simple, click on More Info and click on Run Anyway
Is that safe? Yes, it is. Windows protects your PC because this is an unsigned executable from an external source. If you're feeling a little paranoid, you can build it yourself with the instructions below!


❓ Can I get banned?

Instalocking is a bannable offense. You likely won't get banned unless you go around telling everyone you have an instalocker. I wouldn't recommend keeping it running for long periods of time because it sends API requests instead of listening to the websocket. This is a very small project for educational purposes so I won't provide features like failsafes, that is up to you. Even if Riot detects this (through .exe blacklisting or pregame request measurement), you will likely only recieve a 7 day ban for API abuse. That's still unlikely to occur and hasn't happened yet.

@deadly: With all programs like this, there is no guarantee that it's safe because using the VALORANT API in this manner is against Riot's Terms of Service. However, this program does not use an autoclicker to select the agent, read the game's memory, or change the game's files; therefore, the anticheat shouldn't be triggered. No suspensions have been reported so far from using this method of exploit.


πŸ›  Building

  • For your convinience, simply use install.bat and then build.bat after downloading the repository for a smooth, automated process! After that, you're done. If you insist otherwise, follow ahead.

  • Use a python version lower than 3.12 or you'll end up with this error. You also cannot use python 3.10.0 because there is a pyinstaller issue with it. I used 3.10.10. This issue is probably fixed now. You should be able to run it with latest versions of python without the bottle.py fix. It will still exist just in case.

  • Run python -m pip install -r requirements.txt

  • Building a distributable:

    • Run the replace_bottle.py code in install_and_build. This step counters an issue with pyinstaller. You can also do this manually by going to your python's directory / Libs / site-packages and then replacing bottle.py with the latest variant. (See this issue) Likely unnecessary.
    • Run python -m eel main.py web --onefile --noconsole --icon=./web/favicon.ico --name="VALORANT Instalocker"
    • A distributable should appear in ./dist
  • Running with python:

    • Run python main.py

Adding agents

  • Add the agent name and their UUID in ./main.py and ./web/json/agents.json respectively. Note that the agent hierarchy depends on agents.json.

  • Add an agent banner in ./web/assets/images/agent-banners, The file name must be the agent's name in lower case and the file should be a .png
    The css that crops the banner is as follows. Crop the banner image and adjust it accordingly:

    .agent-thumb {
      max-width: 40vw;
      height: 7vw;
      object-fit: cover;
      object-position: 0vw -6vw;
      position: absolute;
      z-index: -1;
      aspect-ratio: 20 / 3;
      transform: skewY(5deg);
      transition: transform 0.2s;
    }
  • Add an agent preview in ./web/assets/images/agent-previews. The file name must be the agent's name in lower case and the file should be a .gif


πŸ€·β€β™€οΈ Support / Feedback:

  • You can hit me up on Discord @lternatively

  • If your issue is "cannot initialize a valclient", follow this method to report it #12

  • For other issues, use the --debug parameter to log everything that happens when you try to instalock then make an issue: Method 1 Method 2

  • Sometimes the instalocker waits for a few seconds after the loading screen to instalock, this is because it scans for the pre-game screen every 3 seconds. You can change the loop delay in the code for yourself.

Notes

  • I do not plan on developing this further, but I will maintain the code and update agents- this will continue to work.
  • I am also not responsible for misuse of this application, I do not condone using this and this only exists as an educational resource.
  • I plan to release a new version re-written in typescript as an electron app. I am sick of Eel, and I don't like the fact you can't choose individual agents for each map.

πŸ“° Credits

Legal

This is not affiliated with Riot Games. If you are a representative of Riot and wish to have this repository taken down, please reach out to me on my email from an official mailing address.