https://github.com/taaku18/geoguessr-challenge-bot
A Discord Bot that creates Geoguessr challange links.
https://github.com/taaku18/geoguessr-challenge-bot
discord discord-bot discord-py geoguessr
Last synced: 11 days ago
JSON representation
A Discord Bot that creates Geoguessr challange links.
- Host: GitHub
- URL: https://github.com/taaku18/geoguessr-challenge-bot
- Owner: Taaku18
- License: mit
- Created: 2024-05-11T12:24:26.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-31T19:25:53.000Z (4 months ago)
- Last Synced: 2025-03-31T20:26:04.309Z (4 months ago)
- Topics: discord, discord-bot, discord-py, geoguessr
- Language: Python
- Homepage:
- Size: 149 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GeoGuessr Challenge Bot
The GeoGuessr Challenge Bot allows your friends to play single-player GeoGuessr for free through challenge links. However, you will need a GeoGuessr Pro account in order for the bot to create challenges.
How this works:
1. Anyone can use the `/geochallenge` command to create a challenge link.
2. The bot will create a challenge link and send it to the user.
Additionally, you can set the bot up to automatically send daily challenge links by using the `/setupgeodaily` command.
Please note that this bot is not affiliated with GeoGuessr, and we are not responsible for any consequences that may arise from using this bot (e.g. account ban). Use at your own risk.
# Installation
Pre-requisites: `docker`. Without Docker works too, but you will need to figure out how to run the bot yourself.
1. Clone this repository.
2. Create a `.env` file in the root directory with the following variables:
```dotenv
DISCORD_BOT_TOKEN=XXX
GEOGUESSR_AUTO_USERNAME=auto-guess-username
AUTHORIZED_GUILDS=12345,12345
```
If you want to make the bot public, you can remove the `AUTHORIZED_GUILDS` variable.
The `GEOGUESSR_AUTO_USERNAME` is used to auto-guess daily challenges (necessary to display the leaderboard). Since this bot will always guess in Antarctica, this will tank your GeoGuessr average score, so the solution is to make a dedicated (free) account for auto-guessing. If you do not wish to use a dedicated auto-guessing account, you can set `GEOGUESSR_AUTO_USERNAME` to your main account's username and set the session token to your main account's.
3. Build the Docker image:
```bash
docker build -t geoguessr-challenge-bot .
```
4. Run the Docker container:
```bash
docker run -d --name geoguessr-challenge-bot --env-file .env --restart on-failure -v data:/geoguessr/data geoguessr-challenge-bot:latest
```
5. Invite the bot to your server by visiting the following link:
```
https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=309237894208&integration_type=0&scope=bot+applications.commands
```
Replace `YOUR_CLIENT_ID` with your bot's client ID. You can find this in the Discord Developer Portal.
6. Set the session tokens for your GeoGuessr account(s) by DMing the bot (as the bot owner) the following commands:
```
!maintoken MAIN_SESSION_TOKEN
!autotoken AUTO_SESSION_TOKEN
```
The session tokens can be found by:
1. Login to GeoGuessr in your web browser.
2. Open the developer tools and navigate Application → Storage → Cookies.
3. Copy the value of the `_ncfa` cookie (that's the account's session cookie).
Unfortunately, the bot can no longer retrieve the session token automatically due to Cloudflare anti-bot protection. The session token may expire after a while, so you may need to update occasionally.
7. Sync the bot's slash commands by DMing the bot (as the bot owner) the following command:
```
!sync
```
# Usage
The bot has the following commands:
- `/geochallenge`: Create a challenge link.
- `/geodaily`: Get the current daily challenge link.
- `/setupgeodaily`: Set up daily challenge links.
- `/cancelgeodaily`: Disable sending daily challenge links.
Limitations: At the moment, the bot cannot control who can use the commands. This means that anyone in the server can use the commands.
# License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.