Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
DJStompZone authored Oct 10, 2023
1 parent a1c3a07 commit 5bc09a7
Showing 1 changed file with 78 additions and 1 deletion.
79 changes: 78 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,82 @@
# LFGScout
![](https://i.imgur.com/aEgp7Qo.png)
![GitHub top language](https://img.shields.io/github/languages/top/djstompzone/lfgscout)
![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/DJStompZone/LFGScout)
[![CodeQL](https://github.com/DJStompZone/LFGScout/actions/workflows/codeql.yml/badge.svg)](https://github.com/DJStompZone/LFGScout/actions/workflows/codeql.yml)
<a href="https://discord.gg/stompzone"><img src="https://img.shields.io/discord/599808270655291403?color=blue&label=Discord&logo=discord&logoColor=blue"></a>

## About
Discord bot that allows you to get notifications in your Discord server when members are playing your server's favorite games! Can be configured for a variety of games, and offers users the ability to opt out if they do not wish to participate.
LFGScout is a Discord bot designed to monitor and notify when members of a guild start playing a specific game. The bot uses the Disnake (a Python wrapper for the Discord API) and SQLite3 for database management.

![Static Badge](https://img.shields.io/badge/OS-Windows-White?style=flat&logo=Windows&logoColor=White&label=%20&labelColor=black)
![Static Badge](https://img.shields.io/badge/OS-Linux-White?style=flat&logo=Linux&logoColor=White&label=%20&labelColor=black)
![Static Badge](https://img.shields.io/badge/OS-Mac%20OS-White?style=flat&logo=Apple&logoColor=White&label=%20&labelColor=black)

## Features
- Monitor members' game activities in real-time.
- Notify a specified channel when someone starts playing a watched title.
- Admin commands to configure the notification channel and watched titles.
- Users can opt-out of notifications.
- Cooldown feature to prevent spamming notifications.

## Setup & Installation
1. Clone the repository:
```bash
git clone https://github.com/DJStompZone/LFGScout
cd LFGScout
```

2. Set up a virtual environment (recommended):
```bash
python3 -m venv venv
source venv/bin/activate
# On Windows use: venv\Scripts\activate
```

3. Install the required dependencies
```bash
pip install -r requirements.txt
```

4. Configure your environment

Copy the example.env file to .env and fill out the DISCORD_TOKEN and TEST_GUILD_IDS with appropriate values.

6. Run the bot
```bash
python bot.py
```

## Commands

### Admin Commands:

- `/lfgchannel <#channel>`: Set the channel where notifications will be sent.

- `/watchtitle <title>`: Add a game title to the watch list.

- `/unwatchtitle <title>`: Remove a game title from the watch list.

### User Commands:

- `/optout`: Allows a user to opt out of LFG notifications.

## Contribution
Feel free to [fork](https://github.com/DJStompZone/LFGScout/fork) the project, make some improvements, and submit a [pull request](https://github.com/DJStompZone/LFGScout/pulls).

## Issues & Bug Reports
Found a bug? Just create an [issue](https://github.com/DJStompZone/LFGScout/issues) and describe the problem.
You can also join the [StompZone Discord](https://discord.gg/stompzone) to see the bot in action or join our growing community.

## License
This project is licensed under the MIT License. See the LICENSE file for details.

## Acknowledgements

### Disnake
A Python wrapper for the Discord API.<br>
[Docs](https://docs.disnake.dev/en/stable/) | [GitHub](https://github.com/DisnakeDev/disnake) | [Discord](https://discord.gg/disnake)

### SQLite
A C-language library that implements a small, fast, self-contained, high-reliability, full-featured, SQL database engine.<br>
[Homepage](https://www.sqlite.org/index.html)

0 comments on commit 5bc09a7

Please sign in to comment.