setBar: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
No edit summary |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{MacroFunction | {{MacroFunction | ||
|name=setBar | |name=setBar | ||
Line 5: | Line 4: | ||
|version=1.3b42 | |version=1.3b42 | ||
|description= | |description= | ||
Sets the value of the specified [[Token:bar|bar]] for the [[Current Token]]. The value to set is between 0 and 1 for 0% to 100% respectively. | Sets the value of the specified [[Token:bar|bar]] for the [[Current Token]] and makes the bar visible. The value to set is between 0 and 1 for 0% to 100% respectively. | ||
|usage= | |usage= | ||
Line 11: | Line 10: | ||
setBar(name, pct/100) | setBar(name, pct/100) | ||
setBar(name, pct/100, id) | setBar(name, pct/100, id) | ||
setBar(name, pct/100, mapname) | setBar(name, pct/100, id, mapname) | ||
</source> | </source> | ||
Line 25: | Line 24: | ||
[h: setBar("Health", HP/MaxHP)] | [h: setBar("Health", HP/MaxHP)] | ||
</source> | </source> | ||
|also= | |||
{{func|isBarVisible}}, | |||
{{func|setBarVisible}}, | |||
{{func|getBar}} | |||
|changes= | |changes= | ||
Line 30: | Line 34: | ||
}} | }} | ||
==Related Pages== | |||
* [[HP and Health Bars]] | |||
* [[bar.name|The <code>bar.name</code> special variable]] | |||
[[Category:Bar Function]] | [[Category:Bar Function]] |
Revision as of 14:25, 5 November 2019
setBar() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.3b42
Sets the value of the specified bar for the Current Token and makes the bar visible. The value to set is between 0 and 1 for 0% to 100% respectively.
Usage
setBar(name, pct/100)
setBar(name, pct/100, id)
setBar(name, pct/100, id, mapname)
Parameters
name
- The name of the bar.value
- The value of the bar. Should be between 0 and 1.id
- The tokenid
of the token which has its bar set, defaults to the Current Token.Note: This parameter can only be used in a Trusted Macro.
mapname
- The name of the map to find the token. Defaults to the current map.
Example
[h: setBar("Health", HP/MaxHP)]
See Also
Version Changes
- 1.5.7 - Added
id
andmapname
parameter options.