DarqUI Raid and Group Windows and Spell Button Utility
All icon images are reproductions of materials owned and copyrighted by Sony Online Entertainment. They are incorporated herein for entertainment purposes only.
To get the most out of the DarqUI raid and group windows, please take a few minutes to read through all of the instructions. The configuration utility that comes with the raid and group windows must be unzipped before using it. Double-click "Start" inside the folder to open the main page in your browser. I strongly suggest using Internet Explorer to run the utility even if you usually prefer Firefox or something else. Click the flashing yellow security protection bar and allow the blocked script to run. Even though the program runs in a web page, it is completely self-contained on your computer. Neither the EQII game nor the Internet will be accessed in any way while using it. Contents: The Basics Setting Up a Spell Set Select a Subclass, Name, Order, Exact Ability Name, Fifth item, Icon and BG, Tell, GSay and Rsay, Command String, Command Tooltip, Examples, Cures Reconfiguring the UI Files Generate the Text Block, Update the UI Files Making Changes Without Using the Utility Manually Changing Other Fields, Background Color Choices, Changing an Icon, Special Characters in Spell Names, Chat Text and Command Strings Group and Raid Window Defaults Button Set, Line Hilite, Level Display, Cancel Spellcast, Cure Check, Sound Choices, Group Window Display Mode, Group Window Display Mode Controls, Group Audible Detrimental Feedback Sounds, Raid Window Group Arrangement and Quick Cast Button Location, Raidwide Audible Curse Feedback Sound, Color Background Option |  |
The Basics:
On the main page of the utility you will see 10 color-coded blocks which represent five configurable spell sets plus five cure spell combinations for the various curing classes. You can set up just a few spell slots or all of them depending on what you need. Later, you will transfer the choices you've made directly into the UI files using Windows Notepad. Before you start setting up the quick-cast buttons, it's important to understand why they are valuable. Although you could put just about any spell or command onto a button, the ones that will benefit you the most are those that normally require you to target another player before casting. Without the quick-cast buttons, you have to switch your target to the other player, cast the spell, then switch your target back to the first player, or to whatever else you were doing. But using the quick-cast buttons, the targeting is done internally so you can keep one player (or the enemy) targeted while you cast the spell on another player without changing targets. This can dramatically improve the efficiency of your gameplay depending upon your class, your role, and the spells and commands you choose. When deciding which spell sets to set up, your gameplay habits should be considered. If you have multiple alts, you may decide to make a set for each of them. If you do most of your grouping and raiding on a single character, you may want to set up the raid window with sets for pre-battle, during battle, and recovery after a wipe. Your raid sets can be completely different from your group sets, or they can be the same. The sets are easily switched from inside the game, so you can have as many as 9 different targetable group and raid-wide spells on-screen, with another 36 just a few mouse clicks away. Now let's set up a spell set step-by-step. |  |
1. Setting Up a Spell Set:
Select a Subclass: The easiest way to begin is by selecting the adventure class of the first character you want buttons for. When you choose a class from the dropdown list, one or more of the slots will be filled with preconfigured spell names and icons. You can stop there, or continue fine-tuning the spell set. When you log into the game, the DarqUI group and raid windows will search by default for a character with a first name that matches the label of one of the configured spell sets. If none of the labels match the name, the spell set function is turned off. Name: The name of the spell set is automatically changed to the subclass you chose in the previous step. If you change this label to the first name of the character you are configuring the set for, the spells will be automatically loaded when you log in with that character. Make sure you use caps and lowercase properly when naming the spell set for a character. If you prefer a different label, type a unique descriptive name in the space provided at the top of the spell set. This will be displayed in game for easy reference. Keep it short, preferably one word. Order: Each preconfigured spell has a shortcut on the "Order" dropdown. You can use these to change the order of the spells in the game window. If you decide to leave one of the slots empty or set up your own spell, choose the blank choice from this dropdown menu to clear it. Caution: Set up the spells in the order you want prior to customizing anything in the spell set, because switching the order will revert any icon and text changes you have made. Exact Ability Name: Whether you are setting up a new spell or using the preconfigured ones, check the spell names carefully because they have to match your knowledge book precisely or else they won't work. This includes the Roman numeral Level designations. If you only want a macro command on this button without the spell, leave the spell name blank. Fifth Item: You will notice that the fifth item in each set is exclusive to the group window. This is because the raid window only displays the first four custom spells in each set. If you are setting up spells for the raid window, be sure to keep this in mind. It does no harm to set up the fifth spell either way. Both windows use the same data; the raid window simply ignores spell slot #5. Icon and BG: The spell buttons are a composite of three parts: button, icon, and background color. The background color generally depends upon the legal target of the spell. Almost all of the preconfigured spells are either gold (for group or raid ally) or purple (for group allies). If you are setting up a new spell or command, click the icon to open a menu of resources that are available in game. Scroll through the icons and pick the one you want, which will select it and close the pop-up window. Next, choose the correct background color from the BG menu. You will have to wait until you are in game to see the icons overlaid on the backgrounds. The utility can't give you a preview of this. If you are setting up custom spells, you may prefer to leave some or all of the buttons with numbers instead of choosing icons. Simply leave the numbers in place when configuring, or choose a blank choice on an individual button from the Order drop-down. You can also select "Custom (Clear)" from the subclass dropdown to reset the entire block of spells including any text in the text fields. If you want a blank button face without a number or icon, open the icon picker and choose an empty black slot from one of the icon banks (there are empty icons in the resources starting on page 5) and then choose a background color for the blank button from the BG dropdown. (If you leave the BG set to "SEL" the script will choose black for you.) Tell, Gsay and Rsay: The next three fields can be filled in to automatically send a private tell, a groupsay, and/or a raidsay each time the spell button is clicked. Please keep in mind that text chat during encounters is generally very spammy even without macro text. Having visual information for certain critical spells or abilities can often make encounters go better, but a lengthy, cute saying for every single cast of every spell will quickly wear on the nerves of your groupmates. So be thoughtful about just which of your spells actually needs an announcement every time. The raidsay field has a special attribute: If you place any text into the Rsay field, the button target's name will be added as the last word in the raidsay announcement. For example, if you type "J Cap to" in the Rsay field, the raid will see "J Cap to Kalanorf" when you press the J-Cap button next to Kalanorf's name. So configure any raidsay text with this in mind. Command String: As an option, you can set up a spell or detrimental cure button to automatically run an arbitrary command as if you had typed it. This command can contain the reference for the selected button's target using the familiar "%T" mnemonic. The command string can be used together with a spell, or by itself as a simple targeted macro command. Clear the Ability Name field to use the button exclusively as a command. When you generate the XML data block using the utility, the %T will be converted into an internal variable that represents the button's target. So if you edit the UI files directly, be aware of this. Typing %T directly into the Cmd text field in the XML file will not work. Also, the leading forward-slash ("/") cannot be used in the command string. Simply start the string with the command verb without using the slash character. See the examples below. Command Tooltip: Because command strings can vary widely from a single verb to a complex string of text, the command function needs its own tooltip. Decide on a short description for the command and place it into this field. This description will appear in light-blue text under the button's SpellName tooltip, or by itself if you have not configured a spell for the button. If you leave the command field empty, the blue tooltip will not display. If you use "%T" in the tooltip, it will not be translated to the button's target.
IMPORTANT: There are two limitations to the command field: 1) In most commands where you use %T to denote the button's target, the %T should not touch any of the characters adjacent to it. As a best practice, put a single space between the %T and the other parts of the command string so that it will translate the target correctly. 2) If your command string contains an apostrophe or any other characters besides %T, letters, numbers and spaces, you must enclose that portion of the string in quotation marks. Take the following example, an emote, which uses greater than/less than symbols and an apostrophe: em casts <Hyran's Seething Sonata> on %T This string should be typed into the utility with quotes surrounding the part that contains the odd characters as follows: em casts "<Hyran's Seething Sonata>" on %T which the utility will correctly translate in the generated XML data: em casts &quot;&lt;Hyran's Seething Sonata&gt;&quot; on Parent.Parent.T.Value The quotation marks you supply will not show up in the output in-game; they are only used here to facilitate the translation of the non-standard characters. In rare instances like this where you must include quotation marks, be sure the %T stays outside of the quotes, otherwise it will be taken literally and will not translate the button's target.
Some command string examples: assist %T - Assist the selected ally. em gives %T a dark heart - Use a roleplaying emote to inform others in the area of certain actions. tell Baoldor Upbeat Tempo has been placed on %T - Inform your raid leader of important buff choices. 7 ---- ACT MARKER %T ---- - Places text into chat channel 7 to mark events in ACT for searching later. Cures: Certain classes have the ability to cure all the ailments of allies, some can cure a subset of them, and other classes cannot cure others at all. Depending on the class of the character you log in with, the cure spells will be automatically loaded over the detrimental icons. By default for Conjurors and Paladins, the corresponding Alternate Advancement points are assumed to be chosen for the character. Priests: Physical, Arcane, Noxious, Elemental, Curse. Mages: Arcane. Conjurors (with AA): Arcane and Elemental. Paladins (with AA): Arcane, Noxious, Elemental. All other classes: No cures. Curing class presets are set up by default to send a private tell to the target of each detrimental cure attempt, and an additional raidsay for Curse cures by Priests. You can add a command (macro) and command tooltip to each cure similar to the quick-cast buttons, which is primarily a means for raiders to broadcast cure status messages into chat channels. But classes without cures may choose to utilize the command function to create a variety of other targeted commands (see above Command String discussion.) Keep in mind that the detrimental icons cannot and should not be replaced with other icon images. If you want the ability to cast cure potions on your character with a button-click, I suggest the DarqUI threat/detrimental window UI mod which has this feature. IMPORTANT: Non-curing classes who choose to use the command feature on the cure buttons will need to turn off the Cure Check feature on the options panel in order to use the cure buttons on demand. Otherwise they will only become available when a detrimental of that type lands on that character. Once you have the spell set like you want it, you can optionally configure the other four sets in a similar manner. Remember to label the set with the name of the character (properly capitalized) in order to load the set automatically upon login. |  | Select a subclass to quickly populate the buttons. Click an icon slot to open the pick window. Add private tells, groupsay and raidsay sparingly. Quick-cast buttons can contain any combination of spell, chat text, and a macro-like command string. The tooltip above shows a spell + command combination. Hover your cursor over the button set label in-game to see the currently-loaded spells and commands.
2. Reconfiguring the UI Files:
Generate the Text Block: Once you have your spell sets configured, click the "Write My Data" button near the bottom of the application to generate a block of XML text containing your custom configuration data. There will be five blocks of data for the five spell sets, and five blocks of cure data without the icon portion. (Cure icons are not configurable.) You need to make sure your group and raid windows contain all ten blocks, even if you did not configure any spells in some of the blocks. Update the UI Files: Now navigate to the location where your custom UI files are stored. If you have not already dropped the unzipped DarqUI versions of the group and raid windows into this folder, do that now. The raid and group windows have to be the ones I supplied you with. Your UI folder will probably be something like: C:\Program Files\Sony\EverQuest II\UI\<Your Custom UI> If you have generated data for the raid window, locate the file inside this folder called: eq2ui_mainhud_raid.xml If you are configuring the group window, look for: eq2ui_mainhud_groupmembers.xml Right-click the file, and choose Open With... and then choose Notepad. Be sure to use only Notepad and not Word or WordPad, otherwise you will end up with a mess. Once you have Notepad open with your file showing, go to the Format menu at the top of the window and make sure Word Wrap is unchecked. This will make the file much easier to edit and understand. Near the top of the file you will see a placeholder block of text that looks similar to your generated data from the utility window. There will be Start and End markers at the top and bottom of the text block to help you find the right area. Example: <?xml version="1.0" encoding="utf-8"?> <Page eq2usescomwndcontrols="true" MaximumSize="320,227"... <!-- *************** Start *************** --> ... ... Replace all of the text between the start and end markers Replace all of the text between the start and end markers Replace all of the text between the start and end markers Replace all of the text between the start and end markers ... ... <!-- **************** End **************** --> <Page Name="Switches" Visible="false"> <Data Name="TargetColor" Value="#005577" /> <Data Name="TargetOpac" Value="1.000" /> ...code continues... Using standard cut-and-paste techniques, delete all of the text between the markers, and then copy the entire block of generated text out of the utility and paste it into the UI file in place of the matching placeholder text. Save the UI file. If you are using the same spell configuration for both the group and the raid windows, open the other file in the same manner, and cut-and-paste your button data the same way you did for the first window. Otherwise, go back to the utility and reconfigure the buttons, generate new XML text by pressing the Write button, and then copy the updated button information into the second UI file. Save the files and log into the game to use your new quick-cast buttons. |  | Click the 'Write My Data' button to generate XML with your button information. Use Notepad without Word Wrap to edit the UI files. Cut-and-paste the data from the utility into the matching area of the UI file.
3. Making Changes Without Using the Utility:
Once you have your raid and group windows working like you want, you may later find that you want to make some minor changes -- a different spell name, a slight change to the chat text on one of the spells. Since the button utility does not save your data after you close it, it doesn't really make sense to reconfigure all of your spells each time just to make a minor adjustment like this. If you are already familiar with XML, you will very likely feel quite comfortable opening the UI files and making a quick adjustment here and there without fear. If you have not done much with XML, the format of the data may seem intimidating at first, but don't be intimidated by it. Once you know what you are looking at, you will realize it's simple text and you will quickly become able to make certain adjustments without invoking the utility. As an example, look at the Notepad window below. You can see the spell set is composed of a "Page" with a label and 5 spells, then immediately after that you see five lines of text with the icon data. Each spell has one line of commands and one line of icon information (yellow areas in the example). If you want to change the label of the spell set, make the change in the Label Value field (shown below with a blue rectangle around it.)

Manually changing other fields: | If you want to change a spell name, the color of an icon background, or chat text, there is no need to use the button utility at all. Just change the value in Notepad and save the file. The configurable fields for each spell are as follows: SpellName * Tell * Gsay * Rsay * BG Cmd * ** CmdTT * * IMPORTANT: Even if you do not want any text in the SpellName, Tell, Gsay, Rsay, Cmd or CmdTT fields, always leave a single space character between the quotation marks in each empty field as shown in the example above. ** IMPORTANT: If you have a Cmd (command macro) that contains anything other than letters, numbers and spaces, please refer to the discussion box in the main help area regarding certain limitations, as well as the Special Characters section below.
Background Color Choices: | BG values must be a single capital letter between the quotation marks as follows: B = Blue G = Green Y = Yellow R = Red O = Orange P = Purple X = Black
Changing an Icon: | If you want to change an icon without disturbing a button's other properties, run the utility and choose the desired icon from the images, generate the data block in the utility, then copy-and-paste only the specific icon resource and rectangle (Source and SourceRect) into the correct fields surrounded by quotation marks. No need to reconfigure the entire block of spells.
Special Characters in Spell Names, Chat Text and Command Strings: | Some spells and some chat text strings will contain a limited number of special characters that must be handled differently in order not to crash the window. The one you will run into most often is the apostrophe, as in the Jester's Cap spell for example. When the utility encounters one of these characters, it will replace the symbol with an alternative string that the game can digest properly. In the case where spell names have the apostrophe, you need to use the special notation or else the spell won't work. If you generate the XML text using the utility, the spell name will be configured correctly. If you insert spell names into the file manually, replace any special characters using the chart below. Jester's Cap would become Jester&apos;s Cap. Cram all the text together without spaces for the word "Jester's" just like you see it here. When you are manually configuring command text, enclose any special characters in a pair of quotation marks (&quot; for manual entry). Make sure the %T mnemonic is replaced with "Parent.Parent.T.Value" and appears outside the quote pairs, otherwise the button's target conversion will not work. (See the discussion box in the main help area regarding limitations of non-alphanumeric characters on command text strings.) My best advice to you is not to use anything but letters, numbers and the spacebar in your chat text unless it is required, or unless you are willing to test it out in game and be prepared for a possible crash.
Character: | Mark: | Use This:
Ampersand | & | &amp;
Apostrophe | ' | &apos;
Quotation Mark | " | &quot;
Greater than | > | &gt;
Less than | < | &lt;

Group and Raid Window Defaults:
There are several default settings you can change within the raid and group XML files. If you find that you are making certain adjustments to the windows every time you log in, change the default value for that setting. Open up the raid or group window in Notepad, and make sure Word Wrap in the Format menu is unchecked. Use the search function to locate the white text below, and carefully make the exact change shown in blue depending upon your preference:
Switches for Both Windows: `<Page Name="Switches" Visible="false"> <...> <Data Name="DefaultSpellSet" Value="Auto" /> <Data Name="LineHilite" Value="true" /> <Data Name="LevelDisp" Value="false" /> <Data Name="CancelSpellcast" Value="true" /> <Data Name="CureCheck" Value="true" /> </Page>`
1. Which button set to display on login (default is Auto): <Data Name="DefaultSpellSet" Value="3" /> Choices are Auto, 0, 1, 2, 3, 4 Using Auto but logging in with a character that does not have a spell set named for it will turn off the spell icons until a spell set is selected from the options panel. 2. Line Hilite (default is true): <Data Name="LineHilite" Value="false" /> 3. Level Display (default is true for group window, false for raid window): <Data Name="LevelDisp" Value="false" /> 4. Cancel Spellcast (default is true): <Data Name="CancelSpellcast" Value="false" /> 5. Cure Check (default is true): <Data Name="CureCheck" Value="false" /> 6. Sound choices: This list is not exhaustive. Caution is suggested if you select UI sounds for familiar events that could be confusing during encounters, like the friend logon sound for example. broadcast (synthetic chime used for game-wide system messages) coin_cha_ching (coin movement) ding (experience level up) encounter_broken (three dramatic chords, the sound when you /yell) inventory_attune (bon-n-ng!) quest_item (quest update "plink") skill_up (default) (deep gong) spell_gained (synthetic blip) ui_chestdrop (that satisfying wooden "ka-thunng!") ui_friend_logon (synthetic whistle note) ui_guild_lvl_up (zzzap!) ui_spirit_lvl_up (harp arpeggio)
Group Window Specific Switches `<Page Name="Switches" Visible="false"> <...> <Data Name="DefaultLayout" Value="1" /> <Data Name="ShowDispModesMouseOver" Value="true" /> <Data Name="ShowDispModesAlways" Value="false" /> <Data Name="AudTra" Sd=" " Value="false" Sound="quest_item" /> <Data Name="AudArc" Sd=" " Value="false" Sound="quest_item" /> <Data Name="AudNox" Sd=" " Value="false" Sound="quest_item" /> <Data Name="AudEle" Sd=" " Value="false" Sound="quest_item" /> <Data Name="AudCur" Sd=" " Value="false" Sound="quest_item" /> </Page>`
1. Group Window Display Mode (default is 1): <Data Name="DefaultLayout" Value="2" /> Choices:
1 | Vertical elongated, quick-cast buttons over health bars appear on mouseover
2 | Vertical elongated, quick-cast buttons above cures on the right-hand side appear continuously. Pet health bar appears below character health/mana bars
3 | Cascading compact arrangement flows to fit size of window. Quick-cast buttons over health bars, appear on mouseover. Only group members other than self are visible in this mode
4 | Horizontal compact, 6x1 fixed arrangement. Quick-cast buttons over health bars appear on mouseover. All group members appear including self
5 | Horizontal stacked, 6x1 arrangement with limited flow. Quick-cast buttons and cures below health and pet bars appear continuously. All group members appear including self
2. Group Window Display Mode Controls: The display mode controls are located in the same area as the LFG and Find Players icons, and will be visible until you have a full group. If you want to change display modes while you are grouped with five others, cycle through the modes using the numbered button on the options panel. There is a combination of two settings that control the behavior of the front panel display mode buttons. Make the changes shown below according to your preference. Show On Mouse-Over: (default) <Data Name="ShowDispModesMouseOver" Value="true" /> <Data Name="ShowDispModesAlways" Value="false" /> Show Always: <Data Name="ShowDispModesMouseOver" Value="true" /> <Data Name="ShowDispModesAlways" Value="true" /> Show Never: <Data Name="ShowDispModesMouseOver" Value="false" /> <Data Name="ShowDispModesAlways" Value="false" /> 3. Group Audible Detrimental Feedback: Select from the list of sounds in step 6 above for each of the five impairment types. It is recommended that all five be configured with the same sound. The example below is for Trauma. "Value" is whether or not the audible is preset on login (true/false), and "Sound" is of course the name of the sound resource to play. <Data Name="AudTra" Sd=" " Value="false" Sound="quest_item" />
Raid Window Specific Switches `<Page Name="Switches" Visible="false"> <...> <Data Name="DefaultLayout" Value="1" /> <Data Name="AudCurse" Value="quest_item" Active="true" /> <Data Name="ColorBkg" Opac="1.000" Value="false" /> </Page>`
1. Raid Group Arrangement and Quick-Cast Button Location (default is 1): <Data Name="DefaultLayout" Value="1" /> Choices:
1 | 1-across x 4-down, buttons over health bars appear on mouseover
2 | 2-across x 2-down, buttons over health bars appear on mouseover
3 | 3-across x 2-down, buttons over health bars appear on mouseover
4 | 4-across x 1-down, buttons over health bars appear on mouseover
5 | 1-across x 4-down, buttons on the right-hand side appear continuously
6 | 2-across x 2-down, buttons on the right-hand side appear continuously
7 | 3-across x 2-down, buttons on the right-hand side appear continuously
8 | 4-across x 1-down, buttons on the right-hand side appear continuously
2. Raidwide Audible Curse Feedback Sound: Select from the list of sounds in step 6 above for the sound to play each time a curse lands on any raider. "Active" is whether or not the audible is preset on login (true/false), and "Value" is the name of the sound resource to play. <Data Name="AudCurse" Value="quest_item" Active="true" /> 3. Color Background Option (default is false): True defaults your raid window to the classic EQII style four-color group backgrounds. You may also want to experiment with the opacity (transparency level) of the colored fields by changing the Opac value. Choose a real number between 0.000 (completely transparent) and 1.000 (nearly opaque). <Data Name="ColorBkg" Opac="0.500" Value="true" /> |  | Front panel display mode controls can be configured to appear always, never, or on mouse-over. There is another control for display modes on the options panel.