PK[qProx]

Created by SPEARHEADRAMPANCY.sys (ToraNine09#8501)

Version 0.1 - 01/06/2024

Return to site home page


Page Themes & Accessibility

NOTE: Page themes do not persist between pages or sessions.


[V0.2] * modify
===========================
[V0.1] + Tool framework completed


Frequently Asked Questions

Hide FAQ

What is this tool for?

PK[qProx] is short for PluralKit[Quick Proxy].

This tool allows you to quickly set member proxy tags depending on their name, display name, or ID.

You must already have created the member(s) in PluralKit in order to use this tool. This tool does not create new members.


How do I use this tool?

First, enter your 64 alphanumeric character PluralKit API Token, and 5 or 6 letter PluralKit System ID (Allowed formats are abcde, abcdef, abc-def with or without capital letters) in the boxes below. You can get your system's API token by running the command pk;token in the PluralKit bot. When copying the token, make sure that you have exactly 64 alphanumeric (letters and numbers only) characters copied, with no spaces before or after. Some devices may add a space around the text and the tool will not work if these are included in the box below.

Once you've entered those details, you can enter the template for the proxy tag you wish to add. You can find example templates below.

Return to top

How do I tell the tool to use the name/display name/ID?

The tool recognises "aliases" in the format of ${alias_name}. When you run the tool, it looks for aliases in the template field and will replace it with the correct information.

For the below examples, lets pretend that we have a member with a base name of "Alice", a display name of "Alice 🌸✨" and an id of "gaznz".

The standard aliases are:

  • ${base_name}
  • ${display_name}
  • ${id}
But you can also use:
  • ${dn_emoji} to use emojis found in the display name
  • ${api_index} to use the index number of the member from the API. This almost guarantees you won't have a duplicate proxy tag, but it can change if you run this tool again after making other changes to your members.
  • ${first_of...} to use the first character found in some other alias:
    • ${first_of_base_name} such as "A" from "Alice"
    • ${first_of_display_name} such as "A" from "Alice 🌸✨"
    • ${first_of_id} such as "g" from "gaznz"
    • ${first_of_dn_emoji} such as "🌸" from "Alice 🌸✨"
  • ${last_of...} to use the last character found in some other alias:
    • ${last_of_base_name} such as "e" from "Alice"
    • ${last_of_display_name} such as "✨" from "Alice 🌸✨"
    • ${last_of_id} such as "z" from "gaznz"
    • ${last_of_dn_emoji} such as "✨" from "Alice 🌸✨"

Return to top

What if I want to set the proxy tags to use the "${}" format as part of the actual proxy?

Some people may want to use ${} as part of their proxy on purpose, for example to have a proxy tag of ${Alice} text. The tool can do this, but you have to use the escape character \ in your template.

If you want your proxy tags to use ${} itself as part of the proxy, use $\{} in the template instead (for example: $\{${base_name}} text to get ${Alice} text). The tool will recognise this and change it to ${} when setting the proxy tag.

This is kind of a power user feature. If you don't understand, don't worry.

Return to top

What are some examples?

Like the other examples, lets pretend that we have a member with a base name of "Alice", a display name of "Alice 🌸✨", and an id of "gaznz".

Some example templates are:

  • ${base_name}: text results in tags like "Alice: text"
  • text -${display_name} results in tags like "text -Alice 🌸✨"
  • text -${dn_emoji} results in tags like "text -🌸✨"
  • text (${id}) results in tags like "text (gaznz)"

Return to top

PK[qProx]


This process may take some time - each member can take one to two seconds to process. The status header below will update as it progresses, and the box underneath the status header will provide you with detailed information including error messages. Once complete, you will receieve the final list in the "Results" box.

IMPORTANT: This tool does not make any changes to information stored in PluralKit.

Confirmation:


Status: Not running.

While the tool is running, you will receive progress updates here.


Show system images Hide system images Show member images Hide member images Show group images Hide group images
Filter by status:
Show images that succeed Hide images that succeed Show images that may or may not load Hide images that may or may not load Show images that fail Hide images that fail
Filter by reason:
Show unset images Hide unset images Show Discord CDN Hide Discord CDN Show PluralKit CDN Hide PluralKit CDN
Show known bad hosts Hide known bad hosts Show indirect links Hide indirect links Show other hosts Hide other hosts
Filter by image type:
Include avatars Exclude avatars Include proxy avatars Exclude proxy avatars Include banners Exclude banners Include group icons Exclude group icons

When the tool has finished running, you will receive the final list of results here.