Skip to content

A script to find how many Showbucks and Kudos your Fall Guys locker is worth!

License

Notifications You must be signed in to change notification settings

ioh-UwU/fg-locker-value-calculator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 

Repository files navigation

FalL Guys Locker Value Calculator

This is the most involved data science project I've ever worked on!

A script to find how many Showbucks and Kudos your Fall Guys locker is worth!

Item Pricing data obtained from the Fall Guys Cosmetics Spreadsheet

TO USE: Download the repository. The raw python file will be directly in the repository folder, but the executable is inside the locker-value-calculator folder. I would have made it a single executable but GitHub has a commit file size limit of 25MB lol.

Prerequisites

AND, if using the script instead of the executable:

  • Python 3.10 or newer (made and tested on 3.10.8)
  • pip (Should come with the python installation)

libraries:

  • os (for file management) (includeed in the base python installation)
  • win32gui (for active window detection)
  • requests (for downloading the spreadsheets)
  • pandas (for data manipulation and analysis)
  • pynput (for mouse click and position detection)
  • pyautogui (for mouse and keyboard control)
  • pyperclip (for obtaining clipboard contents)

Usage

Disclaimers

  • The script creates and manages files (specifically, a folder which then houses all of the spreadsheets) within its directory, so it is strongly reccomended that it is isolated in some folder when run!
  • ALWAYS wait until the next page is shown before clicking again when cycling between locker pages! (This ONLY does not apply for the last page of each locker)
  • The script works by cycling through Bean Bot's /locker command and copying the text it outputs. If you have Discord's scaling settings set significantly different from the defaults, consider temporarily setting them to the default values

    Discord scaling settings
    Space Between Message Groups can be set to its maximum value to improve the reliability of copied text, but this is not strictly necessary.
  • Don't wait too long between inputs with the bot! The navigation buttons on the locker dissapear after a few minutes of no interaction!

Instructions

  1. Run the file. You will be prompted with a disclaimer similar to the first point above. type "continue" into the terminal and hit ender to keep going
    (this will be the case every time a similar message shows up)

The script will then download or update and organize all of the spreadsheets that it uses.

  1. Open the Discord app or, if it is open already, navigate to it. THe script will continue after this.
  2. You will be prompted to log in to use Bean Bot. It is STRONGLY RECCOMENDED that you use the bot in a private server or channel to avoid any interruptions from other server members typing!
    DO NOT NAVIGATE AWAY FROM THE CHANNEL AFTER COMPLETING THIS STEP!
  3. You will be prompted to continue again in the terminal window. When you navigate back, the bot will automatically enter the first /locker command, and calibration will start.
  4. Calibration
    You will be prompted to click the bottom right of the bot's message box, then the top left, and finally directly under the "Next" button.
    Ensure that your clicks are within the area that gets lightly highlighted when you hover over the message...

Message highlight graphic

That your bottom-right click is below the bottom of the message and far enough to the right...

Message highlight graphic

That your top-left click is within the message box... (Going outside can cause some strange behavior by copying a lot more text from other parts of the app than what is expected.)

Message highlight graphic

And that your click below the "Next" button is as close as possible without highlighting the button.

Button highlight graphic

  1. Click whenever the next page loads (the blue highlighted text goes away), repeat for every page of the locker.
    For the last page, once the text is highlighted and copied, click again to enter the command for the next locker.
  2. Type continue in the terminal again, similar to step 3.
  3. Repeat step six and seven until all locker menus have been processed. A message will appear in the terminal at this point saying all data has been collected (and there will not be another /locker command following the final click).
  4. Wait for the data to be processed. This may take a while, depending on how many items you have and how fast your CPU is.
  5. The value statistics for your locker will be outputed in the terminal window!

Potential Problems

  • Interaction Failed after "Next" is clicked!

First wait a few seconds to see if the error goes away on its own, but if this does not work, simply press down (not scroll) the middle mouse button. This will click the Next button and go to the next page. You can then resume left-clicking as normal.

  • The "Next" button was clicked, but nothing happened!

The click input may not be registered on some rare instances. Just click again! The current page will be copied again, but this will not affect the output!

  • A number in the results is much higher than I think it should be!

As with anything like this, there will be edge cases that may not be accounted for properly. If a number is too high, something (or several) has most-likely gotten around the checks in place and been counted more than once, and this can be resolved by running the script again with better calibration positions.

  • The command wasn't sent and is uncompleted in my message box!

This shouldn't happen, but if something strange occurs, the command can be completed manually and submitted prior to continuing with text input in the terminal.

What does the output mean?

Total Items

The total number of cosmetic items in your locker.

Unobtainable Items

The number of items in your locker that have not been obtainable since Fall Guys became free-to-play.

Unpriced Items

The number of items in your locker that have been or are still obtainable since the start of free-to-play and do not have a price attatched to them.
(Season/Fame Pass items, Crown Rank items, Event items, etc.)

Showbucks Value

The total cost of all of your items that can be purchased with Showbucks.
(This includes items that were purchased in Legacy Fall Guys and have since been given a Showbucks price.)

Kudos Value

The total cost of all of your items that can be purchased with Kudos.
(This does not account for items that were purchased in Legacy Fall Guys and are currently unobtainable.)

About

A script to find how many Showbucks and Kudos your Fall Guys locker is worth!

Resources

License

Stars

Watchers

Forks

Packages

No packages published