(PluralKit integration for BetterDiscord)
- by ash taylor -
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 as of v1.0 -
1. Initial data gathering.
Due to the way the plugin requests data from the API, the first time a member's proxy is displayed, it won't be patched by Pluralchum. Once that member's data is received (usually within a few seconds), subsequent messages will work just fine, and updating existing messages (by hovering over them, for example) will let PC patch them too. This becomes less and less of a problem over time, as the bot builds up a cache of member data, leading to an almost seamless experience. Except, however...
2. Displayname/avatar changes.
The plugin identifies members by hashing the two, so changing them will lead to the bot having to re-identify the member in question. This usually just leads to a single message not being patched.
3. 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.
4. Member names aren't clickable.
This one was more of a deliberate choice, as to not bite off more than I could chew for 1.0. 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 -