chore: format adventure code snippets and simplify particles

Author: Lulu13022002

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

@@ -1028,7 +1028,7 @@ misc:
       in each implementation's respective documentation:
 
       - Eigencraft: No official documentation available. However,
-      [theosib's comments](https://bugs.mojang.com/browse/MC-81098?focusedCommentId=420777#comment-420777)
+      [theosib's comments](https://mojira.dev/MC-81098?focusedCommentId=420777#comment-420777)
       on the Mojira bug tracker give an overview of the Eigencraft implementation.
 
       - [Alternate Current](https://github.com/SpaceWalkerRS/alternate-current/blob/main/README.md)
@@ -1139,7 +1139,7 @@ unsupported-settings:
     default: "true"
     description: >-
       If set to false, the creation of invulnerable end crystals will be
-      allowed. Fixes [MC-108513](https://bugs.mojang.com/browse/MC-108513)
+      allowed. Fixes [MC-108513](https://mojira.dev/MC-108513)
   ticking:
     chunks:
       default: "true"

src/content/docs/adventure/book.md

@@ -15,13 +15,13 @@ Books are composed of:
 
 ```java
 // Create and open a book about cats for the target audience
-public void openMyBook(final @NonNull Audience target) {
-    Component bookTitle = Component.text("Encyclopedia of cats");
-    Component bookAuthor = Component.text("kashike");
-    Collection<Component> bookPages = Cats.getCatKnowledge();
+public void openMyBook(final Audience target) {
+  final Component bookTitle = Component.text("Encyclopedia of cats");
+  final Component bookAuthor = Component.text("kashike");
+  final Collection<Component> bookPages = Cats.getCatKnowledge();
 
-    Book myBook = Book.book(bookTitle, bookAuthor, bookPages);
-    target.openBook(myBook);
+  final Book myBook = Book.book(bookTitle, bookAuthor, bookPages);
+  target.openBook(myBook);
 }
 ```
 

src/content/docs/adventure/bossbar.md

@@ -18,7 +18,7 @@ Boss Bars are composed of:
 ```java
 private @Nullable BossBar activeBar;
 
-public void showMyBossBar(final @NonNull Audience target) {
+public void showMyBossBar(final Audience target) {
   final Component name = Component.text("Awesome BossBar");
   // 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);
@@ -34,7 +34,7 @@ public void showMyBossBar(final @NonNull Audience target) {
   this.activeBar = fullBar;
 }
 
-public void hideActiveBossBar(final @NonNull Audience target) {
+public void hideActiveBossBar(final Audience target) {
   target.hideBossBar(this.activeBar);
   this.activeBar = null;
 }

src/content/docs/adventure/faq.md

@@ -43,7 +43,7 @@ PlaceholderAPI placeholders are not supported in MiniMessage. However, you can e
   * @param player the player
   * @return the tag resolver
   */
-  public @NotNull TagResolver papiTag(final @NotNull Player player) {
+  public TagResolver papiTag(final Player player) {
       return TagResolver.resolver("papi", (argumentQueue, context) -> {
           // Get the string placeholder that they want to use.
           final String papiPlaceholder = argumentQueue.popOr("papi tag requires an argument").value();

src/content/docs/adventure/localization.md

@@ -64,30 +64,31 @@ Below is an example of how one might implement a custom `Translator`.
 public class MyTranslator implements Translator {
 
   @Override
-  public @NotNull Key name() {
+  public Key name() {
     // Every translator has a name which is used to identify this specific translator instance.
     return Key.key("mynamespace:mykey");
   }
 
   @Override
-  public @Nullable MessageFormat translate(final @NotNull String key, final @NotNull Locale locale) {
+  public @Nullable MessageFormat translate(final String key, final Locale locale) {
     // You could retrieve a string from a properties file, a config file, or some other system.
-    // An an example, we will hard-code a check for a specific key here.
+    // As an example, we will hard-code a check for a specific key here.
     if (key.equals("mytranslation.key") && locale == Locale.US) {
-      return new MessageFormat("Hello %s!", locale);
+      return new MessageFormat("Hello {0}!", locale);
     } else {
       // If you only want to use component translation, you can override this method and always return `null`.
       return null;
     }
   }
 
   @Override
-  public @Nullable Component translate(@NotNull TranslatableComponent component, @NotNull Locale locale) {
+  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.
-    if (key.equals("mytranslation.colorful") && locale == Locale.US) {
+    if (component.key().equals("mytranslation.colorful") && locale == Locale.US) {
       return Component.text("Hello, ", NamedTextColor.GREEN)
-        .append(component.arguments().get(0).color(NamedTextColor.RED))
-        .append(component.children()); // Always make sure to copy the children over!
+        .append(component.arguments().stream().map(it -> it.asComponent().color(NamedTextColor.RED)).toList())
+        .append(component.children()) // Always make sure to copy the children over!
+        .applyFallbackStyle(component.style());
     } else {
       return null;
     }
@@ -107,10 +108,10 @@ An example of how to use a translation store is below.
 ```java
 // As above, every translator needs an identifying name!
 // Could also use TranslationStore#component(Key) to work with components instead.
-final TranslationStore myStore = TranslationStore.messageFormat(Key.key("mynamespace:mykey"));
+final TranslationStore.StringBased<MessageFormat> myStore = TranslationStore.messageFormat(Key.key("mynamespace:mykey"));
 
 // You can add translations one-by-one, or in bulk. Consult the Javadocs for a full list of methods.
-myStore.register("mytranslation.key", Locale.US, new MessageFormat("Hello %s!", Locale.US));
+myStore.register("mytranslation.key", Locale.US, new MessageFormat("Hello {0}!", Locale.US));
 
 // You can then register this to the global translator so the translations are available there!
 GlobalTranslator.translator().addSource(myStore);

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

@@ -98,7 +98,7 @@ becomes this Adventure equivalent:
 
 ```java
 Component.text()
-  .append(Component.text("hello", NamedTextColor.GOLD)
+  .append(Component.text("hello", NamedTextColor.GOLD))
   .append(Component.text(" world"))
   .build()
 ```
@@ -118,7 +118,7 @@ becomes
 ```java
 Style style = Style.style(NamedTextColor.GOLD, TextDecoration.BOLD);
 Component.text()
-  .append(Component.text("hello", style)
+  .append(Component.text("hello", style))
   .append(Component.text(" world", style))
   .build()
 ```

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

@@ -32,10 +32,10 @@ MiniMessage allows you to both serialize components into MiniMessage strings and
 Here's a short example to try things out:
 
 ```java
-Audience player = ...;
-MiniMessage mm = MiniMessage.miniMessage();
+final Audience player = ...;
+final MiniMessage mm = MiniMessage.miniMessage();
 
-Component parsed = mm.deserialize("Hello <rainbow>world</rainbow>, isn't <underlined>MiniMessage</underlined> fun?");
+final Component parsed = mm.deserialize("Hello <rainbow>world</rainbow>, isn't <underlined>MiniMessage</underlined> fun?");
 
 player.sendMessage(parsed);
 ```
@@ -85,7 +85,7 @@ final MiniMessage myCustomMiniMessageInstance = builder.build();
 To make customizing MiniMessage easier, we provide a Builder. The specific methods on the builder are explained in the javadoc.
 
 ```java
-MiniMessage minimessage = MiniMessage.builder()
+final MiniMessage mm = MiniMessage.builder()
     .tags(TagResolver.builder()
       .resolver(StandardTags.color())
       .resolver(StandardTags.decorations())
@@ -129,7 +129,7 @@ The builder for `MiniMessage` allows providing a custom tag resolver rather than
 MiniMessage also provides convenience methods to do that:
 
 ```java
-MiniMessage serializer = MiniMessage.builder()
+final MiniMessage serializer = MiniMessage.builder()
   .tags(TagResolver.builder()
     .resolver(StandardTags.color())
     .build()

src/content/docs/adventure/minimessage/translator.md

@@ -30,12 +30,18 @@ public class MyMiniMessageTranslator extends MiniMessageTranslator {
   }
 
   @Override
-  public @Nullable String getMiniMessageString(final @NotNull String key, final @NotNull Locale locale) {
+  public Key name() {
+    // Every translator has a name which is used to identify this specific translator instance.
+    return Key.key("mynamespace:mykey");
+  }
+
+  @Override
+  public @Nullable String getMiniMessageString(final String key, final Locale locale) {
     // Creating a custom MiniMessage translator is as simple as overriding this one method.
     // All you need to do is return a MiniMessage string for the provided key and locale.
     // In this example we will hardcode this, but you could pull it from a resource bundle, a properties file, a config file or something else entirely.
     if (key.equals("mykey") && locale == Locale.US) {
-      return "<red>Hello, <name>! Today is <day_of_week>."
+      return "<red>Hello, <name>! Today is <day_of_week>.";
     } else {
       // Returning null "ignores" this translation.
       return null;

src/content/docs/adventure/platform/bukkit.mdx

@@ -36,7 +36,6 @@ public class MyPlugin extends JavaPlugin {
 
     private BukkitAudiences adventure;
 
-    @NonNull
     public BukkitAudiences adventure() {
         if (this.adventure == null) {
             throw new IllegalStateException("Tried to access Adventure when the plugin was disabled!");

src/content/docs/adventure/platform/bungeecord.mdx

@@ -38,7 +38,6 @@ public class MyPlugin extends Plugin {
 
     private BungeeAudiences adventure;
 
-    @NonNull
     public BungeeAudiences adventure() {
         if (this.adventure == null) {
             throw new IllegalStateException("Cannot retrieve audience provider while plugin is not enabled");