add some new features

Author: HSGamer

content/spigot/extra/formatted/_index.md

@@ -0,0 +1,14 @@
++++
+title = "Handle a formatted value"
++++
+
+If the output of a `Value Provider` ([`Placeholder`]({{% ref "spigot/provider/placeholder" %}}) for example) is a formatted value and you are confident that you can get the raw value from it with a simple method of taking only numbers and the decimal separator, you can enable the `formatted` option in your Holder Setting.
+
+```yml
+holders:
+  example-formatted-value-provider:
+    <your other settings>
+    formatted: true
+    formatted-settings: # Optional settings for the formatted value
+      decimal-separator: "." # Change this to the decimal separator of the formatted value
+```

content/spigot/extra/playtime/_index.md

@@ -0,0 +1,51 @@
++++
+title = "Playtime Leaderboard"
++++
+
+This will guide you on how to create an ~unreliable~ playtime leaderboard for your server using the built-in [`Statistic Value Provider`]({{% ref "spigot/provider/statistic" %}}) and format the value using [`Value Display`]({{% ref "spigot/extra/value_display" %}}).
+
+## Add the Holder
+
+Open the `config.yml` file and add the following holder:
+
+```yaml
+holders:
+  playtime:
+    type: statistic
+    statistic: PLAY_ONE_MINUTE # Or PLAY_ONE_TICK if your server is running on 1.12 or below
+```
+
+This will create a holder named `playtime` that shows the total playtime of a player in ticks.
+
+But the value is in ticks, which is not human-readable. So, we need to format it. Add the following line:
+
+```yaml
+holders:
+  playtime:
+    type: statistic
+    statistic: PLAY_ONE_MINUTE
+    line: "&7[&b{index}&7] &b{name} &7- &b{value;time:pattern=HH:mm:ss&type=duration&unit=ticks}"
+```
+
+We added the `line` setting to the holder and override [the default `line`]({{% ref "spigot/extra/default_value" %}}). The `{value;time:pattern=HH:mm:ss&type=duration&unit=ticks}` will format the value to a human-readable time format.
+
+Now when you save and restart the server, you should see the playtime leaderboard in the `/gettop playtime` command.
+
+![Command output](command_output.png)
+
+## Display the Leaderboard
+
+We will [display it in a hologram]({{% ref "spigot/extra/hologram" %}})
+
+Here is an example of a hologram that displays the top 5 players in the leaderboard:
+
+```
+&b&lPLAYTIME LEADERBOARD
+&7#1 &f%topper_playtime;top_name;1% &7- &b%topper_playtime;top_value;1;time:pattern=HH:mm:ss&type=duration&unit=ticks%
+&7#2 &f%topper_playtime;top_name;2% &7- &b%topper_playtime;top_value;2;time:pattern=HH:mm:ss&type=duration&unit=ticks%
+&7#3 &f%topper_playtime;top_name;3% &7- &b%topper_playtime;top_value;3;time:pattern=HH:mm:ss&type=duration&unit=ticks%
+&7#4 &f%topper_playtime;top_name;4% &7- &b%topper_playtime;top_value;4;time:pattern=HH:mm:ss&type=duration&unit=ticks%
+&7#5 &f%topper_playtime;top_name;5% &7- &b%topper_playtime;top_value;5;time:pattern=HH:mm:ss&type=duration&unit=ticks%
+```
+
+![hologram](hologram.png)

content/spigot/extra/playtime/command_output

@@ -0,0 +1,38 @@
++++
+title = "Value Display"
++++
+
+Some places like [`{value}` in `line`]({{% ref "spigot/extra/default_value" %}}) and [the `value` and `top_value` queries]({{% ref "spigot/query" %}}) can be expanded to format the value in a more readable way. This is done by specifying some settings for them like:
+
+- `{value_<format>}`
+- `<holder>;value;<format>`
+- `<holder>;top_value;<position>;<format>`
+
+The following section will guide you through the available formats to replace `<format>`, we will use the `<holder>;value;<format>` query as an example.
+
+## Available Formats
+
+### Decimal Format
+
+> Format: `decimal:setting1=value1&setting2=value2`
+
+| Setting | Description | Default | Example |
+| --- | --- | --- | --- |
+| `decimalSeparator` | The character used to separate the integer part from the fractional part | `.` | `decimalSeparator=.` |
+| `groupingSeparator` | The character used to separate groups of digits to the left of the decimal separator | | `groupingSeparator=,` |
+| `groupingSize` | The number of digits in each group to the left of the decimal separator | | `groupingSize=3` |
+| `maximumFractionDigits` | The maximum number of digits allowed in the fractional part of the number | | `maximumFractionDigits=2` |
+
+Example: `jump;value;decimal:decimalSeparator=,&groupingSeparator=.&groupingSize=3&maximumFractionDigits=2`
+
+### Time Format
+
+> Format: `time:setting1=value1&setting2=value2`
+
+| Setting | Description | Default | Example |
+| --- | --- | --- | --- |
+| `pattern` | The pattern describing the date and time format | `HH:mm:ss` | `pattern=HH:mm:ss` |
+| `type` | The type of the time: `duration` or `time` | `duration` | `type=duration` |
+| `unit` | The unit of the time: `ticks`, `nanoseconds`, `microseconds`, `milliseconds`, `seconds`, `minutes`, `hours`, `days` | `seconds` | `unit=seconds` |
+
+Example: `playtime;value;time:pattern=HH:mm:ss&type=duration&unit=ticks`