Get an Epic Experience with Premium

X-Perl UnitFrames

Unit Frames Login to Add Favorites
  • World of Warcraft
  • 75,508 Monthly Downloads
  • Supports: 5.4.0
  • 21,567,325 Total Downloads
  • Updated 10/14/2013
  • Created 08/31/2008
  • 15,170 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File: 3.7.5
Support development! **

About X-Perl UnitFrames

Bug Reporting

Please use the Ticketing System on WoWAce Here and avoid posting bugs using comments on Curse because they're difficult to track and they will probably get lost.

Use a good error catcher (like BugSack from and provide the full error text, and give as much information as possible to recreate the problem. Don't assume We know what you're talking about with some three word report.


Perl, with Extra stuff. Much enchanced from Nymbia's Perl UnitFrames, and a complete replacement for Blizzard's default unit frames, including raid frames and raid tools, with little remaining of the original Nymbia code.

  • Range Finder (combined with optional health check and/or debuff check) for all frames based on spell or item range test.
  • HoT Monitor will highlight units clearly that have ''your own'' active Heal over Time spells. Regardless of how many other heal over time buffs are on the raid members, you can keep track of your own ones and when they expire.
  • Debuff Highlighting in standard debuff colours on all friendly frames. Priority given to show debuffs that ''you'' can cure first.
  • Raid Frames, buff icons, MT list units and some other portions or X-Perl are Created on demand. Saving a lot of time and memory at system startup. Defering the creation of many parts of X-Perl to when they are actually required. And of course, most often outside of raids they are never required and are never created.
  • Raid Target icon support for Target, Target's Target, MT Targets.
  • Raid Tooltip will show combat rezzers available (druids with Rebirth ready (or very soon available) and any normal rezzers out of combat) if you bring up tooltip of a dead person.
  • In-combat indicators for all units.
  • 3D Portraits for player, pet, target, focus, party. Optional. Of course this may degrade your framerate somewhat because you are displaying more 3D character models that without this option. But some like it pretty, and it does look cool.
  • Red and Green combat flashes for frames when player, pet, target, party, partypets, raid take damage/heals. Useful indication of things happening.
  • Added '''time left''' on party member/target buffs/debuffs when in a raid, these depend somewhat on CTRA sending appropriate information over the addon channel, although some of it can be determined at run time by X-Perl, when a player gets a buff for example, we know how long it should last, and therefor when it should expire.
  • Totally new options window including all X-Perl options and access via minimap icon and the /xperl splash command.
  • Configurable colours for borders and backgrounds. Including class coloured names, and configurable reaction colours.

Much care has been taken with code size, memory load, memory usage per cycle and so on. LuaProfiler/OnEvent mods used extensively and regularly to ensure that X-Perl does not do more work than is absolutely necessary.

Assists View

Will show anyone from raid assising you with your target, and can also show healers or all plus known enemies targetting you.

Tooltips for the same also available (on player and target frames) if you prefer to not use the main window.

MT Targets

Replaces CTRA MT Targets window, and doubles as a replacement for the Perl RaidFrames warrior targets.

Indicator shows which target you are on.

Frames will be coloured to show if tanks have duplicate targets.

Casting Monitor


Shows selected classes (defaults to healer classes) in a list (much like the MT List), but with some differences.

Shows mana bars and cast bars on left. Their targets on right. Health bar as normal, but a secondary small red bar on targets which shows the maximum single hit this unit has received since entering combat. The secondary bar will extend downwards from their current HP level down to as far as zero.

A green name on the targets indicates this is the same target that you have. You can click on casters or their targets as expected.

For druids, right clicking on a caster will cast Innervate on them.

For shamans, right clicking on a caster will cast Mana Tide Totem. Check the * indicator to see if they're in your group.

All bars can be re-sized in X-Perl main options (Monitor section).

Totals can be toggled (from the 'T' minibutton at top of frame) which gives overview of raid mana status.

Raid Admin


Save/Load raid roster setups Only does direct save and load for the moment, but more to come (templates and such).

Item Check

Replacement for /raitem /radur /raresist /rareg. Use the old commands before, or drop items in the left item list.

Query button will perform /raitem on all ticked items (query always includes dur and resists) and you can then view and review all the results whenever, without having to re-query each item.

Includes everyone in raid, so you don't have to work out who doesn't have items, it'll list them with 0 instead of no entry.

Active Scanner to check raid member's equipment for the item selected. So you can be sure that people actually have the item worn (Onyxia Cloak for example), without having to go round single target inspecting everyone who 'forgot' to install CTRA for the 50th raid in a row.

Grim Reaper

Removed from X-Perl, but continues as it's own standalone Ace mod.


More Buffing Features

Can be found in my new universal buffing mod, ZOMGBuffs


3.7.5 Release (r860/r859)
1.You can now disable pvp marks on the frames.
2.TTT Frame, FocusTarget and PetTarget Debuffs are now enabled and disabled correctly.
3.You can now enable Target's Target Debuffs independently from its Buffs.


First Previous Page 4 of 472 Next Last
  • #7883
    One Raid Frame

    Is there anyway to make it so you can move all the groups at once instead of one at a time? IUf not can we get it added? If not can you tell me where its located so I can change it myself?

    Last edited by kable13 on 12/31/2013 7:51:42 PM
  • #7882

    When I exit combat most of the time I receive the following error code. Has been going on for a few weeks now.

    Message: Interface\AddOns\XPerl_RaidFrames\XPerl_Raid.lua:594: attempt to index local 'self' (a number value)
    Time: 12/31/13 15:01:17
    Count: 6
    Stack: Interface\AddOns\XPerl_RaidFrames\XPerl_Raid.lua:594: in function <Interface\AddOns\XPerl_RaidFrames\XPerl_Raid.lua:582>
    Interface\AddOns\XPerl_RaidFrames\XPerl_Raid.lua:1235: in function `func'
    Interface\AddOns\XPerl_RaidFrames\XPerl_Raid.lua:1183: in function <Interface\AddOns\XPerl_RaidFrames\XPerl_Raid.lua:1170>

    Locals: self = 2
    (*temporary) = nil
    (*temporary) = nil
    (*temporary) = nil
    (*temporary) = nil
    (*temporary) = nil
    (*temporary) = nil
    (*temporary) = nil
    (*temporary) = "attempt to index local 'self' (a number value)"

  • #7885

    a quick-and-dirty-fix is to change row 588 in XPerl_Raid.lua


    if(not self or self == 1) then


    if(not self or self == 1 or self == 2) then


  • #7881

    I don't think it is necessarily a bug, rather than I have missed an option to tick, that's why I post it here...

    first time i started XPerl in options/arrangement mode, the 10/11 raid groups had a black background, so that i had a preview for arranging them

    since then, the black background for the raid groups in options-mode is gone (the black background for the group window persists)

    the groups' names are still displayed, but I have no chance to arrange them outside of a ride, because the preview-black-background is gone

    how can i re-activate the black background for the raid groups in options-mode?

    edit: deleting the savedvariables for xperl and clearing the wow cache folder solved the problem for me...just had to configure xperl again

    Last edited by Plini_us on 1/1/2014 1:08:45 PM
  • #7871
    Bad Framerate on Cast Bars?


    First off, thanks for all your work that has gone into Xperl over the years.  I have used it since, well, as long as I can remember, on every toon I make.  =)

    To put it simply, I am suffering from poor framerates in my cast bars.  The bars fill up in visible chunks rather than filling up smoothly, pixel line by pixel line, as they used to.

    On very slow casts, i.e. 3-10 seconds or more, the problem is not extremely noticable, though it is still visible.  On casts quicker than that, however, the "fill" framerate is very low.  This is even more frustrating because the "spark" is moving as smooth as ever.  It is only the "fill" of the bar, that appears in large chunks, bit by bit.

    I must also mention that my computer stays pegged at a rock-solid 60fps during 100% of my gameplay time.  I have my performance indicator situated directly above my unit frame, so it is easy to see that my overall framerate is not dipping when I see the cast bar fill problem.

    I've tried disabling all addons other than Xperl, and the problem still persists.  The problem also persists on both factions, any race and any class.

    Any suggestions on a fix I can attempt to remedy this?

  • #7872

    I've never heard of that before. It could be a problem with a particular video setting or with your video card.

  • #7884

    I wanted to note that the problem I was having spontaneously fixed itself.  My cast bars are back to super smooth animation, and the problem was obviously on my end.

    Apologies for cluttering up your comments section; I should have used the ticket system in the first place.  You could delete this whole thread if you want =)

    Thanks again,


  • #7880

    Thanks very much for your help.  I'm 100% sure the problem is on my end, I just figured I would ask in case the fix was an easy one.

    Since it's just the cast bar that is bugging me, I'll probably either just get used to it, or disable the Xperl castbar and use another addon for that.

    Thanks again =)


  • #7879


    Quote from matt0717 »

    Thanks for the reply.

    My player frame is scaled to 80%.  I've tried at the minimum and maximum scale, and the problem persists.  I have a bit of extra width set, but I have tried at minimum and maximum width, and the problem persists.

    I have no options selected on cast bars, other than having them enabled.  Note that a good way to reproduce and get a visual on the problem is to "Enable old cast bar".  If I do that, I have a good view of the Xperl cast bar and the old cast bar at the same time.  The old cast bar fills super smooth, and the xperl cast bar fills in blocks.

    I'm running a Windows machine, with Windows 7 SP1.  My graphics card is an Nvidia 560 TI.

    Since I already not using X-Perl's casting bar at all(the out-dated eCasting bar addon still working with some manual code fixes at Patch 5.x so I still stuck at that fancy one), so I didn't notices anything go wrong about X-Perl's casting bar...

    The casting bar functions seems going weird when I tested it right now, like the those sub options do not take effect unless I disable the casting bar function then re-enable it again, the Pre-cast Indicator function looks like do/show nothing at all but I only has 6~20ms of latency so maybe it just not for my situation...and sometimes I interrupted my casting spells by manual but X-Perl's casting bar still showed the completed green one instead the interrupted red one...and it may stuck at that unless I re-enable that casting bar functions again...

    The uninterrupted spells indicator seems working fine at player frame(showed shields near the spell name of both sides) but not tested about target frame or other ones has casting bar functions...

    But sadly, matt0717's problem I cannot reproduced at all, except I get some "really short" delay of "filling casting bar" when I set my maxfps to 60 or 56 but it's not noticeable...not even I set it as the max of 200fps. Enable Vsync and triple-buffers do not changed too much, my fps is 75fps, the filling animations still going to fine as hell.

    Tried a lot of options but no shit, it just working fine (except some minor glitches I said above) as DooMed hell...sorry! :p

  • #7878

    Thanks for the reply.

    My player frame is scaled to 80%.  I've tried at the minimum and maximum scale, and the problem persists.  I have a bit of extra width set, but I have tried at minimum and maximum width, and the problem persists.

    I have no options selected on cast bars, other than having them enabled.  Note that a good way to reproduce and get a visual on the problem is to "Enable old cast bar".  If I do that, I have a good view of the Xperl cast bar and the old cast bar at the same time.  The old cast bar fills super smooth, and the xperl cast bar fills in blocks.

    I'm running a Windows machine, with Windows 7 SP1.  My graphics card is an Nvidia 560 TI.

  • #7877

    Can you also tell me if you have very small frames (if you scaled them a lot) and which options you have activated regarding the casting bar?

  • #7875

    I completely understand you and your problem but I can't do anything to help you because nobody ever reproduced this problem. The only thing I can do is to have a look at the code that controls the cast bar to see if there's something strange happening there.

    Could you also tell me if you use Mac/Win and which graphic card you have?
    Sometimes ATI cards have trouble rendering strange things, so everything may be running smootly apart from that bar (maybe because the code that renders it is somewhat strange). 

  • #7874

    Thanks for the reply.  I'd be willing to entertain that as a solution to the problem if the cast bars weren't the only thing on my screen with the poor framerate problem.  My overall WoW is running at a solid 60fps (three times that if I disable Vsync), none of my other addons that have any animation whatsoever are suffering from low framerates, and most important of all, the "spark" on the cast bar is chugging along just as smooth as ever.  It's only the fill that looks terrible.

    The nail in the coffin for Xperl is the fact that if I enable the old "classic" standard WoW cast bar, the fill rate on that bar is super smooth too.  No "chunk fills".

    This is a shame because as petty of a thing as this would appear to be, over the years and countless thousands of hours of gameplay, I've learned to time my casts to the progress of that bar.  It's second nature to me where my GCD falls and when I can fire off another cast, based on the position of that bar.  And I time this viewing the bar only out of the corner of my eye.  But now the bar is useless, as the "spark" is usually ahead of the "fill", which is dropping in chunk by  chunk.  Often whatever spell I am casting actually fires off befor the last "chunk" even falls into place.

    I would screenshot this activity, but I don't see the point, as it's going to be impossible to demonstrate the framerate problem with a series of still images.  As for recording a video of the problem, I suppose I could do that, if absolutely necessary.  However, I only have software-based recording apps (Fraps) and as good as my system is, it simply will not record 1920x1080 @ 60fps.

  • #7870

    Does anyone know that how on earth I can remove the portrait text from my target i.e. hit indicator without actually using Xperl?

  • #7869

    Awesome addon! One problem for me. When I join a raid we're all sorted into Tanks, Healers, Damage dealers in that order, no matter which groups we're actually in. This was super practical. As a tank I loved it, as a damage dealer I didn't mind it, and as a healer I thought it practical.

    And then we split the raid and I was healing even groups. Only, X-Perl mashed all the groups together so I had no clue who's in the even groups.

    I'm sure there's a button somewhere to deactivate that, but for the life of me I can't find that damn button. Please tell me where to look.

  • To post a comment, please login or register a new account.
Login to Curse

Don't have an account? Create One.

Get an epic experience with Curse Premium
  • Faster addon downloads
  • Premium-Only Beta Giveaways
  • Ad-Free Curse experience
  • Premium Curse Client
  • and many More Features
  • Learn More »

Leaguepedia PAX Skin Giveaway