Custom Configs

Custom Configs

So, your current resolution and/or aspect ratio is not supported, don't fret, if you're willing to get your hands a little dirty, you can make VALocker work for you.

Prerequisites

• Basic knowledge of yaml syntax
• Text Editor
• ShareX, or any other screenshot tool that provides pixel coordinates
• (Optional) Tool to gather raw screen pixel color values, such as the Powertoys Color Picker

Steps

1. Download the Custom Config

Gathering Information

2. Open the game and set it to borderless windowed mode.
3. In the main menu, note the pixel coordinates of one of the two locations down below (I just take a picture with my phone).

Menu Section 1 - White Bar

Menu Section 2 - Yellow Bar

5. Start a custom game, turn Allow Cheats and Hide Match History on
6. Find and note down the coordinates of the bottom of the yellow bar, and match it exactly to the image below, although the exact horizontal position is not that important.

Locking Location - Yellow Bar

7. Hover over the top left-most agent and note the top-left pixel coordinates of the highlighted section, the clickable section. Then, count the pixels (you can drag with your mouse, ShareX will display the selection width) of the size of the agent box, and the spacing between the horizontal and vertical spacing of the selectable portion of the agent boxes. Finally, click on an agent and hover over the lock button, note the top-left most pixel coordinates of the lock button and the size, compare to the images below.

Top-Left Agent Button	Top-Left Locking Button
Horizontal Spacing	Vertical Spacing

8. Using the cheats menu, keep ending the game phase till you can surrender. Surrender and end the match.
9. In the post-match screen, note the pixel coordinates of the Play Again button, similar to the image below.

Red Play Button

Changing the Config

10. You're almost done, you can close VALORANT and open the custom config file in a text editor. Replace the values in the custom config file with the values you noted down:

• title: The title of the locking config, this is what will be displayed in the VALocker app. Make it easy to remember and unique.
• agentButtons:
  • size: The size of the agent box, in pixels.
  • columns: The number of columns of agents, this should be 9, but it may vary.
  • xDistance: The horizontal spacing between the selectable section of the agent boxes.
  • yDistance: The vertical spacing between the selectable section of the agent boxes.
  • start: The top-left most pixel coordinates of the highlighted section of the agent boxes, in the format [xCoord, yCoord].
• lockButton:
  • size: The size of the lock button, in pixels, in the format [width, height].
  • location: The top-left most pixel coordinates of the lock button, in the format [xCoord, yCoord].
• lockRegion (How the app knows when to lock in the agent):
  • xCoord: The x-coordinate of the yellow bar.
  • yCoord: The y-coordinate of the yellow bar.
  • width: The width of the yellow bar to scan for, if you find a pixel on the left-ish side of the yellow bar, you can increase the value. All pixels in the width must be the same color, default is 1.
  • height: The height of the yellow bar to scan for, it should be left as 1.
  • color: The color of the yellow bar, in the format [R, G, B], default is [234, 238, 178].
• waitingRegions (How the app knows when you are no longer in-game):
  • All values are the same as lockRegion, but the color should be the color of the pixel section, here are some default values:
    • White bar above banner: [245, 244, 240]
    • Yellow username: [235, 238, 178]
    • Red Play Button: [216, 57, 70]

10. Save the file in %AppData%/VALocker/data/locking-configs, open VALocker, go to the settings and select the custom config file you just edited, it should be displayed as whatever . You should now be able to lock in agents with your custom config.

If you gathered the data but are still having issues configuring the .yaml file, please open an issue and > I'll try to help you.

(Optional) Sharing

Optionally, please open an issue, and select the Locking Config template, and provide the info in the template, so I can add it as a default config for others to use.