settings
r26
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:
- Squared.GetSetting("option")
- Squared.SetSetting("option", value)
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. |
| 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. |
| direction-fill | up | The direction in which the health bar fills within the unit's box. |
| 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 | true | Whether or not to filter the buff indicator to only show buffs that you cast on players. |
| 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 | true | Whether or not to filter the heal-over-time indicator to only show HoTs that you cast on players. |
| 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-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-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. |
Facts
- Date created
- 26 Oct 2008
