world of warcraft
Categories > Roleplay > [rp:tags]
made by oraibi
rpTags lets you create custom unit frames using information drawn from roleplaying addons, such as MyRolePlay or Total RP 3.

To use rpTags, you need one of each of these:
  • A roleplaying addon -- currently MyRolePlay and Total RP 3 are supported
  • A unit frames addon -- currently ElvUI and rpUnitFrames are supported.
rpUnitFrames is included with rpTags, so even if you use the stock Blizzard unit frames, you can still use rpTags.

What's an rp:tag?

A tag is a string of text that tells the unit frame addon what you'd like to display. All of the tags in rpTags are prefaced by rp: and look like this:

Code: Select all

You can string tags together to add them to your unit frames. For example:

Code: Select all

[rp:color][rp:name][nocolor]: [rp:race] [rp;class] [rp:icon] [rp:statuscolor][rp:curr][nocolor]
If you added this to the target unit frame (in rpUnitFrames or in ElvUI), you'd see the following when you targeted someone:
  • First, their roleplaying name, in whatever their chosen color is -- set in their own RP profile in MyRolePlay, Total RP 3, or XRP. If they don't have a color, their name will be in the default text color. If they don't have an RP name, then their character name will be shown.
  • Then, their roleplaying race and their roleplaying class. If they don't have either, the default will be shown -- the actual game race and game class.
  • That's followed by their RP profile icon.
  • Finally, in either green (for in-character) or red (for out-of-character), their "currently" field from their profile will be shown.
How Do I Use rpTags?

You should be able to make it work just by installing it. It will unpack into 6 different addons, which are modular interfaces between rpTags and other addons:
  • RP_Tags, the core addon
  • RP_Tags_MyRolePlay, an rpClient module interfacing with MyRolePlay
  • RP_Tags_totalRP3, an rpClient module interfacing with Total RP 3
  • RP_Tags_ElvUI, a unitFrames module interfacing with ElvUI
  • RP_UnitFrames, a unitFrames addon with its own built-in interface module
  • RP_Tags_Listener, a dataSource module interfacing with Listener
Each module has a dependency the addon with which it interfaces; so if you don't have MyRolePlay installed, for example, RP_Tags_MyRolePlay will automatically disable itself.

You can, of course, toggle each module on and off from WoW's addon menu, either before you enter the game or from within the game itself.

rpUnitFrames will load by default, but you can disable each frame individually or all in one fell swoop from the options.

Configuring rpTags

You can configure rpTags (and rpUnitFrames) by going to the Interface menu in WoW, or by typing /rptags in the chat window to open the configuration menu.

What other cool things can I do?

If you're using ElvUI, you can also include rp:tags in your Name Plates. Go to "Name Plates" in ElvUI and set various tags. For example, you can set it to show you someone's RP name and title without you having to mouse-over or target them.

If you're using rpUnitFrames and ElvUI, you can set up two sets of unit frames -- the normal ones you that you use when you're out out in the world questing or whatever, and a set just for displaying roleplaying information. rpUnitFrames is made to complement ElvUI, not replace it.

You can zoom in and out on the 3D portraits, that's always fun.
  • Fixed bug preventing correct scanning for the player's nickname in RP_Tags_Listener
  • Fixed bug in RP_Tags_Listener and minor bug in RP_Tags_MyRolePlay

  • Primarily bug fixes
  • Color modifiers
  • Updated layouts for RP_UnitFrames
  • First release for WoW 9
  • rpUnitFrames should be working
  • rpTags now supports Listener as well
  • The addon is modularized; if you don't want to load a module, you can disable it -- or even delete it
  • By default, rpTags will look for which other supported addons you have installed and enabled
  • Added [rp:me] tags, plus [rp:listen] tags
  • Help and configuration are all via the `/rptags` (or `/rpt`) command
  • Tag sizes now supported -- use [rp:tagname(medium)] or [rp:tagname(m)] on ElvUI and rpUnitFrames; use [rp:tagname(10)] on rpUnitFrames
v. beta 2

Updated for WoW 9.0.5.

v. alpha 1:

Changed numbering, fixed old bugs, updated for WoW 9.0.2, currently works with ElvUI but not alone with RP:UnitFrames.

This is an alpha version, so be careful out there!


Updated for WoW 8.2.
Fixed bug.


Fixed several bugs


Added keybindings for RPTAGS help, RPTAGS options.
Added keybinding for "Open Mouseover Profile" in both MRP and TRP3.
Fixed a bug preventing the importation of RPTAGS options previously saved in Total RP 3's config system.


Fixed some bugs since the previous verison;
Re-added the reference menu in Options
Something else that slips my mind.

v0.940 beta 10:

Bug fixes;
Added more granular control over hiding rp:UnitFrames;
Styling of rp:UnitFrames status bar.

v0.940 beta 8:

Bug fixes for MyRolePlay support; removed TargetTarget frame; added [rp:target] tags.

v0.940 beta 2:

Major changes. Now includes rp:UnitFrames for running alongside ElvUI or without running ElvUI at all. New config system. More tags. Tag editor. More!


Updated for 8.1, changed a little about how wrapping and field size for glances work.


Fixed a bug related to updating frames when in a party or raid.


Fixed a bug where [rp:color] was actually displaying [rp:eyecolor].
Added [rp:statusicon] tag.


Some bug fixes, plus added pronoun tags. See /rptags pronouns for details.


Fixed a bug from yesterday's update that was causing the game to freeze for part of a second while updating unit frames.


Text Wrapping!

Also a bonus in-game "user manual" for people with trp3 Extended.


Labels! For most tags, you can add a -label flag onto it.

That does the following:

1. It puts a label, like "Age: " in front of the tag value.
2. It puts a newline after the tag value.
3. If the unit doesn't have the field to display, it puts nothing.

So you can do [rp:age-label][rp:alignment-label][rp:eyes-label] and let's say the target doesn't have an alignment custom field set. You'll see:

Age: 30ish
Eyes: Violet

Better control over field display sizes!

Use the sliders to set how big you want your fields to be, in characters, from 5 to 60. Or you can give a limit of 0 which means no limits at all.

Icons! (I think I kind of buried the lede...)

You can use icons for the following:

[rp:icon] -- the default icon
[rp:gendericon] -- an icon based on the unit's gender, colored according to your gender color settings
[rp:glance-icons] -- a horizontal row of unit's at-first-glance icons
[rp:icon-glance-2] -- the unit's second at-first-glance icon

... speaking of which ...

At first glance!

You can do the following now:

[rp:glance-2] -- the title of the second at-first-glance
[rp:glance-2-text] -- the text of the second at-first-glance
[rp:glance-2-icon] -- the icon (an alias for [rp:icon-glance-2]) for the second at-first-glance
[rp:glance-2-full] -- the icon, the title, and the text


[rp:years] -- This will say like "30 years", depending on the unit's age field
[rp:years-old] -- "30 years old"
[rp:years-ago] -- "30 years ago"

If the unit's age is set to something like "30ish", you'll instead see

[rp:years-old] -- "about 30 years old"

New Demo UI!

There's a new demo UI. It's ugly but that's okay, you can make a better one. 

Get to it through TRP3 -> Settings -> [rp:tags] settings -> Demo (at the bottom)

Click the button, copy the text (it says it's a url link, but it's not, don't worry about it), and then go to

ElvUI Config -> Profiles -> Import -> and paste in the messy text. Boom! You get a new demo UI to play with.

We Need Our Giant Face Pictures UIs!

Speaking of ElvUI, go to ElvUI Config -> [rp:tags] and there's a single checkbox that will let you break the normal limits on ElvUI's unit frames, at least the player and target frames. This way you can have a giant face that takes up half your screen.



Added more config options for maximum tag sizes

Added parsing of age, gender, height, and weight
Added support for non-binary and neuter genders (when parsed)
Added tag [rp:years] -- like [rp:age] but gives the parsed value
Added config options for comparative colors
Added comparative color tags [rp:agecolor], [rp:heightcolor], and [rp:weightcolor], relative to the player's values (when parsed)

The latest version of this addon is and was uploaded on Jun 05, 2021 at 10:01.

This file was last downloaded on Nov 28, 2022 at 18:11 and has been downloaded 8376 times.


NydrisStarspear Sep 14, 2022 at 23:24

Is there any chance of making a version of this that will work in WOTLK Classic? That would be wonderful!
You must be logged in to comment. Please login.