What is Gladius?
Gladius adds enemy unit frames to arenas for easier targeting and focusing. It is highly configurable and you can disable most features of this addon.
Features
- Uses the 3.0 Arena Unit IDs, this enables full functionality even if the enemy is seen first while in combat.
- General arena unit frame features:
- HP bar + Text
- Mana bar + Text
- Cast bar + Text
- Class icon
- PvP trinket status:
- Five display options:
- Name icon.
- Name text.
- Big icon (big, scalable icon to the right).
- Small icon (small icon to the right on top of the mana bar).
- Grid-style icon (colored square to the right on top of the mana bar that turns red when the trinket has been used).
- Target of Target - displays a class icon representing the enemy's target.
- Announcements
- New enemy announcement - announces new enemies.
- Trinket announcement - announces when the trinket is used/is ready again.
- Drinking announecment.
- Enemies on low health - announces enemies that are about to die, you can set the percentage yourself.
- Auras - shows important buffs and debuffs on the arena enemies.
- You can add/delete/edit auras via the configuration screen.
- Click actions - you can select what is going to happen when you click on a Gladius button.
- Ten editable click actions.
- Three modifiers: SHIFT, CTRL and ALT.
- Four different action types: Target, Focus, Cast Spell and Macro.
How to use
Slash commands
- /gladius ui/config/options - displays the configuration screen.
- /gladius test1-5 - shows a test frame with the chosen amount of test units.
- /gladius hide - hides the test frame.
- /gladius trinket - simulates a trinket being used for the first arena target.
Macros
Macros are meant for the more advanced users, since you'd need to use "*unit" (short for the UnitID of the enemy) for a macro to work. To cast Polymorph on the enemy and print out the name of the enemy in the party chat you would have to do:
/cast [target=*unit] Polymorph
/script SendChatMessage(UnitName("*unit"), "PARTY")
FAQ
Will you ever have Gladius function in a non-arena environment?
No, Gladius is meant for arenas only and it'll stay that way.
Yes, simply lock the Gladius frame.
Suggestions and Bugs
For suggestions and bugs, post a ticket here: http://wow.curseforge.com/projects/gladius/create-ticket/.
Translations
Curse has setup a very good and easy to use translation system, see: http://wow.curseforge.com/projects/gladius/localization/.
If you'd like to become a permanent translator, send an e-mail to gladius@proditor.net.
Thanks to
- sillyboy6 - zhCN and zhTW translations
- bluenyx - koKR translations
- Shadowed (SSArenaFrames) - snippets of code, inspiration and lots of help
- Proximo - inspiration
r28 | Proditor-125533 | 2009-05-27 23:46:52 +0200 (on, 27 maj 2009) | 1 line
- Fixed a bug which would cause Gladius to not work properly when Clique support was enabled.
r27 | Proditor-125533 | 2009-05-24 01:25:41 +0200 (sö, 24 maj 2009) | 1 line
- Fixed an error when a pet dies.
r26 | Proditor-125533 | 2009-05-23 04:40:16 +0200 (lö, 23 maj 2009) | 3 lines
- Added pet bars (optional and customizable). Automatically resizes the frame to fit the amount of pet classes in the current match if out of combat when units are discovered. Currently priest, warlock, death knight, hunter and mage are classified as pet classes (configuration for this is coming in a future rev).
- Few extremely minor optimization changes (no longer using a function to get class color, no longer creating a new function each trinket, using a table with stored GUIDs instead of looping).
- Updated all localization files and added deDE and frFR localizations.
r25 | Proditor-125533 | 2009-05-10 05:00:35 +0200 (sö, 10 maj 2009) | 4 lines
- Revamped the aura system, it's now solely using the UNIT_AURA event and should be 99.9% reliable.
- Changed the combat log event the trinket detection is using in hope of it becoming slightly more reliable.
- Fixed so it won't announce drinking more than once every 3 seconds.
- Fixed so it won't announce unknown names when it first finds a unit.
r24 | Proditor-125533 | 2009-04-18 03:56:47 +0200 (lö, 18 apr 2009) | 4 lines
- TOC updated to 30100
- Now uses the ARENA_OPPONENT_UPDATE and UNIT_NAME_UPDATE events to detect enemies.
- Added a an optional focus border which looks exactly like the target border but in a different (customizable) color.
- Fixed a bug that'd cause the drinking announcement would only work on US and EU clients.
r23 | Proditor-125533 | 2009-03-19 11:31:51 +0100 (to, 19 mar 2009) | 1 line
- Fix for the click actions, left button was not working as it should with modifiers. You may have to redo the click actions involving the left button.
r22 | Proditor-125533 | 2009-03-19 10:52:28 +0100 (to, 19 mar 2009) | 1 line
- Fix for the Russian localization, used the wrong encoding of localization.ruRU.lua which caused the letters to turn into question marks.
r21 | Proditor-125533 | 2009-03-17 15:02:28 +0100 (ti, 17 mar 2009) | 3 lines
- Fixed a bug which would cause Gladius to malfunction if you had auras turned off before r20.
- Fixed so it doesn't register UNIT_AURA and COMBAT_LOG_EVENT too early, it led to error messages.
- Added ruRU localization (thank you Hemathio and StingerSoft).
r20 | Proditor-125533 | 2009-03-13 15:11:33 +0100 (fr, 13 mar 2009) | 8 lines
- Revamped the click action options completely, there are now 10 different actions that you can setup as you wish. You can select a mouse button, a modifier key and an action. There are four available actions: Target, Focus, Spell and Macro. Thank you Shadowed for supplying me with bits of code to help me do this easier.
- Macro support is added as stated above, tho they are ment for more advanced users since you need to use "*unit" (short for the UnitID of the enemy) for anything to work.
- Auras are now editable in the options, so you no longer have to worry about the auralist.lua, should be pretty straight forward to use.
- Added options for the health text (same as for the power text).
- Added a new option for the health and power text called "Shorten Health/Power text" - when toggled on it formats health/power text to e.g. "22.5k/25.0k" when the value is above 9999.
- Fixed a bug that caused the new enemy announcement to only function the first arena match.
- Fixed so the Wyvern Sting DoT won't show up anymore.
- Fixed a lot of taint errors that would occur frequently.
r19 | Proditor-125533 | 2009-02-10 06:13:55 +0100 (ti, 10 feb 2009) | 6 lines
- Added a new announcement option: Drinking.
- Lots of background changes that you won't really notice, most important one is that it uses the same frame all the time instead of creating a new one for each match.
- Most likely fixed the font issue with asian clients.
- Added three localizations (thank you bluenyx and sillyboy6): koKR, zhCN and zhTW.
- Added a couple of new auras to auralist.lua
- Added Clique support
r18 | Proditor-125533 | 2009-01-11 01:25:54 +0100 (sö, 11 jan 2009) | 3 lines
- Fixed so it won't print out enemy names twice... again (damn typos!).
- Fixed a very minor bug in the low health announcement function.
- Removed "Beta" from Gladius.toc
r17 | Proditor-125533 | 2009-01-10 01:37:14 +0100 (lö, 10 jan 2009) | 6 lines
- Added a "Grow frame upwards" option.
- Added three new announce options: Enemies on low health, Trinket used and Trinket ready. No announcements are toggled on by default.
- Added the ability to chose where to announce to, the current options are: Party, Raid Warning, MikScrollingBattleText, Scrolling Combat Text and Blizzard's Floating Combat Text.
- Announcement messages are class colored when sent to SCT, MSBT and FCT.
- Reorganized the options quite a bit, added a lot of new categories so it wouldn't get so messy. Some categories are quite empty right now but I'm planning on filling them up later.
- Added Hex to auralist.lua and removed a few unnecessary auras (doing the checking by name not by id).
r16 | Proditor-125533 | 2008-12-18 18:43:42 +0100 (to, 18 dec 2008) | 1 line
- Fixed bugs with the new announce feature (shouldn't print out names twice now) and the "/gladius hide" command.
r15 | Proditor-125533 | 2008-12-16 18:29:03 +0100 (ti, 16 dec 2008) | 2 lines
- Added options for Death Knights runic power.
- Added a function printing out new enemies names to the party chat (optional). Toggled off by default.
r14 | Proditor-125533 | 2008-11-10 13:50:32 +0100 (må, 10 nov 2008) | 1 line
- Bug fixes for the "Override class/aura icons" trinket display option. It shouldn't melt together with the class icon anymore and it should always display the correct icon depending on the enemy's faction.
r13 | Proditor-125533 | 2008-11-09 16:26:46 +0100 (sö, 09 nov 2008) | 3 lines
- Added another trinket display option: "Override class/aura icon".
- Fixed a bug where the selected border would be too wide when not having class icons enabled.
- Removed the ability to open the configuration screen when right clicking the frame (still works for the anchor when Gladius is unlocked).
r12 | Proditor-125533 | 2008-11-06 14:32:40 +0100 (to, 06 nov 2008) | 4 lines
- Added different display options for the trinket status: Name icon, name text, big icon, small icon, and grid-style icon.
- Fixed so the trinket status isn't visible when everything else is hidden (when waiting for an arena to begin).
- Fixed so the human racial "Every Man for Himself" is included in the trinket checking.
- /gladius trinket command added: simulates a trinket being used for the first Gladius target. Should ONLY be used while testing the frame outside of an arena.
r11 | Proditor-125533 | 2008-11-03 08:03:24 +0100 (må, 03 nov 2008) | 5 lines
- PvP trinket status added, shows the PvP trinket icon or "(t)" to the right of the enemies name when the trinket is ready.
- Target icons, shows the class of the enemies target in a small icon to the right. Toggled off as default since I'm not 100% satisfied with it.
- Added a ton of new auras to auralist.lua.
- Reorganized the options a bit.
- Removed like 150 lines of unecessary code from frame.lua
r10 | Proditor-125533 | 2008-10-31 21:38:06 +0100 (fr, 31 okt 2008) | 1 line
- Fixed so the frame won't show up everytime you logon.
r9 | Proditor-125533 | 2008-10-31 21:30:01 +0100 (fr, 31 okt 2008) | 3 lines
- Added options for clicks, you can choose between target, focus and cast spell for the five mouse buttons. No macro support yet.
- Added options for the power text, you can now select what to display, actual power, maximum power and power percentage. You can combine several options.
- Changed the default priorities auralist.lua, still not completely done tho.
r8 | Proditor-125533 | 2008-10-30 20:24:51 +0100 (to, 30 okt 2008) | 3 lines
- Changed how the frame positions itself. It should now always resize itself from the top and the left, except when it cannot go further in that direction so to speak.
- Frame is now clamped to screen.
- "/gladius hide" slash command added.
r7 | Proditor-125533 | 2008-10-29 23:35:44 +0100 (on, 29 okt 2008) | 3 lines
- Changed so it uses GUID to identify targets instead of name.
- Simplified some code.
- Fixed a few leaked globals.
r6 | Proditor-125533 | 2008-10-29 19:43:11 +0100 (on, 29 okt 2008) | 4 lines
- Fixed a bug where the frame would not reset if you joined an arena when you were in one already.
- Removed Bindings.xml from Gladius.toc as it was not necessary for it to be there.
- Fixed enUS localization for bindings.
- Few code optimizations (foremost for buff scanning)
r5 | Proditor-125533 | 2008-10-29 02:21:53 +0100 (on, 29 okt 2008) | 1 line
- Fixed error in svn:externals, AceDB-3.0 was called AceAceDB-3.0
r4 | Proditor-125533 | 2008-10-28 22:20:12 +0100 (ti, 28 okt 2008) | 1 line
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...