estroBiologist / pluralchum

PluralKit integration for BetterDiscord
MIT License
42 stars 12 forks source link


(PluralKit integration for BetterDiscord)



Hey! Is your head FULL OF PEOPLE? Are you an avid PLURALKIT USER?
Does seeing plain white usernames, broken profile popups and BOT tags all day make you want to BREAK THINGS?

Then PLURALCHUM is the plugin for you!


- [ Download - Changelog - Twitter ] -

(requires Zere's Plugin Library)





PluralKit is great. It helps untold numbers of systems communicate over Discord, providing them with robust tools for self-expression.
It's an invaluable resource for plural folk on the internet.

But as you may have noticed... It looks a bit crap, right?



These limitations aren't PK's fault. The bot uses webhooks to create proxy messages, which Discord just doesn't give features like custom name colours to. Nothing to do about it, unfortunately.

Except, of course, if you could mod the client. Enter Pluralchum.



Pluralchum is a plugin for BetterDiscord that utilizes PluralKit's web API to provide better integration for proxied messages.
It brings features like coloured member names and system tags, optional text colouring, a special PK badge for proxied messages, and much* more!

*not actually that much right now but i'm working on it okay





Yeah, it's not perfect. I tried my best, but I am categorically not a web developer. I'm always looking to make it better, and some of these will likely be fixed in due time, but, y'know, be aware of them.


- Major limitations -


1. Member colours aren't updated when changed.
PC has no way of knowing when a member's colour changes. It only gets that information when it asks for an update from PK in the first place!

As a workaround, you can click the PK badge next to a user to request a member info update manually.


2. Member names aren't clickable.
This one was more of a deliberate choice, as to not bite off more than I could chew. At some point, I'd love to give member names and avatars special PK profile popouts when clicked. That's The Big One, baby.


Beyond that, there are likely to be loads of bugs and small issues I haven't spotted. Please don't hesitate to submit an issue if something's wrong, and any contributions are greatly appreciated! (I apologize for my code.)





"This is great!"
- The Entire Cast of Homestuck Several Times Over


"This is gr8!"
- Oh, You Know


"this shitty plugin's crashed my discord like 5 times"
- Satisfied Customer


"I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT I HATE JAVASCRIPT"
- Unsatisfied Programmer


"this is just like chordioid"
- Unsubtle Plug


"I've embedded a virus in this code that will cause your computer to explode in thirty seconds. Run."
-Dirk Strider




disclaimer: i made all of these quotes up because i thought it would be mildly funny

except dirk's that one is real



- by ash taylor -