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
- #19
igrayne Sun, 28 Sep 2008 12:55:57o ye how to enable positioning moving and size of the addon?
- #18
igrayne Sun, 28 Sep 2008 12:54:31mmm i use libslash but the both commands for settings dont work
any toughts?
- #17
gyganti Sat, 27 Sep 2008 15:00:14hi there im stucked in the very beginnin of using this mod. any idea what this does mean?: [string "Interface/AddOns\Squared\SquaredSlashConfig.lua"]:85: attempt to index global 'args' (a nil value) me have only squared and libslash addons installed and it happens when me enter any command /sqr 'option' 'value'
- #16
pap3rninj4 Fri, 26 Sep 2008 13:39:42Same problem, would really appreciate an answer, the main reason I want an addon like this is to be able to tell at a glance if someone is in range for healing. PLEASE get back to us on this!!
- #15
rawenek Fri, 26 Sep 2008 11:12:01My bars wont fade/unfade until i click the bar of the person that went far/close, tested on two accounts not in bg or big group. Tried various update times, abilities, playing with the other settings, nothing helped. Any ideas what could be the cause ?
pic: http://img527.imageshack.us/img527/8318/uiuc1.jpg (the other char is far behind me on that pic)
- #14
phliptrip Fri, 26 Sep 2008 09:11:15Would probably be better to give a default value for rangefading-ability based on class than to force user to set it, a knowledgeable user can always set it to their preference but that way everyone would have the feature functional by default.
Another nice feature would be to have a /squared [on|off] that basically makes it display or not display as needed... really not tremendously useful on bright wizard, but I don't think I could live without it anymore on my zealot and archmage. I could probably acheive this by turning all the disables to true... hmm.
- #13
Celestian Fri, 26 Sep 2008 06:43:18The settings options are a bit confusing for me. I try:
I get a reply it's set to false. I do it 10 times, each time just says it's false. I tried to set the rangefading-ability to Lambent Aura and it did not say it took it but I look at the saved file and it has 9238 which might or might not be the abilityID (I dunno).
- #12
Aiiane Fri, 26 Sep 2008 03:51:07eekamouse - make a ticket about it.
- #11
peiper Thu, 25 Sep 2008 23:28:10Yet another excellent mod by a very active modder. Thank you for your efforts!
Could you extend functionality by adding something akin to a "color-inrange" option? For example, it could change the color of the health bar to gray if the target was out of spell range?
- #10
eekamouse Thu, 25 Sep 2008 20:12:04Is there a command to turn off/on the mod as a whole?
I'd like to be able to just make a macro to toggle it on when I'm logged into my Shaman, and shut it off if I'm on my Witch Elf.