🌩 RustStorm PluginLister

A polished, production-ready plugin for Rust (uMod/Oxide) that lists installed plugins in-game and sends a beautifully formatted audit to Discord.

---

✨ Features

• 📋 List Installed Plugins

  • Use /listplugins to view all active plugins in-game.

• 🔒 Permission Controlled

  • Restricted to admins via:

    pluginlister.admin
    

• 🌐 Discord Webhook Integration

  • Sends a clean, branded plugin audit to Discord.
  • Supports embeds, pagination, thumbnails, and banners.

• 🎨 RustStorm Branding

  • Custom webhook name, avatar, colors, and layout.
  • Designed to match your server identity.

• 🚫 Plugin Blacklist (NEW)

  • Automatically hides system/admin plugins from output.
  • Keeps your audit clean and professional.

• 📄 Smart Pagination

  • Handles large servers (50+ plugins) safely.
  • Splits output into multiple embeds when needed.

---

⚙️ Configuration

Example config:

{
  "Enable Plugin": true,
  "Enable Discord Webhook": true,
  "Webhook URL": "YOUR_WEBHOOK_HERE",
  "Command Cooldown Seconds": 30,
  "Sort Plugins Alphabetically": true,

  "Plugin Blacklist": [
    "Unity",
    "Rust",
    "PlayerAdministration",
    "PermissionsManager",
    "CopyPaste",
    "AdminMenu",
    "AdminPanel"
  ],

  "Discord: Webhook Username": "RustStorm",
  "Discord: Avatar URL": "",
  "Discord: Embed Title": "🌩 RustStorm Plugin Audit",
  "Discord: Embed Color": 5814783,
  "Discord: Footer Text": "RustStorm • Plugin Inventory",
  "Discord: Embed Description": "Live plugin inventory snapshot from your RustStorm server.",
  "Discord: Thumbnail URL": "",
  "Discord: Banner Image URL": "",
  "Discord: Mention Everyone": false,
  "Discord: Max Plugins Per Embed": 20,
  "Discord: Include Text Fallback": true,

  "Config Version": "1.4"
}

---

🚫 Blacklist System

The blacklist removes unwanted plugins from:

• in-game /listplugins
• Discord output

This is ideal for hiding:

• core Rust plugins
• admin tools
• system utilities

You can edit it anytime without touching code.

---

🧠 How It Works

1. Player runs:

   /listplugins
   

2. Plugin:

   • checks permissions
   • applies cooldown
   • filters blacklist
   • sorts plugins (optional)

3. Output:

   • prints clean list in-game
   • sends formatted embeds to Discord

---

🔐 Permissions

Grant access:

oxide.grant group admin pluginlister.admin

---

📡 Discord Output

Includes:

• plugin name + version
• total plugin count
• requester name
• timestamp
• pagination for large lists

---

⚠️ Notes

• Discord has embed size limits — pagination handles this automatically.

• If nothing appears in Discord:

  • check webhook URL
  • ensure it hasn’t been leaked/regenerated
  • check server console for response logs

---

💡 Tips

• Set Max Plugins Per Embed = 15–20 for best reliability
• Use a logo as thumbnail
• Use a banner for page 1 branding
• Keep blacklist updated for clean output

---

🌩 RustStorm Ready

Built for:

• clean admin workflows
• professional Discord presentation
• scalable servers (50+ plugins)

---

📦 Summary

PluginLister gives you a clean, branded, and automated way to audit your server plugins both in-game and on Discord — without clutter.

---