https://github.com/himuraw/px-guard
powerful Discord Guard Bot with anti-raid, anti-spam, and moderation features.
https://github.com/himuraw/px-guard
anti anti-raid discord discord-bot discord-guard discord-guard-bot discord-js discord-js-v14 guard-bot protection security
Last synced: 9 months ago
JSON representation
powerful Discord Guard Bot with anti-raid, anti-spam, and moderation features.
- Host: GitHub
- URL: https://github.com/himuraw/px-guard
- Owner: HIMURAw
- License: mit
- Created: 2025-07-28T17:05:05.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-10-05T00:25:07.000Z (9 months ago)
- Last Synced: 2025-10-05T02:41:12.854Z (9 months ago)
- Topics: anti, anti-raid, discord, discord-bot, discord-guard, discord-guard-bot, discord-js, discord-js-v14, guard-bot, protection, security
- Language: JavaScript
- Homepage: https://pixeldev.com.tr
- Size: 74.2 KB
- Stars: 10
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🚨 PX-Guard | Discord Anti-Raid & Authorization Bot
[](https://discord.gg/pxdev)
[](LICENSE)
[](https://github.com/HIMURAw/PX-Guard/stargazers)
[](https://discord.js.org/)
**PX-Guard** is a powerful anti-raid and user authorization bot designed to protect your Discord server. It prevents unauthorized access attempts, detects suspicious activities, and provides authorization systems to make administrators' jobs easier.
[](https://heroku.com/deploy?template=https://github.com/HIMURAw/PX-Guard)
[](https://discord.com/oauth2/authorize?client_id=YOUR_BOT_ID&permissions=8&scope=bot%20applications.commands)
---
## 📑 Table of Contents
- [✨ Features](#-features)
- [🚀 Installation](#-installation)
- [⚙️ Configuration](#️-configuration)
- [💡 Usage](#-usage)
- [🔧 Commands](#-commands)
- [📸 Preview](#-preview)
- [🤝 Contributing](#-contributing)
- [📄 License](#-license)
- [📜 Changelog](CHANGELOG.md)
---
## 🔥 Features
- **Anti-Raid Protection**
- Instantly detects mass joins and spam attacks
- Automatically bans or quarantines suspicious users
- Locks server settings during raids to prevent damage
- **User Authorization**
- Custom role and permission management
- Detailed control for admin, moderator, and other authorized roles
- Automatically detects and intervenes in unauthorized actions by users
- **Unauthorized Action Prevention**
- Monitors channel, role, message, and membership changes
- Automatic alerts and logging for suspicious activities
- Approval system for critical operations requiring admin confirmation
- **Advanced Logging System**
- Logs all suspicious activities in detail
- Sends real-time notifications to specified channels
- **Easy Setup and Configuration**
- Simple, customizable configuration file
- Modern codebase with Discord.js v14 support
---
## 🚀 Installation
### Prerequisites
- Node.js v16.9.0 or higher
- npm v7 or higher
- Discord.js v14
- A Discord Bot Token from the [Discord Developer Portal](https://discord.com/developers/applications)
### Setup Instructions
1. Clone the repository:
```bash
git clone https://github.com/HIMURAw/PX-Guard.git
cd PX-Guard
```
2. Install dependencies:
```bash
npm install
```
3. Start the bot:
```bash
node .
# or using PM2 (recommended for production)
npm install -g pm2
pm2 start index.js --name "px-guard"
```
## ⚙️ Configuration
Edit the `config.js` file with your preferred settings. Here's an example configuration:
```javascript
module.exports = {
discord: {
token: "Your Discord Bot Token",
guards_token: ["Your Discord Bot Token", "Your Discord Bot Token"],
serverId: "your discord server id",
voiceID: "your discord voice channel id"
},
// ... other configuration options
};
```
### Protection Features
- Automatic raid detection and prevention
- Role and permission management
- Suspicious activity monitoring
## 📸 Preview
## 🤝 Contributing
Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) for details on how to contribute to this project.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
### 🐛 Reporting Issues
Found a bug? Please open an issue on our [GitHub Issues](https://github.com/HIMURAw/PX-Guard/issues) page.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🔗 Links
- [Support Server](https://discord.gg/pxdev)
- [GitHub Repository](https://github.com/HIMURAw/PX-Guard)
## 🙏 Acknowledgments
- Built with ❤️ by [HIMURAw](https://github.com/HIMURAw)
- Thanks to all contributors who helped improve this project
- Special thanks to the Discord.js team for their amazing library
Made with :heart: and JavaScript