Hypixel SkyBlock Wiki:Calculators

Calculators are tools for determine quantities of ingame items, actions, or money.

Form calculators use a script that enables dynamic loading of templates into parts of a page. A configurable form is used to input parameters into the template.

These form config files are stored in the "Calculator:" namespace, and are added to Category:Calculators. There is a Sandbox page for it as well.

The script that is used for this was taken from the RuneScape fandom wiki, as well as some newer features taken from the more up to date non-fandom RS wiki (fandom script used instead due to errors). These are the pages they use for learning about them:
 * Form calculators
 * Form calculators/Examples
 * Form calculators/Tests

Added features not on the fandom wiki's version of the script:
 * Toggles (feature taken from non-fandom RS wiki)

Beyond this point is documentation taken from the RS fandom wiki, tweaked as needed:

Configuration
The JS calculator's configuration section uses pairs, each separated by a newline. The possible names are:
 * calcname - The name of the calculator used as a title (default 'Calculator'). Optional.
 * calcpage - The name of the calculator page of this calculator. If none is provided, the 'view calculator' link will not work.
 * template - The name of the template to use on form submittal. If no namespace is provided, then the template namespace will be searched by default. If the template is in the main namespace, you must prepend a colon to the article name. This follows the same convention that's used when transcluding templates into a page. If none is provided, 'view template' link will not work.
 * form - The unique HTML ID of the element that will contain the form. Each configuration block should specify a different form ID.
 * result - The unique HTML ID of the element that will contain the parsed template.
 * suggestns - A comma-separated list of namespace IDs to use for autocomplete. This field applies for all article parameter types used in the form. By default, namespace 0 (main) is searched. See the table to the bottom for the valid namespace IDs.
 * param - Defines a parameter to be sent to the template, in the format shown in the next section.

Parameter format
A param line should be in the following format:




 * - The name of the parameter as used by the template. Parameter names are case sensitive, and there can be no spaces.
 * - The label used for the parameter in the form. If blank,  is used.   supports using HTML to format the labels - including simple formats like,  and even.
 * However, normal wikiscript can only be used if the config is contained within a div tag instead of a pre tag
 * - The default value used to prefill the form initially.
 * - The type of the parameter, used for form validation and to control the appearance of the form field. Valid values for  are:
 * string (default) - The input box can contain any value.
 * article - The input box should contain an article name. Currently, this means that autocomplete will be enabled for the text box. To set the namespaces searched by autocomplete, use the suggestns field (see above).
 * number - The input box must contain a number. A valid range can be specified in  in the format min-max. If either min or max is omitted or a range is not given, then infinity is assumed.
 * int - The input box must contain an integer. A valid range can be specified (see above).
 * select - The input is selected from a comma-separated list of values given in.
 * check - A checkbox, with values sent to the template defined by the.
 * The  has format value if true,value if false, which defines what the form will pass to the template when ticked or not ticked. The default for this is true,false.
 * The checkbox will be checked by default if the  is set to true or the same as the value if true given in the.
 * fixed - The value specified by  will be shown but cannot be changed in the form.
 * hidden - The value specified by  will be hidden in the form and cannot be changed. No row is generated for the form at all.
 * semihidden - A combination of fixed and hidden: The value specified by  will be hidden in the form and cannot be changed, but unlike hidden, a row is added to the form, which is hidden with CSS. This is primarily for inter-script usage (i.e. some other script sets the semihidden value to something so that it is passed to the template when submitted).
 * - The allowed range of the parameter. The format of this field depends on the  chosen.
 * - The inputs or groups of inputs toggled by this widget. Applies to select, buttonselect, combobox, check, toggleswitch, togglebutton, int and number param types. Toggles are given in the format . Note that when an option is chosen, all the groups/fields listed for other options (that aren't listed on the selected option) will be hidden.
 * Default toggles: For checkboxes, toggleswitches and togglebutton the keys are "true" and "false" (values specified in  cannot be used), if no key is given key is assumed to be "true". For number and int inputs available keys are any numbers or "not0" which is also used for any nonzero input (if no key is specified key is assumed to be "non0").
 * Value is the name of the option (listed in param range for the input). Multiple options can be assigned them same toggles by separating them with a comma ,.
 * Toggles are the groups or fields toggled by that option, multiple groups should be separated by a comma ,. The group or field names should be those specified in their respecitve.
 * Multiple toggle sets are separated by semicolons ;.
 * Examples:
 * If a select has Option 1,Option 2 for the range and for the toggles then when "Option 1" is selected all inputs that belong to "Group1" and "Group2" will be shown while those belonging to "Group3" will be hidden. when "Option 2" is selected all inputs that belong to "Group2" and "Group3" will be shown while those belonging to "Group1" will be hidden.
 * If a button select has Button 1,Button 2,Button 3 for the range and Button 1,Button 2=Input1 for the toggles then when "Button 1" or "Button 2" is selected the other input "Input1" will be displayed while if "Button 3" is selected it will not be.

The configuration section should be contained within a &lt;div&gt; or &lt;pre&gt; tag with the class jcConfig, e.g.: &lt;pre class="jcConfig"&gt; ... configuration ... &lt;/pre&gt;

For example configurations, see /Examples.

Architecture
The JSCalc architecture on the Hypixel SkyBlock Wiki is as follows:
 * A calculator page named Calculator:NAME
 * A calculation template page usually named Template:Calculator/NAME. All the calculation should be done on the template, including module invocation.

As an example,
 * Calculator page: Calculator:Ability damage
 * Calculation template: Template:Calculator/Ability damage

The categorization for calculators is a bit tricky. As of today:
 * Category:Calculators is a category for calculator pages, not templates made for individual calculators. This is added automatically when using JSCalculator.
 * There is currently no category for calculation templates.

There is currently no category for calculation templates. Do not get confused by the templates below. The templates below are not purposed for calculation templates.
 * Category:Calculator templates is a category for functional templates made to support running JS Calculator.
 * Category:Calculation templates is a category for templates made for calculations usually used outside of calculators. It is currently not related to the JS Calculator function.

List of Calculators
Check below for DPL lists of pages made for calculators. This is a DPL list of calculator pages. Alternatively, see Category:Calculators.
 * -|Calculator Pages=

This is a DPL list of calculation templates.
 * -|Calculation Templates=

License
This script is released under the GNU General Public License. The source code is available at MediaWiki:Common.js/calc.js.