Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lyubomirt/peacekeeper

PeaceKeeper is a powerful Discord moderation bot that helps you manage your server with ease. It's packed with features to keep your community safe and well-organized.
https://github.com/lyubomirt/peacekeeper

discord discord-bot moderation moderation-bot python

Last synced: 4 days ago
JSON representation

PeaceKeeper is a powerful Discord moderation bot that helps you manage your server with ease. It's packed with features to keep your community safe and well-organized.

Host: GitHub
URL: https://github.com/lyubomirt/peacekeeper
Owner: LyubomirT
License: gpl-3.0
Created: 2024-08-01T17:02:55.000Z (4 months ago)
Default Branch: main
Last Pushed: 2024-09-05T18:53:19.000Z (3 months ago)
Last Synced: 2024-10-19T02:42:06.833Z (about 1 month ago)
Topics: discord, discord-bot, moderation, moderation-bot, python
Language: Python
Homepage: https://discord.com/oauth2/authorize?client_id=1268613618610470992&permissions=8&integration_type=0&scope=bot
Size: 337 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# PeaceKeeper 🕊️

[![Discord](https://img.shields.io/discord/1079761115636043926?color=7289da&logo=discord&logoColor=white)](https://discord.gg/the-orange-squad)
[![GitHub license](https://img.shields.io/github/license/LyubomirT/peacekeeper)](https://github.com/LyubomirT/peacekeeper/blob/main/LICENSE)
[![Py-Cord](https://img.shields.io/badge/discord-py--cord-blue)](https://github.com/Pycord-Development/pycord)

PeaceKeeper is a powerful Discord moderation bot that helps you manage your server with ease. It's packed with features to keep your community safe and well-organized. 🛡️

## Features 🌟

- Classic moderation commands (kick, ban, timeout, etc.)
- Advanced logging system
- Auto-moderation with customizable filters
- A full-blown logging system
- User warning system
- Temporary roles
- And much more!

## Invite PeaceKeeper 🤖

Want to add PeaceKeeper to your server? [Click here to invite!](https://discord.com/oauth2/authorize?client_id=1268613618610470992&permissions=8&integration_type=0&scope=bot)

## Originally Made for PyDev Cafe ☕

PeaceKeeper was originally created for the PyDev Cafe Discord server, a community of Python developers. It's now open-source and available for everyone to use. Feel free to fork the repository and customize it to your liking!

## Setting Up Locally 🛠️

Want to run your own instance of PeaceKeeper? Here's how:

1. Clone the repository:
```
git clone https://github.com/LyubomirT/peacekeeper.git
```

2. Install the required dependencies:
```
pip install -r requirements.txt
```

3. Create a `.env` file in the root directory and add your bot token:
```
TOKEN=your_bot_token_here
```

4. Run the bot:
```
python main.py
```

## How It Works 🧠

PeaceKeeper uses Py-Cord for Discord API interactions and SQLite3 for data storage. It's designed for speed and efficiency, with features like:

- Customizable logging: Keep track of all important events in your server.
- Smart filters: Automatically moderate messages based on your rules.
- User management: Easily manage warnings, notes, and temporary roles.

## Contributing 🤝

We welcome contributions! If you have an idea or a bug fix, feel free to open an issue or submit a pull request.

## License 📄

This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.

---

Made with ❤️ by LyubomirT | [GitHub](https://github.com/LyubomirT) | [Discord](https://discord.gg/the-orange-squad)

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/lyubomirt)