Skip to content

theokyr/vencord-plugins

Repository files navigation

venpm

vencord-plugins

Custom Vencord userplugins by kamaras.
UI enhancements, keyboard navigation, and developer tools for Discord.

showcase license requires Vencord


Plugins

Plugin Description
betterBlockIgnore Fork of Vencord NoBlockedMessages that hides blocked and ignored users more completely: messages, replies, mentions, and reactions
betterRes Unlocks Discord stream quality choices and adds lower/custom resolutions and frame rates
bsNoMore Remove upsell clutter — compacts DM nav, hides clan tags, avatar decorations, quest popups, and store UI
channelTabs Quick-access tab bar for channels and DMs
discordMcp MCP bridge — expose Discord to AI agents via the Model Context Protocol
embedFix Replaces social media URLs with embed-friendly alternatives from third-party providers
enrichedHeader Moves Discord channel header controls into the title bar and exposes a typed header layout API
hotkeyNav Keyboard-driven navigation to notifications, DMs, and servers with inline keycap hints
messageHeaderAvatar Displays user avatars inline in message headers next to the username
minimalCallBar Replaces the large DM/Group DM call overlay with a compact 32px bar
settingsHub Unified settings page for custom plugins
venpmGui Manage Vencord plugins from inside Discord — browse, install, update, and configure without the terminal
vipNotifications VIP notification rules that can alert through Discord notification restrictions

Attribution: betterBlockIgnore is a fork of Vencord's stock NoBlockedMessages plugin by Vendicated and contributors, originally authored by rushii, Samu, and jamesbt365. This fork keeps the upstream foundation and adds ignored-user handling, reply and mention filtering, reaction filtering, and settingsHub integration.

See the plugin showcase for interactive demos and screenshots.

Install with venpm

venpm is a package manager for Vencord userplugins.

# Install venpm
npm install -g @kamaras/venpm

# Add this plugin repo
venpm repo add https://raw.githubusercontent.com/theokyr/vencord-plugins/main/plugins.json

# Install plugins
venpm install channelTabs
venpm install settingsHub hotkeyNav minimalCallBar

# Rebuild Vencord and restart Discord
venpm rebuild

See the venpm docs for full setup instructions.

DiscordMCP Proxy

The discordMcp plugin exposes a running Discord client to MCP-capable AI agents. It has two parts:

  • plugins/discordMcp/ — Vencord userplugin running inside Discord
  • proxy/ — Node.js MCP stdio server that listens for Discord on 127.0.0.1:21420

Build the proxy before adding it to an MCP client:

cd proxy
npm install
npm run build

MCP server command:

{
  "command": "node",
  "args": ["/path/to/vencord-plugins/proxy/dist/index.js"]
}

If tools report Discord is disconnected, start Discord, enable the discordMcp Vencord plugin, and confirm the proxy is running. Rebuilding plugins from an agent should use the DiscordMCP rebuild tool when available; it may refuse while you are in a voice call.

Manual Install

For users who already have Vencord set up with userplugins:

# Clone this repo somewhere convenient
git clone https://github.com/theokyr/vencord-plugins.git
cd vencord-plugins

# Symlink the plugins you want into your Vencord userplugins directory
ln -s "$(pwd)/plugins/_libAnimationKit" ~/path/to/Vencord/src/userplugins/_libAnimationKit
ln -s "$(pwd)/plugins/_libKeybindRegistry" ~/path/to/Vencord/src/userplugins/_libKeybindRegistry
ln -s "$(pwd)/plugins/channelTabs" ~/path/to/Vencord/src/userplugins/channelTabs
ln -s "$(pwd)/plugins/settingsHub" ~/path/to/Vencord/src/userplugins/settingsHub

# Rebuild Vencord
cd ~/path/to/Vencord && pnpm build

Replace ~/path/to/Vencord with your actual Vencord source path. _lib* directories are shared build-time modules required by several plugins; venpm installs them transitively, but manual installs must symlink them explicitly when needed.

New to Vencord userplugins?

  1. Clone Vencord: git clone https://github.com/Vendicated/Vencord.git
  2. Install dependencies: cd Vencord && pnpm install
  3. Inject into Discord: pnpm inject (follow the prompts)
  4. Create the userplugins directory: mkdir -p src/userplugins
  5. Then follow the manual install steps above to symlink plugins
  6. Build: pnpm build
  7. Restart Discord

For Developers

plugins/
  channelTabs/       # Each folder is one plugin
    index.tsx        # Plugin entry point (definePlugin)
    style.css        # Optional styles
  _libAnimationKit/  # Shared animation presets (build-time dependency)
  _libKeybindRegistry/ # Shared keybind registry (build-time dependency)
proxy/               # MCP proxy server for discordMcp
tests/               # Vitest test suite (186 tests)
plugins.json         # venpm plugin index

Full documentation: venpm.dev

Disclaimer

These plugins are not affiliated with, endorsed by, or sponsored by Discord Inc. or the Vencord project. "Discord" is a trademark of Discord Inc., mentioned solely for descriptive purposes.

Client modifications — including Vencord and any userplugins — are against Discord's Terms of Service. While no widespread bans for client mod usage are known, Discord may take action against accounts at any time. You use client modifications entirely at your own risk.

These plugins are provided "as is", without warranty of any kind. The author is not responsible for any damage to your Discord account, computer, or data.

License

GPL-3.0-or-later, as indicated by the plugin source SPDX headers.

Releases

Packages

Contributors

Languages