https://github.com/lorencerri/discord-guardian

Set strict limits on administration actions such as bans and deletions with Guardian
https://github.com/lorencerri/discord-guardian

hacktoberfest

Last synced: 2 months ago
JSON representation

Set strict limits on administration actions such as bans and deletions with Guardian

• Host: GitHub
• URL: https://github.com/lorencerri/discord-guardian
• Owner: lorencerri
• License: mit
• Created: 2020-03-20T19:02:10.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2022-11-08T18:07:46.000Z (about 2 years ago)
• Last Synced: 2024-10-03T16:15:33.455Z (3 months ago)
• Topics: hacktoberfest
• Language: JavaScript
• Homepage: https://plexidev.org
• Size: 146 KB
• Stars: 59
• Watchers: 5
• Forks: 25
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
> 🎉🎉 **A rewrite is currently in progress! The new update will utilize all of Discord's new features (Buttons, User Contexts, etc.) and comply with their upcoming changes (slash commands).** 🎉🎉 

> 

> **Give the repo a ⭐ to stay up to date for when it drops!**

## ![Guardian Logo](https://www.plexidev.org/guardian.png)

Guardian allows server owners to set strict limits on administration actions. These actions include: bans, kicks, channel creations/deletions, and role creations/deletions. Once someone meets any of these limits, their Discord permissions are automatically revoked via removing all of their roles.

## Hey There 👋

I work on these projects in my spare time, if you'd like to support me, you can do so via [Patreon! ❤️](https://www.patreon.com/lorencerri)

*Need a custom Discord bot or project completed? Feel free to send me a message on [Discord](https://discord.gg/plexidev) (lorencerri#2113) or [Twitter](https://twitter.com/lorencerri)!*

## Suggesting Features

Please suggest features via the [issues](https://github.com/lorencerri/discord-guardian) page. Alternatively, you can send me a message on [Twitter](https://twitter.com/lorencerri).

## Setup

_Requires [Node.js](nodejs.org) v12 or higher_

**1.** Download or clone this repository

**2.** Install required dependencies using `npm install` within the repository folder

**3.** Create a .env file at the root level of the project and add `BOT_TOKEN=` to it. (Replace \ with your TOKEN)

**4.** Configure `config.js` to your personal preferences

**5.** Run `npm start` to start the bot

**6.** Ensure the highest role the bot has is higher than others so it can remove their roles

If you have any questions, feel free to either ask me on [Twitter](https://twitter.com/lorencerri) or [Discord](https://discord.gg/plexidev).

## Commands

_You can mention the bot instead of using a prefix_

**`g!prefix [prefix]`** Displays the current prefix, changes the prefix if specified

**`g!limits [index] [value]`** Displays the limits, changes an index's value if specified

**`g!reset [type]`** Resets the specified data or collection

**`g!recent [ID]`** Displays recent moderation actions that can trigger the bot's limits

**`g!log [#channel]`** Assigns the logging channel for actions and limit changing

## Example Images

_The prefix shown in the images are different due to the ability to change the prefix using `g!prefix newPrefix`_

_g!limits command_ 


![](https://i.plexidev.org/w05p)

_Image of a limit reached notification_ 


![](https://i.plexidev.org/gVYq)

_g!recent command_ 


![](https://i.plexidev.org/nfMD)

*Thanks for reading! Feel free to star this repo if you've found it useful 😊*