unofficial pluralkit commands list

this includes: official documentation, lesser known commands, modifiers and shortform

pluralkit links/resources


shortforms

includes most shortforms in commands

  • pk;system -> pk;s
  • pk;member -> pk;m
  • pk;group -> pk;g
  • description is desc
  • avatar is PFP
  • new is N
  • displayname is DN
  • servername is SN
  • pronouns is PRNS
  • timezone is TZ
  • serveravatar is SA
  • config is CFG

flags

add these on to the end of a message to change the commands!

  • -pub: public. only useful if you've changed the members privacy settings
    example: pk;m member -pub (shows member without showing their metadata, if thats something you have private)
  • -raw or -r: raw. the raw data from a message, set in a block of code so it can be copied with used markdown
    example: pk;m member desc -r (returns with the full description so you can copy it with markdown to edit)
  • -all: shows a full list of items, regardless of privacy settings
  • -append and -prepend: for pk;edit - add some text to the beginning and/or end of a message, instead of replacing the entire content
    • -ns: allows you to do above message without adding a space between your edit and OG message
  • -clear or -c: allows you to clear information added into the bot!
    example: pk;m member pfp -c (removes the pfp)
    • -ce: used on an edit command allows you to clear your pesky embeds!
  • -with-displayname: used to show displaynames in lists
  • -full: returns with the full information of a list, group, etc. this includes full descriptions and member cards

system commands

commands that apply to the entire system when used!

  • pk;s <name>: shows information about a system. if simply ran as pk;s then it shows the users system
  • pk;s n: creates a new system! there's a limit of one per account
  • pk;s rename <new name>: renames your system!
  • pk;s sn <name>: sets a system name "nickname" for a server.
    ie. you're known as "pissheads" globally, but if you run that in a server you can be known as "shitheads" locally!
  • pk;s desc: creates a bio/description for your system! perfect for collective intros
  • pk;s pfp: adds an avatar thats displayed in the pk;s information, but also as a default avatar for every new member created
  • pk;s serveravatar: same as above, but per server (like the pk;s sn command)
  • pk;s banner: adds an image below the description
  • pk;s color: adds a color to the side of the pk;s information, as well as a base color added to all new members created
  • pk;s tag: allows you to add a phrase/symbol/etc at the end of every members name to differentiate one system from another
  • pk;s prns: changes the systems collective pronouns
  • pk;s delete: deletes the entire system
  • pk;l: shows a list of all the public members of a system
    pk;l -full shows every member along with their set description
  • pk;find WORD: searches member by name
    you can also use pk;l WORD to do the same thing
  • pk;random (pk;r): shows a random member profile
  • pk;s ID: gives you a systems ID
    switching and fronting commands
  • pk;s fronter: Shows the current fronter of a system.
  • pk;s fronthistory: Shows the last 10 fronters of a system.
  • pk;s frontpercent: Shows the aggregated front history of a system within a given time frame.
  • pk;s switch <member>/out: allows you to log whos fronting in the bot

member commands

  • pk;m <member>: Shows information about a member.
  • pk;m new <name>: Creates a new system member.
  • pk;m <member> rename <new name>: Changes the name of a member.
  • pk;m <member> dn <new display name>: Changes the display name of a member.
  • pk;m <member> sn <new server name>: Changes the display name of a member, only in the current server.
  • pk;m <member> desc [description]: Changes the description of a member.
  • pk;m <member> pfp: Changes the avatar of a member.
  • pk;m <member> pa: Changes the avatar used for proxied messages sent by a member. Allows for a secondary PFP, essentially. Usually used for cropping
  • pk;m <member> serveravatar: Changes the avatar of a member in a specific server.
  • pk;m <name> banner: Changes the banner image of a member.
  • pk;m <member> proxy [tags]: Changes the proxy tags of a member. use below add/remove commands for members with multiple tag pairs.
    use like: pk;m <member> proxy text -membername- text part is required
  • pk;m <member> proxy add [tags]: Adds a proxy tag pair to a member.
  • pk;m <member> proxy remove [tags]: Removes a proxy tag from a member.
  • pk;m <member> ap [on|off]: Sets whether a member will be autoproxied when autoproxy is set to latch or front mode.
  • pk;m <member> kp [on|off]: Sets whether to include a member's proxy tags in the proxied message.
  • pk;m <member> skp [on|off]: Sets whether to include a member's proxy tags in the proxied message per server.
  • pk;m <member> prns [pronouns]: Changes the pronouns of a member.
  • pk;m <member> color [color]: Changes the color of a member.
  • pk;m <member> bday [birthdate|today]: Changes the birthday of a member.
  • pk;m <member> delete: Deletes a member.
  • pk;m <member> id: Prints a member's id
  • pk;m <member> tts: Turns on TTS per member if allowed in the server.

group commands

  • pk;g <group>: Shows information about a group.
  • pk;g n <name>: Creates a new group.
  • pk;g l: Lists all groups in your system.
  • pk;g <group> list: Lists all members in a group.
  • pk;g <group> random: Shows the info card of a randomly selected member in a group.
  • pk;g <group> rename <new name>: Renames a group.
  • pk;g <group> dn [display name]: Shows or changes a group's display name.
  • pk;g <group> desc [description]: Shows or changes a group's description.
  • pk;g <group> add <member> [member 2] [member 3...]: Adds one or more members to a group.
  • pk;g <group> remove <member> [member 2] [member 3...]: Removes one or more members from a group.
  • pk;g <group> pfp: Shows or changes a group's icon.
  • pk;g <group> color [color]: Shows or changes a group's color.
  • pk;g <group> random: Shows a random member from a group.
  • pk;g <group> banner [image url|upload]: Shows or changes a group's banner image.
  • pk;g <group> delete: Deletes a group.
  • pk;g <group> id: Prints a group's id

proxy commands

  • pk;rp <member>: when replied to a message, takes whatever message sent and resends it under the member you've specified
  • pk;e <message>: used to edit whatever proxied message you're replying to
  • pk;ap off: Disables autoproxying for your system in the current server.
  • pk;ap front: Sets your system's autoproxy in this server to proxy the first member currently registered as front.
  • pk;ap l: Sets your system's autoproxy in this server to proxy the last manually proxied member.
  • pk;ap <member>: Sets your system's autoproxy in this server to proxy a specific member

config commands

  • pk;cfg timezone <location>: Changes the time zone of your system.
  • pk;cfg ping <enable|disable>: Changes your system's ping preferences, and if you will be pinged if someone reacts to a message with a bell.
  • pk;cfg ap timeout [<duration>|off|reset]: Sets the latch timeout duration for your system.
  • pk;config ap account [on|off]: Toggles autoproxy globally for the current account.
  • pk;cfg proxy case [on|off]: Toggles case sensitive proxy tags for your system.
  • pk;cfg show private [on|off]: Toggles whether private information is shown to linked accounts by default
  • pk;import: imports system information
  • pk;export: exports system information
  • pk;token: gives you your token (which allows anyone who has it to edit system info)
  • pk;link @member: links your pluralkit system with another account (as long as they dont have a preexisting system), allowing them to use, edit and manage your members/proxies
  • pk;unlink @member: undoes the above command
  • pk;cfg proxy error off: turns off the "pluralkit cant proxy this message" error

privacy

  • pk;s privacy: allows you to change privacy settings globally
  • pk;cfg private group [on|off]: Toggles whether group privacy is automatically set to private for new groups.
  • pk;cfg private member [on|off]: Toggles whether member privacy is automatically set to private for new members.
  • pk;s privacy [name|icon|description|list|front|fronthistory|groups|all] [private|public]: Changes/Displays privacy settings.
  • pk;g <group> privacy [name|icon|description|members|metadata|visibility|all]: Changes/Displays a group's privacy settings.
  • pk;m <member> privacy [name|icon|proxy|birthday|pronouns|description|metadata|visibility|all] [private|public]: Changes/Displays a members current privacy settings.
Edit Report
Pub: 31 Jul 2023 01:35 UTC
Edit: 12 Oct 2023 22:14 UTC
Views: 1690