chore: format a few pages

Author: Lulu13022002

CONTRIBUTING.md

@@ -135,6 +135,10 @@ import {
   LATEST_PAPER_BUILD_API_VERSION,
   LATEST_VELOCITY_RELEASE,
   LATEST_FOLIA_RELEASE,
+  LATEST_ADVENTURE_API_RELEASE,
+  LATEST_ADVENTURE_PLATFORM_MOD_RELEASE,
+  LATEST_ADVENTURE_PLATFORM_RELEASE,
+  LATEST_ANSI_RELEASE,
   LATEST_WATERFALL_RELEASE,
   LATEST_USERDEV_RELEASE,
 } from "/src/utils/versions";
@@ -144,6 +148,10 @@ Latest Paper API build version is {LATEST_PAPER_BUILD_API_VERSION}
 Latest Velocity version is {LATEST_VELOCITY_RELEASE}.
 Latest Minecraft version is {LATEST_MC_RELEASE}.
 Latest Folia version is {LATEST_FOLIA_RELEASE}.
+Latest Adventure API version is {LATEST_ADVENTURE_API_RELEASE}.
+Latest Adventure platform mod version is {LATEST_ADVENTURE_PLATFORM_MOD_RELEASE}.
+Latest Adventure platform version is {LATEST_ADVENTURE_PLATFORM_RELEASE}.
+Latest `ansi` version is {LATEST_ANSI_RELEASE}.
 Latest Waterfall version is {LATEST_WATERFALL_RELEASE}.
 Latest `paperweight-userdev` version is {LATEST_USERDEV_RELEASE}.
 ```

src/config/paper/paper-global.yml

@@ -275,7 +275,7 @@ misc:
     vanilla: "false"
     default: "true"
     description: >-
-      Whether to fix MC-159283 which causes unusual ring-shaped terrain patterns in the outer End islands at extremely far distances.
+      Whether to fix [MC-159283](https://mojira.dev/MC-159283) which causes unusual ring-shaped terrain patterns in the outer End islands at extremely far distances.
   load-permissions-yml-before-plugins:
     default: "true"
     description: >-
@@ -298,7 +298,7 @@ misc:
   prevent-negative-villager-demand:
     default: "false"
     description: >-
-      Fixes MC-163962. Prevents the villager demand from going
+      Fixes [MC-163962](https://mojira.dev/MC-163962). Prevents the villager demand from going
       negative, but may introduce parity issues with Vanilla.
   region-file-cache-size:
     default: "256"

src/config/paper/paper-world-defaults.yml

@@ -364,7 +364,7 @@ entities:
       vanilla: "disabled"
       default: "200"
       description: >-
-        Workaround for MC-125757, makes all arrows advance their despawn
+        Workaround for [MC-125757](https://mojira.dev/MC-125757), makes all arrows advance their despawn
         timer as if they were stuck in the ground, after a delay (in ticks).
     count-all-mobs-for-spawning:
       vanilla: "true"

src/config/waterfall/waterfall-config.yml

@@ -1,7 +1,7 @@
 use_netty_dns_resolver:
   default: "true"
   description: >-
-    Sets whether Netty''s async DNS resolver is used for account authentication.
+    Sets whether Netty's async DNS resolver is used for account authentication.
 disable_modern_tab_limiter:
   default: "true"
   description: >-

src/content/docs/adventure/bossbar.md

@@ -23,7 +23,7 @@ public void showMyBossBar(final Audience target) {
   // Creates a red boss bar which has no progress and no notches
   final BossBar emptyBar = BossBar.bossBar(name, 0, BossBar.Color.RED, BossBar.Overlay.PROGRESS);
   // Creates a green boss bar which has 50% progress and 10 notches
-  final BossBar halfBar = BossBar.bossBar(name, 0.5f, BossBar.Color.GREEN, BossBar.Overlay.NOTCHED_10);
+  final BossBar halfBar = BossBar.bossBar(name, 0.5F, BossBar.Color.GREEN, BossBar.Overlay.NOTCHED_10);
   // etc..
   final BossBar fullBar = BossBar.bossBar(name, 1, BossBar.Color.BLUE, BossBar.Overlay.NOTCHED_20);
 

src/content/docs/adventure/faq.md

@@ -16,7 +16,7 @@ In vanilla Minecraft, some places where components are rendered have parent styl
 
 - Test on a vanilla client, without any mods or resource packs. Modded clients (such as Badlion), client mods, and even resource packs can break many elements of the modern JSON chat format and mess with incoming chat packets in ways that cause a myriad of issues.
 - Try without other plugins/mods. If another plugin/mod is modifying outgoing packets or formatting chat messages, this could cause a loss of formatting in the messages you send. Try without any other plugins to see if any are causing issues.
-- For RGB colors, test on a client of at least version *1.16*. Mojang added RGB support in this version. The JSON message format has evolved over time and has had many new additions since its introduction many, many years ago. For a full version history, see [the Minecraft wiki](https://minecraft.wiki/w/Text_component_format).
+- For RGB colors, test on a client of at least version *1.16*. Mojang added RGB support in this version. The JSON message format has evolved over time and has had many new additions since its introduction many, many years ago. For a full version history, see [the Minecraft Wiki](https://minecraft.wiki/w/Text_component_format).
 
 ## How can I support both MiniMessage and legacy (§-code) formatting?
 
@@ -67,7 +67,7 @@ In the case of `adventure-platform-fabric`, you need to make sure you are proper
 
 - Not shading the correct version of `adventure-api`. You can check your dependency tree to see what or why your build tool is not including the correct version of the API that matches the one used by the platform version you are using.
 - Not relocating your dependencies. If you are running on a platform that includes an older version of the API, or another mod/plugin is also not properly relocating their dependencies, you will use their out-of-date version of the API, causing errors.
-- Building/running against a native implementation of `adventure-api`.  If you are running on a platform that includes an older version of the API, this could cause issues if the library depends on newer features that are not available in the outdated version of the API, your library will not be able to find these methods, causing errors.
+- Building/running against a native implementation of `adventure-api`. If you are running on a platform that includes an older version of the API, this could cause issues if the library depends on newer features that are not available in the outdated version of the API, your library will not be able to find these methods, causing errors.
 - Relocating `adventure-api` and trying to use native/library methods. If you relocate the API, you will not be able to use any methods that use the API in native implementations or libraries as method signatures will differ. Either shade and relocate this software, or do not use native methods. Alternatively, if you are shading and relocating a library but want to use the API, make sure you are only relocating the packages that you are shading.
 
 Please consult the documentation for your build tool for more information on how to shade, relocate and manage your dependencies. We do not provide one-on-one support for these sorts of issues, as there are far too many project-specific variables that make isolating issues difficult.

src/content/docs/adventure/localization.md

@@ -83,7 +83,7 @@ public class MyTranslator implements Translator {
 
   @Override
   public @Nullable Component translate(final TranslatableComponent component, final Locale locale) {
-    // As above, we will hardcode a check here, but you should be reading this from elsewhere.
+    // As above, we will hard-code a check here, but you should be reading this from elsewhere.
     if (component.key().equals("mytranslation.colorful") && locale == Locale.US) {
       return Component.text("Hello, ", NamedTextColor.GREEN)
         .append(component.arguments().stream().map(it -> it.asComponent().color(NamedTextColor.RED)).toList())

src/content/docs/adventure/migration/bungeecord-chat-api.md

@@ -116,7 +116,7 @@ new ComponentBuilder("hello")
 becomes
 
 ```java
-Style style = Style.style(NamedTextColor.GOLD, TextDecoration.BOLD);
+final Style style = Style.style(NamedTextColor.GOLD, TextDecoration.BOLD);
 Component.text()
   .append(Component.text("hello", style))
   .append(Component.text(" world", style))

src/content/docs/adventure/minimessage/dynamic-replacements.md

@@ -48,8 +48,8 @@ This will insert and parse the text.
 When you want to create your own styling tag you can use the styling placeholder.
 
 ```java
-MiniMessage.miniMessage().deserialize("<my-style>Hello :)</my-style> How are you?",
-    Placeholder.styling("my-style", ClickEvent.suggestCommand("/say hello"), NamedTextColor.RED, TextDecoration.BOLD));
+MiniMessage.miniMessage().deserialize("<my_style>Hello :)</my_style> How are you?",
+    Placeholder.styling("my_style", ClickEvent.suggestCommand("/say hello"), NamedTextColor.RED, TextDecoration.BOLD));
 // will apply a click event, a red text color and bold decoration to the text
 ```
 
@@ -59,8 +59,8 @@ Create your own styling tags:
 
 ```java
 Placeholder.styling("fancy", TextColor.color(150, 200, 150)); // will replace the color between "<fancy>" and "</fancy>"
-Placeholder.styling("myhover", HoverEvent.showText(Component.text("test"))); // will display your custom text as hover
-Placeholder.styling("mycmd", ClickEvent.runCommand("/mycmd is cool")); // will create a clickable text which will run your specified command.
+Placeholder.styling("my_hover", HoverEvent.showText(Component.text("test"))); // will display your custom text as hover
+Placeholder.styling("my_cmd", ClickEvent.runCommand("/mycmd is cool")); // will create a clickable text which will run your specified command.
 ```
 
 :::tip
@@ -83,10 +83,10 @@ To specify the locale and format of the number the formatter accepts optionally
 You can specify the locale and the number format. It's possible to pass both as arguments to the tag but you have provide the locale first.
 
 ```java
-MiniMessage.miniMessage().deserialize("<gray>Hello my number <no>!", Formatter.number("no", 250.25d));
-MiniMessage.miniMessage().deserialize("<gray>Hello my number <no:'#.00'>!", Formatter.number("no", 250.25d));
-MiniMessage.miniMessage().deserialize("<gray>Hello my number <no:'de-DE':'#.00'>!", Formatter.number("no", 250.25d));
-MiniMessage.miniMessage().deserialize("<gray>Hello my number <no:'de-DE'>!", Formatter.number("no", 250.25d));
+MiniMessage.miniMessage().deserialize("<gray>Hello my number <no>!", Formatter.number("no", 250.25));
+MiniMessage.miniMessage().deserialize("<gray>Hello my number <no:'#.00'>!", Formatter.number("no", 250.25));
+MiniMessage.miniMessage().deserialize("<gray>Hello my number <no:'de-DE':'#.00'>!", Formatter.number("no", 250.25));
+MiniMessage.miniMessage().deserialize("<gray>Hello my number <no:'de-DE'>!", Formatter.number("no", 250.25));
 ```
 
 All those examples are valid and will insert the number as the tag.
@@ -98,7 +98,7 @@ Refer to Locale and DecimalFormat for valid locale tags and usable patterns.
 You can change the style such as the color by a more complex pattern:
 
 ```java
-MiniMessage.miniMessage().deserialize("<gray>Your current balance is <no:'en-EN':'<green>#.00;<red>-#.00'>.", Formatter.number("no", 250.25d));
+MiniMessage.miniMessage().deserialize("<gray>Your current balance is <no:'en-EN':'<green>#.00;<red>-#.00'>.", Formatter.number("no", 250.25));
 ```
 
 This will display the balance in red for negative numbers, otherwise the number will be green.
@@ -139,12 +139,12 @@ You can simply create your own placeholders. Take a look at the [Formatter](http
 
 Create a custom tag which makes its contents clickable:
 
-```java
-TagResolver.resolver("click-by-version", (args, context) -> {
+```java replace
+TagResolver.resolver("click_by_version", (args, context) -> {
   final String version = args.popOr("version expected").value();
-  return Tag.styling(ClickEvent.openUrl("https://jd.papermc.io/adventure/ " + version + "/"));
+  return Tag.styling(ClickEvent.openUrl("https://jd.papermc.io/adventure/" + version + "/"));
 });
-// creates a tag to get javadocs of adventure by the version: <click-by-version:'5.2.0'>
+// creates a tag to get javadocs of adventure by the version: <click_by_version:'\{LATEST_ADVENTURE_API_RELEASE}'>
 ```
 
 You can create your own complex placeholders with multiple arguments and their own logic.

src/content/docs/adventure/minimessage/format.mdx

@@ -41,7 +41,7 @@ For tags with no content, tags can be auto-closed by using the format `<tag/>`.
 
 All tag names are case-insensitive to reduce the possibility for conflict, but we recommend keeping all tag names lowercase (or at the very least, being consistent).
 
-Some tags have argument. Those look like this: `<tag:argument>stuff</tag>`.
+Some tags have argument. Those look like this: `<tag:argument>content</tag>`.
 For example:
 ```mm
 <hover:show_text:"<red>test:TEST">TEST
@@ -57,7 +57,7 @@ the opening quote character can be escaped (`'` or `"`). In either place, the es
 In locations where escaping is not supported, the literal escape character will be passed through. In locations where escaping *is* supported but a literal escape character is desired, the escape character can itself be escaped to produce a `\`.
 
 The default tags try to represent components in a manner compatible with Vanilla, but simplifying some elements. It might be helpful to
-use [the Minecraft wiki](https://minecraft.wiki/w/Text_component_format) as a reference for the Vanilla component system, especially
+use [the Minecraft Wiki](https://minecraft.wiki/w/Text_component_format) as a reference for the Vanilla component system, especially
 for things like the actions and values of click and hover events.
 
 The [MiniMessage Web Viewer](https://webui.advntr.dev) allows testing MiniMessage text locally, without having to spin up a Minecraft instance.
@@ -83,7 +83,7 @@ Tag
   * `<_colorname_>`
 
 Arguments
-   * `_colorname_`, any minecraft color constant: `black`, `dark_blue`, `dark_green`, `dark_aqua`, `dark_red`, `dark_purple`, `gold`, `gray`, `dark_gray`, `blue`, `green`, `aqua`, `red`, `light_purple`, `yellow`, or `white`.
+  * `_colorname_`, any minecraft color constant: `black`, `dark_blue`, `dark_green`, `dark_aqua`, `dark_red`, `dark_purple`, `gold`, `gray`, `dark_gray`, `blue`, `green`, `aqua`, `red`, `light_purple`, `yellow`, or `white`.
 
 
      `dark_grey` can be used in place of `dark_gray`, and so can `grey` in place of `gray`.
@@ -133,12 +133,12 @@ Examples
 Color the shadow of the next parts
 
 Tag
-   * `<shadow:_colorNameOrHex_:[alpha_as_float]>`
-   * `<!shadow>` as an alias to disable the shadow (equivalent to `<shadow:#00000000>`)
+  * `<shadow:_colorNameOrHex_:[alpha_as_float]>`
+  * `<!shadow>` as an alias to disable the shadow (equivalent to `<shadow:#00000000>`)
 
 Arguments
-   * `_colorNameOrHex_`, a named color or hex color string with the format `#RRGGBB` or `#RRGGBBAA`
-   * `[alpha_as_float]`, a float value between 0 and 1, representing the alpha value of the shadow. Optional, defaults to 0.25. Has no effect if an alpha value is already provided in the hex color string.
+  * `_colorNameOrHex_`, a named color or hex color string with the format `#RRGGBB` or `#RRGGBBAA`
+  * `[alpha_as_float]`, a float value between 0 and 1, representing the alpha value of the shadow. Optional, defaults to 0.25. Has no effect if an alpha value is already provided in the hex color string.
 
 Examples
 ```mm
@@ -208,7 +208,7 @@ Tag
 
 Arguments
   * `_action_`, the type of click event, one of [this list](jd:adventure:net.kyori.adventure.text.event.ClickEvent$Action#field-summary)
-  * `_value_`, the argument for that particular event, refer to [the minecraft wiki](https://minecraft.wiki/w/Text_component_format)
+  * `_value_`, the argument for that particular event, refer to [the Minecraft Wiki](https://minecraft.wiki/w/Text_component_format#Click_events)
 
 Examples
 ```mm