Ignore deprecation state of getUnsafe()

Reviewed-on: https://codeberg.org/Andre601/AdvancedServerList/pulls/166

.github/workflows/docs-deploy.yml

@@ -2,16 +2,6 @@ name: 'Deploy Site (Push)'
 
 on:
   workflow_dispatch:
-  push:
-    paths:
-      - 'docs/**'
-      - 'mkdocs.yml'
-      - 'requirements.txt'
-      - '.github/workflows/docs-deploy.yml'
-    branches:
-      - master
-    tags-ignore:
-      - '**'
 
 permissions:
   contents: read
@@ -55,4 +45,5 @@ jobs:
         with:
           path: 'site/'
       - name: Deploy to GitHub Pages
+        id: deployment
         uses: actions/deploy-pages@v2

.gitignore

@@ -2,3 +2,4 @@
 /.idea/
 /**/dependency-reduced-pom.xml
 /**/target/
+/**/__pycache__/

.woodpecker/renovate.yml

@@ -1,45 +0,0 @@
-platform: linux/amd64
-
-when:
-  event:
-    - cron
-    - manual
-  branch:
-    - master
-
-steps:
-  #renovateDryRun:
-  #  image: renovate/renovate
-  #  pull: true
-  #  commands:
-  #    - renovate $${CI_REPO}
-  #  environment:
-  #    RENOVATE_PLATFORM: gitea
-  #    RENOVATE_ENDPOINT: https://codeberg.org
-  #    LOG_LEVEL: debug
-  #    RENOVATE_DRY_RUN: full
-  #  secrets:
-  #    - source: rb_token
-  #      target: renovate_token
-  #    - source: git_author
-  #      target: renovate_git_author
-  #  when:
-  #    - event: push
-  renovate:
-    image: renovate/renovate
-    pull: true
-    commands:
-      - renovate $${CI_REPO}
-    environment:
-      RENOVATE_PLATFORM: gitea
-      RENOVATE_ENDPOINT: https://codeberg.org
-      LOG_LEVEL: debug
-    secrets:
-      - source: rb_token
-        target: renovate_token
-      - source: gh_renovate_token
-        target: github_com_token
-    when:
-      - event: cron
-        cron: renovate
-      - event: manual

README.md

@@ -3,6 +3,7 @@
 AdvancedServerList is a plugin that allowys you to customize your server's MOTD, favicon, Player count text and player count hover displayed in a player's multiplayer server list based on conditions and priorities.
 
 ## Downloads
+
 <a href="https://modrinth.com/plugin/advancedserverlist" target="_blank">
   <img src="https://cdn.jsdelivr.net/gh/Andre601/devins-badges@13e0142/assets/compact/available/modrinth_vector.svg" height="46" alt="modrinth" title="Available on Modrinth">
 </a>
@@ -43,10 +44,10 @@ When multiple profiles exist that have valid conditions will the one with the hi
 > [*Read More*][conditions]
 
 ### Placeholders
-Placeholders can be used within conditions to further customize them. They can also be used in any other text option (motd, playerCount and players) to display their respective values.
+Placeholders can be used within conditions to further customize them. They can also be used in any other text option to display their respective values.
 The format is `${<target> <identifier>}` which was adopted from BungeeTabListPlus. Depending on what platform you use the plugin on are only specific placeholders available.
 
-When using the SpigotMC/PaperMC version can you also use placeholders from [PlaceholderAPI][placeholderapi] using its `%<identifier>_<values>%` placeholder format. PlaceholderAPI needs to be installed for that.
+When using the SpigotMC/PaperMC version, or while PAPIProxyBridge is installed on your proxy, can you also use placeholders from [PlaceholderAPI][placeholderapi] using its `%<identifier>_<values>%` placeholder format. PlaceholderAPI needs to be installed for that.
 
 If you're a plugin dev can you even add your own custom placeholders through AdvancedServerList's own API.
 
@@ -84,6 +85,7 @@ You can disable this in the global bStats config file located in `/plugins/bstat
 </a>
 
 ## Support
+
 <a href="https://discord.gg/6dazXp6" target="_blank">
   <img src="https://cdn.jsdelivr.net/gh/Andre601/devins-badges@13e0142/assets/compact-minimal/social/discord-singular_vector.svg" height="64" alt="discord" title="Join my Discord Server">
 </a>
@@ -103,7 +105,7 @@ You can disable this in the global bStats config file located in `/plugins/bstat
 [modrinth]: https://modrinth.com/plugin/advancedserverlist
 
 [protocollib]: https://hangar.papermc.io/dmulloy2/ProtocolLib
-[placeholderapi]: https://www.spigotmc.org/resources/6245/
+[placeholderapi]: https://hangar.papermc.io/HelpChat/PlaceholderAPI
 [viaversion]: https://hangar.papermc.io/ViaVersion/ViaVersion
 [papiproxybridge]: https://hangar.papermc.io/William278/PAPIProxyBridge
 [maintenance]: https://hangar.papermc.io/kennytv/Maintenance

bukkit/pom.xml

@@ -94,7 +94,7 @@
         <dependency>
             <groupId>net.kyori</groupId>
             <artifactId>adventure-platform-bukkit</artifactId>
-            <version>4.3.0</version>
+            <version>4.3.1</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -112,13 +112,13 @@
         <dependency>
             <groupId>me.clip</groupId>
             <artifactId>placeholderapi</artifactId>
-            <version>2.11.3</version>
+            <version>2.11.4</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>com.viaversion</groupId>
             <artifactId>viaversion-api</artifactId>
-            <version>4.8.0</version>
+            <version>4.8.1</version>
             <scope>provided</scope>
         </dependency>
     </dependencies>
@@ -143,7 +143,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.5.0</version>
+                <version>3.5.1</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <relocations>

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/objects/placeholders/PAPIPlaceholders.java

@@ -25,13 +25,14 @@
 
 package ch.andre601.advancedserverlist.bukkit.objects.placeholders;
 
+import ch.andre601.advancedserverlist.api.bukkit.objects.BukkitServer;
 import ch.andre601.advancedserverlist.api.objects.GenericPlayer;
 import ch.andre601.advancedserverlist.api.objects.GenericServer;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 import ch.andre601.advancedserverlist.bukkit.BukkitCore;
 import ch.andre601.advancedserverlist.bukkit.objects.impl.BukkitPlayerImpl;
+import ch.andre601.advancedserverlist.bukkit.objects.impl.BukkitServerImpl;
 import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
-import ch.andre601.advancedserverlist.core.objects.GenericServerImpl;
 import ch.andre601.advancedserverlist.core.parsing.ComponentParser;
 import ch.andre601.advancedserverlist.core.profiles.ServerListProfile;
 import ch.andre601.advancedserverlist.core.profiles.profile.ProfileManager;
@@ -92,7 +93,7 @@ public class PAPIPlaceholders<F> extends PlaceholderExpansion{
         int protocol = resolveProtocol(pl);
         int online = Bukkit.getOnlinePlayers().size();
         int max = Bukkit.getMaxPlayers();
-        GenericServer server = new GenericServerImpl(online, max, host);
+        BukkitServer server = new BukkitServerImpl(plugin.getWorldCache().worlds(), online, max, host);
         GenericPlayer player = new BukkitPlayerImpl(pl, cached, protocol);
         
         ServerListProfile profile = ProfileManager.resolveProfile(plugin.getCore(), player, server);
@@ -101,17 +102,29 @@ public class PAPIPlaceholders<F> extends PlaceholderExpansion{
         
         ProfileEntry entry = ProfileManager.merge(profile);
         
-        if(ProfileManager.checkOption(entry.extraPlayersEnabled()))
-            max = online + (entry.extraPlayersCount() == null ? 0 : entry.extraPlayersCount());
+        Integer maxPlayers = null;
+        if(ProfileManager.checkOption(entry.maxPlayersEnabled())){
+            max = entry.maxPlayersCount() == null ? 0 : entry.maxPlayersCount();
+            maxPlayers = entry.maxPlayersCount();
+        }
         
-        GenericServer finalServer = new GenericServerImpl(online, max, host);
+        Integer extraPlayers = null;
+        if(ProfileManager.checkOption(entry.extraPlayersEnabled())){
+            max = online + (entry.extraPlayersCount() == null ? 0 : entry.extraPlayersCount());
+            extraPlayers = entry.extraPlayersCount();
+        }
+        
+        BukkitServer finalServer = new BukkitServerImpl(plugin.getWorldCache().worlds(), online, max, host);
         
         return switch(identifier.toLowerCase(Locale.ROOT)){
             case "motd" -> getOption(entry.motd(), pl, player, finalServer);
             case "favicon" -> getOption(entry.favicon(), pl, player, finalServer);
             case "playercount_hover" -> getOption(entry.players(), pl, player, finalServer);
             case "playercount_text" -> getOption(entry.playerCountText(), pl, player, finalServer);
-            case "extra_players_max" -> String.valueOf(max);
+            // TODO: Remove extra_players_max in future release
+            case "extra_players_max", "playercount_extraplayers" -> extraPlayers == null ? "null" : String.valueOf(extraPlayers);
+            case "playercount_maxplayers" -> maxPlayers == null ? "null" : String.valueOf(maxPlayers);
+            case "server_playersmax" -> String.valueOf(max);
             default -> null;
         };
     }
@@ -137,6 +150,7 @@ public class PAPIPlaceholders<F> extends PlaceholderExpansion{
         
         // getProtocolVersion is only in Paper, so this is only called when main class isn't SpigotCore.
         // Also, ViaVersion is not present, so the player protocol *should* be the same as the server.
+        //noinspection deprecation
         return Bukkit.getUnsafe().getProtocolVersion();
     }
     

bungeecord/pom.xml

@@ -93,7 +93,7 @@
         <dependency>
             <groupId>net.kyori</groupId>
             <artifactId>adventure-platform-bungeecord</artifactId>
-            <version>4.3.0</version>
+            <version>4.3.1</version>
             <scope>compile</scope>
         </dependency>
         <dependency>
@@ -133,7 +133,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.5.0</version>
+                <version>3.5.1</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <relocations>

core/pom.xml

@@ -110,13 +110,13 @@
         <dependency>
             <groupId>com.google.guava</groupId>
             <artifactId>guava</artifactId>
-            <version>32.1.2-jre</version>
+            <version>32.1.3-jre</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>net.william278</groupId>
             <artifactId>papiproxybridge</artifactId>
-            <version>1.3</version>
+            <version>1.4.2</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -152,7 +152,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.5.0</version>
+                <version>3.5.1</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <filters>

core/src/main/java/ch/andre601/advancedserverlist/core/AdvancedServerList.java

@@ -31,7 +31,6 @@ import ch.andre601.advancedserverlist.core.check.UpdateChecker;
 import ch.andre601.advancedserverlist.core.commands.CommandHandler;
 import ch.andre601.advancedserverlist.core.file.FileHandler;
 import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
-import ch.andre601.advancedserverlist.core.objects.ServerPlaceholders;
 import ch.andre601.advancedserverlist.core.profiles.players.PlayerHandler;
 
 import java.io.IOException;

core/src/main/java/ch/andre601/advancedserverlist/core/objects/GenericServerImpl.java

@@ -1,56 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2022-2023 Andre_601
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-
-package ch.andre601.advancedserverlist.core.objects;
-
-import ch.andre601.advancedserverlist.api.objects.GenericServer;
-
-public class GenericServerImpl implements GenericServer{
-    
-    private final int online;
-    private final int max;
-    private final String host;
-    
-    public GenericServerImpl(int online, int max, String host){
-        this.online = online;
-        this.max = max;
-        this.host = host;
-    }
-    
-    @Override
-    public int getPlayersOnline(){
-        return online;
-    }
-    
-    @Override
-    public int getPlayersMax(){
-        return max;
-    }
-    
-    @Override
-    public String getHost(){
-        return host;
-    }
-}

core/src/main/java/ch/andre601/advancedserverlist/core/objects/ServerPlaceholders.java

@@ -1,47 +0,0 @@
-/*
- * MIT License
- *
- * Copyright (c) 2022-2023 Andre_601
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-
-package ch.andre601.advancedserverlist.core.objects;
-
-import ch.andre601.advancedserverlist.api.PlaceholderProvider;
-import ch.andre601.advancedserverlist.api.objects.GenericPlayer;
-import ch.andre601.advancedserverlist.api.objects.GenericServer;
-
-public class ServerPlaceholders extends PlaceholderProvider{
-    
-    public ServerPlaceholders(){
-        super("server");
-    }
-    
-    @Override
-    public String parsePlaceholder(String placeholder, GenericPlayer genericPlayer, GenericServer genericServer){
-        return switch(placeholder){
-            case "playersOnline" -> String.valueOf(genericServer.getPlayersOnline());
-            case "playersMax" -> String.valueOf(genericServer.getPlayersMax());
-            case "host" -> genericServer.getHost();
-            default -> null;
-        };
-    }
-}

docs/.hooks/badges.py

@@ -0,0 +1,58 @@
+#
+# Modified version of Squidfunk's shortcodes.py file for Material for MkDocs.
+#
+# It was altered to create compact admonition-like boxes to display in the documentation.
+#
+# Original shortcodes.py file:
+# https://github.com/squidfunk/mkdocs-material/blob/56b96b4d799174d48d36613d70ffac9b964171cc/material/overrides/hooks/shortcodes.py
+#
+
+from __future__ import annotations
+
+import posixpath
+import re
+
+from mkdocs.config.defaults import MkDocsConfig
+from mkdocs.structure.files import File, Files
+from mkdocs.structure.pages import Page
+from re import Match
+
+def on_page_markdown(
+    markdown: str, *, page: Page, config: MkDocsConfig, files: Files
+):
+
+    # Replace callback
+    def replace(match: Match):
+        type, args = match.groups()
+        args = args.strip()
+        if type == "abstract":   return _admo(text = args, type = "abstract")
+        elif type == "info":     return _admo(text = args, type = "info")
+        elif type == "tip":      return _admo(text = args, type = "tip")
+        elif type == "success":  return _admo(text = args, type = "success")
+        elif type == "question": return _admo(text = args, type = "question")
+        elif type == "warning":  return _admo(text = args, type = "warning")
+        elif type == "failure":  return _admo(text = args, type = "failure")
+        elif type == "danger":   return _admo(text = args, type = "danger")
+        elif type == "bug":      return _admo(text = args, type = "bug")
+        elif type == "example":  return _admo(text = args, type = "example")
+        elif type == "quote":    return _admo(text = args, type = "quote")
+        else:                    return _admo(text = args)
+
+        # Otherwise, raise an error
+        raise RuntimeError(f"Unknown shortcode: {type}")
+
+    # Find and replace all external asset URLs in current page
+    return re.sub(
+        r"<!-- admo:(\w+)(.*?) -->",
+        replace, markdown, flags = re.I | re.M
+    )
+
+def _admo(text: str = "", type: str = ""):
+    classes = f"mdx-badge mdx-badge--{type}" if type else "mdx-badge"
+    iconClasses = f"mdx-badge__icon mdx-badge--{type}" if type else "mdx-badge__icon"
+    return "".join([
+        f"<div class=\"{classes}\">",
+        f"<span class=\"{iconClasses}\"></span>",
+        *([f"<span class=\"mdx-badge__text\">{text}</span>"] if text else []),
+        f"</div>",
+    ])

docs/.overrides/api-objects/info-template.html

@@ -149,7 +149,7 @@
       </h3>
       
       {% if detail.deprecated %}
-        <div class="admonition danger">
+        <div class="admonition deprecated">
           <div class="admonition-title">Deprecation Warning</div>
           <p>
             {{ detail.deprecated }}

docs/.snippets/api_version.md

@@ -0,0 +1 @@
+<div class="mdx-badge"><span class="mdx-badge__icon">[:octicons-tag-24:](changelog.md#v3.1.0 'View latest Release Changelog')</span><span class="mdx-badge__text">[v3.1.0](changelog.md#v3.1.0 'View latest Release Changelog')</span></div>

docs/.snippets/warn-header.md

@@ -0,0 +1 @@
+<div class="mdx-badge"><span class="mdx-badge__icon" >[:octicons-alert-24:](changelog.md)</span><span class="mdx-badge__text">[v3.1.0](changelog.md#v3.1.0 'View latest Release Changelog')</span></div>

docs/api/changelog.md

@@ -7,25 +7,34 @@ icon: octicons/log-24
 This page lists the recent changes made towards the AdvancedServerListAPI.  
 They are ordered newest to oldest.
 
-## v3.1.0
+## v3.1.0 { #v3.1.0 }
 
 ### :octicons-plus-circle-24:{ .changelog-added title="Added" } Added { #v3.1.0-added }
 
-- New getters in `ProfileEntry`:
-    - `maxPlayersEnabled()` - Returns the value for `playerCount -> maxPlayers -> enabled` as `NullBool`
-    - `maxPlayersCount()` - Returns the value of `playerCount -> maxPlayers -> amount` as nullable `Integer`
-- New setters in `ProfileEntry.Builder`:
-    - `setMaxPlayersEnabled(NullBool)` - Sets whether the max players feature is enabled or not.
-    - `setMaxPlayersCount(Integer)` - Sets the number to use for the max players count.
-    - `setExtraPlayersCount(Integer)` - Replacement for [deprecated `setExtraPlayerCount(Integer)` method](#v3.1.0-deprecated).
+- New getters in [`ProfileEntry`][profileentry]:
+    - [`maxPlayersEnabled()`][maxplayersenabled] - Returns the value for `playerCount -> maxPlayers -> enabled` as `NullBool`
+    - [`maxPlayersCount()`][maxplayerscount] - Returns the value of `playerCount -> maxPlayers -> amount` as nullable `Integer`
+- New setters in [`ProfileEntry.Builder`][profileentry.builder]:
+    - [`setMaxPlayersEnabled(NullBool)`][setmaxplayersenabled] - Sets whether the max players feature is enabled or not.
+    - [`setMaxPlayersCount(Integer)`][setmaxplayerscount] - Sets the number to use for the max players count.
+    - [`setExtraPlayersCount(Integer)`][setextraplayersecount] - Replacement for [deprecated `setExtraPlayerCount(Integer)` method](#v3.1.0-deprecated).
 
 ### :octicons-zap-24:{ .changelog-breaking title="Deprecated" } Deprecated { #v3.1.0-deprecated }
 
 - `setExtraPlayerEnabled(Integer)` in `ProfileEntry.Builder` - Typo in method name.
 
+[profileentry]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md
+[maxplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md#maxplayersenabled()
+[maxplayerscount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md#maxplayerscount()
+
+[profileentry.builder]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md
+[setmaxplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#setmaxplayersenabled(nullbool)
+[setmaxplayerscount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#setmaxplayerscount(integer)
+[setextraplayersecount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#setextraplayerscount(integer)
+
 ----
 
-## v3.0.0
+## v3.0.0 { #v3.0.0 }
 
 ### :octicons-alert-24:{ .changelog-breaking title="Breaking Changes" } Breaking Changes { #v3-breaking }
 
@@ -45,7 +54,7 @@ They are ordered newest to oldest.
 
 ----
 
-## v2.1.0
+## v2.1.0 { #v2.1.0 }
 
 ### :octicons-pencil-24:{ .changelog-changed title="Changed" } Changed { #v2.1.0-changed }
 
@@ -54,7 +63,7 @@ They are ordered newest to oldest.
 
 ----
 
-## v2.0.0
+## v2.0.0 { #v2.0.0 }
 
 ### :octicons-alert-24:{ .changelog-breaking title="Breaking Changes" } Breaking Changes { #v2-breaking }
 
@@ -85,7 +94,7 @@ They are ordered newest to oldest.
 
 ----
 
-## v1.0.0
+## v1.0.0 { #v1.0.0 }
 
 ### :octicons-plus-circle-24:{ .changelog-added title="Added" } Added { #v1-added }
 

docs/api/index.md

@@ -9,35 +9,10 @@ It provides a way for your plugin to provide its own placeholders that should be
 
 ## Add dependency
 
-Add the following to your `build.gradle` or `pom.xml` file to use the API:
-
-=== ":simple-gradle: Gradle"
-    
-    [![latest_release][release]][api-repo]
-    
-    Make sure to replace `{version}` with the version displayed above.
-    
-    ```groovy title="build.gradle"
-    repositorories {
-        maven { url = 'https://jitpack.io/' }
-    }
-    
-    dependencies {
-        implementation 'ch.andre601.asl-api:api:{version}'
-        
-        // Optional platform dependencies
-        implementation 'ch.andre601.asl-api:platform-bukkit:{version}'
-        implementation 'ch.andre601.asl-api:platform-bungeecord:{version}'
-        implementation 'ch.andre601.asl-api:platform-velocity:{version}'
-    }
-    ```
+Add the following to your `pom.xml`, `build.gradle` or `build.gradle.kts` depending on what you use:
 
 === ":simple-apachemaven: Maven"
     
-    [![latest_release][release]][api-repo]
-    
-    Make sure to replace `{version}` with the version displayed above.
-    
     ```xml title="pom.xml"
     <repositories>
       <repository>
@@ -51,6 +26,7 @@ Add the following to your `build.gradle` or `pom.xml` file to use the API:
         <groupId>ch.andre601.asl-api</groupId>
         <artifactId>api</artifactId>
         <version>{version}</version>
+        <scope>provided</scope>
       </dependency>
       
       <!-- Optional platform dependencies -->
@@ -58,38 +34,67 @@ Add the following to your `build.gradle` or `pom.xml` file to use the API:
         <groupId>ch.andre601.asl-api</groupId>
         <artifactId>platform-bukkit</artifactId>
         <version>{version}</version>
+        <scope>provided</scope>
       </dependency>
       <dependency>
         <groupId>ch.andre601.asl-api</groupId>
         <artifactId>platform-bungeecord</artifactId>
         <version>{version}</version>
+        <scope>provided</scope>
       </dependency>
       <dependency>
         <groupId>ch.andre601.asl-api</groupId>
         <artifactId>platform-velocity</artifactId>
         <version>{version}</version>
+        <scope>provided</scope>
       </dependency>
     </dependencies>
     ```
+=== ":simple-gradle: Gradle"
+    
+    ```groovy title="build.gradle"
+    repositorories {
+        maven { url = 'https://jitpack.io/' }
+    }
+    
+    dependencies {
+        compileOnly 'ch.andre601.asl-api:api:{version}'
+        
+        // Optional platform dependencies
+        compileOnly 'ch.andre601.asl-api:platform-bukkit:{version}'
+        compileOnly 'ch.andre601.asl-api:platform-bungeecord:{version}'
+        compileOnly 'ch.andre601.asl-api:platform-velocity:{version}'
+    }
+    ```
+=== ":simple-gradle: Gradle (KTS)"
+    ```kotlin title="build.gradle.kts"
+    repositories {
+        maven("https://jitpack.io")
+    }
+    
+    dependencies {
+        compileOnly("ch.andre601.asl-api:api:{version}")
+        
+        // Optional platform dependencies
+        compileOnly("ch.andre601.asl-api:platform-bukkit:{version}")
+        compileOnly("ch.andre601.asl-api:platform-bungeecord:{version}")
+        compileOnly("ch.andre601.asl-api:platform-velocity:{version}")
+    }
+    ```
 
-[release]: https://img.shields.io/github/v/tag/Andre601/asl-api?labelColor=252631&color=292a36&style=for-the-badge&label=Latest%20Release:
-[api-repo]: https://github.com/Andre601/asl-api
+## Adding your own Placeholders
 
-## Add own placeholders
+<!-- admo:info This requires the main api module -->
 
-To add your own placeholders will you need to do a few steps.
+The API allows you to add your own placeholders which would be available through the `${<identifier> <values>}` placeholder Pattern in a Server List profile.
 
-### 1) Get API instance
+To add your own placeholders, follow these steps:
 
-Use `AdvancedServerListAPI.get()` to retrieve an instance of the currently used AdvancedServerList API.  
-It will be needed at a later point.
+### 1. Create a Placeholder class
 
-### 2) Create a Placeholder class
+You should first create a new class and make it extend the abstract [`PlaceholderProvider`][placeholderprovider]. This class includes a constructor and a method you need to add, so do that:
 
-Make a new class that you want to use for the placeholders and let it extend the `PlaceholderProvider` class of AdvancedServerList.  
-Your IDE should now tell you to implement/override some methods. Confirm this action and your class should look something alongside this:
-
-```java title="PlaceholderProvider example"
+```java
 public class MyPlaceholders extends PlaceholderProvider {
     
     public MyPlaceholders(String identifier) {
@@ -103,60 +108,258 @@ public class MyPlaceholders extends PlaceholderProvider {
 }
 ```
 
-It's recommended to replace your generated constructor with a no-args one and set the identifier directly in the `super()`.  
-For example:
-
-```java
-public MyPlaceholders() {
-    super("myplaceholders");
-}
-```
-
-The next step now would be to handle the different placeholders. These are handled in the `parsePlaceholder` method you had to override.  
-The `placeholder` String is whatever value was provided after the identifier in `${<identifier> <placeholder>}`. It can contain spaces.
-
-Something to note is, that when returning `null` will AdvancedServerList understand it as an invalid placeholder and return it unchanged.
-
-Here is a small example of the final class:
-
-```java title="PlaceholderProvider example"
-public class MyPlaceholders extends PlaceholderProvider {
-    
+!!! tip
+    You can replace the Constructor with a String argument with a no-args constructor and set the identifier directly in the `super`:
+    ```java
     public MyPlaceholders() {
         super("myplaceholders");
     }
+    ```
+
+The [`parsePlaceholder(String, GenericPlayer, GenericServer)`][parseplaceholder] method is used by AdvancedServerList to replace a matching placeholder with a value.  
+What you return is completely up to you. Just keep in mind that returning `null` will be treated as an invalid placeholder by AdvancedServerList, resulting in the placeholder being returned as-is without any changes.
+
+[placeholderprovider]: reference/api/ch.andre601.advancedserverlist.api/placeholderprovider.md
+[parseplaceholder]: reference/api/ch.andre601.advancedserverlist.api/placeholderprovider.md#parseplaceholder(string,-genericplayer,-genericserver)
+
+??? example "Example of final class"
+    ```java
+    public class MyPlaceholders extends PlaceholderProvider {
+        
+        public MyPlaceholders() {
+            super("myplaceholders");
+        }
+        
+        @Override
+        public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server) {
+            if(placeholder.equalsIgnoreCase("hello"))
+                return "Hello " + player.getName();
+            
+            return null;
+        }
+    }
+    ```
+
+### 2. Register the Placeholders
+
+Next step should be to register the placeholder. To achieve this, first obtain an instance of the [`AdvancedServerListAPI`][advancedserverlistapi] by using the static [`get()`][get] method. After that call [`addPlaceholderProvider(PlaceholderProvider placeholderProvider)`][addplaceholderprovider].  
+Your code may look similar to this:
+
+```java title="Registering PlaceholderProvider class"
+public class MyPlugin extends JavaPlugin {
     
     @Override
-    public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server) {
-        if(placeholder.equals("hello"))
-            return "Hi!";
+    public void onEnable() {
+        AdvancedServerListAPI api = AdvancedServerListAPI.get();
         
-        return null;
+        api.addPlaceholderProvider(new MyPlaceholders());
     }
 }
 ```
 
-### 3) Register the placeholder class
+[advancedserverlistapi]: reference/api/ch.andre601.advancedserverlist.api/advancedserverlistapi.md
+[get]: reference/api/ch.andre601.advancedserverlist.api/advancedserverlistapi.md#get()
+[addplaceholderprovider]: reference/api/ch.andre601.advancedserverlist.api/advancedserverlistapi.md#addplaceholderprovider(placeholderprovider)
 
-All that is left to do now is to register your class as a new PlaceholderProvider instance. To do this, get the API instance you retrieved earlier and use `addPlaceholderProvider` with a new instance of your class.
+This should register your PlaceholderExpansion as long as it is valid, meaning that the identifier...
 
-```java title="Registering PlaceholderProvider class"
-AdvancedServerListAPI api = AdvancedServerListAPI.get();
+- ...is not `null`
+- ...is not containing spaces
+- ...is not using a name already registered in the API
 
-api.addPlaceholderProvider(new MyPlaceholders());
-```
+### 3. Declare AdvancedServerList as (soft)depend
 
-## Events
+The final thing you should make sure is to define AdvancedServerList as a depend or soft-depend for your plugin, to make sure it loads after AdvancedServerList.
 
-!!! info "Note"
-    The mentioned event is only accessible through one of the platform dependencies, as those are used in the platform's respective event handler system.
+Below are example setups for Spigot, Paper, BungeeCord and Velocity:
 
-v2 of the API adds the `PreServerListSetEvent` to the different platform dependencies to use.  
-It allows you to modify the ProfileEntry used for the player pinging the server/proxy or even cancelling the event altogether.
+=== ":simple-spigotmc: Spigot"
+    === "Softdepend"
+        ```yaml title="plugin.yml"
+        name: "MyPlugin"
+        author: "author"
+        version: "1.0.0"
+        
+        main: "com.example.plugin.ExamplePlugin"
+        
+        softdepend:
+          - AdvancedServerList
+        ```
+    === "Depend"
+        ```yaml title="plugin.yml"
+        name: "MyPlugin"
+        author: "author"
+        version: "1.0.0"
+        
+        main: "com.example.plugin.ExamplePlugin"
+        
+        depend:
+          - AdvancedServerList
+        ```
+=== ":fontawesome-solid-paper-plane: Paper"
+    === "Softdepend"
+        ```yaml title="paper-plugin.yml"
+        name: "MyPlugin"
+        author: "author"
+        version: "1.0.0"
+        
+        main: "com.example.plugin.ExamplePlugin"
+        
+        dependencies:
+          server:
+            AdvancedServerList:
+              load: BEFORE
+              required: false # Default, not required
+        ```
+    === "Depend"
+        ```yaml title="paper-plugin.yml"
+        name: "MyPlugin"
+        author: "author"
+        version: "1.0.0"
+        
+        main: "com.example.plugin.ExamplePlugin"
+        
+        dependencies:
+          server:
+            AdvancedServerList:
+              load: BEFORE
+              required: true
+        ```
+=== ":octicons-git-merge-24: BungeeCord"
+    === "Softdepend"
+        ```yaml title="bungee.yml"
+        name: "MyPlugin"
+        author: "author"
+        version: "1.0.0"
+        
+        main: "com.example.plugin.ExamplePlugin"
+        
+        softDepends:
+          - AdvancedServerList
+        ```
+    === "Depend"
+        ```yaml title="bungee.yml"
+        name: "MyPlugin"
+        author: "author"
+        version: "1.0.0"
+        
+        main: "com.example.plugin.ExamplePlugin"
+        
+        depends:
+          - AdvancedServerList
+        ```
+=== ":octicons-git-merge-24: Velocity"
+    === "Softdepend (File)"
+        ```json title="velocity-plugin.json"
+        {
+          "id": "myplugin",
+          "name": "MyPlugin",
+          "version": "1.0.0",
+          "authors": [
+            "author"
+          ],
+          "main": "com.example.plugin.ExamplePlugin",
+          "dependencies": [
+            {
+              "id": "advancedserverlist",
+              "optional": true
+            }
+          ]
+        }
+        ```
+    === "Depend (File)"
+        ```json title="velocity-plugin.json"
+        {
+          "id": "myplugin",
+          "name": "MyPlugin",
+          "version": "1.0.0",
+          "authors": [
+            "author"
+          ],
+          "main": "com.example.plugin.ExamplePlugin",
+          "dependencies": [
+            {
+              "id": "advancedserverlist",
+              "optional": false
+            }
+          ]
+        }
+        ```
+    === "Softdepend (Annotation)"
+        ```java title="MyPlugin.java"
+        @Plugin(
+          id = "myplugin",
+          name = "MyPlugin",
+          version = "1.0.0",
+          authors = {"author"},
+          dependencies = {
+            @Dependency(
+              id = "advancedserverlist",
+              optional = true
+            )
+          }
+        )
+        public class MyPlugin {
+          
+          // ...
+          
+        }
+        ```
+    === "Depend (Annotation)"
+        ```java title="MyPlugin.java"
+        @Plugin(
+          id = "myplugin",
+          name = "MyPlugin",
+          version = "1.0.0",
+          authors = {"author"},
+          dependencies = {
+            @Dependency(
+              id = "advancedserverlist",
+              optional = false // Default, not required
+            )
+          }
+        )
+        public class MyPlugin {
+          
+          // ...
+          
+        }
+        ```
+
+### 4. You're done!
+
+Your plugin should now hook into AdvancedServerList and register its own custom placeholders to use.
+
+## Listening for events
+
+<!-- admo:info This requires the platform specific dependencies -->
+
+AdvancedServerList provides an Event that your plugin can listen for.  
+The event is called `PreServerListSetEvent` and provides the following methods to use:
+
+- [`getEntry()`][getentry] - Gets the currently set [`ProfileEntry`][profileentry].
+- [`setEntry(ProfileEntry)`][setentry] - Sets a new [`ProfileEntry`][profileentry] to use.
+- [`isCancelled()`][iscancelled] - Gets the current cancelled state of the event.
+- [`setCancelled(boolean)`][setcancelled] - Sets the current cancelled state.
+
+Setting the event's cancelled state to true will result in AdvancedServerList not altering the Server list.
+
+Please check the server/proxy's documentation on how to listen for events with your plugin.
+
+[getentry]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry()
+[setentry]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#setentry(profileentry)
+[iscancelled]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#iscancelled()
+[setcancelled]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#setcancelled(boolean)
+
+[profileentry]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md
 
 ### ProfileEntry
 
-The ProfileEntry class has been moved to the API in v2 allowing you to create your own versions using the available Builder class.
+The ProfileEntry record is the core class used within the `PreServerListSetEvent`. It sets what values (MOTD, Favicon, Players, etc.) should be displayed.  
+Note that the record is - by nature - immutable and that the [`Builder`][builder] class should be used to create a new ProfileEntry instance to use.
 
-This class contains values from a Server List Profile file. The values can either be from a `profiles` list entry, one of the global options in the file, or a mix of both, depending on what options are present.  
-You can create a new entry or copy an existing one (i.e. from the [`PreServerListSetEvent`](#events)) to modify and use in the server list by setting it in the aforementioned `PreServerListSetEvent`.
+A convenience method exists to create a `Builder` instance from an existing `ProfileEntry` in case you only want to alter certain options while everything else unchanged.
+
+This allows you to customize the Server list using your plugin. Just keep in mind that other plugins may also do the same, overriding your changes.
+
+[builder]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md

docs/api/javadocs.md

@@ -0,0 +1,10 @@
+---
+template: redirect.html
+
+location: https://docs.andre601.ch/asl-api
+
+title: Javadocs
+icon: octicons/link-external-24
+---
+
+<!-- Comment to trigger proper build -->

docs/api/reference/structure.md

@@ -27,7 +27,7 @@ An example class to show how the page structure may look like.
 ## custom HTML tags
 
 There is a collection of custom HTML tags that are used to render specific text in certain styles.  
-Below is a list of all custom tags. Note that these tags only render on the actual site and not within the repository.
+Below is a list of all custom tags. Note that these tags only render on the actual site and not within the repository when viewing the source.
 
 - `<api__class></api__class>`: <api__class></api__class>
 - `<api__interface></api__interface>`: <api__interface></api__interface>
@@ -43,12 +43,12 @@ Below is a list of all custom tags. Note that these tags only render on the actu
 In addition are there two classes used within `span` tags to colour the text, to indicate their type:
 
 - `<span class="api-type__object">Object</span>`: <span class="api-type__object">Object</span>
-- `<span class="api-type__primitive">Object</span>`: <span class="api-type__primitive">Primitive</span>
+- `<span class="api-type__primitive">primitive</span>`: <span class="api-type__primitive">primitive</span>
 
 ## Auto-generated content
 
-The page template used checks for specific YAML frontmatter in the page to include other templates.  
-These templates pull the data from the YAML frontmatter to generate the page content which is then appendet to the already existing page content.
+A page template is used to auto-generate the page content based on available YAML frontmatter.  
+Depending on the frontmatter available will the template call a jinja2 Macro to generate a Summary and Detailed info on the page for the respective frontmatter data.
 
 There are 5 frontmatter options, each following a specific structure:
 
@@ -88,7 +88,7 @@ constructors:
     - `description` - Description of the parameter.
     - `type` - The type this parameter is.
     - `attributes` - List of attributes (i.e. nullability) to display. The provided values will be turned into `<api__{name}></api__{name}>` tags that will be prependet to the parameter name.
-- `deprecated` - Adds a notice about the deprecation of this Constructor in the form of a deprecation label and a `deprecated` section with the provided explanation.
+- `deprecated` - Adds a notice about the deprecation of this Constructor in the form of a deprecation label and a `deprecated` section with the provided `<string>` as explanation.
 - `throws` - List of possible throws to display.
     - `name` - Name of the throw to display.
     - `description` - Description of the throw.
@@ -128,10 +128,10 @@ enums:
 
 **Options:**
 
-- `name` - The name to display for the Constructor summary and detail. This should include any parameters the Constructor has, but without any parameter name.
-- `description` - The description to display for the Constructor.
+- `name` - The name to display for the Enum summary and detail. This should include any parameters the Enum has, but without any parameter name.
+- `description` - The description to display for the Enum.
 - `type` - The return type to display. Will default to `{{ page.title }}` if not set.
-- `deprecated` - Adds a notice about the deprecation of this Enum in the form of a deprecation label and a `deprecated` section with the provided explanation.
+- `deprecated` - Adds a notice about the deprecation of this Enum in the form of a deprecation label and a `deprecated` section with the provided `<string>` as explanation.
 - `seealso` - List of "See also" text to display.
     - `name` - Name of the See also link.
     - `link` - Link (Relative, absolute or URL) to use for the See also text.
@@ -166,8 +166,8 @@ methods:
 
 **Options:**
 
-- `name` - The name to display for the Constructor summary and detail. This should include any parameters the Constructor has, but without any parameter name.
-- `description` - The description to display for the Constructor.
+- `name` - The name to display for the Method summary and detail. This should include any parameters the Method has, but without any parameter name.
+- `description` - The description to display for the Method.
 - `type` - Options for object type to display.
     - `name` - Displayed name of the object.
     - `type` - Object type. Can be either `object` or `primitive` which would be used in a class name for styling.
@@ -179,7 +179,7 @@ methods:
     - `type` - The type this parameter is.
     - `attributes` - List of attributes (i.e. nullability) to display. The provided values will be turned into `<api__{name}></api__{name}>` tags that will be prependet to the parameter name.
 - `returns` - Possible return values.
-- `deprecated` - Adds a notice about the deprecation of this Method in the form of a deprecation label and a `deprecated` section with the provided explanation.
+- `deprecated` - Adds a notice about the deprecation of this Method in the form of a deprecation label and a `deprecated` section with the provided `<string>` as explanation.
 - `throws` - List of possible throws to display.
     - `name` - Name of the throw to display.
     - `description` - Description of the throw.

docs/assets/js/repo-stats.js

@@ -2,7 +2,7 @@ document$.subscribe(async () => {
     const url = 'https://codeberg-stats-proxy.vercel.app/repo'
     const repo_stats = document.querySelector('[data-md-component="source"] .md-source__repository');
     
-    function loadInfo(data) {
+    function loadCodebergInfo(data) {
         const facts = document.createElement("ul");
         facts.className = "md-source__facts";
         
@@ -26,6 +26,26 @@ document$.subscribe(async () => {
         repo_stats.appendChild(facts);
     }
     
+    function loadApiInfo(data) {
+        const version = data["version"];
+        const versionToken = '{version}';
+        const codeBlocks = document.querySelectorAll('.md-content pre code');
+        for(const codeBlock of codeBlocks) {
+            codeBlock.innerHTML = codeBlock.innerHTML.replace(new RegExp(versionToken, 'g'), version);
+        }
+    }
+    
+    async function fetchApiInfo() {
+        const tag = await fetch("https://api.github.com/repos/Andre601/asl-api/releases/latest").then(_ => _.json());
+        
+        const data = {
+            "version": tag.tag_name
+        };
+        
+        __md_set("__api_tag", data, sessionStorage);
+        loadApiInfo(data);
+    }
+    
     async function fetchInfo() {
         const [release, repo] = await Promise.all([
             fetch(`${url}/latest-release`).then(_ => _.json()),
@@ -39,15 +59,24 @@ document$.subscribe(async () => {
         };
         
         __md_set("__git_repo", data, sessionStorage);
-        loadInfo(data);
+        loadCodebergInfo(data);
     }
     
-    if(!document.querySelector('[data-md-component="source"] .md-source__facts')){
+    if(!document.querySelector('[data-md-component="source"] .md-source__facts')) {
         const cached = __md_get("__git_repo", sessionStorage);
         if((cached != null) && (cached["version"])) {
-            loadInfo(cached);
+            loadCodebergInfo(cached);
         } else {
             fetchInfo();
         }
     }
+    
+    if(location.href.includes('/api/')) {
+        const cachedApi = __md_get("__api_tag", sessionStorage);
+        if((cachedApi != null) && (cachedApi["version"])) {
+            loadApiInfo(cachedApi);
+        } else {
+            fetchApiInfo();
+        }
+    }
 })

docs/assets/stylesheets/admo.css

@@ -0,0 +1,257 @@
+:root {
+    --md-badge-fg--note: #448aff;
+    --md-badge-bg--note: #448aff1a;
+    --md-badge-fg--abstract: #00b0ff;
+    --md-badge-bg--abstract: #00b0ff1a;
+    --md-badge-fg--info: #00b8d4;
+    --md-badge-bg--info: #00b8d41a;
+    --md-badge-fg--tip: #00bfa5;
+    --md-badge-bg--tip: #00bfa51a;
+    --md-badge-fg--success: #00c853;
+    --md-badge-bg--success: #00c8531a;
+    --md-badge-fg--question: #64dd17;
+    --md-badge-bg--question: #64dd171a;
+    --md-badge-fg--warning: #ff9100;
+    --md-badge-bg--warning: #ff91001a;
+    --md-badge-fg--failure: #ff5252;
+    --md-badge-bg--failure: #ff52521a;
+    --md-badge-fg--danger: #ff1744;
+    --md-badge-bg--danger: #ff17441a;
+    --md-badge-fg--bug: #f50057;
+    --md-badge-bg--bug: #f500571a;
+    --md-badge-fg--example: #7c4dff;
+    --md-badge-bg--example: #7c4dff1a;
+    --md-badge-fg--quote: #9e9e9e;
+    --md-badge-bg--quote: #9e9e9e1a;
+    
+    --badge-icon--note: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M17.263 2.177a1.75 1.75 0 0 1 2.474 0l2.586 2.586a1.75 1.75 0 0 1 0 2.474L19.53 10.03l-.012.013L8.69 20.378a1.753 1.753 0 0 1-.699.409l-5.523 1.68a.748.748 0 0 1-.747-.188.748.748 0 0 1-.188-.747l1.673-5.5a1.75 1.75 0 0 1 .466-.756L14.476 4.963ZM4.708 16.361a.26.26 0 0 0-.067.108l-1.264 4.154 4.177-1.271a.253.253 0 0 0 .1-.059l10.273-9.806-2.94-2.939-10.279 9.813ZM19 8.44l2.263-2.262a.25.25 0 0 0 0-.354l-2.586-2.586a.25.25 0 0 0-.354 0L16.061 5.5Z"></path></svg>');
+    --badge-icon--abstract: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M5.962 2.513a.75.75 0 0 1-.475.949l-.816.272a.25.25 0 0 0-.171.237V21.25c0 .138.112.25.25.25h14.5a.25.25 0 0 0 .25-.25V3.97a.25.25 0 0 0-.17-.236l-.817-.272a.75.75 0 0 1 .474-1.424l.816.273A1.751 1.751 0 0 1 21 3.97v17.28A1.75 1.75 0 0 1 19.25 23H4.75A1.75 1.75 0 0 1 3 21.25V3.97a1.75 1.75 0 0 1 1.197-1.66l.816-.272a.75.75 0 0 1 .949.475Z"></path><path d="M7 1.75C7 .784 7.784 0 8.75 0h6.5C16.216 0 17 .784 17 1.75v1.5A1.75 1.75 0 0 1 15.25 5h-6.5A1.75 1.75 0 0 1 7 3.25Zm1.75-.25a.25.25 0 0 0-.25.25v1.5c0 .138.112.25.25.25h6.5a.25.25 0 0 0 .25-.25v-1.5a.25.25 0 0 0-.25-.25Z"></path></svg>');
+    --badge-icon--info: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M13 7.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Zm-3 3.75a.75.75 0 0 1 .75-.75h1.5a.75.75 0 0 1 .75.75v4.25h.75a.75.75 0 0 1 0 1.5h-3a.75.75 0 0 1 0-1.5h.75V12h-.75a.75.75 0 0 1-.75-.75Z"></path><path d="M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1ZM2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5 9.5 9.5 0 0 0 2.5 12Z"></path></svg>');
+    --badge-icon--tip: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M14.265 1.627c0 3.545 1.869 5.327 3.479 7.021 1.54 1.62 3.006 3.163 3.006 6.102 0 4.812-3.753 8.25-8.565 8.25-4.813 0-8.935-3.421-8.935-8.25 0-2.039.962-4.011 2.509-4.899.305-.175.672.007.803.334C7.563 12.684 8.797 12.64 9.437 12c.388-.387.47-1.116-.004-2.062-2.405-4.812 1.863-8.279 4.2-8.854.336-.082.615.198.632.543ZM12.185 21.5c4.059 0 7.065-2.84 7.065-6.75 0-2.337-1.093-3.489-2.678-5.158l-.021-.023c-1.44-1.517-3.139-3.351-3.649-6.557a6.148 6.148 0 0 0-1.911 1.76c-.787 1.144-1.147 2.633-.216 4.495.603 1.205.777 2.74-.277 3.794-.657.657-1.762 1.1-2.956.586-.752-.324-1.353-.955-1.838-1.79-.567.706-.954 1.74-.954 2.893 0 3.847 3.288 6.75 7.435 6.75Z"></path></svg>');
+    --badge-icon--success: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M21.03 5.72a.75.75 0 0 1 0 1.06l-11.5 11.5a.747.747 0 0 1-1.072-.012l-5.5-5.75a.75.75 0 1 1 1.084-1.036l4.97 5.195L19.97 5.72a.75.75 0 0 1 1.06 0Z"></path></svg>');
+    --badge-icon--question: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M10.97 8.265a1.45 1.45 0 0 0-.487.57.75.75 0 0 1-1.341-.67c.2-.402.513-.826.997-1.148C10.627 6.69 11.244 6.5 12 6.5c.658 0 1.369.195 1.934.619a2.45 2.45 0 0 1 1.004 2.006c0 1.033-.513 1.72-1.027 2.215-.19.183-.399.358-.579.508l-.147.123a4.329 4.329 0 0 0-.435.409v1.37a.75.75 0 1 1-1.5 0v-1.473c0-.237.067-.504.247-.736.22-.28.486-.517.718-.714l.183-.153.001-.001c.172-.143.324-.27.47-.412.368-.355.569-.676.569-1.136a.953.953 0 0 0-.404-.806C12.766 8.118 12.384 8 12 8c-.494 0-.814.121-1.03.265ZM13 17a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path><path d="M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1ZM2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5 9.5 9.5 0 0 0 2.5 12Z"></path></svg>');
+    --badge-icon--warning: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M13 17.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Zm-.25-8.25a.75.75 0 0 0-1.5 0v4.5a.75.75 0 0 0 1.5 0v-4.5Z"></path><path d="M9.836 3.244c.963-1.665 3.365-1.665 4.328 0l8.967 15.504c.963 1.667-.24 3.752-2.165 3.752H3.034c-1.926 0-3.128-2.085-2.165-3.752Zm3.03.751a1.002 1.002 0 0 0-1.732 0L2.168 19.499A1.002 1.002 0 0 0 3.034 21h17.932a1.002 1.002 0 0 0 .866-1.5L12.866 3.994Z"></path></svg>');
+    --badge-icon--failure: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M5.72 5.72a.75.75 0 0 1 1.06 0L12 10.94l5.22-5.22a.749.749 0 0 1 1.275.326.749.749 0 0 1-.215.734L13.06 12l5.22 5.22a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L12 13.06l-5.22 5.22a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L10.94 12 5.72 6.78a.75.75 0 0 1 0-1.06Z"></path></svg>');
+    --badge-icon--danger: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M15.716 1.329a1.341 1.341 0 0 1 2.109 1.55L15.147 9h4.161c1.623 0 2.372 2.016 1.143 3.075L8.102 22.721a1.148 1.148 0 0 1-1.81-1.317L8.996 15H4.674c-1.619 0-2.37-2.008-1.148-3.07l12.19-10.6Zm.452 1.595L4.51 13.061a.25.25 0 0 0 .164.439h5.45a.749.749 0 0 1 .692 1.041l-2.559 6.066 11.215-9.668a.25.25 0 0 0-.164-.439H14a.75.75 0 0 1-.687-1.05Z"></path></svg>');
+    --badge-icon--bug: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M7.72.22a.75.75 0 0 1 1.06 0l1.204 1.203A4.98 4.98 0 0 1 12 1c.717 0 1.4.151 2.016.423L15.22.22a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-.971.972A4.991 4.991 0 0 1 17 6v1.104a2.755 2.755 0 0 1 1.917 1.974l1.998-.999a.75.75 0 0 1 .67 1.342L19 10.714V13.5l3.25.003a.75.75 0 0 1 0 1.5L19 15.001V16c0 .568-.068 1.134-.204 1.686l.04.018 2.75 1.375a.75.75 0 1 1-.671 1.342l-2.638-1.319A6.998 6.998 0 0 1 12 23a6.998 6.998 0 0 1-6.197-3.742l-2.758 1.181a.752.752 0 0 1-1.064-.776.752.752 0 0 1 .474-.602l2.795-1.199A6.976 6.976 0 0 1 5 16v-.996H1.75a.75.75 0 0 1 0-1.5H5v-2.79L2.415 9.42a.75.75 0 0 1 .67-1.342l1.998.999A2.756 2.756 0 0 1 7 7.104V6a4.99 4.99 0 0 1 1.69-3.748l-.97-.972a.75.75 0 0 1 0-1.06ZM6.5 9.75V16a5.5 5.5 0 1 0 11 0V9.75c0-.69-.56-1.25-1.25-1.25h-8.5c-.69 0-1.25.56-1.25 1.25ZM8.5 7h7V6a3.5 3.5 0 1 0-7 0Z"></path></svg>');
+    --badge-icon--example: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M8 8.807V3.5h-.563a.75.75 0 0 1 0-1.5h9.125a.75.75 0 0 1 0 1.5H16v5.307l5.125 9.301c.964 1.75-.302 3.892-2.299 3.892H5.174c-1.998 0-3.263-2.142-2.3-3.892ZM4.189 18.832a1.123 1.123 0 0 0 .985 1.668h13.652a1.123 1.123 0 0 0 .985-1.668L17.7 15H6.3ZM14.5 3.5h-5V9a.75.75 0 0 1-.093.362L7.127 13.5h9.746l-2.28-4.138A.75.75 0 0 1 14.5 9Z"></path></svg>');
+    --badge-icon--quote: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M3 6.25a.75.75 0 0 1 .75-.75h13.5a.75.75 0 0 1 0 1.5H3.75A.75.75 0 0 1 3 6.25Zm5 6.063a.75.75 0 0 1 .75-.75h11.5a.75.75 0 0 1 0 1.5H8.75a.75.75 0 0 1-.75-.75Zm0 5.937a.75.75 0 0 1 .75-.75h11.5a.75.75 0 0 1 0 1.5H8.75a.75.75 0 0 1-.75-.75ZM3.75 11a.75.75 0 0 1 .75.75v7a.75.75 0 0 1-1.5 0v-7a.75.75 0 0 1 .75-.75Z"></path></svg>');
+}
+
+.md-typeset .mdx-badge {
+    font-size: .85em;
+    border: .075rem solid var(--md-badge-fg--note);
+    border-radius: .1rem;
+    padding: .3rem;
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon {
+    background: var(--md-accent-fg-color--transparent);
+    padding: .5rem .3rem;
+    margin-left: -.3rem;
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon::before {
+    content: "";
+    
+    background-color: var(--md-badge-fg--note);
+    
+    mask-position: center;
+    mask-repeat: no-repeat;
+    mask-size: contain;
+    
+    display: inline-block;
+    
+    height: 1rem;
+    width: 1rem;
+    
+    vertical-align: middle;
+    
+    -webkit-mask-image: var(--badge-icon--note);
+    mask-image: var(--badge-icon--note);
+}
+
+.md-typeset .mdx-badge__text {
+    padding: .3rem .3rem;
+    margin: .3rem;
+}
+
+/*
+ * Types
+ */
+
+/* Abstract */
+.md-typeset .mdx-badge.mdx-badge--abstract {
+    border-color: var(--md-badge-fg--abstract);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--abstract {
+    background-color: var(--md-badge-bg--abstract);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--abstract::before {
+    background-color: var(--md-badge-fg--abstract);
+    
+    mask-image: var(--badge-icon--abstract);
+    -webkit-mask-image: var(--badge-icon--abstract);
+}
+
+/* Info */
+.md-typeset .mdx-badge.mdx-badge--info {
+    border-color: var(--md-badge-fg--info);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--info {
+    background-color: var(--md-badge-bg--info);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--info::before {
+    background-color: var(--md-badge-fg--info);
+    
+    mask-image: var(--badge-icon--info);
+    -webkit-mask-image: var(--badge-icon--info);
+}
+
+/* Tip */
+.md-typeset .mdx-badge.mdx-badge--tip {
+    border-color: var(--md-badge-fg--tip);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--tip {
+    background-color: var(--md-badge-bg--tip);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--tip::before {
+    background-color: var(--md-badge-fg--tip);
+    
+    mask-image: var(--badge-icon--tip);
+    -webkit-mask-image: var(--badge-icon--tip);
+}
+
+/* Success */
+.md-typeset .mdx-badge.mdx-badge--success {
+    border-color: var(--md-badge-fg--success);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--success {
+    background-color: var(--md-badge-bg--success);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--success::before {
+    background-color: var(--md-badge-fg--success);
+    
+    mask-image: var(--badge-icon--success);
+    -webkit-mask-image: var(--badge-icon--success);
+}
+
+/* Question */
+.md-typeset .mdx-badge.mdx-badge--question {
+    border-color: var(--md-badge-fg--question);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--question {
+    background-color: var(--md-badge-bg--question);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--question::before {
+    background-color: var(--md-badge-fg--question);
+    
+    mask-image: var(--badge-icon--question);
+    -webkit-mask-image: var(--badge-icon--question);
+}
+
+/* Warning */
+.md-typeset .mdx-badge.mdx-badge--warning {
+    border-color: var(--md-badge-fg--warning);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--warning {
+    background-color: var(--md-badge-bg--warning);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--warning::before {
+    background-color: var(--md-badge-fg--warning);
+    
+    mask-image: var(--badge-icon--warning);
+    -webkit-mask-image: var(--badge-icon--warning);
+}
+
+/* Failure */
+.md-typeset .mdx-badge.mdx-badge--failure {
+    border-color: var(--md-badge-fg--failure);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--failure {
+    background-color: var(--md-badge-bg--failure);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--failure::before {
+    background-color: var(--md-badge-fg--failure);
+    
+    mask-image: var(--badge-icon--failure);
+    -webkit-mask-image: var(--badge-icon--failure);
+}
+
+/* Danger */
+.md-typeset .mdx-badge.mdx-badge--danger {
+    border-color: var(--md-badge-fg--danger);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--danger {
+    background-color: var(--md-badge-bg--danger);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--danger::before {
+    background-color: var(--md-badge-fg--danger);
+    
+    mask-image: var(--badge-icon--danger);
+    -webkit-mask-image: var(--badge-icon--danger);
+}
+
+/* Bug */
+.md-typeset .mdx-badge.mdx-badge--bug {
+    border-color: var(--md-badge-fg--bug);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--bug {
+    background-color: var(--md-badge-bg--bug);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--bug::before {
+    background-color: var(--md-badge-fg--bug);
+    
+    mask-image: var(--badge-icon--bug);
+    -webkit-mask-image: var(--badge-icon--bug);
+}
+
+/* Example */
+.md-typeset .mdx-badge.mdx-badge--example {
+    border-color: var(--md-badge-fg--example);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--example {
+    background-color: var(--md-badge-bg--example);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--example::before {
+    background-color: var(--md-badge-fg--example);
+    
+    mask-image: var(--badge-icon--example);
+    -webkit-mask-image: var(--badge-icon--example);
+}
+
+/* Quote */
+.md-typeset .mdx-badge.mdx-badge--quote {
+    border-color: var(--md-badge-fg--quote);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--quote {
+    background-color: var(--md-badge-bg--quote);
+}
+
+.md-typeset .mdx-badge .mdx-badge__icon.mdx-badge--quote::before {
+    background-color: var(--md-badge-fg--quote);
+    
+    mask-image: var(--badge-icon--quote);
+    -webkit-mask-image: var(--badge-icon--quote);
+}

docs/assets/stylesheets/api-docs.css

@@ -20,6 +20,8 @@
     --color-api-bg__static: #00c8531a;
     --color-api-bg__final: #ff91001a;
     --color-api-bg__abstract: #00bfa51a;
+    
+    --md-admonition-icon--deprecated: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M16 1.75V3h5.25a.75.75 0 0 1 0 1.5H2.75a.75.75 0 0 1 0-1.5H8V1.75C8 .784 8.784 0 9.75 0h4.5C15.216 0 16 .784 16 1.75Zm-6.5 0V3h5V1.75a.25.25 0 0 0-.25-.25h-4.5a.25.25 0 0 0-.25.25ZM4.997 6.178a.75.75 0 1 0-1.493.144L4.916 20.92a1.75 1.75 0 0 0 1.742 1.58h10.684a1.75 1.75 0 0 0 1.742-1.581l1.413-14.597a.75.75 0 0 0-1.494-.144l-1.412 14.596a.25.25 0 0 1-.249.226H6.658a.25.25 0 0 1-.249-.226L4.997 6.178Z"></path><path d="M9.206 7.501a.75.75 0 0 1 .793.705l.5 8.5A.75.75 0 1 1 9 16.794l-.5-8.5a.75.75 0 0 1 .705-.793Zm6.293.793A.75.75 0 1 0 14 8.206l-.5 8.5a.75.75 0 0 0 1.498.088l.5-8.5Z"></path></svg>');
 }
 
 /* Page design */
@@ -148,4 +150,21 @@ api__record::before {
 .api-type__primitive {
     color: var(--color-api-fg-type__primitive);
     font-weight: bold;
+}
+
+.md-typeset .admonition.deprecated,
+.md-typeset details.deprecated {
+    border-color: var(--color-api-fg__deprecated);
+}
+
+.md-typeset .deprecated > .admonition-title,
+.md-typeset .deprecated > summary {
+    background-color: var(--color-api-bg__deprecated);
+}
+
+.md-typeset .deprecated > .admonition-title::before,
+.md-typeset .deprecated > summary::before {
+    background-color: var(--color-api-fg__deprecated);
+    -webkit-mask-image: var(--md-admonition-icon--deprecated);
+            mask-image: var(--md-admonition-icon--deprecated);
 }

docs/examples/index.md

@@ -6,7 +6,7 @@ icon: octicons/list-unordered-24
 
 ## About
 
-!!! warning "The below examples may only work in v1.10.0 or newer!"
+<!-- admo:info The below examples may only work in v1.10.0 or newer! -->
 
 This page lists some examples you may want to use for your proxy or server.
 
@@ -72,7 +72,7 @@ Examples that can be used with the Spigot or PaperMC version.
 
 ### Different profile for banned Player
 
-!!! warning "Requires a cached player to work reliably."
+<!-- admo:info Requires a cached player -->
 
 Displays a separate profile for when the player has been banned from the server.
 

docs/placeholderapi/index.md

@@ -6,23 +6,22 @@ icon: material/percent
 
 AdvancedServerList provides support for [PlaceholderAPI] placeholders to be used, while also providing its own set of placeholders.
 
-[placeholderapi]: https://www.spigotmc.org/resources/6245/
+[placeholderapi]: https://hangar.papermc.io/HelpChat/PlaceholderAPI
 
 ## Own placeholders
 
-The following list of placeholders is available for use through PlaceholderAPI.  
-Please note that they are only available through the Bukkit version of AdvancedServerList.
+The below listed placeholders can be used through PlaceholderAPI in other plugins.  
+Note that the values depend on the player it is used for, as AdvancedServerList will try and get a matching [Server List Profile](../profiles/index.md) to display values from.
 
-Also note, that AdvancedServerList will try to find and use a [Server List profile](../profiles/index.md) that has maching conditions for the player, before returning any placeholder values.  
-This means that the output of a placeholder depends on what profile (if any) matches for the player.
-
-| Placeholder               | Description                                                                   |
-|---------------------------|-------------------------------------------------------------------------------|
-| `%asl_favicon%`           | Gives the value of `favicon` from a matching Profile.                         |
-| `%asl_extra_players_max%` | Gives the value of `playerCount.extraPlayers.amount` from a matching Profile. |
-| `%asl_motd%`              | Gives the value of `motd` in the matching Profile.                            |
-| `%asl_playercount_hover%` | Gives the value of `playerCount.hover` from a matching Profile.               |
-| `%asl_playercount_text%`  | Gives the value of `playerCount.text` from a matching Profile.                |
+| Placeholder                  | Description                                                                                             |
+|------------------------------|---------------------------------------------------------------------------------------------------------|
+| `%asl_favicon%`              | Gives the value of `favicon` from a matching Profile.                                                   |
+| `%asl_extra_players_max%`    | Gives the value of `playerCount -> extraPlayers -> amount` from a matching Profile. Can return `null`.  |
+| `%asl_motd%`                 | Gives the value of `motd` in the matching Profile as a single String.                                   |
+| `%asl_playercount_hover%`    | Gives the value of `playerCount -> hover` from a matching Profile as a single String.                   |
+| `%asl_playercount_text%`     | Gives the value of `playerCount -> text` from a matching Profile.                                       |
+| `%asl_players_max%`          | Gives the value of `playerCount -> maxPlayers -> amount` from a matching Profile. Can return `null`.    |
+| `%asl_players_max_modified%` | Returns the output of `${server playersMax}`.                                                           |
 
 ## Using Placeholders in Server List profiles
 

docs/profiles/index.md

@@ -39,7 +39,7 @@ You can remove this option, or set it to an empty list (`conditions: []`) to alw
 
 The following operants are available and can be used in the conditions.
 
-!!! warning "Only one operant can be used per condition!"
+<!-- admo:warning Only one operant can be used per condition! -->
 
 | Operand | Description                                                            |
 |---------|------------------------------------------------------------------------|
@@ -58,7 +58,7 @@ The following operants are available and can be used in the conditions.
 
 ## Profiles
 
-!!! warning "Priority and Conditions are NOT supported!"
+<!-- admo:warning Priority and Conditions can NOT be used within profiles -->
 
 The `profiles` option allows you to set multiple MOTDs, player counts, etc. which the plugin would randomly choose from.  
 If an option such as motd is not present in an entry will it check the file for the option and use that if present.
@@ -226,7 +226,7 @@ To not override the player count, remove this option or set it to an empty Strin
 
 Contains options to modify how the `<max>` number in the player count should look like.
 
-!!! warning "Using this option will modify the `${server playersMax}` placeholder (Except in conditions)"
+<!-- admo:warning Using this option will modify the `${server playersMax}` placeholder (Except when used in conditions) -->
 
 #### Enabled { #extraplayers-enabled }
 
@@ -268,7 +268,7 @@ Note that this feature is ignored should [`extraPlayers`](#extraplayers) be enab
 In case [`hidePlayers`](#hideplayers) is enabled will the max player count not be displayed, but still changed by this option.  
 Should [`text`](#text) be set to a non-empty String will the max player count only be displayed when `${server playersMax}` is used.
 
-!!! warning "Using this option will modify the `${server playersMax}` placeholder (Except in conditions)"
+<!-- admo:warning Using this option will modify the `${server playersMax}` placeholder (Except when used in conditions) -->
 
 #### Enabled { #maxplayers-enabled }
 

mkdocs.yml

@@ -36,7 +36,7 @@ theme:
       note: 'octicons/tag-24'
       abstract: 'octicons/checklist-24'
       info: 'octicons/info-24'
-      tip: 'octicons/squirrel-24'
+      tip: 'octicons/flame-24'
       success: 'octicons/check-24'
       question: 'octicons/question-24'
       warning: 'octicons/alert-24'
@@ -49,6 +49,7 @@ theme:
 extra_css:
   - assets/stylesheets/custom.css
   - assets/stylesheets/api-docs.css
+  - assets/stylesheets/admo.css
 
 extra_javascript:
   - assets/js/repo-stats.js
@@ -86,3 +87,8 @@ markdown_extensions:
   - pymdownx.tabbed:
       alternate_style: true
   - pymdownx.details:
+  - pymdownx.snippets:
+      base_path: docs/.snippets
+
+hooks:
+  - docs/.hooks/badges.py

pom.xml

@@ -38,7 +38,7 @@
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.build.commit/>
         
-        <plugin.version>3.5.0</plugin.version>
+        <plugin.version>3.5.1</plugin.version>
         <plugin.description>Create multiple Server lists based on conditions.</plugin.description>
         
         <api.version>v3.1.0</api.version>

requirements.txt

@@ -1,4 +1,4 @@
-mkdocs-material==9.4.1
+mkdocs-material==9.4.5
 mkdocs-glightbox==0.3.4
 mkdocs-awesome-pages-plugin==2.9.2
 git+https://github.com/Andre601/mkdocs-pagenav-generator

velocity/pom.xml

@@ -106,7 +106,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.5.0</version>
+                <version>3.5.1</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <relocations>

version-uploader/pom.xml

@@ -109,7 +109,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.5.0</version>
+                <version>3.5.1</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                 </configuration>

version-uploader/src/main/java/ch/andre601/advancedserverlist/versionuploader/VersionUploader.java

@@ -85,7 +85,7 @@ public class VersionUploader{
                 return;
             }
             default -> {
-                LOGGER.warn("Unknown argument '{}' provided. Supported are '--all', '--modrinth' and '--hangar'", args[0]);
+                LOGGER.warn("Unknown argument '{}' provided. Supported are '--all', '--modrinth', '--hangar' and '--dryrun'", args[0]);
                 System.exit(1);
                 return;
             }

version-uploader/src/main/java/ch/andre601/advancedserverlist/versionuploader/hangar/HangarVersionUploader.java

@@ -101,7 +101,7 @@ public class HangarVersionUploader{
         final List<Dependency> bukkitDependencies = List.of(
             Dependency.fromNamespace("ViaVersion", false, new Namespace("ViaVersion", "ViaVersion")),
             Dependency.fromNamespace("Maintenance", false, new Namespace("kennytv", "Maintenance")),
-            Dependency.fromUrl("PlaceholderAPI", false, "https://www.spigot.org/resources/6245/")
+            Dependency.fromNamespace("PlaceholderAPI", false, new Namespace("HelpChat", "PlaceholderAPI"))
         );
         final List<Dependency> bungeeDependencies = List.of(
             Dependency.fromNamespace("PapiProxyBridge", false, new Namespace("William278", "PAPIProxyBridge")),
@@ -130,7 +130,7 @@ public class HangarVersionUploader{
                 Platform.WATERFALL, List.of("1.19.x", "1.20.x"),
                 Platform.VELOCITY, Collections.singletonList("3.2")
             ),
-            changelog,
+            changelog.replaceAll("\r\n", "\n"),
             fileInfo,
             preRelease ? "Beta" : "Release"
         );
@@ -173,6 +173,7 @@ public class HangarVersionUploader{
                             "Received non-successful response while uploading release. Code: %d, Message: %s", response.getCode(), response.getReasonPhrase()
                         ));
                     }
+                    LOGGER.info("Successfully uploaded new release on Hangar!");
                     return true;
                 });
             }catch(IOException ex){

version-uploader/src/main/java/ch/andre601/advancedserverlist/versionuploader/modrinth/ModrinthVersionUploader.java

@@ -51,7 +51,7 @@ public class ModrinthVersionUploader{
         PlatformInfo.BUNGEECORD,
         PlatformInfo.VELOCITY
     );
-    private final List<String> versions = List.of("1.19.4", "1.20", "1.20.1", "1.20.2");
+    private final List<String> versions = List.of("1.19", "1.19.1", "1.19.2", "1.19.3", "1.19.4", "1.20", "1.20.1", "1.20.2");
     
     private final ModrinthAPI api;