🚨 PX-Guard | Discord Anti-Raid & Authorization Bot

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.

---

📑 Table of Contents

• ✨ Features
• 🚀 Installation
• ⚙️ Configuration
• 💡 Usage
• 🔧 Commands
• 📸 Preview
• 🤝 Contributing
• 📄 License
• 📜 Changelog

---

🔥 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

Setup Instructions

1. Clone the repository:

   git clone https://github.com/HIMURAw/PX-Guard.git
   cd PX-Guard

2. Install dependencies:

   npm install

3. Start the bot:

   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:

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 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 page.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• Support Server
• GitHub Repository

🙏 Acknowledgments

• Built with ❤️ by HIMURAw
• Thanks to all contributors who helped improve this project
• Special thanks to the Discord.js team for their amazing library

Made with ❤️ and JavaScript