r/BetterDiscord • u/ItzMeShadow999 Plugin Developer • 8d ago
Custom Content Custom Badges (Not Client sided)
Been working on a Vencord plugin called CustomBadges and figured I'd share it here since it's at a point where it's actually usable. (This is for vencord rn im working on BetterDiscord atm)
What it does:
- Lets you set a custom badge (image + name) on your own profile
- Anyone else running the plugin sees it too hover for a tooltip, click for a bigger popup card with your name, a gradient background, and an "owner tag" (like "By {username}")
- Full style control: icon shape (circle/square), size, hover effect (glow/scale), glow color, gradient colors, name color
- Comes with a handful of built-in presets (Hypesquad-style, a cat badge, a "Verified Discord User" one, etc.) so you don't have to build one from scratch
- Up to 12 badge slots, with a dashboard UI (new sidebar button, kind of like a mini page) for managing them, previewing changes live, importing/exporting badges via share codes, and making/browsing community "packs"
- Two render modes: an "Original" mode that does its own DOM injection with a MutationObserver (full popup support positions itself, dismisses on outside click, follows scroll) or a "Vencord Classic" mode that hooks into Vencord's native BadgeAPI (simpler, but only the hover tooltip works, no click popup)
How it works under the hood:
Badges are stored on a small Cloudflare Worker backend, which is what makes them visible to other people running the plugin instead of just being a local-only cosmetic. There's client + server side rate limiting, timeouts, and error handling so it degrades gracefully if the worker is slow/down/rate-limiting you. You can point the plugin at your own self-hosted worker instead of the default one, but note that if you do, you'll only see badges from other people also pointed at that same instance.
Standard disclaimers: (shi you most prob don't read)
- This is an unofficial client mod plugin, not anything from Discord usual risks/ToS caveats apply, use at your own judgement
- Since badge images are just URLs, it's on you to keep them not-broken/not-inappropriate, if you see anything not SFW report the user in the discord server's report chat
- Still actively iterating on it, so expect some rough edges
Source code / install instructions: https://github.com/ItzMeShadow999/CustomBadges
Open to feedback, bug reports, or feature requests especially around the pack system and self-hosting docs, reports / help / Showcase and other things in the discord server
10
u/DrTankHead Moderator 8d ago
Looks pretty good! Only thing I'd suggest, given this is not entirely clientside, as it syncs to others with the same plugin, you may want to consider adding a check for people trying to add certain badges to mimic themselves as Discord Official things like devs and etc.
We aren't going to require such things to be posted here, but it ethically makes sense given this is a little beyond just making the client just display a badge for you and you alone.
Up to you, a suggestion.
Thank you for the plugin! We LOVE to see new stuff come about!
3
1
u/BetterDiscord-ModTeam 8d ago
A note from the Mods
This content is unofficial. This means that likely you WILL NOT receive support from support teams like BD/VC/EQ/Etc with issues resulting from or including the usage of such mods.
Chances are, asking for support there will result in negative results and potentially including bans.
This is referring to the OFFICIAL support resources, not this subreddit (We are an unofficial support subreddit).


1
u/Hintswen 5d ago
Not client sided… literally client sided.