Skip to content

IDemixI/Among-Us-Statistics-Grabber

Repository files navigation

Among Us: Statistics Grabber

Among Us: Statistics Grabber

A script written in Python to extract and upload your Among Us player statistics to a REST endpoint so you can share with your friends and build a leaderboard or analyse data.

The current leaderboard can be found at: https://amongus.demix.network/leaderboard

Among Us, Statistics, Data Analytics, Leaderboard, Stats

GitHub Issues GitHub Licence GitHub Releases GitHub last commit Donate via PayPal


Table of Contents


Installation

Executable

  • Simply download the latest release and run it once to perform the setup. After this, the program will run whenever you launch Among Us via Steam.
  • If you decide to move the location of the executable, please run it again from the new location or it will not work. I recommend placing it somewhere like C:\Users\<user>\Documents\Among Us SG.

Python

  • Download the Python Script, ensure you have all of the required packages, then run the script from a Python interpreter (e.g. python AmongUsStats.py or py AmongUsStats.py)

Settings GIF   Tray Icon GIF

Manual Setup (Using either Python script or Executable)

Add the following line to your Steam: Among Us Launch Options if you're running the script manually via Python or you've downloaded the binary, but don't want to "Install" it automatically.

  • Python: python-interpreter "C:\path\to\script.py" %command%
  • Binary: "C:\path\to\executable.exe" %command%

Features

  • Ability to change REST Endpoint to push your JSON statistics to a database/front-end of your choice.
  • Player Stats file will be polled on an interval while playing Among Us and will update live, as you play.
  • Additional fields are sent in the POST Data - Unique Player ID, Last Used Nickname, Date & Time of your last change to statistics.
  • Log file written to C:\Users\<user>\AppData\LocalLow\Innersloth\Among Us\statGrabber.log which tracks successful POST requests and also if you've opened/closed the game.

JSON Schema

Your statistics are organised into a simple JSON object before being posted to your REST endpoint. The elements you're able to access are as follows:

User ID
Nickname
lastUpdated
Bodies Reported
Emergencies Called
Tasks Completed
All Tasks Completed
Sabotages Fixed
Impostor Kills
Times Murdered
Times Ejected
Crewmate Streak
Times Impostor
Times Crewmate
Games Started
Games Finished
Crewmate Vote Wins
Crewmate Task Wins
Impostor Vote Wins
Impostor Kill Wins
Impostor Sabotage Wins
Unknown 1
Unknown 2
Unknown 3
Unknown 4
Unknown 5
Unknown 6
Unknown 7

Contributing

To get started...

  1. 🍴 Fork this repo
  2. 👥 Add yourself as a contributor under the credits section
  3. 🔧 Open a new pull request after changing the code
  4. 🎉 Get your pull request approved - success!

Or just create an issue - every little bit of help counts! 😊


Contributors

IDemixI OMCS
IDemixI OMCS
IDemixI OMCS

FAQ

  • How do I uninstall the application?
    • You can remove the application by simply deleting the executable and removing the Launch Options from Among Us via Steam.

License

License

About

A small script written in Python (3.6+) to extract and upload your Among Us player statistics to a REST endpoint.

Topics

Resources

License

Stars

Watchers

Forks