https://github.com/mrbean355/zak-bagans-bot
Reddit bot for r/GhostAdventures that posts funny Zak Bagans-themed comments.
https://github.com/mrbean355/zak-bagans-bot
bot reddit-bot
Last synced: 11 months ago
JSON representation
Reddit bot for r/GhostAdventures that posts funny Zak Bagans-themed comments.
- Host: GitHub
- URL: https://github.com/mrbean355/zak-bagans-bot
- Owner: MrBean355
- Created: 2021-04-05T15:18:14.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-08-09T11:37:56.000Z (11 months ago)
- Last Synced: 2025-08-09T13:20:50.721Z (11 months ago)
- Topics: bot, reddit-bot
- Language: Kotlin
- Homepage:
- Size: 28.6 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# Zak Bagans Reddit Bot
*There are things in this world we will never fully understand... understand*
## Welcome
This is a Reddit bot for [r/GhostAdventures](https://www.reddit.com/r/GhostAdventures/) which replies to posts and
comments that mention various Zak-related keywords with random quotes.
Credits go to [u/shiverstar](https://www.reddit.com/user/shiverstar/) for the amazing idea! It was discussed in
[this post](https://www.reddit.com/r/GhostAdventures/comments/mguuyi/we_need_a_zakbot/).
## How It Works
Every 15 minutes, the bot checks for new posts and comments on
[r/GhostAdventures](https://www.reddit.com/r/GhostAdventures/). The content of each post/comment is checked for various
keywords, and a reply may be sent if the keywords match. **Keywords are checked in this order**:
1. `zozo` - 25% chance to send a random
[Z̶̞̼̔̍o̶̮͇̕z̷̜͓̅̽ỡ̵̗ ̶̹͚̔̔p̵̂͜ḣ̷͓̜̏r̷͙͘̕ȃ̴̰̞s̵̹̗̈́̔e̴͚̻̒͊](https://zak-bagans-bot.herokuapp.com#zozo).
2. `mercury` - 25% chance to send a random [mercury phrase](https://zak-bagans-bot.herokuapp.com#mercury).
3. `situation` - 20% chance to send a random [situation phrase](https://zak-bagans-bot.herokuapp.com#situation).
4. `I feel` or `I'm feeling` - 25% chance to send a random
[feeling phrase](https://zak-bagans-bot.herokuapp.com#feeling).
5. `3` or `three` - 10% chance to send a random [trinity phrase](https://zak-bagans-bot.herokuapp.com#trinity).
6. `Aaron` - 10% chance to send a random [Aaron phrase](https://zak-bagans-bot.herokuapp.com#aaron).
7. `understand` - 20% chance to send a random [understand phrase](https://zak-bagans-bot.herokuapp.com#understand).
8. `we want answers` - 25% chance to send a random [answers phrase](https://zak-bagans-bot.herokuapp.com#answers).
9. `Zak` or `Bagans` - 20% chance send a random [generic phrase](https://zak-bagans-bot.herokuapp.com#generic).
Each post/comment will only receive, at most, one reply from the bot. If the bot sends a reply for one of the keywords,
it will not check for any of the others.
All keywords have a chance to send a reply. If the chance prevents a reply from being sent, the next keyword in the list
will be checked instead. For example, if a comment mentions "situation", there's a 50% chance to reply with a "situation
phrase", and a 50% chance to skip to the next keyword in the list.
## Opting Out
If you find the bot annoying, you can reply to one of its comments with `bad bot`. This will make the bot ignore all of
your future posts and comments.
## Special Commands
There are some commands that can be sent to the bot via comments on Reddit, and **only the bot's author can send them**.
- `!ZakBagansBot ignore_user ` - Ignore the user's future posts and comments.
- `!ZakBagansBot unignore_user ` - Stop ignoring the user.
- `!ZakBagansBot ignore_post ` - Ignore all comments on the current post. The reason is optional.
- `!ZakBagansBot unignore_post` - Stop ignoring the current post.
## Contributing
Any contributions by the community are welcome!
### Adding Responses
If you would like to add more Zak responses to the bot, please
[search the existing responses](https://zak-bagans-bot.herokuapp.com) first, to see if there's a similar one already
added. If not, you can [open an issue on GitHub](https://github.com/MrBean355/zak-bagans-bot/issues/new/choose), using
the issue template to get started. If you're unfamiliar with GitHub, feel free to
[chat to me on Reddit](https://www.reddit.com/user/Mr_Bean355) instead.
### Other Contributions
- Pull requests are welcome!
- [Open an issue on GitHub](https://github.com/MrBean355/zak-bagans-bot/issues/new/choose) for any feedback related to
the project.
- [Message me on Reddit](https://www.reddit.com/user/Mr_Bean355) if you'd prefer.