If you have LibSlash installed, settings can be set via /sqr or /squared. The syntax is as follows: /squared option value(s) - if you omit any values, the current value of the setting will be displayed instead.
So for instance, to set the border color, I'd use the following command:
- /sqr bordercolor 100 50 100
If you don't have LibSlash, you can get and set options via /script and Lua function instead:
- /script Squared.GetSetting("option")
- /script Squared.SetSetting("option", value)
To reset all settings to their default values, use the following command (capitalization counts):
- /script Squared.ResetSettings()
Help with values:
- Settings that are toggles can be set to (true, on, 1 or yes) to activate them, or (false, off, 0, or no) to deactivate them.
- Settings that are numbers can be set to any number.
- Settings that are directions typically have 4 options: (up, down, left, right)
- Settings that are colors are set as RGB (red, green, blue) triplets, which can be entered with most normal separators, spaces included.
The following default settings are available for Squared (in addition to the color customization options):
| Setting | Default | Description |
| fgcolor | 0 150 0 | The default color of the bars. |
| bgcolor | 0 0 0 | The default background of the bars. |
| bordercolor | 128 128 128 | The default border color of the bars. |
| groupbordercolor | 200 200 200 | The color of the border for people in the same group as you. |
| leaderbordercolor | 50 50 255 | The color of the border for a group leader. |
| targetbordercolor | 255 255 255 | The color of the border for a unit you're currently targeting. |
| textcolor | 255 255 255 | The default text color for the center text area. |
| textcolor-top | 255 255 255 | The default text color for the top text area. |
| textcolor-bottom | 255 255 255 | The default text color for the bottom text area. |
| boxheight | 68 | The height of each bar. |
| boxwidth | 68 | The width of each bar. |
| bordersize | 4 | The size of the border around each bar. |
| alpha | 1.0 | The tranparency value for each bar (1.0 = opaque, 0.0 = invisible). |
| namelength | 5 | The length to which names are truncated. |
| showicon | true | Whether or not to show the icons on bars (for now, just class icons). |
| showmenu | true | Whether or not to enable right-clicks showing the options menu for units in group/warband mode. |
| direction-group | down | The direction in which groups are ordered away from the anchor. |
| direction-member | right | The direction in which group members are ordered away from the first member of the group. |
| direction-column | down | The direction in which columns of groups expand. |
| spacing-group | 0 | If this value is greater than 0, it will add a gap between each group in the layout. |
| spacing-member | 0 | If this value is greater than 0, it will add a gap between the borders of each member in a group. |
| spacing-column | 0 | If this value is greater than 0, it will add a gap between each column of groups. |
| columnsize | 0 | If this value is greater than 0, it will set how many groups are added to a column before the next column is created. |
| direction-fill | up | The direction in which the health bar fills within the unit's box. |
| invert-bars | false | If set to true, bars will become more filled the less HP a unit has. The default setting of false means that bars are more filled with more HP. |
| disable | false | Whether or not to disable Squared from appearing entirely. |
| disable-default | false | Whether or not to disable the solo-player display mode. |
| disable-group | false | Whether or not to disable the group display mode. |
| disable-warband | false | Whether or not to disable the warband display mode. |
| disable-scenario | false | Whether or not to disable the scenario display mode. |
| color-classnames | false | Whether or not to color names by class type. |
| color-classbars | false | Whether or not to color bars by class type. |
| color-hpnames | false | Whether or not to color names by hp status. |
| color-hpbars | false | Whether or not to color bars by hp status. |
| color-hpborders | false | Whether or not to color borders by hp status. |
| hp-high | 80 | The percentage threshold below which a unit will be considered to have "high" hp (above this, the default color will be used). |
| hp-medium | 50 | The percentage threshold below which a unit will be considered to have "medium" hp. |
| hp-low | 25 | The percentage threshold below which a unit will be considered to have "low" hp. |
| rangefading | true | Whether or not to fade frames that are range/LOS-blacklisted. |
| rangefading-freq | 0 | How often to update range fading, in seconds. Default is 0 (every frame). |
| rangefading-min | 0.2 | A multiplier for the "alpha" value, this sets the initial (least visible) state of fading. For instance, if the regular alpha is 0.8, then having this at 0.2 would result in the frame being initially faded to overall alpha of 0.16 and then getting more visible over time. |
| rangefading-max | 0.5 | A multiplier for the "alpha" value, this sets the final (most visible) state of fading. A frame will fade up this alpha times this, then "pop" up to alpha when it is no longer doing is fading. Setting this to 1.0 means that a frame will fade smoothly all the way back to the regular alpha value, with no "pop" at the end. |
| status-size | 10 | The size of the corner status indicators. |
|
This is not currently supported and may cause indicators to not display properly. | ||
| status-buff | topleft | The location to display the indicator for non-HoT buffs on a player. Valid positions are topleft, topright, bottomleft, bottomright (any other value will hide this indicator). |
| status-debuff | topright | The location to display the indicator for debuffs on a player. Valid positions are topleft, topright, bottomleft, bottomright (any other value will hide this indicator). |
| status-hot | bottomright | The location to display the indicator for heal-over-time effects on a player. Valid positions are topleft, topright, bottomleft, bottomright (any other value will hide this indicator). |
| status-buff-selfonly | Disabled as of patch 1.0.6 | Whether or not to filter the buff indicator to only show buffs that you cast on players. Currently disabled as Mythic removed the necessary info in 1.0.6, hopefully will be possible again once 1.1 arrives. |
| status-debuff-selfonly | true | Whether or not to filter the debuff indicator to only show debuffs that your career is capable of dispelling. |
| status-hot-selfonly | Disabled as of patch 1.0.6 | Whether or not to filter the hot indicator to only show hots that you cast on players. Currently disabled as Mythic removed the necessary info in 1.0.6, hopefully will be possible again once 1.1 arrives. |
| bufftracking-freq | 0.5 | How often SquaredBuffIndicators updates its indicators. |
| text-position-name | center | Where the unit's name is displayed. Possible values are center, top, bottom, or none. |
| text-position-hp | none | Where the unit's health percentage is displayed. Possible values are center, top, bottom, or none. |
| text-position-level | none | Where the unit's career rank is displayed. Possible values are center, top, bottom, or none. |
| text-position-ap | none | Where the unit's action point percentage is displayed. Possible values are center, top, bottom, or none. |
| text-font-center | font_clear_small_bold | The font used to display the center text. (See here for options.) |
| text-font-top | font_clear_small_bold | The font used to display the top text. (See here for options.) |
| text-font-bottom | font_clear_small_bold | The font used to display the bottom text. (See here for options.) |
| text-align-center | center | The alignment of the text in the center text area. Recommended values are "center", "leftcenter", or "rightcenter". |
| text-align-top | center | The alignment of the text in the top text area. Recommended values are "center", "leftcenter", or "rightcenter". |
| text-align-bottom | center | The alignment of the text in the top text area. Recommended values are "center", "leftcenter", or "rightcenter". |
| deplete-off | false | Setting this option to true will cause the boxes to always be completely filled, if you prefer to not have the bar-like effect but instead just have them change color/text. Setting it to false will return to the standard bar-like functionality of the fill. |
| icon-position | center | Sets the anchoring of the center icon. Possible values are center (default), left, right, top, bottom, topleft, topright, bottomleft, bottomright. |
| icon-offset-x | 0 | Sets the horizontal position relative to the anchor point of the icon. Negative values are to the left, positive values to the right. |
| icon-offset-y | 0 | Sets the vertical position relative to the anchor point of the icon. Negative values are upwards, positive values are downwards. |
| icon-scale | 0 | Forces a particular scaling for the class icon. Setting this to 0 will have Squared use its own method for determining how to size the icon. Setting it to anything above 0 will use that exact scaling (if you want to change this, start at 1 and work larger/smaller from there). |
| testmode | false | Setting this to turn will turn on a test mode that displays a random set of 4 groups with 6 members each (with varying health levels and classes) to allow for visual preview of changes without joining a larger group. Set it to false again to turn it off. |
| update-freq | 0.5 | How often Squared updates its unit displays in Warband or Scenario modes - by default, this is every 0.5 seconds. |
| texture-border | tint_square | The texture used for rendering the border element of each unit. |
| texture-background | tint_square | The texture used for rendering the background element of each unit. |
| texture-foreground | tint_square | The texture used for rendering the foreground element of each unit. |
| key-assist | alt | Which modifier key will allow you to assist the clicked unit. Possibilities are alt, ctrl, or shift. |
| key-assist-final | false | If this is true, using the modifier key for assisting when clicking on a unit will not also target that unit. If it is false, then clicking with the modifier key will both assist and target the unit. |
Facts
- Date created
- 11 Dec 2008
- Last updated
- 16 Feb 2009
- #9
Henk85 Thu, 25 Sep 2008 16:34:38is it possible to show the hp percentage? i didn´t find the option for this.
- #8
lialith Thu, 25 Sep 2008 13:13:02oh, sorry, didnt see that one... :)
- #7
Aiiane Thu, 25 Sep 2008 10:30:18royalflushxx: The issue with the name length is probably it hitting the actual borders of the label element displaying the text. I'll see if I can't tell the label to auto-resize itself in the next release to fix that for you.
- #6
Aiiane Thu, 25 Sep 2008 10:19:28lialith, all of the colorgroups are listed on the color customization page.
- #5
lialith Thu, 25 Sep 2008 09:09:19thank you!!! ;D
i think you forgot to mention colorgroup-hpdead in the list. ;)
- #4
kemal69 Thu, 25 Sep 2008 07:32:58I've noticed the menu for warbands doesn't have the warband options item, which is very inconvenient, you can change loot settings as leader but not access the options to move people from group to group, invite, change open/private status.
Love the mod, except for this one small problem.
- #3
royalflushxx Wed, 24 Sep 2008 20:29:23Really REALLY love this addon. Grid was essential as a healer in WoW, and I hope you can put this addon to the same eventual glory that Grid now commands.
The options are so customizable it fills me with glee, but the only problem I've found so far is your "/sqr namelength" only allows me to get up to 7 letters, even though I set it to 16 (changed the boxwidth to 140, and height to 40). Other than that minor problem, it's fantastic!
(Edit: Oh, I'd also like to see an option for locking and unlocking the window instead of having to use the Interface Customization tool in the Main Menu. Perhaps a hold-key-to-move button like Alt would be good for that?)
- #2
voon Tue, 23 Sep 2008 23:39:16Correct me if I'm wrong, but as I understand these settings, they do the following:
fgcolor - Foreground color - Default is Green. This is seen when you are at full HP
bgcolor - Background color - Default is Black. This is see when a user starts to loose HP
bordercolor - Border Color for the entire frame
groupbordercolor - Border Color for just your group
targetbordercolor - Border Color for your target? No idea on this one!
textcolor - The Colored text (Player Name) displayed in each frame.
boxheight - Height of each player box in the frame.
boxwidth - Width of each player box in the frame.
bordersize - Size of the border around each person in the frame.
alpha - The transparency of the frame.
showicon - Shows the class icon for each member in the frame.
showmenu - Allows you to bring up the Party menu for each player in the frame (typically via Right-Clicking on that person's name.)
direction-group - The direction the GROUPS will grow within the frame. Options Are: up, down, left, right
direction-member - The direction the MEMBERS will grow within each GROUP. Options are: up, down, left, right
direction-fill - The direction the health indicator will fill. Options are: up, down, left, right
disable-default - Disables your own name when not grouped. Useful if you are want a different unitframes to be displayed elsewhere. Set to 'true' or 'false' depending on preferences.
disable-group - Disables your group's names. Useful if you are want a different unitframes to be displayed elsewhere.
disable-warband - Displays your warband's groups and names. Useful if you are want a different unitframes to be displayed elsewhere. Set to 'true' or 'false' depending on preferences.
disable-scenario - Displays scenario groups and names. Useful if you are want a different unitframes to be displayed elsewhere. Set to 'true' or 'false' depending on preferences.
- #1
lialith Tue, 23 Sep 2008 10:12:10could you discripe what that settings exactly do please? :)