Add faviconStrategy config option

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

README.md

@@ -40,7 +40,7 @@ A Server List Profile is a single YAML file located in the plugin's `profiles` f
 Each file has a priority and optional condition. The priority is used to determine what file AdvancedServerList should use first - starting from highest number to lowest - with conditions being used to set when the profile should be used.  
 Once a profile has been found with a condition returning true - which is the default should there be no condition - will AdvancedServerList use said profile.
 
-> *Read more about [Priority](https://asl.andre601.ch/profiles/#priority) and [Conditions](https://asl.andre601.ch/profiles/#condition)*
+> *Read more about [Priority](https://asl.andre601.ch/profiles/options/priority) and [Conditions](https://asl.andre601.ch/profiles/options/condition)*
 
 ### Placeholders
 

SECURITY.md

@@ -8,12 +8,12 @@ To ensure proper safety and support are only certain versions and Platforms of A
 |---------------|-----------|
 | v5            | Yes       |
 | v4            | Yes*      |
-| v3            | Yes**     |
+| v3            | No**      |
 | v2            | No        |
 | v1            | No        |
 
 \*Only receives support but no updates or bug fixes.  
-\*\*Support ends at the end of 2024.
+\*\*Support ended on December 31st, 2024.
 
 ## Supported Server/Proxy Versions
 

addons/banplugins/pom.xml

@@ -40,8 +40,8 @@
     <version>${plugin.version}</version>
 
     <properties>
-        <maven.compiler.source>16</maven.compiler.source>
-        <maven.compiler.target>16</maven.compiler.target>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     </properties>
     
@@ -65,14 +65,14 @@
         <dependency>
             <groupId>net.md-5</groupId>
             <artifactId>bungeecord-api</artifactId>
-            <version>1.20-R0.2</version>
+            <version>1.21-R0.3</version>
             <type>jar</type>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>net.md-5</groupId>
             <artifactId>bungeecord-api</artifactId>
-            <version>1.20-R0.2</version>
+            <version>1.21-R0.3</version>
             <type>javadoc</type>
             <scope>provided</scope>
         </dependency>
@@ -99,13 +99,13 @@
         <dependency>
             <groupId>space.arim.libertybans</groupId>
             <artifactId>bans-api</artifactId>
-            <version>1.1.0-RC1</version>
+            <version>1.1.0</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>com.gitlab.ruany</groupId>
             <artifactId>LiteBansAPI</artifactId>
-            <version>0.5.0</version>
+            <version>0.6.1</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -117,19 +117,12 @@
     </dependencies>
     
     <build>
-        <finalName>AdvancedServerList-BanPlugins-Addon-${plugin.version}</finalName>
+        <finalName>AdvancedServerList-BanPlugins-Addon-${plugin.version}${project.build.build_id}</finalName>
         <resources>
             <resource>
                 <filtering>true</filtering>
                 <directory>src/main/resources</directory>
             </resource>
         </resources>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.13.0</version>
-            </plugin>
-        </plugins>
     </build>
 </project>

bungeecord/pom.xml

@@ -40,8 +40,9 @@
     <description>${plugin.description}</description>
 
     <properties>
-        <maven.compiler.source>16</maven.compiler.source>
-        <maven.compiler.target>16</maven.compiler.target>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     </properties>
     
     <repositories>
@@ -49,6 +50,10 @@
             <id>sonatype</id>
             <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
         </repository>
+        <repository>
+            <id>repo-sayandevelopment</id>
+            <url>https://repo.sayandev.org/releases/</url>
+        </repository>
     </repositories>
     
     <dependencies>
@@ -69,14 +74,14 @@
         <dependency>
             <groupId>net.md-5</groupId>
             <artifactId>bungeecord-api</artifactId>
-            <version>1.20-R0.2</version>
+            <version>1.21-R0.3</version>
             <type>jar</type>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>net.md-5</groupId>
             <artifactId>bungeecord-api</artifactId>
-            <version>1.20-R0.2</version>
+            <version>1.21-R0.3</version>
             <type>javadoc</type>
             <scope>provided</scope>
         </dependency>
@@ -121,7 +126,19 @@
         <dependency>
             <groupId>com.github.LeonMangler</groupId>
             <artifactId>PremiumVanishAPI</artifactId>
-            <version>2.9.0-4</version>
+            <version>2.9.18-2</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.sayandev</groupId>
+            <artifactId>sayanvanish-api</artifactId>
+            <version>1.6.5</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.sayandev</groupId>
+            <artifactId>sayanvanish-proxy-bungeecord</artifactId>
+            <version>1.6.5</version>
             <scope>provided</scope>
         </dependency>
         
@@ -132,10 +149,16 @@
             <version>2.0.0-SNAPSHOT</version>
             <scope>compile</scope>
         </dependency>
+        <dependency>
+            <groupId>org.incendo</groupId>
+            <artifactId>cloud-bungee</artifactId>
+            <version>${dependency.cloud-bungee}</version>
+            <scope>compile</scope>
+        </dependency>
     </dependencies>
 
     <build>
-        <finalName>AdvancedServerList-BungeeCord-${plugin.version}</finalName>
+        <finalName>AdvancedServerList-BungeeCord-${plugin.version}${project.build.build_id}</finalName>
         <resources>
             <resource>
                 <filtering>true</filtering>
@@ -143,44 +166,51 @@
             </resource>
         </resources>
         <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.13.0</version>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
                 <version>3.6.0</version>
-                <configuration>
-                    <createDependencyReducedPom>false</createDependencyReducedPom>
-                    <relocations>
-                        <relocation>
-                            <pattern>org.bstats</pattern>
-                            <shadedPattern>ch.andre601.advancedserverlist.bungeecord.depends.bstats</shadedPattern>
-                        </relocation>
-                        <relocation>
-                            <pattern>net.byteflux.libby</pattern>
-                            <shadedPattern>ch.andre601.advancedserverlist.bungeecord.depends.libby</shadedPattern>
-                        </relocation>
-                    </relocations>
-                    <filters>
-                        <filter>
-                            <artifact>*:*</artifact>
-                            <excludes>
-                                <exclude>META-INF/*.SF</exclude>
-                                <exclude>META-INF/*.DSA</exclude>
-                                <exclude>META-INF/*.RSA</exclude>
-                            </excludes>
-                        </filter>
-                    </filters>
-                </configuration>
                 <executions>
                     <execution>
                         <phase>package</phase>
                         <goals>
                             <goal>shade</goal>
                         </goals>
+                        <configuration>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                            <relocations>
+                                <relocation>
+                                    <pattern>org.bstats</pattern>
+                                    <shadedPattern>ch.andre601.advancedserverlist.bungeecord.depends.bstats</shadedPattern>
+                                </relocation>
+                                <relocation>
+                                    <pattern>com.alessiodp.libby</pattern>
+                                    <shadedPattern>ch.andre601.advancedserverlist.bungeecord.depends.libby</shadedPattern>
+                                </relocation>
+                                <relocation>
+                                    <pattern>ch.andre601.expressionparser</pattern>
+                                    <shadedPattern>ch.andre601.advancedserverlist.bungeecord.depends.expressionparser</shadedPattern>
+                                </relocation>
+                                <relocation>
+                                    <pattern>com.unascribed.flexver</pattern>
+                                    <shadedPattern>ch.andre601.advancedserverlist.bungeecord.depends.flexver</shadedPattern>
+                                </relocation>
+                                <relocation>
+                                    <pattern>org.incendo.cloud</pattern>
+                                    <shadedPattern>ch.andre601.advancedserverlist.bungeecord.depends.cloud</shadedPattern>
+                                </relocation>
+                            </relocations>
+                            <filters>
+                                <filter>
+                                    <artifact>*:*</artifact>
+                                    <excludes>
+                                        <exclude>META-INF/*.SF</exclude>
+                                        <exclude>META-INF/*.DSA</exclude>
+                                        <exclude>META-INF/*.RSA</exclude>
+                                    </excludes>
+                                </filter>
+                            </filters>
+                        </configuration>
                     </execution>
                 </executions>
             </plugin>

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/BungeeCordCore.java

@@ -25,15 +25,16 @@
 
 package ch.andre601.advancedserverlist.bungeecord;
 
-import ch.andre601.advancedserverlist.bungeecord.commands.CmdAdvancedServerList;
-import ch.andre601.advancedserverlist.bungeecord.listeners.JoinEvent;
-import ch.andre601.advancedserverlist.bungeecord.listeners.PingEvent;
+import ch.andre601.advancedserverlist.bungeecord.commands.BungeeCommandManagerInterface;
+import ch.andre601.advancedserverlist.bungeecord.listeners.PlayerJoinEventListener;
+import ch.andre601.advancedserverlist.bungeecord.listeners.ProxyPingEventListener;
 import ch.andre601.advancedserverlist.bungeecord.logging.BungeeLogger;
 import ch.andre601.advancedserverlist.bungeecord.objects.placeholders.BungeePlayerPlaceholders;
 import ch.andre601.advancedserverlist.bungeecord.objects.placeholders.BungeeProxyPlaceholders;
 import ch.andre601.advancedserverlist.bungeecord.objects.placeholders.BungeeServerPlaceholders;
 import ch.andre601.advancedserverlist.core.AdvancedServerList;
 import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
+import ch.andre601.advancedserverlist.core.interfaces.commands.CmdSender;
 import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
 import ch.andre601.advancedserverlist.core.profiles.handlers.FaviconHandler;
 import com.alessiodp.libby.BungeeLibraryManager;
@@ -47,6 +48,8 @@ import net.md_5.bungee.api.connection.ProxiedPlayer;
 import net.md_5.bungee.api.plugin.Plugin;
 import org.bstats.bungeecord.Metrics;
 import org.bstats.charts.SimplePie;
+import org.incendo.cloud.CommandManager;
+import org.sayandev.sayanvanish.bungeecord.api.SayanVanishBungeeAPI;
 
 import java.awt.image.BufferedImage;
 import java.nio.file.Path;
@@ -55,6 +58,7 @@ import java.util.List;
 import java.util.Map;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.TimeUnit;
+import java.util.logging.Level;
 
 public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
     
@@ -66,17 +70,19 @@ public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
     private AdvancedServerList<Favicon> core;
     private FaviconHandler<Favicon> faviconHandler = null;
     private BungeeAudiences audiences = null;
+    private BungeeCommandManagerInterface handler;
     
     private BungeeLibraryManager libraryManager = null;
     
     @Override
     public void onLoad(){
-        logger.info("Loading libraries. This may take a while...");
+        // Using getLogger() here, because PluginLogger requires MiniMessage, which isn't loaded at this stage.
+        getLogger().info("Loading libraries. This may take a while...");
         successfulLoad = loadLibs();
         if(successfulLoad){
-            logger.info("Library loading completed successfully!");
+            getLogger().info("Library loading completed successfully!");
         }else{
-            logger.warn("Library loading completed with errors!");
+            getLogger().warning("Library loading completed with errors!");
         }
     }
     
@@ -84,11 +90,12 @@ public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
     public void onEnable(){
         if(!successfulLoad){
             logger.warn("There were issues during the plugins Loading-phase! Please see the console for possible reasons.");
-            logger.warn("The plugin won't be enabled to avoid problems.");
+            logger.warn("Aborting further enabling of the plugin to avoid errors.");
             return;
         }
         
         this.audiences = BungeeAudiences.create(this);
+        this.handler = new BungeeCommandManagerInterface(this);
         this.core = AdvancedServerList.init(this,
             BungeePlayerPlaceholders.init(), BungeeServerPlaceholders.init(this), BungeeProxyPlaceholders.init(this));
     }
@@ -97,17 +104,13 @@ public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
     public void onDisable(){
         core.disable();
         getProxy().getScheduler().cancel(this);
-    }
-    
-    @Override
-    public void loadCommands(){
-        getProxy().getPluginManager().registerCommand(this, new CmdAdvancedServerList(this));
+        audiences.close();
     }
     
     @Override
     public void loadEvents(){
-        new JoinEvent(this);
-        new PingEvent(this);
+        new PlayerJoinEventListener(this);
+        new ProxyPingEventListener(this);
     }
     
     @Override
@@ -176,6 +179,11 @@ public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
         return faviconHandler;
     }
     
+    @Override
+    public CommandManager<CmdSender> getCommandManager(){
+        return handler.commandHandler();
+    }
+    
     @Override
     public String getPlatformInfo(){
         return getProxy().getName() + " " + getProxy().getVersion();
@@ -206,6 +214,9 @@ public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
         // Exclude players when PremiumVanish is enabled and player is hidden.
         if(getProxy().getPluginManager().getPlugin("PremiumVanish") != null){
             players.removeIf(BungeeVanishAPI::isInvisible);
+        }else // Do the same if SayanVanish is enabled.
+        if(getProxy().getPluginManager().getPlugin("SayanVanish") != null){
+            players.removeIf(player -> SayanVanishBungeeAPI.getInstance().isVanished(player.getUniqueId()));
         }
         
         return players.size();
@@ -226,7 +237,7 @@ public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
             
             return true;
         }catch(Exception ex){
-            logger.warn("Encountered an Exception while trying to load dependencies.", ex);
+            getLogger().log(Level.WARNING, "Encountered an Exception while trying to load dependencies.", ex);
             return false;
         }
     }

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/commands/BungeeCmdSender.java

@@ -27,8 +27,10 @@ package ch.andre601.advancedserverlist.bungeecord.commands;
 
 import ch.andre601.advancedserverlist.core.interfaces.commands.CmdSender;
 import ch.andre601.advancedserverlist.core.parsing.ComponentParser;
+import net.kyori.adventure.audience.Audience;
 import net.kyori.adventure.platform.bungeecord.BungeeAudiences;
 import net.md_5.bungee.api.CommandSender;
+import net.md_5.bungee.api.connection.ProxiedPlayer;
 
 public class BungeeCmdSender implements CmdSender{
     
@@ -40,13 +42,22 @@ public class BungeeCmdSender implements CmdSender{
         this.bungeeAudiences = bungeeAudiences;
     }
     
-    @Override
-    public boolean hasPermission(String permission){
-        return sender.hasPermission(permission) || sender.hasPermission("advancedserverlist.admin");
-    }
-    
     @Override
     public void sendMsg(String msg, Object... args){
         bungeeAudiences.sender(sender).sendMessage(ComponentParser.text(String.format(msg, args)).toComponent());
     }
+    
+    @Override
+    public Audience audience(){
+        return bungeeAudiences.sender(sender);
+    }
+    
+    @Override
+    public boolean isPlayer(){
+        return sender instanceof ProxiedPlayer;
+    }
+    
+    public CommandSender sender(){
+        return sender;
+    }
 }

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/commands/BungeeCommandManagerInterface.java

@@ -1,7 +1,7 @@
 /*
  * MIT License
  *
- * Copyright (c) 2022-2023 Andre_601
+ * Copyright (c) 2022-2025 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
@@ -20,27 +20,41 @@
  * 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.bungeecord.commands;
 
 import ch.andre601.advancedserverlist.bungeecord.BungeeCordCore;
-import net.kyori.adventure.platform.bungeecord.BungeeAudiences;
+import ch.andre601.advancedserverlist.core.interfaces.commands.CmdSender;
+import ch.andre601.advancedserverlist.core.interfaces.commands.CommandManagerInterface;
 import net.md_5.bungee.api.CommandSender;
-import net.md_5.bungee.api.plugin.Command;
+import org.incendo.cloud.CommandManager;
+import org.incendo.cloud.SenderMapper;
+import org.incendo.cloud.bungee.BungeeCommandManager;
+import org.incendo.cloud.execution.ExecutionCoordinator;
 
-public class CmdAdvancedServerList extends Command{
+public class BungeeCommandManagerInterface implements CommandManagerInterface<CommandSender>{
     
     private final BungeeCordCore plugin;
     
-    public CmdAdvancedServerList(BungeeCordCore plugin){
-        super("advancedserverlist", "advancedserverlist.command.asl", "asl");
+    public BungeeCommandManagerInterface(BungeeCordCore plugin){
         this.plugin = plugin;
     }
     
     @Override
-    public void execute(CommandSender sender, String[] args){
-        plugin.getCore().getCommandHandler().handle(new BungeeCmdSender(sender, plugin.getAudiences()), args);
+    public CommandManager<CmdSender> commandHandler(){
+        return new BungeeCommandManager<>(
+            plugin,
+            ExecutionCoordinator.asyncCoordinator(),
+            senderMapper()
+        );
+    }
+    
+    @Override
+    public SenderMapper<CommandSender, CmdSender> senderMapper(){
+        return SenderMapper.create(
+            cmdSender -> new BungeeCmdSender(cmdSender, plugin.getAudiences()),
+            sender -> ((BungeeCmdSender)sender).sender()
+        );
     }
 }

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/listeners/BungeeEventWrapper.java

@@ -118,6 +118,11 @@ public class BungeeEventWrapper implements GenericEventWrapper<Favicon, BungeePl
             ping.getPlayers().setSample(players);
     }
     
+    @Override
+    public void setPlayersHidden(){
+        ping.getPlayers().setSample(new ServerPing.PlayerInfo[0]);
+    }
+    
     @Override
     public void setFavicon(Favicon favicon){
         ping.setFavicon(favicon);

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/listeners/PlayerJoinEventListener.java

@@ -34,10 +34,10 @@ import net.md_5.bungee.event.EventHandler;
 
 import java.net.InetSocketAddress;
 
-public class JoinEvent implements Listener{
+public class PlayerJoinEventListener implements Listener{
     private final BungeeCordCore plugin;
     
-    public JoinEvent(BungeeCordCore plugin){
+    public PlayerJoinEventListener(BungeeCordCore plugin){
         this.plugin = plugin;
         plugin.getProxy().getPluginManager().registerListener(plugin, this);
     }

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/listeners/ProxyPingEventListener.java

@@ -33,11 +33,11 @@ import net.md_5.bungee.api.event.ProxyPingEvent;
 import net.md_5.bungee.api.plugin.Listener;
 import net.md_5.bungee.event.EventHandler;
 
-public class PingEvent implements Listener{
+public class ProxyPingEventListener implements Listener{
     
     private final BungeeCordCore plugin;
     
-    public PingEvent(BungeeCordCore plugin){
+    public ProxyPingEventListener(BungeeCordCore plugin){
         this.plugin = plugin;
         plugin.getProxy().getPluginManager().registerListener(plugin, this);
     }

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/logging/BungeeLogger.java

@@ -27,6 +27,7 @@ package ch.andre601.advancedserverlist.bungeecord.logging;
 
 import ch.andre601.advancedserverlist.bungeecord.BungeeCordCore;
 import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
+import ch.andre601.advancedserverlist.core.parsing.ComponentParser;
 
 import java.util.logging.Level;
 import java.util.logging.Logger;
@@ -55,21 +56,21 @@ public class BungeeLogger implements PluginLogger{
     
     @Override
     public void info(String msg, Object... args){
-        logger.info(String.format(msg, args));
+        logger.info(ComponentParser.textFormatted(msg, args).toStringStriped());
     }
     
     @Override
     public void warn(String msg, Object... args){
-        logger.warning(String.format(msg, args));
+        logger.warning(ComponentParser.textFormatted(msg, args).toStringStriped());
     }
     
     @Override
     public void warn(String msg, Throwable throwable){
-        logger.log(Level.WARNING, msg, throwable);
+        logger.log(Level.WARNING, ComponentParser.text(msg).toStringStriped(), throwable);
     }
     
     @Override
     public void warn(String msg, Throwable throwable, Object... args){
-        logger.log(Level.WARNING, String.format(msg, args), throwable);
+        logger.log(Level.WARNING, ComponentParser.textFormatted(msg, args).toStringStriped(), throwable);
     }
 }

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/objects/impl/BungeePlayerImpl.java

@@ -30,21 +30,11 @@ import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
 
 import java.util.UUID;
 
-public class BungeePlayerImpl implements BungeePlayer{
-    
-    private final String name;
-    private final int protocol;
-    private final UUID uuid;
-    
-    public BungeePlayerImpl(CachedPlayer player, int protocol){
-        this.name = player.name();
-        this.protocol = protocol;
-        this.uuid = player.uuid();
-    }
+public record BungeePlayerImpl(CachedPlayer player, int protocol) implements BungeePlayer{
     
     @Override
     public String getName(){
-        return name;
+        return player.name();
     }
     
     @Override
@@ -54,6 +44,6 @@ public class BungeePlayerImpl implements BungeePlayer{
     
     @Override
     public UUID getUUID(){
-        return uuid;
+        return player.uuid();
     }
 }

core/pom.xml

@@ -39,9 +39,11 @@
     <version>${plugin.version}</version>
 
     <properties>
-        <maven.compiler.source>16</maven.compiler.source>
-        <maven.compiler.target>16</maven.compiler.target>
-        <plugin.config.version>6</plugin.config.version>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        
+        <plugin.config.version>9</plugin.config.version>
     </properties>
     
     <repositories>
@@ -77,7 +79,7 @@
         <dependency>
             <groupId>ch.andre601</groupId>
             <artifactId>expressionparser</artifactId>
-            <version>1.5.0</version>
+            <version>1.6.0</version>
             <scope>compile</scope>
         </dependency>
         
@@ -91,7 +93,7 @@
         <dependency>
             <groupId>org.spongepowered</groupId>
             <artifactId>configurate-hocon</artifactId>
-            <version>4.1.2</version>
+            <version>4.2.0</version>
             <scope>provided</scope>
         </dependency>
         
@@ -119,7 +121,7 @@
         <dependency>
             <groupId>com.google.code.gson</groupId>
             <artifactId>gson</artifactId>
-            <version>2.11.0</version>
+            <version>2.13.1</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -131,15 +133,42 @@
         <dependency>
             <groupId>com.google.guava</groupId>
             <artifactId>guava</artifactId>
-            <version>33.4.0-jre</version>
+            <version>33.4.8-jre</version>
             <scope>provided</scope>
         </dependency>
         
+        <!-- Command Framework -->
+        <dependency>
+            <groupId>org.incendo</groupId>
+            <artifactId>cloud-annotations</artifactId>
+            <version>${dependency.cloud-annotations}</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.incendo</groupId>
+            <artifactId>cloud-minecraft-extras</artifactId>
+            <version>${dependency.cloud-minecraft-extras}</version>
+            <scope>compile</scope>
+            <exclusions>
+                <exclusion>
+                    <groupId>net.kyori</groupId>
+                    <artifactId>*</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        
+        <!-- Annotations -->
+        <dependency>
+            <groupId>org.jspecify</groupId>
+            <artifactId>jspecify</artifactId>
+            <version>1.0.0</version>
+        </dependency>
+        
         <!-- Plugins -->
         <dependency>
             <groupId>net.william278</groupId>
             <artifactId>papiproxybridge</artifactId>
-            <version>1.7.2</version>
+            <version>1.8.1</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -159,13 +188,13 @@
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
-            <version>5.11.4</version>
+            <version>5.13.1</version>
             <scope>test</scope>
         </dependency>
     </dependencies>
 
     <build>
-        <finalName>AdvancedServerList-Core-${plugin.version}</finalName>
+        <finalName>AdvancedServerList-Core-${plugin.version}${project.build.build_id}</finalName>
         <resources>
             <resource>
                 <filtering>true</filtering>
@@ -186,43 +215,12 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.13.0</version>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-shade-plugin</artifactId>
-                <version>3.6.0</version>
+                <version>3.14.0</version>
                 <configuration>
-                    <createDependencyReducedPom>false</createDependencyReducedPom>
-                    <filters>
-                        <filter>
-                            <artifact>*:*</artifact>
-                            <excludes>
-                                <exclude>META-INF/*.SF</exclude>
-                                <exclude>META-INF/*.DSA</exclude>
-                                <exclude>META-INF/*.RSA</exclude>
-                            </excludes>
-                        </filter>
-                    </filters>
-                    <relocations>
-                        <relocation>
-                            <pattern>com.unascribed</pattern>
-                            <shadedPattern>ch.andre601.advancedserverlist.core.depends.flexver</shadedPattern>
-                        </relocation>
-                        <relocation>
-                            <pattern>ch.andre601.expressionparser</pattern>
-                            <shadedPattern>ch.andre601.advancedserverlist.core.depends.expressionparser</shadedPattern>
-                        </relocation>
-                    </relocations>
+                    <compilerArgs>
+                        <arg>-parameters</arg>
+                    </compilerArgs>
                 </configuration>
-                <executions>
-                    <execution>
-                        <phase>package</phase>
-                        <goals>
-                            <goal>shade</goal>
-                        </goals>
-                    </execution>
-                </executions>
             </plugin>
         </plugins>
     </build>

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

@@ -31,22 +31,40 @@ import ch.andre601.advancedserverlist.core.check.UpdateChecker;
 import ch.andre601.advancedserverlist.core.commands.CommandHandler;
 import ch.andre601.advancedserverlist.core.compat.maintenance.MaintenancePlaceholder;
 import ch.andre601.advancedserverlist.core.file.FileHandler;
+import ch.andre601.advancedserverlist.core.interfaces.commands.CmdSender;
+import ch.andre601.advancedserverlist.core.interfaces.commands.CommandType;
 import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
 import ch.andre601.advancedserverlist.core.parsing.TextCenterUtil;
+import ch.andre601.advancedserverlist.core.profiles.ServerListProfile;
 import ch.andre601.advancedserverlist.core.profiles.conditions.ProfileConditionParser;
 import ch.andre601.advancedserverlist.core.profiles.handlers.PlayerHandler;
+import org.incendo.cloud.CommandManager;
+import org.incendo.cloud.annotations.AnnotationParser;
+import org.incendo.cloud.description.Description;
+import org.incendo.cloud.injection.ParameterInjector;
+import org.incendo.cloud.parser.ParserDescriptor;
+import org.incendo.cloud.parser.standard.BooleanParser;
+import org.incendo.cloud.parser.standard.IntegerParser;
+import org.incendo.cloud.parser.standard.StringParser;
+import org.incendo.cloud.permission.Permission;
+import org.incendo.cloud.suggestion.Suggestion;
+import org.incendo.cloud.suggestion.SuggestionProvider;
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.time.LocalDate;
 import java.util.Arrays;
 import java.util.List;
 import java.util.Properties;
 
 public class AdvancedServerList<F>{
     
+    public static <F> AdvancedServerList<F> init(PluginCore<F> plugin, PlaceholderProvider... placeholders){
+        return new AdvancedServerList<>(plugin, Arrays.asList(placeholders));
+    }
+    
     private final PluginCore<F> plugin;
     private final FileHandler fileHandler;
-    private final CommandHandler commandHandler;
     private final PlayerHandler playerHandler;
     private final TextCenterUtil textCenterUtil;
     
@@ -60,7 +78,6 @@ public class AdvancedServerList<F>{
     private AdvancedServerList(PluginCore<F> plugin, List<PlaceholderProvider> placeholders){
         this.plugin = plugin;
         this.fileHandler = new FileHandler(this);
-        this.commandHandler = new CommandHandler(this);
         this.playerHandler = new PlayerHandler(this);
         this.textCenterUtil = new TextCenterUtil(this);
         
@@ -69,19 +86,14 @@ public class AdvancedServerList<F>{
         placeholders.forEach(this::addPlaceholder);
         
         if(plugin.isPluginEnabled("Maintenance")){
-            plugin.getPluginLogger().info("Found Maintenance Plugin. Registering extra Placeholder...");
             addPlaceholder(new MaintenancePlaceholder(this));
         }
         
-        plugin.getPluginLogger().info("Completed internal Placeholder registration!");
-        
+        resolveVersion();
+        getPlugin().getPluginLogger().info("Starting <white>AdvancedServerList v%s</white>...", version);
         load();
     }
     
-    public static <F> AdvancedServerList<F> init(PluginCore<F> plugin, PlaceholderProvider... placeholders){
-        return new AdvancedServerList<>(plugin, Arrays.asList(placeholders));
-    }
-    
     public static AdvancedServerListAPI getApi(){
         return api;
     }
@@ -94,10 +106,6 @@ public class AdvancedServerList<F>{
         return fileHandler;
     }
     
-    public CommandHandler getCommandHandler(){
-        return commandHandler;
-    }
-    
     public PlayerHandler getPlayerHandler(){
         return playerHandler;
     }
@@ -119,15 +127,15 @@ public class AdvancedServerList<F>{
     }
     
     public void disable(){
-        getPlugin().getPluginLogger().info("Saving playercache.json file...");
+        getPlugin().getPluginLogger().info("[-] Saving <white>playercache.json</white> file...");
         getPlayerHandler().save();
         
         if(updateChecker != null){
-            getPlugin().getPluginLogger().info("Disabling Update Checker...");
+            getPlugin().getPluginLogger().info("[-] Disabling Update Checker...");
             updateChecker.disable();
         }
         
-        getPlugin().getPluginLogger().info("AdvancedServerList disabled!");
+        getPlugin().getPluginLogger().success("AdvancedServerList disabled!");
     }
     
     public void clearFaviconCache(){
@@ -139,71 +147,58 @@ public class AdvancedServerList<F>{
     }
     
     private void load(){
-        printBanner();
-        resolveVersion();
-    
-        getPlugin().getPluginLogger().info("Starting AdvancedServerList v%s...", version);
-        getPlugin().getPluginLogger().info("Platform: %s", plugin.getPlatformInfo());
-        
-        if(getFileHandler().loadConfig()){
-            getPlugin().getPluginLogger().info("Successfully loaded config.yml!");
-        }else{
-            getPlugin().getPluginLogger().warn("Unable to load config.yml! Check previous lines for errors.");
+        if(!getFileHandler().loadConfig()){
+            getPlugin().getPluginLogger().failure("Unable to load <white>config.yml</white>! Check previous lines for errors.");
             return;
         }
         
         if(getFileHandler().isOldConfig()){
-            getPlugin().getPluginLogger().info("Detected old config.yml. Attempting to migrate...");
+            getPlugin().getPluginLogger().info("[-] Detected old <white>config.yml</white>. Attempting to migrate...");
             if(getFileHandler().migrateConfig()){
-                getPlugin().getPluginLogger().info("Migration completed successfully!");
+                getPlugin().getPluginLogger().success("Migration completed successfully!");
             }else{
-                getPlugin().getPluginLogger().warn("Couldn't migrate config.yml! Check previous lines for errors.");
+                getPlugin().getPluginLogger().failure("Couldn't migrate <white>config.yml</white>! Check previous lines for errors.");
                 return;
             }
         }
         
+        if(getFileHandler().getBool(true, "printBanner")){
+            printBanner();
+        }
+        
+        getPlugin().getPluginLogger().info("Platform: <white>%s</white>", plugin.getPlatformInfo());
+        getPlugin().getPluginLogger().info("");
+        
         if(getFileHandler().loadProfiles()){
-            getPlugin().getPluginLogger().info("Successfully loaded %d profile(s)!", getFileHandler().getProfiles().size());
+            getPlugin().getPluginLogger().success("Successfully loaded <white>%d</white> profile(s)!", getFileHandler().getProfiles().size());
         }else{
-            getPlugin().getPluginLogger().warn("Unable to load profiles! Check previous lines for errors.");
+            getPlugin().getPluginLogger().failure("Unable to load profiles! Check previous lines for errors.");
             return;
         }
         
-        getPlugin().loadFaviconHandler(this);
-    
-        getPlugin().getPluginLogger().info("Loading Commands...");
-        plugin.loadCommands();
-        getPlugin().getPluginLogger().info("Commands loaded!");
-    
-        getPlugin().getPluginLogger().info("Loading events...");
-        plugin.loadEvents();
-        getPlugin().getPluginLogger().info("Events loaded!");
-    
-        getPlugin().getPluginLogger().info("Loading playercache.json...");
-        getPlayerHandler().load();
-    
-        getPlugin().getPluginLogger().info("Loading bStats metrics. Disable it in the global config under /plugins/bstats/");
-        plugin.loadMetrics();
-        getPlugin().getPluginLogger().info("Metrics loaded!");
+        loadCommands();
         
-        getPlugin().getPluginLogger().info("Enabling Schedulers...");
+        plugin.loadEvents();
+        getPlayerHandler().load();
+        plugin.loadMetrics();
         plugin.startScheduler();
-        getPlugin().getPluginLogger().info("Schedulers enabled.");
     
-        getPlugin().getPluginLogger().info("AdvancedServerList is ready!");
+        getPlugin().getPluginLogger().success("<green>AdvancedServerList is ready!");
         
         if(getFileHandler().getBoolean("checkUpdates"))
             this.updateChecker = new UpdateChecker(this);
     }
     
     private void printBanner(){
-        getPlugin().getPluginLogger().info("           _____ _");
-        getPlugin().getPluginLogger().info("    /\\    / ____| |");
-        getPlugin().getPluginLogger().info("   /  \\  | (___ | |");
-        getPlugin().getPluginLogger().info("  / /\\ \\  \\___ \\| |");
-        getPlugin().getPluginLogger().info(" / ____ \\ ____) | |____");
-        getPlugin().getPluginLogger().info("/_/    \\_\\_____/|______|");
+        getPlugin().getPluginLogger().info("<#3b90ff>     __      _______ ___");
+        getPlugin().getPluginLogger().info("<#3b90ff>    /\\ \\    / ____|_| | |");
+        getPlugin().getPluginLogger().info("<#3b90ff>   /  \\ \\  | (_(___ | | |");
+        getPlugin().getPluginLogger().info("<#3b90ff>  / /\\ \\ \\  \\___ \\ \\| | |");
+        getPlugin().getPluginLogger().info("<#3b90ff> / ____ \\ \\ ____) | | |_|____");
+        getPlugin().getPluginLogger().info("<#3b90ff>/_/_/  \\_\\_\\_____/_/|______|_|");
         getPlugin().getPluginLogger().info("");
+        
+        seasonalText();
     }
     
     private void resolveVersion(){
@@ -219,7 +214,117 @@ public class AdvancedServerList<F>{
     }
     
     private void addPlaceholder(PlaceholderProvider placeholderProvider){
-        getPlugin().getPluginLogger().info("Registering %s Placeholders...", placeholderProvider.getIdentifier());
         AdvancedServerList.getApi().addPlaceholderProvider(placeholderProvider);
     }
+    
+    private void loadCommands(){
+        getPlugin().loadFaviconHandler(this);
+        
+        CommandManager<CmdSender> commandManager = plugin.getCommandManager();
+        
+        commandManager.parameterInjectorRegistry().registerInjector(AdvancedServerList.class, ParameterInjector.constantInjector(this));
+        
+        AnnotationParser<CmdSender> annotationParser = new AnnotationParser<>(commandManager, CmdSender.class);
+        annotationParser.registerBuilderModifier(
+            CommandType.class,
+            (annotation, builder) -> builder.meta(CommandHandler.COMMAND_TYPE, annotation.value())
+        );
+        annotationParser.parse(new CommandHandler(commandManager));
+        
+        for(String option : CommandHandler.PROFILE_OPTIONS){
+            commandManager.command(
+                commandManager.commandBuilder("advancedserverlist", "asl")
+                    .literal("profiles")
+                    .literal("set")
+                    .required(
+                        "profile",
+                        StringParser.stringParser(),
+                        Description.of("The profile to edit."),
+                        SuggestionProvider.suggesting(
+                            getFileHandler().getProfiles().stream()
+                                .map(ServerListProfile::file)
+                                .map(Suggestion::suggestion)
+                                .toList()
+                        )
+                    )
+                    .literal(option)
+                    .optional("value", descriptor(option), description(option))
+                    .commandDescription(Description.of("Sets or resets profile values."))
+                    .handler(context -> CommandHandler.handleSet(this, context))
+                    .meta(CommandHandler.OPTION, option)
+                    .permission(
+                        Permission.anyOf(
+                            Permission.permission("advancedserverlist.admin"), 
+                            Permission.permission("advancedserverlist.command.profiles"),
+                            Permission.permission("advancedserverlist.command.profiles.set")
+                        )
+                    )
+            );
+        }
+        
+        getPlugin().getPluginLogger().success("Loaded Command <white>/advancedserverlist</white>!");
+    }
+    
+    private ParserDescriptor<CmdSender, ?> descriptor(String option){
+        return switch(option){
+            case "playercount.hideplayers", "playercount.hideplayershover", "playercount.extraplayers.enabled",
+                "playercount.maxplayers.enabled", "playercount.onlineplayers.enabled" -> BooleanParser.booleanParser();
+            case "priority" -> IntegerParser.integerParser();
+            default -> StringParser.greedyStringParser();
+        };
+    }
+    
+    private Description description(String option){
+        return switch(option){
+            case "playercount.hideplayers", "playercount.hideplayershover", "playercount.extraplayers.enabled",
+                "playercount.maxplayers.enabled", "playercount.onlineplayers.enabled" -> Description.of(
+                "Whether this option should be enabled or not. Leave empty to unset it."
+            );
+            case "priority" -> Description.of("Priority this Profile should have. Leave empty to reset.");
+            case "motd", "playercount.hover" -> Description.of(
+                "Lines to set. Use \\n or <newline> to set a linebreak. Leave empty to reset."
+            );
+            default -> Description.of("The Value to use for this option. Leave empty to reset.");
+        };
+    }
+    
+    // Adding some seasonal messages
+    private void seasonalText(){
+        LocalDate date = LocalDate.now();
+        
+        switch(date.getMonth()){
+            case JANUARY -> {
+                if(date.getDayOfMonth() == 1){
+                    getPlugin().getPluginLogger().info("Happy new Year!");
+                    getPlugin().getPluginLogger().info("");
+                }
+            }
+            case JUNE -> {
+                getPlugin().getPluginLogger().info("Happy Pride Month!");
+                getPlugin().getPluginLogger().info("");
+            }
+            case AUGUST -> {
+                if(date.getDayOfMonth() == 1){
+                    getPlugin().getPluginLogger().info("Happy Birthday Switzerland!");
+                    getPlugin().getPluginLogger().info("");
+                }
+            }
+            case OCTOBER -> {
+                if(date.getDayOfMonth() == 31){
+                    getPlugin().getPluginLogger().info("Happy Halloween!");
+                    getPlugin().getPluginLogger().info("");
+                }
+            }
+            case DECEMBER -> {
+                if(date.getDayOfMonth() == 13){
+                    getPlugin().getPluginLogger().info("Happy Birthday Andre_601!");
+                    getPlugin().getPluginLogger().info("");
+                }else
+                if(date.getDayOfMonth() > 23 && date.getDayOfMonth() < 27){
+                    getPlugin().getPluginLogger().info("Merry Christmas!");
+                    getPlugin().getPluginLogger().info("");
+                }
+            }
+        }
+    }
 }

core/src/main/java/ch/andre601/advancedserverlist/core/check/UpdateChecker.java

@@ -101,8 +101,12 @@ public class UpdateChecker{
                 );
             }else
             if(result == 1){
-                sender.sendPrefixedMsg("You seem to run a newer Version (<white>%</white>) than what is available on Modrinth (<white>%s</white>).", core.getVersion(), version.versionNumber());
-                sender.sendPrefixedMsg("Are you running a development build?");
+                sender.sendPrefixedMsg(
+                    "Your version (<white>%</white>) is newer than what is available on Modrinth (<white>%s</white>).",
+                    core.getVersion(),
+                    version.versionNumber()
+                );
+                sender.sendPrefixedMsg("Are you using a Development Version?");
             }
         });
     }
@@ -123,11 +127,11 @@ public class UpdateChecker{
     
     private void startUpdateChecker(){
         executor.scheduleAtFixedRate(() -> {
-            logger.info("Looking for an update...");
+            logger.info("[-] Looking for an update...");
             
             performUpdateCheck().whenComplete((version, throwable) -> {
                 if(version == null || throwable != null){
-                    logger.warn("Failed to look for any updates. Check previous messages for causes.");
+                    logger.failure("Failed to look for any updates. Check previous messages for causes.");
                     return;
                 }
                 
@@ -136,11 +140,15 @@ public class UpdateChecker{
                 int result = version.compare(core.getVersion());
                 switch(result){
                     case -1 -> printUpdateBanner(version);
-                    case 0 -> logger.info("You are running the latest version!");
-                    case 1 -> logger.info(
-                        "Your version (%s) seems to be newer than the latest release (%s). Are you running a dev build?",
-                        core.getVersion(), version.versionNumber()
-                    );
+                    case 0 -> logger.success("You are running the latest version!");
+                    case 1 -> {
+                        logger.info(
+                            "[?] Your version (<white>%s</white>) is newer than what is available on Modrint (<white>%s</white>).",
+                            core.getVersion(),
+                            version.versionNumber()
+                        );
+                        logger.info("    Are you using a Development Version?");
+                    }
                 }
             });
         }, 0L, 12L, TimeUnit.HOURS);
@@ -185,18 +193,18 @@ public class UpdateChecker{
         logger.warn("=======================================================================");
         logger.warn("You are running an outdated version of AdvancedServerList!");
         logger.warn("");
-        logger.warn("Your version: %s", core.getVersion());
-        logger.warn("Modrinth:     %s", version.versionNumber());
+        logger.warn("Your version: <white>%s</white>", core.getVersion());
+        logger.warn("Modrinth:     <white>%s</white>", version.versionNumber());
         logger.warn("");
         
         if(!version.isRelease()){
-            logger.warn("WARNING!");
+            logger.warn("<bold>WARNING!</bold>");
             logger.warn("This is a %s version and may contain breaking changes and/or bugs!", version.versionType());
             logger.warn("");
         }
         
         logger.warn("Download the latest version from here:");
-        logger.warn("https://modrinth.com/plugin/advancedserverlist/version/%s", version.id());
+        logger.warn("<white>https://modrinth.com/plugin/advancedserverlist/version/%s</white>", version.id());
         logger.warn("=======================================================================");
     }
     

core/src/main/java/ch/andre601/advancedserverlist/core/commands/ProfileOptionsSender.java

@@ -0,0 +1,172 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2025 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.commands;
+
+import ch.andre601.advancedserverlist.api.objects.NullBool;
+import ch.andre601.advancedserverlist.core.interfaces.commands.CmdSender;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+
+public class ProfileOptionsSender{
+    
+    private final List<OptionStringBuilder> builders = new ArrayList<>();
+    private final String file;
+    
+    public ProfileOptionsSender(String file){
+        this.file = file;
+    }
+    
+    public ProfileOptionsSender append(OptionStringBuilder builder){
+        this.builders.add(builder.file(file));
+        return this;
+    }
+    
+    public void send(CmdSender sender){
+        sender.sendMsg();
+        sender.sendPrefixedMsg("Profile Info [<white>%s</white>]", file);
+        for(OptionStringBuilder builder : builders){
+            sender.sendMsg(builder.build());
+        }
+        sender.sendMsg();
+        sender.sendMsg("[<grey>Hover for info, click for command</grey>]");
+        sender.sendMsg();
+    }
+    
+    public static class OptionStringBuilder{
+        
+        public static OptionStringBuilder of(String displayName, String hover){
+            return new OptionStringBuilder(displayName)
+                .hover(hover == null || hover.isEmpty() ? "<i>Not set</i>" : hover)
+                .color(hover == null || hover.isEmpty() ? ColorName.RED : ColorName.GREEN);
+        }
+        
+        public static OptionStringBuilder of(String displayName, List<String> hover){
+            return new OptionStringBuilder(displayName)
+                .hover(hover == null || hover.isEmpty() ? "<i>Not set</i>" : String.join("\n<reset>", hover))
+                .color(hover == null || hover.isEmpty() ? ColorName.RED : ColorName.GREEN);
+        }
+        
+        public static OptionStringBuilder of(String displayName, NullBool hover){
+            return new OptionStringBuilder(displayName)
+                .hover(hover == null || !hover.getOrDefault(false) ? "<red>Disabled</red>" : "<green>Enabled</green>")
+                .color(hover == null || !hover.getOrDefault(false) ? ColorName.RED : ColorName.GREEN);
+        }
+        
+        public static OptionStringBuilder of(String displayName, int hover){
+            return new OptionStringBuilder(displayName)
+                .hover(String.valueOf(hover));
+        }
+        
+        public static OptionStringBuilder of(String displayName){
+            return new OptionStringBuilder(displayName).hover(null);
+        }
+        
+        private final String displayName;
+        private String file = null;
+        private String prefix = "├─";
+        private ColorName color = ColorName.AQUA;
+        private String hover = "<i>Not set</i>";
+        private String option = null;
+        
+        private OptionStringBuilder(String displayName){
+            this.displayName = displayName;
+        }
+        
+        public OptionStringBuilder file(String file){
+            this.file = file;
+            return this;
+        }
+        
+        public OptionStringBuilder prefix(String prefix){
+            this.prefix = prefix;
+            return this;
+        }
+        
+        public OptionStringBuilder color(ColorName color){
+            this.color = color;
+            return this;
+        }
+        
+        public OptionStringBuilder hover(String hover){
+            this.hover = hover;
+            return this;
+        }
+        
+        public OptionStringBuilder option(String option){
+            this.option = option;
+            return this;
+        }
+        
+        public String build(){
+            StringBuilder builder = new StringBuilder("<grey>")
+                .append(prefix)
+                .append(" <white>[")
+                .append('<')
+                .append(color)
+                .append('>');
+            
+            if(hover != null && !hover.isEmpty()){
+                builder.append("<hover:show_text:\"")
+                    .append(hover)
+                    .append("\">");
+            }
+            
+            if(option != null && !option.isEmpty() && file != null && !file.isEmpty()){
+                builder.append("<click:suggest_command:/asl profiles set ")
+                    .append(file)
+                    .append(" ")
+                    .append(option)
+                    .append(" >");
+            }
+            
+            builder.append(displayName);
+            
+            if(option != null && !option.isEmpty())
+                builder.append("</click>");
+            
+            if(hover != null && !hover.isEmpty())
+                builder.append("</hover>");
+            
+            builder.append("</")
+                .append(color)
+                .append(">]</white></grey>");
+            
+            return builder.toString();
+        }
+    }
+    
+    enum ColorName{
+        RED,
+        GREEN,
+        AQUA;
+        
+        @Override
+        public String toString(){
+            return this.name().toLowerCase(Locale.ROOT);
+        }
+    }
+}

core/src/main/java/ch/andre601/advancedserverlist/core/events/PingEventHandler.java

@@ -158,7 +158,7 @@ public class PingEventHandler{
         
         boolean hidePlayers = ProfileManager.checkOption(entry.hidePlayersEnabled());
         
-        if(hidePlayers && ignoreMaintenance(event, "hidePlayers")){
+        if(hidePlayers && ignoreMaintenance(event, "hidePlayers") && ignoreMaintenance(event, "hidePlayersHover")){
             logger.debug(PingEventHandler.class, "'playerCount -> hidePlayers' enabled. Hiding player count...");
             
             event.hidePlayers();
@@ -175,8 +175,14 @@ public class PingEventHandler{
             );
         }
         
-        if(ProfileManager.checkOption(entry.players()) && !hidePlayers && ignoreMaintenance(event, "playerCountHover")){
-            logger.debug(PingEventHandler.class, "'playerCount -> hover' option set. Applying '%s'...", String.join("\\n", entry.players()));
+        boolean hidePlayersHover = ProfileManager.checkOption(entry.hidePlayersHoverEnabled());
+        if(hidePlayersHover){
+            logger.debug(PingEventHandler.class, "'playerCount -> hidePlayersHover' option set. Hiding Player Hover...");
+            event.setPlayersHidden();
+        }
+        
+        if(ProfileManager.checkOption(entry.players()) && !hidePlayers && !hidePlayersHover && ignoreMaintenance(event, "playerCountHover")){
+            logger.debug(PingEventHandler.class, "'playerCount -> hover' option set. Applying ['%s']...", String.join("', '", entry.players()));
             
             event.setPlayers(entry.players(), player, server);
         }
@@ -184,9 +190,12 @@ public class PingEventHandler{
         if(ProfileManager.checkOption(entry.favicon()) && ignoreMaintenance(event, "favicon")){
             logger.debug(PingEventHandler.class, "'favicon' option set. Resolving '%s'...", entry.favicon());
             
-            String faviconString = StringReplacer.replace(entry.favicon(), player, server);
+            String faviconString = StringReplacer.modifier(entry.favicon())
+                .modify(text -> StringReplacer.replace(text, player, server))
+                .modify(text -> event.parsePAPIPlaceholders(text, player))
+                .asString();
             
-            F favicon = plugin.getFaviconHandler().getFavicon(faviconString);
+            F favicon = plugin.getFaviconHandler().favicon(faviconString);
             
             if(favicon == null){
                 logger.debugWarn(PingEventHandler.class, "Favicon was invalid or not yet resolved! Using default favicon of Server/Proxy...");

core/src/main/java/ch/andre601/advancedserverlist/core/file/ConfigMigrator.java

@@ -46,7 +46,10 @@ public class ConfigMigrator{
     public static ConfigurationTransformation.Versioned create(){
         return ConfigurationTransformation.versionedBuilder()
             .versionKey("configVersion")
-            .addVersion(LATEST, fiveToSix())
+            .addVersion(LATEST, eightToNine())
+            .addVersion(8, sevenToEight())
+            .addVersion(7, sixToSeven())
+            .addVersion(6, fiveToSix())
             .addVersion(5, fourToFive())
             .addVersion(4, threeToFour())
             .addVersion(3, twoToThree())
@@ -54,6 +57,36 @@ public class ConfigMigrator{
             .build();
     }
     
+    public static ConfigurationTransformation eightToNine(){
+        return ConfigurationTransformation.builder()
+            .addAction(NodePath.path(), (path, value) -> {
+                value.node("faviconStrategy").set("resize");
+                
+                return null;
+            })
+            .build();
+    }
+    
+    public static ConfigurationTransformation sevenToEight(){
+        return ConfigurationTransformation.builder()
+            .addAction(NodePath.path("disableDuringMaintenance"), (path, value) -> {
+                value.node("hidePlayersHover").set(true);
+                
+                return null;
+            })
+            .build();
+    }
+    
+    public static ConfigurationTransformation sixToSeven(){
+        return ConfigurationTransformation.builder()
+            .addAction(NodePath.path(), (path, value) -> {
+                value.node("printBanner").set(true);
+                
+                return null;
+            })
+            .build();
+    }
+    
     public static ConfigurationTransformation fiveToSix(){
         return ConfigurationTransformation.builder()
             .addAction(NodePath.path("disableDuringMaintenance"), (path, value) -> {
@@ -122,7 +155,7 @@ public class ConfigMigrator{
             versioned.apply(node);
             final int endVersion = versioned.version(node);
             if(startVersion < endVersion)
-                logger.info("Migrated config.yml from v" + startVersion + " to v" + endVersion);
+                logger.success("Successfully migrated config from <white>v%d</white> to <white>v%d</white>", startVersion, endVersion);
         }
         
         return node;

core/src/main/java/ch/andre601/advancedserverlist/core/file/FileHandler.java

@@ -72,7 +72,6 @@ public class FileHandler{
     }
     
     public boolean loadConfig(){
-        logger.info("Loading config.yml...");
         File folder = plugin.getPlugin().getFolderPath().toFile();
         if(!folder.exists() && !folder.mkdirs()){
             logger.warn("Couldn't create folder for plugin. Is it missing Write permissions?");
@@ -87,7 +86,7 @@ public class FileHandler{
                 }
                 
                 Files.copy(stream, config);
-                logger.info("Created new config.yml!");
+                logger.success("Created new config.yml!");
             }catch(IOException ex){
                 logger.warn("Cannot create config.yml for plugin.", ex);
                 return false;
@@ -98,7 +97,7 @@ public class FileHandler{
     }
     
     public boolean loadProfiles(){
-        logger.info("Loading profiles...");
+        logger.info("[-] Loading profiles...");
         
         if(createFile("default.yml")){
             return reloadProfiles();
@@ -109,7 +108,7 @@ public class FileHandler{
     
     public boolean createFile(String name){
         if(Files.notExists(profilesFolder) && profilesFolder.toFile().mkdirs()){
-            logger.info("Successfully created profiles folder.");
+            logger.debugSuccess(FileHandler.class, "Successfully created profiles folder.");
         }
         
         File file = new File(profilesFolder.toFile(), name);
@@ -126,7 +125,7 @@ public class FileHandler{
             Files.copy(stream, profilesFolder.resolve(name));
             return true;
         }catch(IOException ex){
-            logger.warn("Encountered IOException while trying to create file %s", ex, name);
+            logger.warn("Encountered IOException while trying to create file <white>%s</white>", ex, name);
             return false;
         }
     }
@@ -160,7 +159,7 @@ public class FileHandler{
         
         File[] files = profilesFolder.toFile().listFiles(((dir, name) -> name.endsWith(".yml")));
         if(files == null || files.length == 0){
-            logger.warn("Cannot load files from profiles folder! No valid YAML files present.");
+            logger.failure("Cannot load files from profiles folder! No valid YAML files present.");
             return false;
         }
         
@@ -170,11 +169,11 @@ public class FileHandler{
                 continue;
             
             profiles.add(ServerListProfile.Builder.resolve(file.getName(), tmp, logger).build());
-            logger.info("Loaded '%s'!", file.getName());
+            logger.debugSuccess(FileHandler.class, "Loaded '<white>%s</white>'!", file.getName());
         }
         
         if(profiles.isEmpty()){
-            logger.warn("Couldn't load any profile from profiles folder!");
+            logger.failure("Couldn't load any profile from profiles folder!");
             return false;
         }
         
@@ -191,7 +190,7 @@ public class FileHandler{
         try{
             return loader.load();
         }catch(IOException ex){
-            logger.warn("Cannot load '%s' due to an IOException!", ex, path.toFile().getName());
+            logger.warn("Cannot load '<white>%s</white>' due to an IOException!", ex, path.toFile().getName());
             return null;
         }
     }
@@ -218,11 +217,11 @@ public class FileHandler{
     }
     
     private boolean makeBackup(){
-        logger.info("Making backup of old config.yml...");
+        logger.info("[-] Making backup of old config.yml...");
         
         File backups = plugin.getPlugin().getFolderPath().resolve("backups").toFile();
         if(!backups.exists() && !backups.mkdirs()){
-            logger.warn("Cannot create backups folder for migration!");
+            logger.failure("Cannot create backups folder for migration!");
             return false;
         }
         
@@ -231,16 +230,16 @@ public class FileHandler{
         File configBackup = new File(backups, "config_" + date.replace(":", "_") + ".yml");
         try{
             if(!configBackup.exists() && !configBackup.createNewFile()){
-                logger.warn("Cannot create backup file for config.yml!");
+                logger.failure("Cannot create backup file for config.yml!");
                 return false;
             }
             
             Files.copy(config, configBackup.toPath(), StandardCopyOption.REPLACE_EXISTING);
-            logger.info("Saved backup as '%s'!", configBackup.getName());
+            logger.success("Saved backup as '<white>%s</white>'!", configBackup.getName());
             
             return true;
         }catch(IOException ex){
-            logger.warn("Encountered IOException while trying to create a backup.", ex);
+            logger.failure("Encountered IOException while trying to create a backup.", ex);
             return false;
         }
     }

core/src/main/java/ch/andre601/advancedserverlist/core/interfaces/PluginLogger.java

@@ -27,10 +27,18 @@ package ch.andre601.advancedserverlist.core.interfaces;
 
 public interface PluginLogger{
     
+    default void debugSuccess(Class<?> clazz, String msg, Object... args){
+        debug(clazz, "[<green>✓</green>] " + msg, args);
+    }
+    
     void debug(Class<?> clazz, String msg, Object... args);
     
     void debugWarn(Class<?> clazz, String msg, Object... args);
     
+    default void success(String msg, Object... args){
+        info("[<green>✓</green>] " + msg, args);
+    }
+    
     void info(String msg, Object... args);
     
     void warn(String msg, Object... args);
@@ -38,4 +46,8 @@ public interface PluginLogger{
     void warn(String msg, Throwable throwable);
     
     void warn(String msg, Throwable throwable, Object... args);
+    
+    default void failure(String msg, Object... args){
+        warn("[<red>x</red>] " + msg, args);
+    }
 }

core/src/main/java/ch/andre601/advancedserverlist/core/interfaces/commands/CmdSender.java

@@ -25,12 +25,12 @@
 
 package ch.andre601.advancedserverlist.core.interfaces.commands;
 
+import net.kyori.adventure.audience.Audience;
+
 public interface CmdSender{
     
-    String prefix = "<grey>[<gradient:aqua:white>AdvancedServerList</gradient>] ";
-    String errorPrefix = "<grey>[<gradient:dark_red:red>AdvancedServerList</gradient>] ";
-    
-    boolean hasPermission(String permission);
+    String prefix = "<grey>[<aqua>ASL</aqua>] ";
+    String errorPrefix = "<grey>[<red>ASL</red>] ";
     
     void sendMsg(String msg, Object... args);
     
@@ -45,4 +45,8 @@ public interface CmdSender{
     default void sendErrorMsg(String msg, Object... args){
         sendMsg(errorPrefix + msg, args);
     }
+    
+    Audience audience();
+    
+    boolean isPlayer();
 }

core/src/main/java/ch/andre601/advancedserverlist/core/interfaces/commands/CommandManagerInterface.java

@@ -1,7 +1,7 @@
 /*
  * MIT License
  *
- * Copyright (c) 2022-2023 Andre_601
+ * Copyright (c) 2022-2025 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
@@ -20,24 +20,15 @@
  * 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.velocity.commands;
+package ch.andre601.advancedserverlist.core.interfaces.commands;
 
-import ch.andre601.advancedserverlist.velocity.VelocityCore;
-import com.velocitypowered.api.command.SimpleCommand;
+import org.incendo.cloud.CommandManager;
+import org.incendo.cloud.SenderMapper;
 
-public class CmdAdvancedServerList implements SimpleCommand{
+public interface CommandManagerInterface<S>{
+    CommandManager<CmdSender> commandHandler();
     
-    private final VelocityCore plugin;
-    
-    public CmdAdvancedServerList(VelocityCore plugin){
-        this.plugin = plugin;
-    }
-    
-    @Override
-    public void execute(Invocation invocation){
-        plugin.getCore().getCommandHandler().handle(new VelocityCmdSender(invocation.source()), invocation.arguments());
-    }
+    SenderMapper<S, CmdSender> senderMapper();
 }

core/src/main/java/ch/andre601/advancedserverlist/core/interfaces/commands/CommandType.java

@@ -1,7 +1,7 @@
 /*
  * MIT License
  *
- * Copyright (c) 2022-2023 Andre_601
+ * Copyright (c) 2022-2025 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
@@ -20,32 +20,22 @@
  * 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.interfaces.commands;
 
-import java.util.Locale;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
 
-public abstract class PluginCommand{
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ElementType.METHOD, ElementType.TYPE})
+public @interface CommandType{
+    Type value();
     
-    private final String name;
-    
-    public PluginCommand(String name){
-        this.name = name;
+    enum Type{
+        ALL,
+        PLAYER_ONLY
     }
-    
-    public String name(){
-        return name;
-    }
-    
-    public String permission(){
-        return "advancedserverlist.command." + name().toLowerCase(Locale.ROOT);
-    }
-    
-    public abstract void handle(CmdSender sender, String[] args);
-    
-    public abstract String usage();
-    
-    public abstract String description();
 }

core/src/main/java/ch/andre601/advancedserverlist/core/interfaces/core/PluginCore.java

@@ -27,15 +27,15 @@ package ch.andre601.advancedserverlist.core.interfaces.core;
 
 import ch.andre601.advancedserverlist.core.AdvancedServerList;
 import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
+import ch.andre601.advancedserverlist.core.interfaces.commands.CmdSender;
 import ch.andre601.advancedserverlist.core.profiles.handlers.FaviconHandler;
+import org.incendo.cloud.CommandManager;
 
 import java.awt.image.BufferedImage;
 import java.nio.file.Path;
 
 public interface PluginCore<F>{
     
-    void loadCommands();
-    
     void loadEvents();
     
     void loadMetrics();
@@ -56,6 +56,8 @@ public interface PluginCore<F>{
     
     FaviconHandler<F> getFaviconHandler();
     
+    CommandManager<CmdSender> getCommandManager();
+    
     String getPlatformInfo();
     
     String getLoader();

core/src/main/java/ch/andre601/advancedserverlist/core/interfaces/events/GenericEventWrapper.java

@@ -52,6 +52,8 @@ public interface GenericEventWrapper<F, P extends GenericPlayer>{
     
     void setPlayers(List<String> players, P player, GenericServer server);
     
+    void setPlayersHidden();
+    
     void setFavicon(F favicon);
     
     void setDefaultFavicon();

core/src/main/java/ch/andre601/advancedserverlist/core/migration/minimotd/MiniMOTDConfigMigrator.java

@@ -56,7 +56,7 @@ public class MiniMOTDConfigMigrator{
         
         Path mainConf = core.getPlugin().getFolderPath().getParent().resolve(folder).resolve("main.conf");
         if(!Files.exists(mainConf)){
-            logger.warn("[Migrator - MiniMOTD] Cannot find a main.conf file in /plugins/%s/ folder.", folder);
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Cannot find a main.conf file in <white>/plugins/%s/</white> folder.", folder);
             sender.sendErrorMsg(" -> <red>No main.conf file found.");
             return false;
         }
@@ -76,13 +76,13 @@ public class MiniMOTDConfigMigrator{
             
             config = node.get(MiniMOTDConfig.class);
         }catch(IOException ex){
-            logger.warn("[Migrator - MiniMOTD] Encountered IOException while loading main.conf file.", ex);
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Encountered IOException while loading main.conf file.", ex);
             sender.sendErrorMsg(" -> <red>IOException while loading</red> main.conf <red>file.");
             return false;
         }
         
         if(config == null){
-            logger.warn("[Migrator - MiniMOTD] Retrieved main.conf file returned null.");
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Retrieved main.conf file returned null.");
             sender.sendErrorMsg(" -> <red>Received invalid</red> main.conf <red>file.");
             return false;
         }
@@ -147,14 +147,14 @@ public class MiniMOTDConfigMigrator{
         
         boolean profilesInvalid = profiles.isEmpty() || profiles.stream().allMatch(ProfileEntry::isInvalid);
         if(entry.isInvalid() && profilesInvalid){
-            logger.warn("[Migrator - MiniMOTD] Main ProfileEntry was invalid and profiles were empty.");
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Main ProfileEntry was invalid and profiles were empty.");
             sender.sendErrorMsg(" -> <red>Received invalid configuration.");
             return false;
         }
         
         Path profile = core.getPlugin().getFolderPath().resolve("profiles").resolve("minimotd_migrated.yml");
         if(Files.exists(profile)){
-            logger.warn("[Migrator - MiniMOTD] Cannot create new file minimotd_migrated.yml. One with the same name is already present.");
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Cannot create new file minimotd_migrated.yml. One with the same name is already present.");
             sender.sendErrorMsg(" -> <red>File</red> minimotd_migrated.yml <red>already present.");
             
             return false;
@@ -163,7 +163,7 @@ public class MiniMOTDConfigMigrator{
         try{
             Files.createFile(profile);
         }catch(IOException ex){
-            logger.warn("[Migrator - MiniMOTD] Encountered an IOException while trying to create file minimotd_migrated.yml.", ex);
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Encountered an IOException while trying to create file minimotd_migrated.yml.", ex);
             sender.sendErrorMsg(" -> <red>File creation error.");
             
             return false;
@@ -180,14 +180,14 @@ public class MiniMOTDConfigMigrator{
         try{
             migrated = yamlLoader.load();
         }catch(IOException ex){
-            logger.warn("[Migrator - MiniMOTD] Encountered an IOException while trying to load file minimotd_migrated.yml.", ex);
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Encountered an IOException while trying to load file minimotd_migrated.yml.", ex);
             sender.sendErrorMsg(" -> <red>File loading error.");
             
             return false;
         }
         
         if(migrated == null){
-            logger.warn("[Migrator - MiniMOTD] Cannot migrate Configuration. ConfigurationNode was null.");
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Cannot migrate Configuration. ConfigurationNode was null.");
             sender.sendErrorMsg(" -> <red>File loading error.");
             
             return false;
@@ -202,7 +202,7 @@ public class MiniMOTDConfigMigrator{
             
             migrated.set(entry);
         }catch(SerializationException ex){
-            logger.warn("[Migrator - MiniMOTD] Encountered a SerializationException while setting values.", ex);
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Encountered a SerializationException while setting values.", ex);
             sender.sendErrorMsg(" -> <red>Error while updating file</red> minimotd_migrated.yml<red>.");
             
             return false;
@@ -214,7 +214,7 @@ public class MiniMOTDConfigMigrator{
             
             return true;
         }catch(IOException ex){
-            logger.warn("[Migrator - MiniMOTD] Encountered an IOException while trying to save new file minimotd_migrated.yml.", ex);
+            logger.warn("[<white>Migrator - MiniMOTD</white>] Encountered an IOException while trying to save new file minimotd_migrated.yml.", ex);
             sender.sendErrorMsg(" -> <red>File saving error.");
             
             return false;

core/src/main/java/ch/andre601/advancedserverlist/core/migration/serverlistplus/SLPConfigMigrator.java

@@ -101,13 +101,13 @@ public class SLPConfigMigrator{
         ServerListPlusCore slpCore = ServerListPlusCore.getInstance();
         PluginLogger logger = core.getPlugin().getPluginLogger();
         if(slpCore == null){
-            logger.warn("[Migrator - ServerListPlus] Cannot migrate ServerListPlus config. ServerListPlus is not active!");
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Cannot migrate ServerListPlus config. ServerListPlus is not active!");
             return 0;
         }
         
         ServerStatusConf conf = slpCore.getConf(ServerStatusConf.class);
         if(conf == null){
-            logger.warn("[Migrator - ServerListPlus] Cannot migrate ServerListPlus configuration. Received configuration was null.");
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Cannot migrate ServerListPlus configuration. Received configuration was null.");
             return 0;
         }
         
@@ -130,7 +130,7 @@ public class SLPConfigMigrator{
     private static int parseConf(AdvancedServerList<?> core, CmdSender sender, PersonalizedStatusConf.StatusConf conf, Type type){
         PluginLogger logger = core.getPlugin().getPluginLogger();
         if(conf == null){
-            logger.info("[Migrator - ServerListPlus] No StatusConf found for type %s. Skipping...", type.getName());
+            logger.info("[<white>Migrator - ServerListPlus</white>] No StatusConf found for type <white>%s</white>. Skipping...", type.getName());
             sender.sendPrefixedMsg(" -> Not found! Skipping...");
             
             return 0;
@@ -170,7 +170,7 @@ public class SLPConfigMigrator{
         
         boolean profilesInvalid = profileEntries.isEmpty() || profileEntries.stream().anyMatch(ProfileEntry::isInvalid);
         if(entry.isInvalid() && profilesInvalid){
-            logger.warn("[Migrator - ServerListPlus] Unable to parse ServerListPlus configuration of type %s. Generated ProfileEntry was invalid.", type.getName());
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Unable to parse ServerListPlus configuration of type <white>%s</white>. Generated ProfileEntry was invalid.", type.getName());
             sender.sendErrorMsg(" -> <red>Received invalid Configuration.");
             
             return 0;
@@ -178,7 +178,7 @@ public class SLPConfigMigrator{
         
         Path profile = core.getPlugin().getFolderPath().resolve("profiles").resolve(type.getFile());
         if(Files.exists(profile)){
-            logger.warn("[Migrator - ServerListPlus] Cannot create new file %s. One with the same name is already present", type.getFile());
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Cannot create new file <white>%s</white>. One with the same name is already present", type.getFile());
             sender.sendErrorMsg(" -> <red>File</red> %s <red>already present.", type.getFile());
             
             return 0;
@@ -187,7 +187,7 @@ public class SLPConfigMigrator{
         try{
             Files.createFile(profile);
         }catch(IOException ex){
-            logger.warn("[Migrator - ServerListPlus] Encountered an IOException while trying to create file %s.", ex, type.getFile());
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Encountered an IOException while trying to create file <white>%s</white>.", ex, type.getFile());
             sender.sendErrorMsg(" -> <red>File creation error.");
             
             return 0;
@@ -204,14 +204,14 @@ public class SLPConfigMigrator{
         try{
             node = loader.load();
         }catch(IOException ex){
-            logger.warn("[Migrator - ServerListPlus] Encountered an IOException while trying to load file %s.", ex, type.getFile());
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Encountered an IOException while trying to load file <white>%s</white>.", ex, type.getFile());
             sender.sendErrorMsg(" -> <red>File loading error.");
             
             return 0;
         }
         
         if(node == null){
-            logger.warn("[Migrator - ServerListPlus] Cannot migrate Configuration of type %s. ConfigurationNode was null.", type.getName());
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Cannot migrate Configuration of type <white>%s</white>. ConfigurationNode was null.", type.getName());
             sender.sendErrorMsg(" -> <red>File loading error.");
             
             return 0;
@@ -236,7 +236,7 @@ public class SLPConfigMigrator{
             
             node.set(entry);
         }catch(SerializationException ex){
-            logger.warn("[Migrator - ServerListPlus] Encountered a SerializationException while setting values.", ex);
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Encountered a SerializationException while setting values.", ex);
             sender.sendErrorMsg(" -> <red>Error while updating file</red> %s<red>.", type.getFile());
             
             return 0;
@@ -248,7 +248,7 @@ public class SLPConfigMigrator{
             
             return 1;
         }catch(IOException ex){
-            logger.warn("[Migrator - ServerListPlus] Encountered an IOException while trying to save new file %s.", ex, type.getFile());
+            logger.warn("[<white>Migrator - ServerListPlus</white>] Encountered an IOException while trying to save new file <white>%s</white>.", ex, type.getFile());
             sender.sendErrorMsg(" -> <red>File saving error.");
             
             return 0;

core/src/main/java/ch/andre601/advancedserverlist/core/parsing/ComponentParser.java

@@ -51,8 +51,13 @@ public class ComponentParser{
         return new ComponentParser(text);
     }
     
+    public static ComponentParser textFormatted(String text, Object... args){
+        return text(String.format(text, args));
+    }
+    
     public ComponentParser modifyText(Function<String, String> function){
         this.text = function.apply(text);
+        
         return this;
     }
     
@@ -68,4 +73,8 @@ public class ComponentParser{
     public String toString(){
         return legacy.serialize(toComponent());
     }
+    
+    public String toStringStriped(){
+        return mm.stripTags(text);
+    }
 }

core/src/main/java/ch/andre601/advancedserverlist/core/parsing/TextCenterUtil.java

@@ -89,7 +89,7 @@ public class TextCenterUtil{
         }catch(IOException ex){
             plugin.getPlugin().getPluginLogger().warn("Encountered IOException while loading font widths.");
             plugin.getPlugin().getPluginLogger().warn("The <center> Placeholder won't work.");
-            plugin.getPlugin().getPluginLogger().warn("Cause: %s", ex.getMessage());
+            plugin.getPlugin().getPluginLogger().warn("Cause: <white>%s</white>", ex.getMessage());
             return new HashMap<>();
         }
     }

core/src/main/java/ch/andre601/advancedserverlist/core/profiles/ServerListProfile.java

@@ -51,13 +51,13 @@ public record ServerListProfile(int priority, String condition, ProfileEntry def
         boolean result = core.getParser().evaluate(condition, player, server, collector);
         
         if(collector.hasWarnings()){
-            logger.warn("Encountered %d Error(s) while parsing condition for file '%s':", collector.getWarnings().size(), file);
+            logger.warn("Encountered <white>%d</white> Error(s) while parsing condition for file '<white>%s</white>':", collector.getWarnings().size(), file);
             
             for(ParseWarnCollector.Context context : collector.getWarnings()){
-                logger.warn("  - At position %s:", context.position() == -1 ? "Unknown" : context.position());
-                logger.warn("    %s", condition);
-                logger.warn(" ".repeat(context.position() + 3) + "^");
-                logger.warn("    -> %s", context.message());
+                logger.warn("  - At position <white>%s</white>:", context.position() == -1 ? "<italic>Unknown</italic>" : context.position());
+                logger.warn("    <white>%s</white>", condition);
+                logger.warn(" ".repeat(context.position() + 3) + "<red>^</red>");
+                logger.warn("    <grey>-></grey> %s", context.message());
             }
         }
         
@@ -146,7 +146,7 @@ public record ServerListProfile(int priority, String condition, ProfileEntry def
             try{
                 this.profiles = node.node("profiles").getList(ProfileEntry.class);
             }catch(SerializationException ex){
-                logger.warn("Encountered a SerializationException while resolving the profiles entry for %s", ex, fileName);
+                logger.warn("Encountered a SerializationException while resolving the profiles entry for <white>%s</white>", ex, fileName);
             }
             
             return this;
@@ -159,7 +159,7 @@ public record ServerListProfile(int priority, String condition, ProfileEntry def
             try{
                 this.defaultProfile = node.get(ProfileEntry.class);
             }catch(SerializationException ex){
-                logger.warn("Encountered a SerializationException while resolving the global profile for %s", ex, fileName);
+                logger.warn("Encountered a SerializationException while resolving the global profile for <white>%s</white>", ex, fileName);
             }
             return this;
         }

core/src/main/java/ch/andre601/advancedserverlist/core/profiles/handlers/FaviconHandler.java

@@ -1,28 +1,3 @@
-/*
- * MIT License
- *
- * Copyright (c) 2022-2024 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.profiles.handlers;
 
 import ch.andre601.advancedserverlist.core.AdvancedServerList;
@@ -42,9 +17,12 @@ import java.net.http.HttpRequest;
 import java.net.http.HttpResponse;
 import java.nio.file.Files;
 import java.nio.file.Path;
-import java.util.List;
 import java.util.*;
-import java.util.concurrent.*;
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.LinkedBlockingDeque;
+import java.util.concurrent.ThreadPoolExecutor;
+import java.util.concurrent.TimeUnit;
 import java.util.stream.Stream;
 
 public class FaviconHandler<F>{
@@ -54,181 +32,305 @@ public class FaviconHandler<F>{
     private final ThreadPoolExecutor faviconThreadPool;
     private final Cache<String, CompletableFuture<F>> faviconCache;
     
-    private final Map<String, F> localFavicons = new HashMap<>();
-    private final HttpClient client = HttpClient.newHttpClient();
     private final Random random = new Random();
+    private final HttpClient client = HttpClient.newHttpClient();
+    private final Map<String, FaviconPair<F>> localFavicons = new HashMap<>();
     
     public FaviconHandler(AdvancedServerList<F> core){
         this.core = core;
         this.logger = core.getPlugin().getPluginLogger();
-        this.faviconThreadPool = createFaviconThreadPool();
+        this.faviconThreadPool = createThreadPool();
         this.faviconCache = CacheBuilder.newBuilder()
-            .expireAfterWrite(core.getFileHandler().getLong(1, 1, "faviconCacheTime"), TimeUnit.MINUTES)
-            .build();
+                .expireAfterWrite(core.getFileHandler().getLong(1, 1, "faviconCacheTime"), TimeUnit.MINUTES)
+                .build();
         
         loadLocalFavicons();
     }
     
-    public F getFavicon(String input){
-        if(localFavicons.size() > 0){
-            logger.debug(FaviconHandler.class, "Current Local Favicons:");
-            for(String key : localFavicons.keySet()){
-                logger.debug(FaviconHandler.class, "  - %s", key);
-            }
+    public F favicon(String input){
+        if(localFavicons.containsKey(input.toLowerCase(Locale.ROOT))){
+            logger.debug(FaviconHandler.class, "Returning local Favicon '%s'.", input);
+            
+            return localFavicons.get(input.toLowerCase(Locale.ROOT)).favicon();
         }
         
         if(input.equalsIgnoreCase("random")){
-            logger.debug(FaviconHandler.class, "Input matches 'random'. Returning random Favicon...");
-            return getRandomized();
+            logger.debug(FaviconHandler.class, "Returning random local Favicon.");
+            
+            FaviconPair<F> pair = randomFavicon();
+            if(pair == null){
+                logger.warn("Cannot return random Favicon. Make sure PNGs are available in the Favicons folder!");
+                return null;
+            }
+            
+            return pair.favicon();
         }
         
-        if(localFavicons.containsKey(input.toLowerCase(Locale.ROOT))){
-            logger.debug(FaviconHandler.class, "Input matches local favicon Image. Returning it...");
-            return localFavicons.get(input.toLowerCase(Locale.ROOT));
+        CompletableFuture<F> favicon = faviconCache.getIfPresent(input);
+        if(favicon != null)
+            return favicon.getNow(null);
+        
+        logger.debug(FaviconHandler.class, "Processing '%s'", input);
+        if(input.contains(";")){
+            String[] parts = input.split(";");
+            logger.debug(FaviconHandler.class, "Handling multi-part Favicon: ['%s']", String.join("', '", parts));
+            favicon = CompletableFuture.supplyAsync(() -> {
+                List<BufferedImage> images = new ArrayList<>();
+                Arrays.stream(parts).forEach(part -> {
+                    logger.debug(FaviconHandler.class, "Creating BufferedImage for part '%s'...", part);
+                    images.add(create(part));
+                });
+                
+                if(images.isEmpty()){
+                    logger.debugWarn(FaviconHandler.class, "Unable to create Multi-part Favicon. List was empty.");
+                    return null;
+                }
+                
+                return composeFavicon(images);
+            }, faviconThreadPool);
+        }else{
+            logger.debug(FaviconHandler.class, "Handling Favicon input '%s'...", input);
+            
+            favicon = CompletableFuture.supplyAsync(() -> {
+                logger.debug(FaviconHandler.class, "Creating BufferedImage for '%s'...", input);
+                
+                BufferedImage image = create(input);
+                if(image == null){
+                    logger.warn("Cannot create Favicon for '%s'. BufferedImage was null!", input);
+                    return null;
+                }
+                
+                return createFavicon(image);
+            }, faviconThreadPool);
         }
         
-        try{
-            logger.debug(FaviconHandler.class, "Getting Favicon image from cache...");
-            return faviconCache.get(input, () -> getFuture(input)).getNow(null);
-        }catch(ExecutionException ex){
-            logger.warn("Received ExecutionException while retrieving Favicon for '%s'.", ex, input);
-            return null;
-        }
+        faviconCache.put(input, favicon);
+        return favicon.getNow(null);
     }
     
     public void cleanCache(){
-        faviconCache.invalidateAll();
+        localFavicons.clear();
         loadLocalFavicons();
     }
     
-    private CompletableFuture<F> getFuture(String input){
+    private F composeFavicon(List<BufferedImage> images){
+        logger.debug(FaviconHandler.class, "Composing Favicon out of %d part(s)...", images.size());
+        BufferedImage image = new BufferedImage(64, 64, BufferedImage.TYPE_INT_ARGB);
+        Graphics2D graphics = image.createGraphics();
+        
+        String strategy = core.getFileHandler().getString("resize", "faviconStrategy");
+        int layer = 0;
+        for(BufferedImage img : images){
+            layer++;
+            logger.debug(FaviconHandler.class, "Applying layer %d...", layer);
+            if(img == null){
+                logger.debugWarn(FaviconHandler.class, "Layer %d was null! Skipping...", layer);
+                continue;
+            }
+            
+            switch(strategy.toLowerCase(Locale.ROOT)){
+                case "center" -> {
+                    int height = img.getHeight();
+                    int width = img.getWidth();
+                    
+                    int posHeight = 0;
+                    int posWidth = 0;
+                    if(height != 64){
+                        posHeight = (64 - height) / 2;
+                    }
+                    
+                    // 64 - 128 = -64
+                    
+                    if(width != 64){
+                        posWidth = (64 - width) / 2;
+                    }
+                    
+                    graphics.drawImage(img, posWidth, posHeight, img.getWidth(), img.getHeight(), null);
+                }
+                case "none" -> graphics.drawImage(img, 0, 0, img.getWidth(), img.getHeight(), null);
+                default -> graphics.drawImage(img, 0, 0, 64, 64, null);
+            }
+            
+            logger.debug(FaviconHandler.class, "Applied layer %d!", layer);
+        }
+        
+        graphics.dispose();
+        
+        logger.debug(FaviconHandler.class, "Image Composing complete! Creating Favicon instance...");
+        return createFavicon(image);
+    }
+    
+    private BufferedImage create(String input){
         if(input.toLowerCase(Locale.ROOT).startsWith("https://")){
-            logger.debug(FaviconHandler.class, "Resolving URL '%s'...", input);
-            return CompletableFuture.supplyAsync(() -> fromURL(core, input), this.faviconThreadPool);
+            logger.debug(FaviconHandler.class, "Handling URL '%s'...", input);
+            return fromURL(input);
         }else
         if(input.equalsIgnoreCase("random")){
-            return CompletableFuture.completedFuture(getRandomized());
+            logger.debug(FaviconHandler.class, "Returning random local Favicon...");
+            FaviconPair<F> pair = randomFavicon();
+            return pair == null ? null : pair.image();
         }else
         if(input.toLowerCase(Locale.ROOT).endsWith(".png")){
-            logger.debug(FaviconHandler.class, "Resolving image file '%s'...", input);
-            return CompletableFuture.completedFuture(localFavicons.get(input.toLowerCase(Locale.ROOT)));
+            logger.debug(FaviconHandler.class, "Returning local Favicon '%s'...", input);
+            return localFavicons.get(input.toLowerCase(Locale.ROOT)).image();
         }else{
-            logger.debug(FaviconHandler.class, "Resolving Name/UUID as https://mc-heads.net/avatar/%s/64...", input);
-            return CompletableFuture.supplyAsync(() -> fromURL(core, "https://mc-heads.net/avatar/" + input + "/64"), this.faviconThreadPool);
+            logger.debug(FaviconHandler.class, "Handling Player Name/UUID '%s'...", input);
+            return fromURL("https://mc-heads.net/avatar/" + input + "/64");
         }
     }
     
-    private F getRandomized(){
-        logger.debug(FaviconHandler.class, "Obtaining random Favicon...");
+    private FaviconPair<F> randomFavicon(){
         if(localFavicons.isEmpty())
             return null;
         
-        List<F> faviconList = List.copyOf(localFavicons.values());
+        List<FaviconPair<F>> favicons = new ArrayList<>(localFavicons.values());
+        if(favicons.isEmpty())
+            return null;
         
-        // Don't use Random for just one entry.
-        if(faviconList.size() == 1)
-            return faviconList.get(0);
+        if(favicons.size() == 1)
+            return favicons.getFirst();
         
         synchronized(random){
-            return faviconList.get(random.nextInt(faviconList.size()));
+            return favicons.get(random.nextInt(favicons.size()));
         }
     }
     
     private void loadLocalFavicons(){
         this.localFavicons.clear();
         
-        logger.info("Loading local image files as Favicons...");
+        logger.info("[-] Loading local images as Favicons...");
         
         Path folder = core.getPlugin().getFolderPath().resolve("favicons");
         if(!Files.exists(folder)){
             try{
                 Files.createDirectories(folder);
-                logger.info("Created favicons folder.");
+                logger.debugSuccess(FaviconHandler.class, "Created favicons folder");
             }catch(IOException ex){
-                logger.warn("Cannot create favicons folder. Encountered an IOException.", ex);
+                logger.warn("Encountered IOException while creating favicons folder.", ex);
                 return;
             }
         }
         
-        try(Stream<Path> pathStream = Files.list(folder)){
-            pathStream.filter(Files::isRegularFile)
-                .filter(file -> file.getFileName().toString().endsWith(".png"))
-                .forEach(this::loadFile);
+        try(Stream<Path> stream = Files.list(folder)){
+            stream.filter(Files::isRegularFile)
+                    .filter(file -> file.getFileName().toString().endsWith(".png"))
+                    .forEach(this::loadFile);
+            
+            logger.success("Loaded <white>%s</white> local Favicon(s).", localFavicons.size());
         }catch(IOException ex){
-            logger.warn("Cannot load files from Favicons folder.", ex);
+            logger.warn("Encountered IOException while loading local favicons.", ex);
         }
     }
     
     private void loadFile(Path path){
         try(InputStream stream = Files.newInputStream(path)){
-            F favicon = createFavicon(stream);
-            if(favicon == null){
-                logger.warn("Cannot create Favicon from file '%s'. Received Favicon was null.", path.getFileName().toString());
+            BufferedImage image = createBufferedImage(stream);
+            if(image == null)
                 return;
-            }
             
-            localFavicons.put(path.getFileName().toString().toLowerCase(Locale.ROOT), favicon);
-            logger.info("Loaded file '%s' as Favicon.", path.getFileName().toString());
+            F favicon = core.getPlugin().createFavicon(image);
+            if(favicon == null)
+                return;
+            
+            localFavicons.put(path.getFileName().toString().toLowerCase(Locale.ROOT), new FaviconPair<>(image, favicon));
         }catch(IOException ex){
-            logger.warn("Cannot create Favicon from file '%s'. Encountered IOException.", ex);
+            logger.warn("Encountered IOException while creating a Favicon from '%s'.", ex, path.getFileName().toString());
+        }catch(Exception ex){
+            logger.warn("Encountered an Exceotion while creating a Favicon from '%s'.", ex, path.getFileName().toString());
         }
     }
     
-    private F fromURL(AdvancedServerList<F> core, String url){
+    private BufferedImage fromURL(String url){
         try{
-            logger.debug(FaviconHandler.class, "Creating Request for URL '%s'...", url);
+            logger.debug(FaviconHandler.class, "Creating request for URL '%s'...", url);
             HttpRequest request = HttpRequest.newBuilder()
-                .uri(new URI(url))
-                .header("User-Agent", "AdvancedServerList-" + core.getPlugin().getLoader() + "/" + core.getVersion())
-                .build();
+                    .uri(new URI(url))
+                    .header("User-Agent", "AdvancedServerList-" + core.getPlugin().getLoader() + "/" + core.getVersion())
+                    .build();
             
             try(InputStream stream = client.send(request, HttpResponse.BodyHandlers.ofInputStream()).body()){
-                return createFavicon(stream);
-            }catch(InterruptedException | IOException ex){
-                logger.warn("Cannot create Favicon from URL '%s'. Encountered an Exception.", ex, url);
+                return createBufferedImage(stream);
+            }catch(IOException ex){
+                logger.warn("Encountered IOException while performing a web request for '%s'.", ex, url);
+                return null;
+            }catch(InterruptedException ex){
+                logger.warn("Encountered an InterruptedException while performing a web request for '%s'.", ex, url);
                 return null;
             }
         }catch(URISyntaxException ex){
-            logger.warn("Cannot create Favicon from URL '%s'. Encountered an IOException.", ex, url);
+            logger.warn("Received URISyntaxException for URL '%s'", ex, url);
             return null;
         }
     }
     
-    private F createFavicon(InputStream stream){
+    private BufferedImage createBufferedImage(InputStream stream){
+        logger.debug(FaviconHandler.class, "Creating BufferedImage from InputStream...");
         try{
-            logger.debug(FaviconHandler.class, "Creating BufferedImage from InputStream...");
             BufferedImage original = ImageIO.read(stream);
             if(original == null){
-                logger.warn("Cannot create Favicon. Received null BufferedImage.");
+                logger.warn("Cannot create Favicon. Received a null BufferedImage!");
                 return null;
             }
             
-            // Don't waste resources resizing images already having right size.
-            if(original.getWidth() == 64 && original.getHeight() == 64){
-                logger.debug(FaviconHandler.class, "BufferedImage is 64x64 pixels. No resizing needed.");
-                return core.getPlugin().createFavicon(original);
+            logger.debug(FaviconHandler.class, "Check image size for possible resizing...");
+            if(original.getHeight() == 64 && original.getWidth() == 64){
+                logger.debug(FaviconHandler.class, "Image is 64x64. No resizing needed!");
+                return original;
             }
             
-            logger.debug(FaviconHandler.class, "Resizing image to 64x64 pixels...");
+            logger.debug(FaviconHandler.class, "Applying Favicon resize strategy...");
             BufferedImage image = new BufferedImage(64, 64, BufferedImage.TYPE_INT_ARGB);
-            Graphics2D graphics2D = image.createGraphics();
+            Graphics2D graphics = image.createGraphics();
             
-            graphics2D.drawImage(original, 0, 0, 64, 64, null);
-            graphics2D.dispose();
+            String resizeMode = core.getFileHandler().getString("resize", "faviconStrategy");
+            switch(resizeMode.toLowerCase(Locale.ROOT)){
+                case "center" -> {
+                    int height = original.getHeight();
+                    int width = original.getWidth();
+                    
+                    int posHeight = 0;
+                    int posWidth = 0;
+                    if(height != 64){
+                        posHeight = (64 - height) / 2;
+                    }
+                    
+                    if(width != 64){
+                        posWidth = (64 - width) / 2;
+                    }
+                    
+                    graphics.drawImage(original, posWidth, posHeight, original.getWidth(), original.getHeight(), null);
+                }
+                case "none" -> graphics.drawImage(original, 0, 0, original.getWidth(), original.getHeight(), null);
+                default -> graphics.drawImage(original, 0, 0, 64, 64, null);
+            }
             
-            logger.debug(FaviconHandler.class, "Image resized! Returning Favicon...");
-            return core.getPlugin().createFavicon(image);
-        }catch(Exception ex){
-            logger.warn("Unable to create Favicon. Received Exception.", ex);
+            graphics.dispose();
+            
+            logger.debug(FaviconHandler.class, "Image resized. Returning it...");
+            return image;
+        }catch(IOException ex){
+            logger.warn("Encountered an IOException while processing Favicon!", ex);
             return null;
         }
     }
     
-    private ThreadPoolExecutor createFaviconThreadPool(){
+    private F createFavicon(BufferedImage image){
+        try{
+            return core.getPlugin().createFavicon(image);
+        }catch(Exception ex){
+            logger.warn("Encountered an Exception while trying to create a Favicon instance.", ex);
+            return null;
+        }
+    }
+    
+    private ThreadPoolExecutor createThreadPool(){
         return new ThreadPoolExecutor(3, 3, 60L, TimeUnit.SECONDS, new LinkedBlockingDeque<>(1024), r -> {
             Thread t = new Thread(r, "AdvancedServerList-FaviconThread");
             t.setDaemon(true);
+            
             return t;
         });
     }
+    
+    private record FaviconPair<F>(BufferedImage image, F favicon){}
 }

core/src/main/java/ch/andre601/advancedserverlist/core/profiles/handlers/PlayerHandler.java

@@ -79,40 +79,40 @@ public class PlayerHandler{
         try(BufferedReader reader = Files.newBufferedReader(cache)){
             cachedPlayers = gson.fromJson(reader, listType);
         }catch(IOException ex){
-            logger.warn("Encountered IOException while reading the playercache.json file!", ex);
+            logger.warn("Encountered IOException while reading the <white>playercache.json</white> file!", ex);
             return;
         }catch(JsonIOException | JsonSyntaxException ex){
-            logger.warn("Encountered JsonSyntaxException while parsing playercache.json file!", ex);
+            logger.warn("Encountered JsonSyntaxException while parsing <white>playercache.json</white> file!", ex);
             return;
         }
         
         // In case Gson messes up... I guess.
         if(cachedPlayers == null){
-            logger.warn("Couldn't load players from playercache.json file. Is the JSON valid?");
+            logger.warn("Couldn't load players from <white>playercache.json</white> file. Is the JSON valid?");
             // Create new ArrayList instance to avoid further issues.
             cachedPlayers = new ArrayList<>();
             return;
         }
         
-        logger.info("Loaded %d players into cache!", cachedPlayers.size());
+        logger.success("Loaded <white>%d</white> players into cache!", cachedPlayers.size());
     }
     
     public void save(){
         if(cachedPlayers.isEmpty()){
-            logger.info("No players in cache to save. Skipping...");
+            logger.debug(PlayerHandler.class, "No players in cache to save. Skipping...");
             return;
         }
         
         if(core.getFileHandler().getBoolean("disableCache")){
-            logger.info("'disable_cache' is set to true. Skipping saving of cached players...");
+            logger.debug(PlayerHandler.class, "[-] 'disable_cache' is set to true. Not saving cached players.");
             return;
         }
         
         try(BufferedWriter writer = Files.newBufferedWriter(cache, StandardCharsets.UTF_8)){
             gson.toJson(cachedPlayers, listType, writer);
-            logger.info("Successfully saved playercache.json file.");
+            logger.success("Successfully saved <white>playercache.json</white> file.");
         }catch(IOException ex){
-            logger.warn("Encountered IOException while saving cached players to playercache.json!", ex);
+            logger.failure("Encountered IOException while saving cached players to <white>playercache.json</white>!", ex);
         }
     }
     

core/src/main/java/ch/andre601/advancedserverlist/core/profiles/profile/ProfileManager.java

@@ -56,6 +56,7 @@ public class ProfileManager{
         NullBool extraPlayersEnabled = resolve(defEntry, entry, ProfileEntry::extraPlayersEnabled);
         NullBool maxPlayersEnabled = resolve(defEntry, entry, ProfileEntry::maxPlayersEnabled);
         NullBool onlinePlayersEnabled = resolve(defEntry, entry, ProfileEntry::onlinePlayersEnabled);
+        NullBool hidePlayersHoverEnabled = resolve(defEntry, entry, ProfileEntry::hidePlayersHoverEnabled);
         String extraPlayersCount = resolve(defEntry, entry, ProfileEntry::extraPlayersCount);
         String maxPlayersCount = resolve(defEntry, entry, ProfileEntry::maxPlayersCount);
         String onlinePlayersCount = resolve(defEntry, entry, ProfileEntry::onlinePlayersCount);
@@ -69,6 +70,7 @@ public class ProfileManager{
             .extraPlayersEnabled(extraPlayersEnabled)
             .maxPlayersEnabled(maxPlayersEnabled)
             .onlinePlayersEnabled(onlinePlayersEnabled)
+            .hidePlayersHoverEnabled(hidePlayersHoverEnabled)
             .extraPlayersCount(extraPlayersCount)
             .maxPlayersCount(maxPlayersCount)
             .onlinePlayersCount(onlinePlayersCount)
@@ -96,6 +98,7 @@ public class ProfileManager{
         NullBool extraPlayersEnabled = resolveNullBool(node, "playerCount", "extraPlayers", "enabled");
         NullBool maxPlayersEnabled = resolveNullBool(node, "playerCount", "maxPlayers", "enabled");
         NullBool onlinePlayersEnabled = resolveNullBool(node, "playerCount", "onlinePlayers", "enabled");
+        NullBool hidePlayersHoverEnabled = resolveNullBool(node, "playerCount", "hidePlayersHover");
         String extraPlayers = resolveNullableString(node, "playerCount", "extraPlayers", "amount");
         String maxPlayers = resolveNullableString(node, "playerCount", "maxPlayers", "amount");
         String onlinePlayers = resolveNullableString(node, "playerCount", "onlinePlayers", "amount");
@@ -109,6 +112,7 @@ public class ProfileManager{
             .extraPlayersEnabled(extraPlayersEnabled)
             .maxPlayersEnabled(maxPlayersEnabled)
             .onlinePlayersEnabled(onlinePlayersEnabled)
+            .hidePlayersHoverEnabled(hidePlayersHoverEnabled)
             .extraPlayersCount(extraPlayers)
             .maxPlayersCount(maxPlayers)
             .onlinePlayersCount(onlinePlayers)
@@ -116,20 +120,13 @@ public class ProfileManager{
     }
     
     public static boolean checkOption(Object obj){
-        if(obj == null)
-            return false;
+        return switch(obj){
+            case List<?> list -> !list.isEmpty(); // Check if list isn't empty
+            case String str -> !str.isEmpty(); // Check if String is not empty
+            case NullBool nb -> nb.getOrDefault(false); // Return NullBool's value
+            case null, default -> false;
+        };
         
-        if(obj instanceof List<?> list){
-            return !list.isEmpty(); // Check if list isn't empty
-        }else
-        if(obj instanceof String str){
-            return !str.isEmpty(); // Check if String is not empty
-        }else
-        if(obj instanceof NullBool nb){
-            return nb.getOrDefault(false); // Return NullBool's value
-        }
-        
-        return false;
     }
     
     private static <T> T resolve(ProfileEntry defProfile, ProfileEntry profile, Function<ProfileEntry, T> function){

core/src/main/java/ch/andre601/advancedserverlist/core/profiles/profile/ProfileSerializer.java

@@ -53,6 +53,7 @@ public class ProfileSerializer implements TypeSerializer<ProfileEntry>{
         node.node("playerCount", "text").set(profile.playerCountText());
         node.node("favicon").set(profile.favicon());
         node.node("playerCount", "hidePlayers").set(profile.hidePlayersEnabled().getOrDefault(false));
+        node.node("playerCount", "hidePlayersHover").set(profile.hidePlayersHoverEnabled().getOrDefault(false));
         node.node("playerCount", "extraPlayers", "enabled").set(profile.extraPlayersEnabled().getOrDefault(false));
         node.node("playerCount", "extraPlayers", "amount").set((profile.extraPlayersCount() == null) ? "0" : profile.extraPlayersCount());
         node.node("playerCount", "maxPlayers", "enabled").set(profile.maxPlayersEnabled().getOrDefault(false));

core/src/main/java/ch/andre601/advancedserverlist/core/profiles/replacer/StringReplacer.java

@@ -34,9 +34,14 @@ import ch.andre601.advancedserverlist.core.profiles.conditions.placeholders.toke
 import ch.andre601.expressionparser.ParseWarnCollector;
 
 import java.text.ParsePosition;
+import java.util.function.Function;
 
 public class StringReplacer{
     
+    public static StringModifier modifier(String text){
+        return new StringModifier(text);
+    }
+    
     public static String replace(String input, GenericPlayer player, GenericServer server){
         if(input == null)
             return null;
@@ -111,7 +116,7 @@ public class StringReplacer{
                 raw.append(' ').append(valuesStr);
             
             if(collector != null)
-                collector.appendWarningFormatted(index, "Placeholder '%s' does not have a closing bracket (})", raw.toString());
+                collector.appendWarningFormatted(index, "Placeholder '<white>%s</white>' does not have a closing bracket (})", raw.toString());
             
             return raw.toString();
         }
@@ -126,7 +131,7 @@ public class StringReplacer{
             raw.append('}');
             
             if(collector != null)
-                collector.appendWarningFormatted(placeholderStart, "Placeholder '%s' does not have any available PlaceholderProvider", raw.toString());
+                collector.appendWarningFormatted(placeholderStart, "Placeholder '<white>%s</white>' does not have any available PlaceholderProvider", raw.toString());
             
             return raw.toString();
         }
@@ -141,11 +146,29 @@ public class StringReplacer{
             raw.append('}');
             
             if(collector != null)
-                collector.appendWarningFormatted(valueStart, "Placeholder '%s' has an invalid value String '%s'", raw.toString(), valuesStr);
+                collector.appendWarningFormatted(valueStart, "Placeholder '<white>%s</white>' has an invalid value String '<white>%s</white>'", raw.toString(), valuesStr);
             
             return raw.toString();
         }
         
         return replacement;
     }
+    
+    public static class StringModifier{
+        private String value;
+        
+        public StringModifier(String value){
+            this.value = value;
+        }
+        
+        public StringModifier modify(Function<String, String> function){
+            this.value = function.apply(value);
+            
+            return this;
+        }
+        
+        public String asString(){
+            return value;
+        }
+    }
 }

core/src/main/resources/config.yml

@@ -48,6 +48,14 @@ checkUpdates: true
 #
 debug: false
 
+#
+# Should the "ASL" ASCI art be displayed on plugin startup?
+# Setting this to false will hide the banner.
+#
+# Default: true
+#
+printBanner: true
+
 #
 # Sets how long Favicons should be cached. Value is in minutes with the lowest possible value being 1.
 #
@@ -58,6 +66,19 @@ debug: false
 #
 faviconCacheTime: 1
 
+#
+# Sets how AdvancedServerList should handle the size and positioning of images for favicons.
+#
+# Available options:
+#
+#   - resize: Resizes the image to 64x64 pixels if it isn't these dimensions already.
+#   - center: Doesn't resize the image, but instead tries to center it as good as possible in a 64x64 area.
+#   - none:   Doesn't resize the image and leaves it positioned at x 0 and y 0 (top-left) of the 64x64 area.
+#
+# Setting any not listed option or leaving this blank/removing it sets the option to resize.
+#
+faviconStrategy: 'resize'
+
 #
 # Options to disable while the Maintenance Plugin is present and Maintenance Mode is active.
 #
@@ -84,6 +105,12 @@ disableDuringMaintenance:
   #
   hidePlayers: true
   #
+  # Whether hiding player list on hover should be disabled while Maintenance mode is active.
+  #
+  # Default: true
+  #
+  hidePlayersHover: true
+  #
   # Whether player count text changing should be disabled while Maintenance mode is active.
   #
   # Default: true

core/src/main/resources/profiles/default.yml

@@ -10,9 +10,9 @@ priority: 0
 # Set condition(s) that should return true to display this profile.
 # This allows you to create profiles to only show for specific scenarios (i.e. player is banned).
 #
-# Multiple conditions can be chaing with the keywords 'and', 'or', or their counterparts '&&' and '||'.
+# 'AND'/'&&' and 'OR'/'||' can be used to chain together multiple conditions.
 #
-# No condition or an empty condition will be treated as true by default.
+# Removing the condition option or setting it to an empty String will be treated as a true condition being returned.
 #
 # Read more: https://asl.andre601.ch/profiles/#condition
 #
@@ -40,8 +40,11 @@ profiles:
 
 #
 # Set the "Message of the day" to display.
-# This option supports RGB colors for 1.16+ Servers and clients, including gradients using MiniMessage's <gradient>
-# option.
+# This option supports RGB colors for 1.16+ Servers and clients. More advanced MiniMessage features such as <gradient>
+# can be used for further styling the text.
+#
+# <center> can be put at the start of a line to have AdvancedServerList automatically center the text as good as
+# possible.
 #
 # Only the first two lines will be considered and any additional one is ignored.
 #
@@ -55,27 +58,30 @@ motd:
 
 #
 # Set the Favicon (image on the left of a server entry) to display.
-# This option supports three types of inputs:
+# This option supports three types of input:
 #
-#   1. Name, including .png extension, pointing to an image located in the plugin's favicons folder.
-#   2. "random" to display a random PNG from the favicons folder.
+#   1. Filename, including the .png extension, matching a filename in the favicons folder of the plugin.
+#      - 'random' can be used to have AdvancedServerList select a random image from the favicons folder every time
+#        the server is pinged.
 #   3. URL pointing to an image.
-#   4. Player name, UUID or placeholders returning one of these.
-#      https://mc-heads.net will be used to retrieve an image of the provided name/UUID.
+#   4. Player name, UUID or a placeholder that returns either.
+#      - https://mc-heads.net will be used to retrieve an image of the provided name/UUID.
 #
-# Note on favicons not showing:
-#   AdvancedServerList has to create a Favicon object for the Proxy/Server to use which takes time to do so.
-#   To not delay the Proxy/Server from being displayed (increase the loading time on the player end) is this creation
-#   done asynchronously for URL/Player name/UUID. This has the downside that the Proxy/Server may be done handling the
-#   ping before the Favicon is created, causing none to be displayed.
-#   Note that this won't happen with local favicons, as those are created during the plugin's startup.
-#
-# Any images above or below 64x64 pixels will be automatically resized to these dimensions.
+# Any image below or above 64x64 pixels will be resized according to the faviconResizeMode option in the config.yml.
 #
 # If not present or empty (favicon: ''), defaults to not modifying the favicon.
 #
 # Read more: https://asl.andre601.ch/profiles/#favicon
 #
+# "The favicon isn't showing!"
+#   This is a side effect of using either URLs or player names/UUIDs for the favicon.
+#   These types require AdvancedServerList to create a new favicon object from scratch. This action takes a significant
+#   amount of time, which can cause the server to show with a huge ping.
+#   To avoid this is this action performed asynchronously. This means that the plugin doesn't wait for the favicon to
+#   be created before continuing, which can result in no favicon being available when it is done handling the ping.
+#   This should only happen for the first ping of a player and subsequent pings should display the favicon, if the
+#   pings are done within the configured cache time (See 'faviconCacheTime' in the config.yml).
+#
 favicon: ''
 
 #
@@ -95,9 +101,18 @@ playerCount:
   #
   hidePlayers: false
   #
+  # Set whether the List of players is shown when hovering over the player count.
+  # Setting this to true will also make the plugin ignore the hover option below.
+  #
+  # If not present, defaults to false.
+  #
+  # Read more: https://asl.andre601.ch/profiles/#hideplayershover
+  #
+  hidePlayersHover: false
+  #
   # Set the lines shown when the player hovers over the player count.
   # Unlike the MOTD option does this one only support basic color and formatting codes. Any RGB colors will be
-  # downsampled to the nearest matching color.
+  # down-sampled to the nearest matching color.
   #
   # If not present or empty (hover: []), defaults to not modifying the hover.
   #

core/src/test/java/ch/andre601/advancedserverlist/core/DummyPluginLogger.java

@@ -23,7 +23,7 @@
  *
  */
 
-package ch.andre601.advancedserverlist.test;
+package ch.andre601.advancedserverlist.core;
 
 import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
 

core/src/test/java/ch/andre601/advancedserverlist/core/ExpressionParserTests.java

@@ -23,7 +23,7 @@
  *
  */
 
-package ch.andre601.advancedserverlist.test;
+package ch.andre601.advancedserverlist.core;
 
 import ch.andre601.advancedserverlist.core.profiles.conditions.ProfileConditionParser;
 import ch.andre601.expressionparser.ParseWarnCollector;

core/src/test/java/ch/andre601/advancedserverlist/core/FlexVerTests.java

@@ -23,7 +23,7 @@
  *
  */
 
-package ch.andre601.advancedserverlist.test;
+package ch.andre601.advancedserverlist.core;
 
 import com.unascribed.flexver.FlexVerComparator;
 import org.junit.jupiter.api.Test;

docs/.hooks/api_docs.py

@@ -0,0 +1,15 @@
+def on_pre_page_macros(env):
+    footer = """
+    
+    {% if page.meta and page.meta.api %}
+    {% include 'api_docs/constructor_summaries.md' %}
+    {% include 'api_docs/nested_class_summaries.md' %}
+    {% include 'api_docs/enum_summaries.md' %}
+    {% include 'api_docs/method_summaries.md' %}
+    
+    {% include 'api_docs/constructor_details.md' %}
+    {% include 'api_docs/enum_details.md' %}
+    {% include 'api_docs/method_details.md' %}
+    {% endif %}
+    """
+    env.markdown += footer

docs/.hooks/platforms.py

@@ -0,0 +1,23 @@
+import re
+
+from mkdocs.config.defaults import MkDocsConfig
+from mkdocs.structure.files import Files
+from mkdocs.structure.pages import Page
+from re import Match
+
+def on_page_markdown(
+    markdown: str, *, page: Page, config: MkDocsConfig, files: Files
+):
+    def replace(match: Match):
+        platform = match.group(1)
+        if platform == "paper":      return "[:fontawesome-solid-paper-plane:](https://papermc.io){ .md-button .md-button--icon title=\"PaperMC\" target=\"_blank\" rel=\"noopener\" }"
+        elif platform == "bungee":   return "[:simple-spigotmc:](https://spigotmc.org){ .md-button .md-button--icon title=\"BungeeCord\" target=\"_blank\" rel=\"noopener\" }"
+        elif platform == "velocity": return "[:simple-velocity:](https://velocitypowered.com){ .md-button .md-button--icon title=\"Velocity\" target=\"_blank\" rel=\"noopener\" }"
+        elif platform == "proxies":  return "[:simple-spigotmc:](https://spigotmc.org){ .md-button .md-button--icon title=\"BungeeCord\" target=\"_blank\" rel=\"noopener\" } [:simple-velocity:](https://velocitypowered.com){ .md-button .md-button--icon title=\"Velocity\" target=\"_blank\" rel=\"noopener\" }"
+        elif platform == "all":      return "[:fontawesome-solid-paper-plane:](https://papermc.io){ .md-button .md-button--icon title=\"PaperMC\" target=\"_blank\" rel=\"noopener\" } [:simple-spigotmc:](https://spigotmc.org){ .md-button .md-button--icon title=\"BungeeCord\" target=\"_blank\" rel=\"noopener\" } [:simple-velocity:](https://velocitypowered.com){ .md-button .md-button--icon title=\"Velocity\" target=\"_blank\" rel=\"noopener\" }"
+        else:                        return platform
+    
+    return re.sub(
+        r"<!-- icon:(paper|bungee|velocity|proxies|all) -->",
+        replace, markdown, flags = re.I | re.M
+    )

docs/.hooks/replacer.py

@@ -17,7 +17,7 @@
 import re
 
 from mkdocs.config.defaults import MkDocsConfig
-from mkdocs.structure.files import File, Files
+from mkdocs.structure.files import Files
 from mkdocs.structure.pages import Page
 
 def on_page_markdown(

docs/.overrides/api-doc.html

@@ -1,35 +0,0 @@
-{% extends "base.html" %}
-{% import "api-objects/info-template.html" as info %}
-
-{% block content %}
-  {% include "partials/content.html" %}
-  {% if page.meta %}
-    <!--
-      Object summaries
-    -->
-    {% if page.meta.constructors %}
-      {{ info.summary('Constructor Summary', page.meta.constructors, details_type='constructor', defaults=page.meta.defaults) }}
-    {% endif %}
-    {% if page.meta.classes %}
-      {{ info.summary('Class Summary', page.meta.classes, details_type='class', defaults=page.meta.defaults) }}
-    {% endif %}
-    {% if page.meta.enums %}
-      {{ info.summary('Enum Constant Summary', page.meta.enums, details_type='enum', defaults=page.meta.defaults) }}
-    {% endif %}
-    {% if page.meta.methods or page.meta.inherits %}
-      {{ info.summary('Method Summary', page.meta.methods, page.meta.inherits, details_type='method', defaults=page.meta.defaults) }}
-    {% endif %}
-    <!--
-      Detailed object info
-    -->
-    {% if page.meta.constructors %}
-      {{ info.info('Constructor Detail', page.meta.constructors, 'constructor', defaults=page.meta.defaults) }}
-    {% endif %}
-    {% if page.meta.enums %}
-      {{ info.info('Enum Constant Detail', page.meta.enums, 'enum', defaults=page.meta.defaults) }}
-    {% endif %}
-    {% if page.meta.methods %}
-      {{ info.info('Method Detail', page.meta.methods, 'method', defaults=page.meta.defaults)}}
-    {% endif %}
-  {% endif %}
-{% endblock %}

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

@@ -1,228 +0,0 @@
-{% macro summary(title, summaries, inherits, details_type = 'unknown', defaults = []) -%}
-  <h2 id="{{ title | lower() | replace(' ', '-') |  e}}">
-    {{ title }}
-  </h2>
-  <div class="md-typeset__scrollwrap">
-    <div class="md-typeset__table">
-      {% if summaries %}
-        <table>
-          <thead>
-            <tr>
-              {% if details_type and details_type == "method" %}
-                <th>Modifier and Type</th>
-              {% endif %}
-              <th>{{ details_type | capitalize() }}</th>
-              <th>Description</th>
-            </tr>
-          </thead>
-          <tbody>
-            {% for summary in summaries %}
-              <tr>
-                {% set modifiers = namespace(name = "") %}
-                {% for attribute in summary.attributes %}
-                  {% set modifiers.name = modifiers.name ~ attribute %}
-                  {% if loop.revindex > 0 %}{% set modifiers.name = modifiers.name ~ " " %}{% endif %}
-                {% endfor %}
-                
-                {% if modifiers.name %}{% set modifiers.name = modifiers.name ~ " " %}{% endif %}
-                
-                {% if summary.type and summary.type.name %}
-                  {% set modifiers.name = modifiers.name ~ summary.type.name %}
-                {% elif defaults and defaults.type and defaults.type.name %}
-                  {% set modifiers.name = modifiers.name ~ defaults.type.name %}
-                {% else %}
-                  {% set modifiers.name = modifiers.name ~ "void" %}
-                {% endif %}
-                
-                {% set desc = "" %}
-                {% if summary.deprecated %}
-                  {% set desc = "<api__deprecated></api__deprecated><br>" ~ summary.deprecated.split("<br>")[0] %}
-                {% elif summary.description %}
-                  {% set desc = summary.description.split("<br>")[0] %}
-                {% endif %}
-                
-                {% set final_name = namespace(name = "") %}
-                {% if details_type and details_type == "enum" %}
-                  {% set final_name.name = summary.name | upper() %}
-                {% else %}
-                  {% set final_name.name = summary.name ~ "(" %}
-                {% endif %}
-      
-                {% for parameter in summary.parameters %}
-                  {% set final_name.name = final_name.name ~ parameter.type %}
-                  {% if loop.revindex > 1 %}{% set final_name.name = final_name.name ~ ", " %}{% endif %}
-                {% endfor %}
-                
-                {% if details_type != "enum" %}
-                  {% set final_name.name = final_name.name ~ ")" %}
-                {% endif %}
-                
-                {% if details_type and details_type == "method" %}
-                  {% if modifiers.name  %}
-                    <td><code>{{ modifiers.name }}</code></td>
-                  {% else %}
-                    <td></td>
-                  {% endif %}
-                {% endif %}
-                <td>
-                  {% if summary.link %}
-                    <a href="{{ summary.link }}"><code>{{ final_name.name | e}}</code></a>
-                  {% else %}
-                    <a href="#{{ final_name.name | lower() | replace(' ', '-') | e }}"><code>{{ final_name.name | e}}</code></a>
-                  {% endif %}
-                </td>
-                <td>{{ desc }}</td>
-              </tr>
-            {% endfor %}
-          </tbody>
-        </table>
-      {% endif %}
-      
-      {% if inherits %}
-        {% for classpath, inherit in inherits.items() %}
-          <table>
-            <thead>
-              <tr>
-                <th>Methods inherited from <a href="{{ inherit.link }}"><code>{{ classpath }}</code></a></th>
-              </tr>
-            </thead>
-            <tbody>
-              <tr>
-                <td>
-                  {% for inh in inherit.list %}
-                    <a href="{{ inherit.link }}#{{ inh | lower() | replace(' ', '-') | e }}">
-                      <code>{{- inh | e -}}</code>
-                    </a>
-                    {%- if loop.revindex > 1 %}, {% endif -%}
-                  {% endfor %}
-                </td>
-              </tr>
-            </tbody>
-          </table>
-        {% endfor %}
-      {% endif %}
-    </div>
-  </div>
-{%- endmacro %}
-
-{% macro info(title, details, details_type = 'unknown', defaults = []) -%}
-  <h2 id="{{ title | lower() | replace(' ', '-') | e}}">
-    {{ title }}
-  </h2>
-  {% for detail in details %}
-    <div class="api-detail">
-      {% set final_name = namespace(name = "") %}
-      {% if details_type == "enum" %}
-        {% set final_name.name = detail.name | upper() %}
-      {% else %}
-        {% set final_name.name = detail.name ~ "(" %}
-      {% endif %}
-      
-      {% for parameter in detail.parameters %}
-        {% set final_name.name = final_name.name ~ parameter.type %}
-        {% if loop.revindex > 1 %}{% set final_name.name = final_name.name ~ ", " %}{% endif %}
-      {% endfor %}
-      
-      {% if details_type != "enum" %}
-        {% set final_name.name = final_name.name ~ ")" %}
-      {% endif %}
-      
-      <h3 id="{{ final_name.name | lower() | replace(' ', '-') | e }}">
-        {% if detail.deprecated %}
-          <api__deprecated></api__deprecated>
-        {% endif %}
-        
-        {% for attribute in detail.attributes %}
-          <api__{{- attribute -}}></api__{{- attribute -}}>
-        {% endfor %}
-        
-        {% if enum %}
-          <api__static></api__static> <api__final></api__final>
-        {% endif %}
-        
-        {% if detail.type and details_type == "method" %}
-          {% if detail.type.link %}
-            <a href="{{ detail.type.link }}" class="api-type__{{- detail.type.type | default('primitive') -}}">{{ detail.type.name | default('void') | e }}</a>
-          {% else %}
-            <span class="api-type__{{- detail.type.type | default('primitive') -}}">{{ detail.type.name | default('void') | e }}</span>
-          {% endif %}
-        {% elif defaults and defaults.type and details_type == "method" %}
-          {% if defaults.type.link %}
-            <a href="{{ defaults.type.link }}" class="api-type__{{- defaults.type.type | default('primitive') -}}">{{ defaults.type.name | default('void') | e }}</a>
-          {% else %}
-            <span class="api-type__{{- defaults.type.type | default('primitive') -}}">{{ defaults.type.name | default('void') }}</span>
-          {% endif %}
-        {% elif details_type == "method" %}
-          <span class="api-type__primitive">void</span>
-        {% endif %}
-        <code>{{ final_name.name | e }}</code><a href="#{{ final_name.name | lower() | replace(' ', '-') | e }}" class="headerlink" title="Permanent link">¶</a>
-      </h3>
-      
-      {% if detail.deprecated %}
-        <div class="admonition deprecated">
-          <div class="admonition-title">Deprecation Warning</div>
-          <p>
-            {{ detail.deprecated }}
-          </p>
-        </div>
-      {% endif %}
-      
-      {% if detail.description %}
-        <p class="api-detail__description">
-          {{ detail.description }}
-        </p>
-      {% endif %}
-      
-      {% if detail.parameters %}
-        <h4 id="{{ detail.name | lower() | replace(' ', '-')  | e }}-parameters">
-          Parameters:<a href="#{{ detail.name | lower() | replace(' ', '-')  | e }}-parameters" class="headerlink" title="Permanent link">¶</a>
-        </h4>
-        <ul>
-          {% for parameter in detail.parameters %}
-            <li>
-              {% for attribute in parameter.attribute %}
-                <api__{{- attribute -}}></api__{{- attribute -}}>
-              {% endfor %}
-              <code>{{ parameter.type | e }}: {{ parameter.name }}</code>{% if parameter.description %} - {{ parameter.description }}{% endif %}
-            </li>
-          {% endfor %}
-        </ul>
-      {% endif %}
-      
-      {% if detail.returns %}
-        <h4 id="{{ detail.name | lower() | replace(' ', '-') | e }}-returns">
-          Returns:<a href="#{{ detail.name | lower() | replace(' ', '-')  | e }}-returns" class="headerlink" title="Permanent link">¶</a>
-        </h4>
-        <p class="api-detail__description">
-          {{ detail.returns }}
-        </p>
-      {% endif %}
-      
-      {% if detail.throws %}
-        <h4 id="{{ detail.name | lower() | replace(' ', '-') | e }}-throws">
-          Throws:<a href="#{{ detail.name | lower() | replace(' ', '-') | e }}-throws" class="headerlink" title="Permanent link">¶</a>
-        </h4>
-        <ul>
-          {% for throw in detail.throws %}
-            <li>
-              <code>{{ throw.name }}</code>{% if throw.description %} - {{ throw.description }}{% endif %}
-            </li>
-          {% endfor %}
-        </ul>
-      {% endif %}
-      
-      {% if seealso %}
-        <h4 id="{{ detail.name | lower() | replace(' ', '-')  | e }}-see-also">
-          See also:<a href="#{{ detail.name | lower() | replace(' ', '-')  | e }}-see-also" class="headerlink" title="Permanent link">¶</a>
-        </h4>
-        <ul>
-          {% for see in detail.seealso %}
-            <li>
-              <a href="{{ see.link }}"><code>{{ see.name }}</code></a>
-            </li>
-          {% endfor %}
-        </ul>
-      {% endif %}
-    </div>
-  {% endfor %}
-{%- endmacro %}

docs/.overrides/api_docs/constructor_details.md

@@ -0,0 +1,61 @@
+{% if page.meta.constructors %}
+## Constructor Details
+
+{% for constructor in page.meta.constructors %}
+<div class="api-detail" markdown>
+
+{% set name = namespace(text = constructor.name ~ "(") %}
+{% for parameter in constructor.parameters %}
+  {% set name.text = name.text ~ parameter.type %}
+  {% if loop.revindex > 1 %}{% set name.text = name.text ~ ", " %}{% endif %}
+{% endfor %}
+{% set name.text = name.text ~ ")" %}
+
+{% if constructor.deprecated %}
+  {% set name.text = "<api__deprecated></api__deprecated> " ~ name.text %}
+{% endif %}
+
+{% for attribute in constructor.attributes %}
+  {% set name.text = "<api__{{- attribute -}}></api__{{- attribute -}}> " ~ name.text %}
+{% endfor %}
+
+### {{ name.text | e }} { #{{ constructor.name | lower() | replace(' ', '-') | e }} }
+
+{% if constructor.deprecated %}
+/// deprecated | Deprecation Warning
+{{ constructor.deprecated }}
+///
+{% endif %}
+
+{% if constructor.description %}
+<p class="api-detail__description">
+
+{{ constructor.description }}
+
+</p>
+{% endif %}
+
+{% if constructor.parameters %}
+#### Parameters: { #{{ constructor.name | lower() | replace(' ', '-') | e }}-parameters }
+
+{% for parameter in constructor.parameters %}
+- {% for attribute in parameter.attributes %}<api__{{- attribute -}}></api__{{- attribute -}}>{% endfor %} `{{ parameter.type | e}}: {{ parameter.name }}`{% if parameter.description %} - {{ parameter.description }}{% endif %}
+{% endfor %}
+{% endif %}
+
+{% if constructor.seealso %}
+#### See also: { #{{ constructor.name | lower() | replace(' ', '-') | e }}-see-also }
+
+<div class="api-detail__description" markdown>
+
+{% for see in constructor.seealso %}
+- [`{{ see.name }}`]({{ see.link }})
+{% endfor %}
+
+</div> 
+{% endif %}
+
+</div>
+{% endfor %}
+
+{% endif %}

docs/.overrides/api_docs/constructor_summaries.md

@@ -0,0 +1,14 @@
+{% if page.meta.constructors %}
+## Constructor Summary
+
+| Constructor | Description |
+|-------------|-------------|{% for constructor in page.meta.constructors %}
+| [`{{ constructor.name }}({% for parameter in constructor.parameters -%}
+{{ parameter.type }}{% if loop.revindex > 1 %}, {% endif %}
+{%- endfor %})`](#{{ constructor.name | lower() }}) | {% if constructor.deprecated -%}
+<api__deprecated></api__deprecated> {{ constructor.deprecated.split("\n")[0] }}
+{%- elif constructor.description -%}
+{{ constructor.description.split("\n")[0] }}
+{%- endif %} |
+{%- endfor %}
+{% endif %}

docs/.overrides/api_docs/enum_details.md

@@ -0,0 +1,32 @@
+{% if page.meta.enums %}
+## Enum Constant Details
+
+{% for enum in page.meta.enums %}
+<div class="api-detail" markdown>
+
+{% set modifiers = namespace(text = "<api__static></api__static> <api__final></api__final> ") %}
+
+{% if enum.deprecated %}
+  {% set modifiers.text = "<api__deprecated></api__deprecated> " ~ modifiers.text %}
+{% endif %}
+
+### {{ modifiers.text }} `{{ enum.name | upper() }}` { #{{ enum.name | lower() | replace(' ', '-') | e }} }
+
+{% if enum.deprecated %}
+/// deprecated | Deprecation Warning
+{{ enum.deprecated }}
+///
+{% endif %}
+
+{% if enum.description %}
+<div class="api-detail__description" markdown>
+
+{{ enum.description }}
+
+</div>
+{% endif %}
+
+</div>
+{% endfor %}
+
+{% endif %}

docs/.overrides/api_docs/enum_summaries.md

@@ -0,0 +1,8 @@
+{% if page.meta.enums %}
+## Enum Constant Summary
+
+| Enum | Description |
+|------|-------------|{% for enum in page.meta.enums %}
+| [`{{ enum.name | upper() }}`](#{{ enum.name | lower() }}) | {{ enum.description.split("\n")[0] }} |
+{%- endfor %}
+{% endif %}

docs/.overrides/api_docs/helpers.md

@@ -0,0 +1,3 @@
+{% macro render_name(method) -%}
+{{ method.name }}({% for parameter in method.parameters %}{{ parameter.type }}{% if loop.revindex > 1 %}, {% endif %}{% endfor %})
+{%- endmacro %}

docs/.overrides/api_docs/method_details.md

@@ -0,0 +1,109 @@
+{% if page.meta.methods %}
+## Method Details
+
+{% for method in page.meta.methods %}
+<div class="api-detail" markdown>
+
+{% set modifiers = namespace(text = "") %}
+
+{% if method.deprecated %}
+  {% set modifiers.text = "<api__deprecated></api__deprecated> " %}
+{% endif %}
+
+{% for attribute in method.attributes %}
+  {% set modifiers.text = modifiers.text ~ "<api__" ~ attribute ~ "></api__" ~ attribute ~ ">" %}
+  {% if loop.revindex > 0 %}{% set modifiers.text = modifiers.text ~ " " %}{% endif %}
+{% endfor %}
+
+{% if modifiers.text %}{% set modifiers.text = modifiers.text ~ " " %}{% endif %}
+
+{% set method_type = "" %}
+{% if method.type %}
+  {% if method.type.link %}
+    {% set method_type = '[' ~ method.type.name|default('void')|e ~ '](' ~ method.type.link ~ '){ .api-type__' ~ method.type.type|default('primitive') ~ '} ' %}
+  {% else %}
+    {% set method_type = '<span class="api-type__' ~ method.type.type|default('primitive') ~ '">' ~ method.type.name|default('void')|e ~ '</span> ' %}
+  {% endif %}
+{% elif page.meta.defaults and page.meta.defaults.type %}
+  {% if page.meta.defaults.type.link %}
+    {% set method_type = '[' ~ page.meta.defaults.type.name|default('void')|e ~ '](' ~ page.meta.defaults.type.link ~ '){ .api-type__' ~ page.meta.defaults.type.type|default('primitive') ~ '} ' %}
+  {% else %}
+    {% set method_type = '<span class="api-type__' ~ page.meta.defaults.type.type|default('primitive') ~ '">' ~ page.meta.defaults.type.name|default('void')|e ~ '</span> ' %}
+  {% endif %}
+{% else %}
+  {% set method_type = '<span class="api-type__primitive">void</span> ' %}
+{% endif %}
+
+{% set name = namespace(text = method.name ~ "(") %}
+{% for parameter in method.parameters %}
+  {% set name.text = name.text ~ parameter.type %}
+  {% if loop.revindex > 1 %}{% set name.text = name.text ~ ", " %}{% endif %}
+{% endfor %}
+{% set name.text = name.text ~ ")" %}
+
+### {{ modifiers.text }} {{ method_type }} `{{ name.text }}` { #{{ method.name | lower() | replace(' ', '-') | e }} }
+
+{% if method.deprecated %}
+/// deprecated | Deprecation Warning
+{{ method.deprecated }}
+///
+{% endif %}
+
+{% if method.description %}
+<div class="api-detail__description" markdown>
+
+{{ method.description }}
+
+</div>
+{% endif %}
+
+{% if method.parameters %}
+#### Parameters: { #{{ method.name | lower() | replace(' ', '-') | e }}-parameters }
+
+<div class="api-detail__description" markdown>
+
+{% for parameter in method.parameters %}
+- {% for attribute in parameter.attributes %}<api__{{- attribute -}}></api__{{- attribute -}}>{% endfor %} `{{ parameter.type | e}}: {{ parameter.name }}`{% if parameter.description %} - {{ parameter.description }}{% endif %}
+{% endfor %}
+
+</div>
+{% endif %}
+
+{% if method.returns %}
+#### Returns: { #{{ method.name | lower() | replace(' ', '-') | e }}-returns }
+
+<div class="api-detail__description" markdown>
+
+{{ method.returns }}
+
+</div>
+{% endif %}
+
+{% if method.throws %}
+#### Throws: { #{{ method.name | lower() | replace(' ', '-') | e }}-throws }
+
+<div class="api-detail__description" markdown>
+
+{% for throw in method.throws %}
+- `{{ throw.name }}`{% if throw.description %} - {{ throw.description }}{% endif %}
+{% endfor %}
+
+</div>
+{% endif %}
+
+{% if method.seealso %}
+#### See also: { #{{ method.name | lower() | replace(' ', '-') | e }}-see-also }
+
+<div class="api-detail__description" markdown>
+
+{% for see in method.seealso %}
+- [`{{ see.name }}`]({{ see.link }})
+{% endfor %}
+
+</div>
+{% endif %}
+
+</div>
+{% endfor %}
+
+{% endif %}

docs/.overrides/api_docs/method_summaries.md

@@ -0,0 +1,31 @@
+{% if page.meta.methods or page.meta.inherits %}
+## Method Summary
+
+{% if page.meta.methods %}
+| Modifier and Type | Method | Description |
+|-------------------|--------|-------------|{% for method in page.meta.methods %}
+| `{% if method.attributes -%}
+{% for attribute in method.attributes -%}
+{{ attribute }}{% if loop.revindex > 0 %} {% endif %}
+{%- endfor %} {%- endif %}{% if method.type and method.type.name -%}
+{{ method.type.name }}
+{%- elif page.meta.defaults and page.meta.defaults.type and page.meta.defaults.type.name -%}
+{{ page.meta.defaults.type.name }}
+{%- else -%}void{%- endif %}` | [`{{ method.name }}({% for parameter in method.parameters -%}
+{{ parameter.type }}{% if loop.revindex > 1 %}, {% endif %}
+{%- endfor %})`](#{{ method.name | lower() }}) | {% if method.deprecated -%}
+<api__deprecated></api__deprecated> {{ method.deprecated.split("\n")[0] }}
+{%- elif method.description -%}
+{{ method.description.split("\n")[0] }}
+{%- endif %} |
+{%- endfor %}
+{% endif %}
+
+{% if page.meta.inherits %}
+{% for classpath, inherit in page.meta.inherits.items() %}
+| Methods inherited from [`{{ classpath }}`]({{ inherit.link }}) |
+|----------------------------------------------------------------|
+| {% for entry in inherit.list -%}[`{{ entry.name | e }}`]({{ inherit.link }}#{{ entry.link | lower() | replace(' ', '-') | e }}){% if loop.revindex > 1 %}, {% endif %}{% endfor %} |
+{% endfor %}
+{% endif %}
+{% endif %}

docs/.overrides/api_docs/nested_class_summaries.md

@@ -0,0 +1,11 @@
+{% if page.meta.classes %}
+## Nested Class Summary
+
+| Modifier and Type | Class | Description |
+|-------------------|-------|-------------|{% for class in page.meta.classes %}
+| `{% if class.attributes -%}
+{% for attribute in class.attributes -%}
+{{ attribute }}{% if loop.revindex > 1 %} {% endif %}
+{%- endfor %} {%- endif %}{{ class.type }}` | [`{{ class.name }}`]({{ class.link }}) | {{ class.description.split("\n")[0] }} |
+{%- endfor %}
+{% endif %}

docs/.overrides/main.html

@@ -1,7 +1,6 @@
 {% extends "base.html" %}
 
 {% block announce %}
-  <span class="twemoji">{% include ".icons/material/party-popper.svg" %}</span>
-  Celebrating <a href="https://andre601.ch/blog/2024/12-13-history-of-asl/" target="_blank" rel="nofollow">25,000 downloads!</a> Thank you!
-  <span class="twemoji">{% include ".icons/material/party-popper.svg" %}</span>
+  <span class="twemoji">{% include ".icons/octicons/paintbrush-24.svg" %}</span>
+  The <a href="/profiles">Profiles page</a> received a huge restructuring!
 {% endblock %}

docs/addons/first-party/banplugins.md

@@ -16,8 +16,7 @@ The BanPlugins Addon is available in downloads of AdvancedServerList on [:simple
 
 **Supported Platforms:**
 
-- :fontawesome-solid-paper-plane: Paper
-- :simple-spigotmc: BungeeCord
+<!-- icon:paper --> <!-- icon:bungee -->
 
 | Placeholder                     | Description                                                                              |
 |---------------------------------|------------------------------------------------------------------------------------------|
@@ -57,9 +56,7 @@ motd:
 
 **Supported Platforms:**
 
-- :fontawesome-solid-paper-plane: Paper
-- :simple-spigotmc: BungeeCord
-- :fontawesome-solid-paper-plane: Velocity
+<!-- icon:all -->
 
 | Placeholder                     | Description                                                                              |
 |---------------------------------|------------------------------------------------------------------------------------------|
@@ -95,9 +92,7 @@ motd:
 
 **Supported Platforms:**
 
-- :fontawesome-solid-paper-plane: Paper
-- :simple-spigotmc: BungeeCord
-- :fontawesome-solid-paper-plane: Velocity
+<!-- icon:all -->
 
 | Placeholder                  | Description                                                                              |
 |------------------------------|------------------------------------------------------------------------------------------|

docs/addons/index.md

@@ -13,7 +13,7 @@ These Addons are made by Andre601 and available together with the plugin downloa
 
 <div class="grid cards" markdown>
 
--   [**BanPlugins**](banplugins.md)
+-   [**BanPlugins**](first-party/banplugins.md)
 
     ----
     
@@ -25,4 +25,12 @@ These Addons are made by Andre601 and available together with the plugin downloa
 
 Third-party addons made by other people not working on AdvancedServerList.
 
-*Currently no entries*
+<div class="grid cards" markdown>
+
+-   [**SayanVanish**](third-party/sayanvanish.md)
+    
+    ----
+    
+    SayanVanish adds additional placeholders to the Velocity version of AdvancedServerList to use.
+
+</div>

docs/addons/third-party/sayanvanish.md

@@ -0,0 +1,43 @@
+---
+icon: octicons/eye-closed-24
+---
+# SayanVanish
+
+The plugin [SayanVanish]{ target="_blank" rel="nofollow" } is hooking into AdvancedServerList to provide placeholders of its own to be used in conditions and text options.
+
+## Placeholders
+
+/// tab | :fontawesome-solid-paper-plane: Paper
+[:octicons-file-code-24: Source][source-paper]
+
+| Placeholder                      | Description                                                                                |
+|----------------------------------|--------------------------------------------------------------------------------------------|
+| `${sayanvanish vanished}`        | Returns true or false based on if the player is vanished.                                  |
+| `${sayanvanish level}`           | Returns the vanish level of the player.                                                    |
+| `${sayanvanish count}`           | Returns the number of online players that are vanished.                                    |
+| `${sayanvanish online_here}`     | Returns the number of online players on the same server that aren't vanished.              |
+| `${sayanvanish online_total}`    | Returns the number of online players on the entire network that aren't vanished.^[1](#n1)^ |
+| `${sayanvanish online_<server>}` | Returns the number of online players on `<server>` that aren't vanished.^[1](#n1)^         |
+| `${sayanvanish vanish_prefix}`   | Returns the prefix for the player while they are vanished or an empty String.              |
+| `${sayanvanish vanish_suffix}`   | Returns the suffix for the player while they are vanished or an empty String.              |
+
+<small>^1^{ #n1 } Only works when Proxy mode is enabled and will otherwise return `PROXY_MODE IS NOT ENABLED!`</small>
+///
+
+/// tab | :simple-velocity: Velocity
+[:octicons-file-code-24: Source][source-velocity]
+
+| Placeholder                      | Description                                                                      |
+|----------------------------------|----------------------------------------------------------------------------------|
+| `${sayanvanish vanished}`        | Returns true or false based on if the player is vanished.                        |
+| `${sayanvanish level}`           | Returns the vanish level of the player.                                          |
+| `${sayanvanish count}`           | Returns the number of online players that are vanished.                          |
+| `${sayanvanish online_total}`    | Returns the number of online players on the entire network that aren't vanished. |
+| `${sayanvanish online_<server>}` | Returns the number of online players on `<server>` that aren't vanished.         |
+| `${sayanvanish vanish_prefix}`   | Returns the prefix for the player while they are vanished or an empty String.    |
+| `${sayanvanish vanish_suffix}`   | Returns the suffix for the player while they are vanished or an empty String.    |
+///
+
+[SayanVanish]: https://modrinth.com/plugin/sayanvanish
+[source-paper]: https://github.com/Syrent/SayanVanish/blob/6e03b874464a7f07c0baba233c94cdfefab5d3e2/sayanvanish-bukkit/src/main/kotlin/org/sayandev/sayanvanish/bukkit/feature/features/hook/FeatureHookAdvancedServerList.kt
+[source-velocity]: https://github.com/Syrent/SayanVanish/blob/6e03b874464a7f07c0baba233c94cdfefab5d3e2/sayanvanish-proxy/sayanvanish-proxy-velocity/src/main/kotlin/org/sayandev/sayanvanish/velocity/feature/features/hook/FeatureHookAdvancedServerList.kt

docs/api/adding-placeholders.md

@@ -0,0 +1,183 @@
+---
+icon: octicons/plus-circle-24
+---
+
+AdvancedServerList allows you to add your own Placeholders to be useable through its `${identifier value}` format.  
+The benefit of this method over alternatives such as using PlaceholderAPI placeholders is availability and the fact that these placeholders can be used within the [`condition` option](../profiles/options/condition.md) of the plugin.
+
+Adding your own placeholder is relatively easy and only requires the main API module to be used in your dependencies, unless you need platform-specific values (Explained later on).
+
+## Create your PlaceholderProvider class
+
+AdvancedServerList's placeholder system uses a dedicated [`PlaceholderProvider`](reference/api/ch.andre601.advancedserverlist.api/placeholderprovider.md) class where the placeholder gets defined and its values parsed.  
+In order to add your own, you'll need to first create a new class and make it extend the `PlaceholderProvider` class:
+
+```java title="MyPlaceholder.java"
+public class MyPlaceholder extends PlaceholderProvider {
+    
+}
+```
+
+Your IDE should now report issues, namely a missing method to override and a missing Constructor to match the extended class' one. Your IDE should allow you to easily implement those, if not, then manually add the constructor with a `String` argument and the `public String parsePlaceholder` method with `String`, [`GenericPlayer`](reference/api/ch.andre601.advancedserverlist.api/objects/genericplayer.md) and [`GenericServer`](reference/api/ch.andre601.advancedserverlist.api/objects/genericserver.md) arguments:
+
+```java { title="MyPlaceholder.java" .annotate }
+public class MyPlaceholder extends PlaceholderProvider {
+    
+    public MyPlaceholder(String identifier) {
+        super(identifier); // (1)
+    }
+    
+    @Override
+    public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server) {
+        return null;
+    }
+}
+```
+
+1.  It is recommended to replace the Constructor with a No-Args Constructor and set the placeholder name directly in the `super` call:  
+    ```java
+    public MyPlaceholder() {
+        super("myplaceholder");
+    }
+    ```
+
+## Parsing placeholders
+
+To now parse your placeholders, all you need to do is edit the `parsePlaceholder` method.  
+AdvancedServerList calls this method whenever it finds a matching identifier of a PlaceholderProvider, with the `String` argument being the actual value after the identifier and the `GenericPlayer` and `GenericServer` arguments holding the Player and server values respectively.
+
+As an example, assuming you simply want to return `Hello` for the placeholder `${myplaceholder sayHello}`, this would be the code for it:
+
+```java { title="MyPlaceholder.java" .annotate }
+public class MyPlaceholder extends PlaceholderProvider {
+    
+    public MyPlaceholder() {
+        super("myplaceholder");
+    }
+    
+    @Override
+    public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server) {
+        if (placeholder.equals("sayHello")) {
+            return "Hello";
+        }
+        
+        return null; // (1)
+    }
+}
+```
+
+1. Returning `null` tells AdvancedServerList that the placeholder was invalid, making it return the placeholder unchanged, while also reporting an error, if used in `condition`.
+
+## Registering the Placeholder
+
+The final step now would be to register your placeholder for AdvancedServerList to use.  
+To do this, obtain an instance of the [`AdvancedServerListAPI`](reference/api/ch.andre601.advancedserverlist.api/advancedserverlistapi.md) through its static `get()` method and then call `addPlaceholderProvider(PlaceholderProvider)` through it:
+
+/// tab | :fontawesome-solid-paper-plane: Paper Example
+```java title="MyPlugin.java"
+public class MyPlugin extends JavaPlugin {
+    
+    @Override
+    public void onEnable() {
+        AdvancedServerListAPI api = AdvancedServerListAPI.get();
+        api.addPlaceholderProvider(new MyPlaceholder());
+        getLogger().info("Hooked into AdvancedServerList!");
+    }
+}
+```
+///
+
+/// tab | :octicons-git-merge-24: BungeeCord Example
+```java title="MyPlugin.java"
+public class MyPlugin extends Plugin {
+    
+    @Override
+    public void onEnable() {
+        AdvancedServerListAPI api = AdvancedServerListAPI.get();
+        api.addPlaceholderProvider(new MyPlaceholder());
+        getLogger().info("Hooked into AdvancedServerList!");
+    }
+}
+```
+///
+
+/// tab | :simple-velocity: Velocity Example
+```java title="MyPlugin.java"
+@Plugin(
+    id = "myplugin",
+    version = "1.0.0",
+    authors = {"You?"},
+    dependencies = {
+        @Dependency(id = "advancedserverlist")
+    }
+)
+public class MyPlugin {
+    
+    private final ProxyServer proxy;
+    private final Logger logger;
+    
+    @Inject
+    public MyPlugin(ProxyServer proxy, Logger logger) {
+        this.proxy = proxy;
+        this.logger = logger;
+    }
+    
+    @Subscribe
+    public void onProxyInitialization(ProxyInitializeEvent event) {
+        AdvancedServerListAPI api = AdvancedServerListAPI.get();
+        api.addPlaceholderProvider(new MyPlaceholder());
+        logger.info("Hooked into AdvancedServerList!");
+    }
+}
+```
+///
+
+## You're done
+
+Your Placeholders should now be registered successfully if they check the following:
+
+- The provided identifier is not `null` nor empty.
+- The provided identifier does not contain spaces.
+- The provided identifier is not already registered in the API.
+
+## Note on `GenericPlayer` and `GenericServer`
+
+The different platform APIs of AdvancedServerList provide extended versions of the `GenericPlayer` and `GenericServer` instances used, providing additional methods otherwise not available.  
+Should you want to use these specific instances will you need to add the platform API as an additional dependency to your project and then cast the `GenericPlayer` and/or `GenericServer` instance to the platform specific version.
+
+Below is an example using the `platform-bukkit` API (This assumes your plugin is one running on Paper):
+
+```java { title="MyPlaceholder.java" .annotate }
+public class MyPlaceholder extends PlaceholderProvider {
+    
+    public MyPlaceholder() {
+        super("myplaceholder");
+    }
+    
+    @Override
+    public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server) {
+        if (!(player instanceof BukkitPlayer bukkitPlayer)) {
+            return null; // (1)
+        }
+        
+        return switch (placeholder) {
+            case "playedBefore" -> String.valueOf(bukkitPlayer.hasPlayedBefore());
+            case "whitelisted" -> String.valueOf(bukkitPlayer.isWhitelisted());
+            case "banned" -> String.valueOf(bukkitPlayer.isBanned());
+            default -> null;
+        };
+    }
+}
+```
+
+1.  Depending on the Java version you use will you need to alter the code:  
+    ```java
+    if (!(player instanceof BukkitPlayer)) {
+        return null;
+    }
+    
+    // You need to cast it separately.
+    BukkitPlayer bukkitPlayer = (BukkitPlayer) player;
+    
+    // ...use bukkitPlayer here.
+    ```

docs/api/changelog.md

@@ -7,6 +7,15 @@ icon: octicons/log-24
 This page lists the recent changes made towards the AdvancedServerListAPI.  
 They are ordered newest to oldest.
 
+## v4.1.0 { #v4.1.0 }
+
+### :octicons-plus-circle-24:{ .changelog-added title="Added" } Added { #v-added }
+
+- New setter method added to [`ProfileEntry.Builder`][profileentry.builder] class:
+    - [`hidePlayersHoverEnabled(NullBool)`][hidePlayersHoverEnabled]
+
+[hidePlayersHoverEnabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#hideplayershoverenabled
+
 ## v4.0.0 { #v4.0.0 }
 
 ### :octicons-alert-24:{ .changelog-breaking title="Breaking Changes" } Breaking Changes { #v4.0.0-breaking }
@@ -21,8 +30,8 @@ They are ordered newest to oldest.
     - [`onlinePlayersCount(String)`][onlinePlayersCount]
     - [`onlinePlayersEnabled(NullBool)`][onlinePlayersEnabled]
 
-[onlinePlayersCount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#onlineplayerscount(integer)
-[onlinePlayersEnabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#onlineplayersenabled(nullbool)
+[onlinePlayersCount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#onlineplayerscount
+[onlinePlayersEnabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#onlineplayersenabled
 
 ## v3.3.0 { #v3.3.0 }
 
@@ -53,15 +62,15 @@ They are ordered newest to oldest.
     - [`playerCountText(String)`][playercounttext]
     - [`players(List<String>)`][players]
 
-[extraplayerscount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#extraplayerscount(integer)
-[extraplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#extraplayersenabled(nullbool)
-[favicon]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#favicon(string)
-[hideplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#hideplayersenabled(nullbool)
-[maxplayerscount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#maxplayerscount(integer)
-[maxplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#maxplayersenabled(nullbool)
-[motd]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#motd(list<string>)
-[playercounttext]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#playercounttext(string)
-[players]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#players(list<string>)
+[extraplayerscount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#extraplayerscount
+[extraplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#extraplayersenabled
+[favicon]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#favicon
+[hideplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#hideplayersenabled
+[maxplayerscount]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#maxplayerscount
+[maxplayersenabled]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#maxplayersenabled
+[motd]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#motd
+[playercounttext]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#playercounttext
+[players]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md#players
 
 ### :octicons-pencil-24:{ .changelog-changed title="Changed" } Changed { #v3.2.0-changed }
 
@@ -119,22 +128,19 @@ They are ordered newest to oldest.
     - [`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).
+    - `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).
 
 ### :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()
+[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)
 
 ----
 

docs/api/index.md

@@ -84,127 +84,21 @@ dependencies {
 ```
 ///
 
-## Adding your own Placeholders
+## Tutorials
 
-<!-- admo:info This requires the main api module -->
+Dedicated pages to explain aspects of the API are available:
 
-The API allows you to add your own placeholders which would be available through the `${<identifier> <values>}` placeholder Pattern in a Server List profile.
-
-To add your own placeholders, follow these steps:
-
-### 1. 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:
-
-```java { .annotate title="Creating PlaceholderProvider class" }
-public class MyPlaceholders extends PlaceholderProvider {
-    
-    public MyPlaceholders(String identifier) {
-        super(identifier); // (1)
-    }
-    
-    @Override
-    public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server) {
-        return null;
-    }
-}
-```
-
-1.  It is recommended to replace this constructor with a no-args Constructor and have the placeholder name set in the `super` directly:  
-    ```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)
-
-/// details | Example of final class
-    type: example
-
-```java title="MyPlaceholders.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;
-    }
-}
-```
+/// html | div.grid.cards
+- [:octicons-plus-circle-24: Adding Placeholders](adding-placeholders.md)
+- [:octicons-broadcast-24: Listening for Events](listening-for-events.md)
 ///
 
-### 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 void onEnable() {
-        AdvancedServerListAPI api = AdvancedServerListAPI.get();
-        
-        api.addPlaceholderProvider(new MyPlaceholders());
-    }
-}
-```
-
-[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)
-
-This should register your PlaceholderExpansion as long as it is valid, meaning that the identifier...
-
-- ...is not `null`
-- ...is not containing spaces
-- ...is not using a name already registered in the API
-
-### 3. Declare AdvancedServerList as (soft)depend
+## Declare AdvancedServerList as (soft)depend
 
 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.
 
 Below are example setups for Spigot, Paper, BungeeCord and Velocity:
 
-/// tab | :simple-spigotmc: Spigot
-//// tab | Softdepend
-```yaml title="plugin.yml"
-name: "MyPlugin"
-author: "author"
-version: "1.0.0"
-
-main: "com.example.plugin.ExamplePlugin"
-
-softdepend:
-  - AdvancedServerList
-```
-////
-
-//// tab | Depend
-```yaml title="plugin.yml"
-name: "MyPlugin"
-author: "author"
-version: "1.0.0"
-
-main: "com.example.plugin.ExamplePlugin"
-
-depend:
-  - AdvancedServerList
-```
-////
-///
-
 /// tab | :fontawesome-solid-paper-plane: Paper
 //// tab | Softdepend
 ```yaml title="paper-plugin.yml"
@@ -239,7 +133,7 @@ dependencies:
 ////
 ///
 
-/// tab | :octicons-git-merge-24: BungeeCord
+/// tab | :simple-spigotmc: BungeeCord
 //// tab | Softdepend
 ```yaml title="bungee.yml"
 name: "MyPlugin"
@@ -267,7 +161,7 @@ depends:
 ////
 ///
 
-/// tab | :octicons-git-merge-24: Velocity
+/// tab | :simple-velocity: Velocity
 //// tab | Softdepend (File)
 ```json title="velocity-plugin.json"
 {
@@ -355,50 +249,4 @@ 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 These events require the platform-specific APIs -->
-
-AdvancedServerList provides Events that your plugin can listen for specific situations.
-
-### PreServerListSetEvent
-
-This event is called **before** AdvancedServerList starts handling the PingEvent of the Server/Proxy.  
-It allows you to get and alter the [ProfileEntry][profileentry] used in the PingEvent, or even outright cancel the event itself.
-
-The event offers the following methods:
-
-- [`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.
-
-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)
-
-### PostServerListSetEvent
-
-This event is called **after** AdvancedServerList has completed its handling of the Server's/Proxy's PingEvent.
-
-It provides a method to retrieve the [ProfileEntry][profileentry] used during the PingEvent.  
-Do note that this ProfileEntry is **not** a representation of what is actually displayed in the server list, but rather what has been used by AdvancedServerList. It may also be `null` should the event handling get cancelled for any reason.
-
-[profileentry]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md
-
-### ProfileEntry
-
-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.
-
-A convenience method ([`builder()`][builder()]) exists to create a `Builder` instance from an existing `ProfileEntry` in case you only want to alter certain options while everything else should remain 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
-[builder()]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md#builder()
+Your plugin should now hook into AdvancedServerList and register its own custom placeholders to use.

docs/api/listening-for-events.md

@@ -0,0 +1,170 @@
+---
+icon: octicons/broadcast-24
+---
+
+AdvancedServerList provides some events that your plugin can listen to.  
+These events are structurally the same across all platforms, yet still require the usage of Platform-specific APIs due to how some events are registered and handled on some platforms.
+
+The plugin currently offers the following events:
+
+/// html | div.grid.cards
+- [PreServerListSetEvent](#preserverlistsetevent)
+- [PostServerListSetEvent](#postserverlistsetevent)
+///
+
+## PreServerListSetEvent
+
+This event is executed before AdvancedServerList tries to modify the player list.  
+
+### Methods { #preserverlistsetevent-methods }
+
+The following methods are available to use:
+
+| Method                                  | Description                                                                    |
+|-----------------------------------------|--------------------------------------------------------------------------------|
+| [`getEntry()`][getentry]                | Returns the [`ProfileEntry`][profileentry] that AdvancedServerList should use. |
+| [`setEntry(ProfileEntry)`][setentry]    | Sets the [`ProfileEntry`][profileentry] that should be used.                   |
+| [`isCancelled()`][iscancelled]          | Returns wether this event was cancelled or not.                                |
+| [`setCancelled(boolean)`][setcancelled] | Sets the event's cancelled state.                                              |
+
+[setentry]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#setentry
+[iscancelled]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#iscancelled
+[setcancelled]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#setcancelled
+
+### Notes { #preserverlistsetevent-notes }
+
+- Providing `null` as the `ProfileEntry` for `setEntry(ProfileEntry)` is not allowed. Also, a copy of the provided `ProfileEntry` is made and used.
+
+## PostServerListSetEvent
+
+This event is executed after AdvancedServerList completed the server list modifications.
+
+### Methods { #postserverlistsetevent-methods }
+
+| Method                   | Description                                                              |
+|--------------------------|--------------------------------------------------------------------------|
+| [`getEntry()`][getentry] | Returns the [`ProfileEntry`][profileentry] that AdvancedServerList used. |
+
+[getentry]: reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry
+
+### Notes { #postserverlistsetevent-notes }
+
+-   The returned `ProfileEntry` is not an actual representation of what is being displayed to the player and rather an instance of values the plugin received.
+    The returned value may also be `null` should the Ping Event be cancelled due to things such as an invalid Protocol or the [`PreServerListSetEvent`](#preserverlistsetevent) being cancelled.
+
+## Registering the Events
+
+/// tab | :fontawesome-solid-paper-plane: Paper
+```java { title="MyPlugin.java" .annotate }
+public class MyPlugin extends JavaPlugin {
+    
+    @Override
+    public void onEnable() {
+        // (1)
+        Bukkit.getPluginManager().registerEvents(new ASLEventListener(), this);
+    }
+}
+```
+
+1. `getServer()` from the `JavaPlugin` class can be used here too instead of the `Bukkit` singleton.
+
+```java { title="ASLEventListener.java" }
+public class ASLEventListener implements Listener {
+    
+    @EventHandler
+    public void onPreServerListSet(PreServerListSetEvent event) {
+        System.out.println("PreServerListSetEvent fired!");
+    }
+    
+    @EventHandler
+    public void onPostServerListSetEvent(PostServerListSetEvent event) {
+        System.out.println("PostServerListSetEvent fired!");
+    }
+}
+```
+///
+
+/// tab | :simple-spigotmc: BungeeCord
+```java { title="MyPlugin.java" }
+public class MyPlugin extends Plugin {
+    
+    @Override
+    public void onEnable() {
+        getProxy().getPluginManager().registerListener(this, new ASLEventListener());
+    }
+}
+```
+
+```java { title="ASLEventListener.java" }
+public class ASLEventListener implements Listener {
+    
+    @EventHandler
+    public void onPreServerListSet(PreServerListSetEvent event) {
+        System.out.println("PreServerListSetEvent fired!");
+    }
+    
+    @EventHandler
+    public void onPostServerListSetEvent(PostServerListSetEvent event) {
+        System.out.println("PostServerListSetEvent fired!");
+    }
+}
+```
+///
+
+/// tab | :simple-velocity: Velocity
+```java { title="MyPlugin.java" }
+@Plugin(
+    id = "myplugin",
+    name = "MyPlugin",
+    version = "1.0.0",
+    authors = {"author"},
+    dependencies = {
+        @Dependency(
+            id = "advancedserverlist",
+        )
+    }
+)
+public class MyPlugin {
+    
+    private final ProxyServer proxy;
+    
+    @Inject
+    public MyPlugin(ProxyServer server) {
+        this.proxy = proxy;
+    }
+    
+    @Subscribe
+    public void init(ProxyInitializeEvent event) {
+        proxy.getEventManager().register(this, new ASLEventListener());
+    }
+}
+```
+
+```java { title="ASLEventListener.java" }
+public class ASLEventListener {
+    
+    @Subscribe
+    public void onPreServerListSet(PreServerListSetEvent event) {
+        System.out.println("PreServerListSetEvent fired!");
+    }
+    
+    @Subscribe
+    public void onPostServerListSetEvent(PostServerListSetEvent event) {
+        System.out.println("PostServerListSetEvent fired!");
+    }
+}
+```
+///
+
+## What is a ProfileEntry?
+
+Both events provide and use a so called [`ProfileEntry`][profileentry].  
+The `ProfileEntry` is a record, representing the values of a [Server List Profile](../profiles/index.md), meaning all values you can set in the profile configuration (Except condition and priority) will be available as a `ProfileEntry`.
+
+It is important to note, that the `ProfileEntry` can be a representation of the [`profiles` option](../profiles/index.md#profiles), the global options or a mixture of both.  
+If you want to create your own instance, you'll need to use the [`ProfileEntry.Builder` class](reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md) as the `ProfileEntry` is unmodifiable.
+
+A convenience method in the form of [`builder()`][builder] exists to create a Builder instance of the ProfileEntry with its values already pre-set.
+
+[profileentry]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md
+[builder]: reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md#builder

docs/api/reference/api/ch.andre601.advancedserverlist.api/advancedserverlistapi.md

@@ -1,10 +1,10 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'get'
     description: |
-      Retrieve the instance used of this API.<br>
+      Retrieve the instance used of this API.  
       If no instance has been made so far will a new one be created.
     returns: 'Instance of this API.'
     attributes:
@@ -14,38 +14,38 @@ methods:
       type: 'object'
   - name: 'addPlaceholderProvider'
     description: |
-      Adds the provided <a href="./../placeholderprovider/"><code>PlaceholderProvider</code></a> to the list, if it passes the following checks:<br>
-      <ul>
-        <li>Provided PlaceholderProvider instance is not null.</li>
-        <li>The identifier is not null nor empty.</li>
-        <li>The identifier does not contain any spaces.</li>
-        <li>A PlaceholderProvider with the same identifier doesn't exist already.</li>
-      </ul>
-      Not passing any of the above checks results in a <a href="./../exceptions/invalidplaceholderproviderexception/"><code>InvalidPlaceholderProviderException</code></a> being thrown.
+      Adds the provided [`PlaceholderAPIProvider`](placeholderprovider.md) to the list, if it passes the following checks:
+      
+      - Provided PlaceholderProvider instance is not null.
+      - The identifier is not null nor empty.
+      - The identifier does not contain any spaces.
+      - A PlaceholderProvider with the same identifier doesn't exist already.
+      
+      Not passing any of the above checks results in a [`InvalidPlaceholderProviderException`](exceptions/invalidplaceholderproviderexception.md) being thrown.
     parameters:
       - name: 'placeholderProvider'
-        description: 'The <a href="./../placeholderprovider/"><code>PlaceholderProvider</code></a> to add.'
+        description: 'The [`PlaceholderProvider`](placeholderprovider.md) to add.'
         type: PlaceholderProvider
         attributes:
           - notnull
     throws:
       - name: 'InvalidPlaceholderProviderException'
-        description: 'When the provided <a href="./../placeholderprovider/"><code>PlaceholderProvider</code> instance</a> is null, has a null or empty identifier, the identifier contains spaces, or another PlaceholderProvider with the same identifier is already in use.'
+        description: 'When the provided [`PlaceholderProvider`](placeholderprovider.md) is null, has a null or empty identifier, the identifier contains spaces, or another PlaceholderProvider with the same identifier is already in use.'
     type:
       name: 'void'
   - name: 'retrievePlaceholderProvider'
-    description: 'Retrieves the <a href="./../placeholderprovider/"><code>PlaceholderProvider</code></a> associated with the provided identifier, or <code>null</code> should no such entry exist.'
+    description: 'Retrieves the [`PlaceholderProvider`](placeholderprovider.md) associated with the provided identifier, or `null` should no such entry exist.'
     parameters:
       - name: 'identifier'
-        description: 'The identifier to find a matching <a href="./../placeholderprovider/"><code>PlaceholderProvider</code></a> for.'
+        description: 'The identifier to find a matching [`PlaceholderProvider`](placeholderprovider.md) for.'
         type: String
-    returns: 'Possibly-null <a href="./../placeholderprovider/"><code>PlaceholderProvider</code> instance</a>.'
+    returns: 'Possibly-null [`PlaceholderProvider` instance](placeholderprovider.md).'
     attributes:
       - nullable
     type:
       name: PlaceholderProvider
       type: object
-      link: './../placeholderprovider'
+      link: 'placeholderprovider.md'
 ---
 
 # <api__class></api__class> AdvancedServerListAPI

docs/api/reference/api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md

@@ -1,27 +1,27 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getEntry'
-    description: 'Gets the <a href="../../profiles/profileentry/"><code>ProfileEntry</code></a> currently set.'
+    description: 'Gets the [`ProfileEntry`](../profiles/profileentry/index.md) currently set.'
     returns: The currently used ProfileEntry.
     type:
       name: ProfileEntry
       type: object
-      link: '../../profiles/profileentry/'
+      link: '../profiles/profileentry/index.md'
   - name: 'setEntry'
     description: |-
-      Sets the new <a href="../../profiles/profileentry/"><code>ProfileEntry</code></a> to use.<br>
-      This may not be <code>null</code>.
+      Sets the new [`ProfileEntry`](../profiles/profileentry/index.md) to use.  
+      This may not be `null`.
     parameters:
       - name: 'entry'
-        description: 'The new <a href="../../profiles/profileentry/"><code>ProfileEntry</code></a> to use.'
+        description: 'The new [`ProfileEntry`](../profiles/profileentry/index.md) to use.'
         type: ProfileEntry
         attributes:
           - notnull
     throws:
       - name: 'IllegalArgumentException'
-        description: 'When the provided ProfileEntry is <code>null</code>'
+        description: 'When the provided ProfileEntry is `null`'
     type:
       name: 'void'
   - name: 'isCancelled'

docs/api/reference/api/ch.andre601.advancedserverlist.api/exceptions/invalidplaceholderproviderexception.md

@@ -1,11 +1,13 @@
 ---
-template: 'api-doc.html'
+api: true
 
 constructors:
   - name: 'InvalidPlaceholderProviderException'
+    description: Basic Constructor to create an instance of this Exception.
     parameters:
       - name: msg
         type: String
+        description: The reason of the exception.
 ---
 
 # <api__class></api__class> InvalidPlaceholderProviderException

docs/api/reference/api/ch.andre601.advancedserverlist.api/objects/genericplayer.md

@@ -1,29 +1,27 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getName'
     description: |
-      Returns the name of the player.<br>
-      Note that on Spigot, Paper and other forks can the name differ from the one cached by AdvancedServerList, if the plugin was able to retrieve an OfflinePlayer instance from the server. On BungeeCord and Velocity will the returned String always be the name from the cache.<br>
-      <br>
-      Name may be whatever has been defined in AdvancedServerList's config.yml, should the player not be cached yet by the plugin.
+      Returns the name of the player.  
+      On BungeeCord and Velocity is the returned value always what AdvancedServerList has cached, while on paper the value may differ, should the plugin be able to obtain a OfflinePlayer instance from the Server.
+      
+      Name may also be whatever has been defined in AdvancedServerList's `unknownPlayer -> name` config.yml Option.
     returns: 'String representing the player''s name'
     type:
       name: String
       type: object
   - name: 'getProtocol'
-    description: |
-      Returns the protocol ID the player is using.<br>
-      The protocol ID is an integer used by Minecraft to determine what version a server or client is running.
+    description: Returns the protocol ID the player is using. The protocol ID is a unique positive integer that is used in Minecraft to determine the Version used by the Client and Server.
     returns: 'Integer representing the protocol version of this player.'
     type:
       name: int
   - name: 'getUUID'
     description: |
-      Returns the unique ID associated with this player.<br>
-      <br>
-      UUID may be whatever has been defined in AdvancedServerList's config.yml, should the player not be cached yet by AdvancedServerList.
+      Returns the unique ID associated with this player.
+      
+      UUID may also be whatever has been defined in AdvancedServerList's `unknownPlayer -> uuid` config.yml Option.
     returns: 'UUID of the player'
     type:
       name: UUID
@@ -32,11 +30,11 @@ methods:
 
 # <api__interface></api__interface> GenericPlayer
 
-A basic interface used to store generic player data to use in placeholder resolving.  
-The different variants of AdvancedServerList implement this into their own class and may provide additional data not available through this interface.
+Interface used by the API to share common information across all platforms.
 
-The following values will always be present, no matter the platform this interface is used on:
+Platform-specific interfaces extending this interface are available and may offer additional features in addition to what this interface is offering.  
+This interface always offers data for the following:
 
-- [Name of the Player](#getname())
-- [Protocol version of the Player](#getprotocol())
-- [UUID of the Player](#getuuid())
+- [Name of the Player](#getname)
+- [Protocol version of the Player](#getprotocol)
+- [UUID of the Player](#getuuid)

docs/api/reference/api/ch.andre601.advancedserverlist.api/objects/genericserver.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getPlayersOnline'
@@ -24,4 +24,11 @@ methods:
 
 # <api__interface></api__interface> GenericServer
 
-Simple class used to wrap around some generic server data such as online player count, number of total players that can join and the host (IP/Domain) that got pinged by the player.
+Interface used to share common information across all platforms.
+
+Platform-specific interfaces extending this interface are available and may offer additional features in addition to what this interface is offering.  
+This interface always offers data for the following:
+
+- [Players currently online on the Proxy/Server](#getplayersonline)
+- [Max Players allowed to join the Proxy/Server](#getplayersmax)
+- [IP/Domain pinged by the Player](#gethost)

docs/api/reference/api/ch.andre601.advancedserverlist.api/objects/nullbool.md

@@ -1,23 +1,23 @@
 ---
-template: api-doc.html
+api: true
 
 enums:
   - name: 'true'
-    description: 'Boolean value <code>true</code>'
+    description: 'Boolean value `true`'
   - name: 'false'
-    description: 'Boolean value <code>false</code>'
+    description: 'Boolean value `false`'
   - name: 'not_set'
-    description: 'Boolean value <code>null</code>'
+    description: 'Boolean value `null`'
 
 methods:
   - name: 'resolve'
     description: |
-      Returns a NullBool instance based on the provided <code>Boolean</code> value.<br>
-      In case of <code>null</code> being provided will <a href="#not_set"><code>NullBool.NOT_SET</code></a> be returned, otherwise will the corresponding NullBool instance matching the Boolean value be returned.
-    returns: 'NullBool instance based on the provided <code>Boolean</code> value.'
+      Returns a NullBool instance based on the provided `Boolean` value.  
+      In case of `null` being provided will [`NullBool.NOT_SET`](#not_set) be returned, otherwise will the corresponding NullBool instance matching the Boolean value be returned.
+    returns: 'NullBool instance based on the provided `Boolean` value.'
     parameters:
       - name: 'bool'
-        description: 'The <code>Boolean</code> value to receive a NullBool instance for.'
+        description: 'The `Boolean` value to receive a NullBool instance for.'
         type: Boolean
         attributes:
           - nullable
@@ -27,19 +27,19 @@ methods:
       name: 'NullBool'
       type: 'object'
   - name: 'isNotSet'
-    description: 'Returns whether the NullBool is <a href="#not_set"><code>NullBool.NOT_SET</code></a>.'
-    returns: 'True if the instance is <a href="#not_set"><code>NullBool.NOT_SET</code></a>, otherwise false.'
+    description: 'Returns whether the NullBool is [`NullBool.NOT_SET`](#not_set)'
+    returns: 'True if the instance is [`NullBool.NOT_SET`](#not_set), otherwise false.'
     type:
       name: 'boolean'
       type: 'primitive'
   - name: 'getOrDefault'
     description: |
-      Gets the corresponding boolean value associated with the NullBool instance.<br>
-      In the case of NullBool <a href="#isnotset()">not being set</a> will the provided default value be returned.
+      Gets the corresponding boolean value associated with the NullBool instance.  
+      In the case of NullBool [not being set](#isnotset) will the provided default value be returned.
     returns: 'True or false depending on the NullBool instance and the provided default value.'
     parameters:
       - name: 'def'
-        description: 'The default boolean value to return should the NullBool instance be <a href="#not_set"><code>NullBool.NOT_SET</code></a>.'
+        description: 'The default boolean value to return should the NullBool instance be [`NullBool.NOT_SET`](#not_set).'
         type: boolean
     type:
       name: 'boolean'
@@ -48,4 +48,4 @@ methods:
 
 # <api__enum></api__enum> NullBool
 
-Enum used to return a `Boolean` value with a default one should no value be set.
+Enum used to return a [`Boolean`](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/Boolean.html){ target="_blank" rel="noopener" } Value with a fallback, should the boolean be `null`.

docs/api/reference/api/ch.andre601.advancedserverlist.api/placeholderprovider.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'PlaceholderProvider'
@@ -8,27 +8,27 @@ constructors:
       - name: 'identifier'
         description: 'The identifier to use for the placeholder. Cannot be empty.'
         type: String
-        attribute:
+        attributes:
           - notnull
 
 methods:
   - name: 'parsePlaceholder'
     description: |
-      Method called by AdvancedServerList's StringReplacer class to replace any appearances of <code>${&lt;identifier&gt; &lt;placeholder&gt;}</code> with whatever value a matching PlaceholderProvider may return.<br>
-      <br>
-      Returning <code>null</code> will be treated as an invalid placeholder by the plugin, making it return the placeholder as-is without any changes.
+      Method called by AdvancedServerList's StringReplacer class to replace any appearances of `${<identifier> <placeholder>}` with whatever value a matching PlaceholderProvider may return.
+      
+      Returning `null` will be treated as an invalid placeholder by the plugin, making it return the placeholder as-is without any changes.
     parameters:
       - name: 'placeholder'
         type: String
         description: 'The part of the Placeholder that comes after the identifier and before the closing curly bracket.'
       - name: 'player'
         type: GenericPlayer
-        description: 'The <a href="./../objects/genericplayer/"><code>GenericPlayer</code> instance</a> used.'
+        description: 'The [`GenericPlayer` instance](objects/genericplayer.md) used.'
       - name: 'server'
         type: GenericServer
-        description: 'The <a href="./../objects/genericserver/"><code>GenericServer</code> instance</a> used.'
+        description: 'The [`GenericServer` instance](objects/genericserver.md) used.'
     returns: 'Possibly-parsed or possibly-null String to replace the placeholder with.'
-    attribute:
+    attributes:
       - nullable
       - abstract
     type:
@@ -47,4 +47,4 @@ methods:
 Abstract class that is used to provide your own Placeholder patterns for AdvancedServerList to parse.
 
 In order for your class to be considered a valid PlaceholderProvider will you need to set the `identifier` to a non-null, non-empty value without having any spaces in it.  
-Once set, use [`AdvancedServerListAPI#addPlaceholderProvider(PlaceholderProvider)`](advancedserverlistapi.md#addplaceholderprovider(placeholderprovider)) to register your class for AdvancedServerList to use.
+Once set, use [`AdvancedServerListAPI#addPlaceholderProvider(PlaceholderProvider)`](advancedserverlistapi.md#addplaceholderprovider) to register your class for AdvancedServerList to use.

docs/api/reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/builder.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 defaults:
   type:
@@ -13,176 +13,199 @@ constructors:
 methods:
   - name: 'extraPlayersCount'
     description: |
-      Sets the number of players to add to the online players to use as the new max players value.<br>
-      This option has no effect when <a href="../#extraplayersenabled()"><code>extraPlayersEnabled</code></a> is set to <a href="../../../objects/nullbool/#false"><code>NullBool.FALSE</code></a> or <a href="../../objects/nullbool/#not_set"><code>NullBool.NOT_SET</code></a>.<br>
-      <br>
-      Set this to <code>null</code> to not alter the max player count. Alternatively, set <a href="#setextraplayersenabled(nullbool)"><code>setExtraPlayersEnabled(NullBool)</code></a> to <a href="../../../objects/nullbool/#false"><code>NullBool.FALSE</code></a>.
+      Sets the value to resolve into a number by AdvancedServerList.  
+      Strings not resolving into valid numbers will be treated as this option not being set.
+      
+      This option has no effect when [`extraPlayersEnabled()`](index.md#extraplayersenabled) is set to [`NullBool.FALSE`](../../objects/nullbool.md#false) or [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set).
+      
+      Set this to `null` to not alter the max player count. Alternatively [disable extra Players](#extraplayersenabled).
     parameters:
       - name: 'extraPlayersCount'
         description: 'The number of extra players to add.'
-        type: 'Integer'
-        attribute:
+        type: 'String'
+        attributes:
           - 'nullable'
     returns: 'This Builder after the extra player count has been set. Useful for chaining.'
   - name: 'extraPlayersEnabled'
     description: |
-      Sets whether the extra players feature should be enabled or not.<br>
-      <br>
-      Set to <a href="../../../objects/nullbool#not_set"><code>NullBool.NOT_SET</code></a> to not set this.
+      Sets whether the extra players feature should be enabled or not.
+      
+      Set to [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set) to not set this.
     parameters:
       - name: 'extraPlayersEnabled'
         description: 'Whether the extra players feature should be enabled or not.'
         type: 'NullBool'
-        attribute:
+        attributes:
           - 'notnull'
     returns: 'This Builder after the NullBool has been set. Useful for chaining.'
     throws:
       - name: 'IllegalArgumentException'
-        description: Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.
+        description: Thrown by the `CheckUtil` in case `null` has been provided as parameter.
   - name: 'favicon'
     description: |
-      Sets the value to use for the favicon.<br>
+      Sets the value to use for the favicon.  
       The following values are supported:
-      <ul>
-      <li>URL to a valid PNG file.</li>
-      <li>File name (with <code>.png</code> extension) matching a file saved in the favicons folder of AdvancedServerList.</li>
-      <li><code>${player uuid}</code> to display the avatar of the player.
-      </ul>
-      Set to an empty String or <code>null</code> to not alter the Favicon.
+      
+      - URL to a valid PNG file
+      - File name (with `.png` extension) matching a file saved in the favicons folder of AdvancedServerList
+      - `${player uuid}` to display the avatar of the player
+      
+      Set to an empty String or `null` to not alter the Favicon.
     parameters:
       - name: 'favicon'
         description: 'The favicon to set.'
         type: 'String'
-        attribute:
+        attributes:
           - 'nullable'
     returns: 'This Builder after the Favicon has been set. Useful for chaining.'
   - name: 'hidePlayersEnabled'
     description: |
-      Sets whether the player count should be hidden or not.<br>
-      <br>
-      Set to <a href="../../../objects/nullbool#not_set"><code>NullBool.NOT_SET</code></a> to not set this.
+      Sets whether the player count should be hidden or not.
+      
+      Set to [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set) to not set this.
     parameters:
       - name: 'hidePlayersEnabled'
         description: 'Whether the player count should be hidden or not.'
         type: 'NullBool'
-        attribute:
+        attributes:
           - 'notnull'
     returns: 'This Builder after the NullBool has been set. Useful for chaining.'
     throws:
       - name: 'IllegalArgumentException'
-        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+        description: 'Thrown by the `CheckUtil` in case `null` has been provided as parameter.'
+  - name: 'hidePlayersHoverEnabled'
+    description: |
+      Sets ehther the Hover List of online Players should be hidden or not.
+      
+      Set to [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set) to not set this.
+    parameters:
+      - name: 'hidePlayersHoverEnabled'
+        description: 'Whether the online players feature should be enabled or not.'
+        type: 'NullBool'
+        attributes:
+          - 'notnull'
+    returns: 'This Builder after the NullBool has been set. Useful for chaining.'
+    throws:
+      - name: 'IllegalArgumentException'
+        description: 'Thrown by the `CheckUtil` in case `null` has been provided as parameter.'
   - name: 'maxPlayersCount'
     description: |
-      Sets the number of max players allowed to join this server.<br>
-      This option has no effect when <a href="#maxplayersenabled(nullbool)">maxPlayersEnabled</a> is set to <a href="../../../objects/nullbool/#false"><code>NullBool.FALSE</code></a> or <a href="../../../objects/nullbool/#not_set"><code>NullBool.NOT_SET</code></a>.<br>
-      <br>
-      Set this to <code>null</code> to not alter the max player count. Alternatively <a href="#maxplayersenabled(nullbool)">disable max Players</a>.
+      Sets the value to resolve into a number by AdvancedServerList.  
+      Strings not resolving into valid numbers will be treated as this option not being set.
+      
+      This option has no effect when [`maxPlayersEnabled(NullBool)`](#maxplayersenabled) is set to [`NullBool.FALSE`](../../objects/nullbool.md#false) or [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set).
+      
+      Set this to `null` to not alter the max player count. Alternatively [disable max Players](#maxplayersenabled).
     parameters:
       - name: 'maxPlayersCount'
         description: 'The number of max players to set.'
         type: 'Integer'
-        attribute:
+        attributes:
           - 'nullable'
     returns: 'This Builder after the max player count has been set. Useful for chaining.'
   - name: 'maxPlayersEnabled'
     description: |
-      Sets whether the max players feature should be enabled.<br>
-      <br>
-      Set to <a href="../../../objects/nullbool/#not_set"><code>NullBool.NOT_SET</code></a> to not set this.<br>
-      <br>
-      An <code>IllegalArgumentException</code> may be thrown by the <code>CheckUtil</code> should maxPlayersEnabled be null.
+      Sets whether the max players feature should be enabled.
+      
+      Set to [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set) to not set this.
+      
+      An `IllegalArgumentException` may be thrown by the `CheckUtil` should maxPlayersEnabled be null.
     parameters:
       - name: 'maxPlayersEnabled'
         description: 'Whether the extra players feature should be enabled or not.'
         type: 'NullBool'
-        attribute:
+        attributes:
           - 'notnull'
     returns: 'This Builder after the NullBool has been set. Useful for chaining.'
     throws:
       - name: 'IllegalArgumentException'
-        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+        description: 'Thrown by the `CheckUtil` in case `null` has been provided as parameter.'
   - name: 'motd'
     description: |
-      Sets a new MOTD to use.<br>
-      <br>
-      Set to an empty list to not change the MOTD.<br>
-      Only the first two entries of the list will be considered and any additional ones discarded.<br>
-      <br>
-      An <code>IllegalArgumentException</code> may be thrown by the <code>CheckUtil</code> should the provided motd list be null.
+      Sets a new MOTD to use.
+      
+      Set to an empty list to not change the MOTD.  
+      Only the first two entries of the list will be considered and any additional ones discarded.
+      
+      An `IllegalArgumentException` may be thrown by the `CheckUtil` should the provided motd list be null.
     parameters:
       - name: 'motd'
         description: 'The MOTD to use.'
         type: 'List<String>'
-        attribute:
+        attributes:
           - 'notnull'
     returns: 'This Builder after the motd has been set. Useful for chaining.'
     throws:
       - name: 'IllegalArgumentException'
-        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+        description: 'Thrown by the `CheckUtil` in case `null` has been provided as parameter.'
   - name: 'onlinePlayersCount'
     description: |
-      Sets the value to resolve into a number by AdvancedServerList.<br>
+      Sets the value to resolve into a number by AdvancedServerList.  
       Strings not resolving into valid numbers will be treated as this option not being set.
+      
+      This option has no effect when [`onlinePlayersEnabled(NullBool)`](#onlineplayersenabled) is set to [`NullBool.FALSE`](../../objects/nullbool.md#false) or [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set).
+      
+      Set this to `null` to not alter the online player count. Alternatively [disable online Players.](#onlineplayersenabled).
     parameters:
       - name: 'onlinePlayersCount'
         description: 'The number of online players to set.'
         type: 'String'
-        attribute:
+        attributes:
           - 'nullable'
     returns: 'This Builder after the max player count has been set. Useful for chaining.'
   - name: 'onlinePlayersEnabled'
     description: |
-      Sets whether the online players feature should be enabled.<br>
-      <br>
-      Set to <a href="../../../objects/nullbool/#not_set"><code>NullBool.NOT_SET</code></a> to not set this.<br>
-      <br>
-      An <code>IllegalArgumentException</code> may be thrown by the <code>CheckUtil</code> should onlinePlayersEnabled be null.
+      Sets whether the online players feature should be enabled.
+      
+      Set to [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set) to not set this.
+      
+      An `IllegalArgumentException` may be thrown by the `CheckUtil` should onlinePlayersEnabled be null.
     parameters:
       - name: 'onlinePlayersEnabled'
         description: 'Whether the extra players feature should be enabled or not.'
         type: 'NullBool'
-        attribute:
+        attributes:
           - 'notnull'
     returns: 'This Builder after the NullBool has been set. Useful for chaining.'
     throws:
       - name: 'IllegalArgumentException'
-        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+        description: 'Thrown by the `CheckUtil` in case `null` has been provided as parameter.'
   - name: 'playerCountText'
     description: |
       Sets the text to override the player count with.<br>
       <br>
-      Set to an empty String or <code>null</code> to not alter the player count text.
+      Set to an empty String or `null` to not alter the player count text.
     parameters:
       - name: 'playerCountText'
         description: 'The text to show in the player count.'
         type: 'String'
-        attribute:
+        attributes:
           - 'nullable'
     returns: 'This Builder after the player count text has been set. Useful for chaining.'
   - name: 'players'
     description: |
-      Sets the players (lines) to use for the hover.<br>
-      <br>
+      Sets the players (lines) to use for the hover.
+      
       Set to an empty list to not change the hover text.
-      <br>
-      An <code>IllegalArgumentException</code> may be thrown by the <code>CheckUtil</code> should the provided okayersmotd list be null.
+      
+      An `IllegalArgumentException` may be thrown by the `CheckUtil` should the provided okayersmotd list be null.
     parameters:
       - name: 'players'
         description: 'The lines to set for the hover.'
         type: 'List<String>'
-        attribute:
+        attributes:
           - 'notnull'
     returns: 'This Builder after the players have been set. Useful for chaining.'
     throws:
       - name: 'IllegalArgumentException'
-        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+        description: 'Thrown by the `CheckUtil` in case `null` has been provided as parameter.'
   - name: 'build'
-    description: 'Creates a new <a href="./.."><code>ProfileEntry</code> instance</a> with the values set in this Builder.'
-    returns: 'New <a href="./.."><code>ProfileEntry</code> instance</a>.'
+    description: 'Creates a new [`ProfileEntry` instance](index.md) with the values set in this Builder.'
+    returns: 'New [`ProfileEntry` instance](index.md).'
     type:
       name: 'ProfileEntry'
       type: 'object'
-      link: './..'
+      link: 'index.md'
 ---
 
 # <api__class></api__class> Builder

docs/api/reference/api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md

@@ -1,11 +1,11 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'ProfileEntry'
     description: |
-      Creates a new instance of a ProfileEntry with the given values.<br>
-      It's recommended to use the <a href="./builder/"><code>Builder</code> class</a> for a more convenient configuration of the Settings.
+      Creates a new instance of a ProfileEntry with the given values.  
+      It's recommended to use the [`Builder` class](builder.md) for a more convenient configuration of the Settings.
     parameters:
       - name: 'motd'
         description: 'The MOTD to use.'
@@ -42,41 +42,53 @@ constructors:
         type: NullBool
         attributes:
           - notnull
+      - name: 'onlinePlayersCount'
+        description: 'The number to set for the Online Players count.'
+        type: String
+        attributes:
+          - nullable
+      - name: 'hidePlayersHoverEnabled'
+        description: 'Whether the online Players Hover should beenabled.'
+        type: NullBool
+        attributes:
+          - notnull
       - name: 'extraPlayersCount'
-        description: 'The number to add to the online players for the max players number.'
-        type: Integer
+        description: 'The number to add to the online Players for the extra Players.'
+        type: String
         attributes:
           - nullable
       - name: 'maxPlayersCount'
-        description: 'The number to use for the max players count.'
-        type: Integer
+        description: 'The number to set for the max Players count.'
+        type: String
         attributes:
           - nullable
     seealso:
       - name: 'ProfileEntry.Builder'
-        link: './builder/'
+        link: 'builder.md'
 
 classes:
   - name: 'Builder'
     description: 'Builder class to create a new ProfileEntry instance.'
     type: 'static class'
-    link: 'builder/'
+    link: 'builder.md'
 
 methods:
   - name: 'empty'
     description: |
-      Creates an "empty" PlayerEntry with the following values set:<br>
-      <ul>
-        <li><a href="#motd()"><code>motd</code></a>: Empty List</li>
-        <li><a href="#players()"><code>players</code></a>: Empty List</li>
-        <li><a href="#playercounttext()"><code>playerCountText</code></a>: Empty String</li>
-        <li><a href="#favicon()"><code>favicon</code></a>: Empty String</li>
-        <li><a href="#hideplayersenabled()"><code>hidePlayersEnabled</code></a>: <a href="../../objects/nullbool/#not_set"><code>NullBool.NOT_SET</code></a></li>
-        <li><a href="#extraplayersenabled()"><code>extraPlayersEnabled</code></a>: <a href="../../objects/nullbool/#not_set"><code>NullBool.NOT_SET</code></a></li>
-        <li><a href="#maxplayersenabled()"><code>maxPlayersEnabled</code></a>: <a href="../../objects/nullbool/#not_set"><code>NullBoo.NOT_SET</code></a></li>
-        <li><a href="#extraplayerscount()"><code>extraPlayersCount</code></a>: <code>null</code></li>
-        <li><a href="#maxplayerscount()"><code>maxPlayersCount</code></a>: <code>null</code></li>
-      </ul>
+      Creates an "empty" PlayerEntry with the following values set:  
+      
+      - [`motd`](#motd): Empty List
+      - [`players`](#players): Empty List
+      - [`playerCountText`](#playercounttext): Empty String
+      - [`favicon`](#favicon): Empty String
+      - [`hidePlayersEnabled`](#hideplayersenabled): [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set)
+      - [`extraPlayersEnabled`](#extraplayersenabled): [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set)
+      - [`maxPlayersEnabled`](#maxplayersenabled): [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set)
+      - [`onlinePlayersEnabled`](#onlineplayersenabled): [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set)
+      - [`hidePlayersHoverEnabled`](#hideplayershoverenabled): [`NullBool.NOT_SET`](../../objects/nullbool.md#not_set)
+      - [`extraPlayersCount`](#extraplayerscount): `null`
+      - [`maxPlayersCount`](#maxplayerscount): `null`
+      - [`onlinePlayersCount`](#onlineplayerscount): `null`
     returns: 'New ProfileEntry instance with empty/null values defined'
     attributes:
       - static
@@ -85,26 +97,32 @@ methods:
       type: 'object'
   - name: 'copy'
     description: |
-      Creates a copy of this ProfileEntry instance.<br>
-      <br>
-      This is simply a convenience method to not have to call <a href="#builder()"><code>builder()</code></a><code>.</code><a href="./builder/#build()"><code>build()</code></a>.<br>
-      If you want to modify the ProfileEntry <a href="#builder()"><code>builder()</code></a> is preferred.
+      Creates a copy of this ProfileEntry instance.
+      
+      This is a convenience method that avoids using [`builder()`](#builder) first followed by [`ProfileEntry.Builder.build()`](builder.md#build):
+      ```java
+      ProfileEntry entry = ProfileEntry.empty(); // Obtain ProfileEntry
+      
+      // Both do the same
+      ProfileEntry newEntry1 = entry.builder().build();
+      ProfileEntry newEntry2 = entry.copy();
+      ```
     returns: 'A copy of this ProfileEntry instance.'
     seealso:
       - name: 'builder()'
-        link: '#builder()'
+        link: '#builder'
     type:
       name: 'ProfileEntry'
       type: 'object'
   - name: 'builder'
     description: |
-      Creates a <a href="./builder/"><code>Builder</code> instance</a> with the values from this ProfileEntry set.<br>
+      Creates a [`Builder` instance](builder.md) with the values from this ProfileEntry set.  
       Use this method if you would like to modify the ProfileEntry.
-    returns: 'A new <a href="./builder/"><code>Builder</code> instance</a> with the values of this ProfileEntry set.'
+    returns: 'A new [`Builder` instance](builder.md) with the values of this ProfileEntry set.'
     type:
       name: 'Builder'
       type: 'object'
-      link: './builder/'
+      link: 'builder.md'
   - name: 'motd'
     description: 'Gets the currently set MOTD of this ProfileEntry.'
     returns: 'The current MOTD used by this ProfileEntry.'
@@ -125,51 +143,70 @@ methods:
       type: 'object'
   - name: 'favicon'
     description: |
-      Gets the currently set favicon of this ProfileEntry.<br>
+      Gets the currently set favicon of this ProfileEntry.  
       Note that the favicon usually is and supports one of the following options:
-      <ul>
-        <li>URL to a valid PNG file</li>
-        <li>File name (with <code>.png</code> extension) matching a file saved in the favicons folder of AdvancedServerList</li>
-        <li><code>${player uuid}</code> to display the avatar of the player</li>
-      </ul>
+      
+      - URL to a valid PNG file
+      - File name (with `.png` extension) matching a file saved in the favicons folder of AdvancedServerList
+      - `${player uuid}` to display the avatar of the player
     returns: 'The current favicon used by this ProfileEntry.'
     type:
       name: 'String'
       type: 'object'
   - name: 'hidePlayersEnabled'
     description: |
-      Whether the player count should be hidden or not in this ProfileEntry.<br>
-      To get the actual boolean value, append <a href="../../objects/nullbool/#getordefault()"><code>getOrDefault(boolean)</code></a>.
+      Whether the player count should be hidden or not in this ProfileEntry.  
+      To get the actual boolean value, append [`getOrDefault(boolean)`](../../objects/nullbool.md#getordefault).
     returns: 'Whether the player count should be hidden or not in this ProfileEntry.'
     type:
       name: 'NullBool'
       type: 'object'
-      link: '../../objects/nullbool/'
+      link: '../../objects/nullbool.md'
   - name: 'extraPlayersEnabled'
     description: |
-      Whether the extra players feature should be used or not in this ProfileEntry.<br>
-      To get the actual boolean value, append <a href="../../objects/nullbool/#getordefault()"><code>getOrDefault(boolean)</code></a>.
+      Whether the extra players feature should be used or not in this ProfileEntry.  
+      To get the actual boolean value, append [`getOrDefault(boolean)`](../../objects/nullbool.md#getordefault).
     returns: 'Whether the extra players feature should be used or not in this ProfileEntry.'
     type:
       name: 'NullBool'
       type: 'object'
-      link: '../../objects/nullbool/'
+      link: '../../objects/nullbool.md'
   - name: 'maxPlayersEnabled'
     description: |
-      Whether the max players feature should be used or not.<br>
-      To get the actual boolean value, append <a href="../../objects/nullbool/#getordefault()"><code>getOrDefault(boolean)</code></a>.
+      Whether the max players feature should be used or not.  
+      To get the actual boolean value, append [`getOrDefault(boolean)`](../../objects/nullbool.md#getordefault).
     returns: 'Whether the max players feature should be used or not.'
     type:
       name: 'NullBool'
       type: 'object'
-      link: '../../objects/nullbool/'
+      link: '../../objects/nullbool.md'
+  - name: 'onlinePlayersEnabled'
+    description: |
+      Whether the online players feature should be used or not.  
+      To get the actual boolean value, append [`getOrDefault(boolean)`](../../objects/nullbool.md#getordefault).
+    returns: 'Whether the online players feature should be used or not.'
+    type:
+      name: 'NullBool'
+      type: 'object'
+      link: '../../objects/nullbool.md'
+  - name: 'hidePlayersHoverEnabled'
+    description: |
+      Whether the Hover List of online players should be hidden or not.  
+      To get the actual boolean value, append [`getOrDefault(boolean)`](../../objects/nullbool.md#getordefault).
+      
+      When true, this option will force the [`players()`](#players) list to be ignored.
+    returns: 'Whether the Hover List of online players should be hidden or not.'
+    type:
+      name: 'NullBool'
+      type: 'object'
+      link: '../../objects/nullbool.md'
   - name: 'extraPlayersCount'
-    description: 'Gets the currently set number of extra players to use by this ProfileEntry. May be <code>null</code>.'
-    returns: 'Possibly-null integer number of extra players used by this ProfileEntry.'
+    description: 'Gets the currently set number of extra players of this ProfileEntry.'
+    returns: 'The current number of extra players used by this ProfileEntry.'
     attributes:
       - nullable
     type:
-      name: 'Integer'
+      name: 'String'
       type: 'object'
   - name: 'maxPlayersCount'
     description: 'Gets the currently set number of max players of this ProfileEntry.'
@@ -177,19 +214,27 @@ methods:
     attributes:
       - nullable
     type:
-      name: 'Integer'
+      name: 'String'
+      type: 'object'
+  - name: 'onlinePlayersCount'
+    description: 'Gets the currently set number of online players of this ProfileEntry.'
+    returns: 'The current number of online players used by this ProfileEntry.'
+    attributes:
+      - nullable
+    type:
+      name: 'String'
       type: 'object'
   - name: 'isInvalid'
     description: |
-      Whether this ProfileEntry is considered invalid or not.<br>
+      Whether this ProfileEntry is considered invalid or not.  
       The ProfileEntry is considered invalid if all the following is true:
-      <ul>
-        <li><a href="#motd()"><code>motd()</code></a> is empty.</li>
-        <li><a href="#players()"><code>players()</code></a> is empty.</li>
-        <li><a href="#playercounttext()"><code>playerCountText()</code></a> is null/empty <b>and</b> <a href="#hideplayersenabled()"><code>hidePlayersEnabled()</code></a> is <code>false</code>.</li>
-        <li><a href="#favicon()"><code>favicon()</code></a> is null/empty.</li>
-      </ul>
-      As long as one of the above is <b>not</b> true is this ProfileEntry considered valid and <code>false</code> will be returned.
+      
+      - [`motd()`](#motd) is empty.
+      - [`players()`](#players) is empty.
+      - [`playerCountText()`](#playercounttext) is null/empty **and** [`hidePlayersEnabled()`](#hideplayersenabled) is `false`.
+      - [`favicon()`](#favicon) is null/empty.
+      
+      As long as one of the above is **not** true is this ProfileEntry considered valid and `false` will be returned.
     returns: 'Whether this ProfileEntry is invalid or not.'
     type:
       name: 'boolean'
@@ -201,4 +246,4 @@ methods:
 This record represents the content found in a server list profile YAML file.  
 The content may come from either the "profiles" list, the options in the file itself (global options) or a mix of both.
 
-This class is immutable. Use [`builder()`](#builder()) to get a [`Builder` instance](builder.md) with the values of this class added.
+This class is immutable. Use [`builder()`](#builder) to get a [`Builder` instance](builder.md) with the values of this class added.

docs/api/reference/platform-bukkit/ch.andre601.advancedserverlist.api.bukkit/events/postserverlistsetevent.md

@@ -1,20 +1,20 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'PostServerListSetEvent'
     description: 'Constructor for creating a new PostServerListSetEvent instance.'
     parameters:
       - name: 'entry'
-        description: 'The <a href="../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/"><code>ProfileEntry</code></a> used during the PingEvent.'
+        description: 'The [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md) used during the PingEvent.'
         type: ProfileEntry
         attribute:
           - nullable
 
 methods:
   - name: 'getHandlerList'
-    description: 'Static <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/HandlerList.html" target="_blank" rel="nofollow"><code>HandlerList</code></a> getter. Required by Paper.'
-    returns: 'The static <a href="https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/HandlerList.html" target="_blank" rel="nofollow"><code>HandlerList instance</code></a> of this event.'
+    description: 'Static [`HandlerList`](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/HandlerList.html){ target="_blank" rel="nofollow" } getter. Required by Paper.'
+    returns: 'The static [`HandlerList` instance](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/HandlerList.html){ target="_blank" rel="nofollow" } of this event.'
     attributes:
       - static
     type:
@@ -22,9 +22,9 @@ methods:
       type: 'object'
   - name: 'getEntry'
     description: |
-      The <a href="../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/"><code>ProfileEntry</code></a> that was used during the PingEvent handling.<br>
-      <br>
-      The returned value may be <code>null</code> should the PingEvent handling be cancelled at any point (i.e. due to an invalid protocol or because the <a href="../preserverlistsetevent/"><code>PreServerListSetEvent</code></a> has been cancelled).<br>
+      The [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md) that was used during the PingEvent handling.
+      
+      The returned value may be `null` should the PingEvent handling be cancelled at any point (i.e. due to an invalid protocol or because the [`PreServerListSetEvent`](preserverlistsetevent.md) has been cancelled).  
       The values within the ProfileEntry also do not represent what is actually used within the Server list itself, but only the values provided for the PingEvent handling.
     returns: 'Possibly-null ProfileEntry used for the PingEvent.'
     attributes:
@@ -32,18 +32,19 @@ methods:
     type:
       name: 'ProfileEntry'
       type: 'object'
-      link: '../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/'
+      link: '../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md'
 
 inherits:
   'org.bukkit.event.Event':
     link: 'https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/Event.html'
     list:
-      - 'getHandlers()'
+      - name: 'getHandlers()'
+        link: 'getHandlers()'
 ---
 
 # <api__class></api__class> PostServerListSetEvent
 
 Called **after** the plugin has updated the Server List.
 
-The provided [`ProfileEntry`](#getentry()) may be null due to the PingEvent handling being cancelled (i.e. due to a invalid protocol or due to the [`PreServerListSetEvent`](preserverlistsetevent.md) being cancelled).  
+The provided [`ProfileEntry`](#getentry) may be null due to the PingEvent handling being cancelled (i.e. due to a invalid protocol or due to the [`PreServerListSetEvent`](preserverlistsetevent.md) being cancelled).  
 The entry also only represents the values used during the PingEvent, not the actual content that is being displayed.

docs/api/reference/platform-bukkit/ch.andre601.advancedserverlist.api.bukkit/events/preserverlistsetevent.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'PreServerListSetEvent'
@@ -9,7 +9,7 @@ constructors:
 
 methods:
   - name: 'getHandlerList'
-    returns: 'Static <code>HandlerList</code> instance.'
+    returns: 'Static `HandlerList` instance.'
     attributes:
       - static
     type:
@@ -18,19 +18,24 @@ methods:
 
 inherits:
   'ch.andre601.advancedserverlist.api.events.GenericServerListEvent':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md'
     list:
-      - 'getEntry()'
-      - 'setEntry(ProfileEntry)'
-      - 'isCancelled()'
-      - 'setCancelled(boolean)'
+      - name: 'getEntry()'
+        link: 'getentry'
+      - name: 'setEntry(ProfileEntry)'
+        link: 'setentry'
+      - name: 'isCancelled()'
+        link: 'iscancelled'
+      - name: 'setCancelled(boolean)'
+        link: 'setcancelled'
   'org.bukkit.event.Event':
     link: 'https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/Event.html'
     list:
-      - 'getHandlers()'
+      - name: 'getHandlers()'
+        link: 'getHandlers()'
 ---
 
 # <api__class></api__class> PreServerListSetEvent
 
 Called **before** AdvancedServerList modifies the server list.  
-The provided [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry()) will be the one used for the server list.
+The provided [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry) will be the one used for the server list.

docs/api/reference/platform-bukkit/ch.andre601.advancedserverlist.api.bukkit/objects/bukkitplayer.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getPlayer'
@@ -10,24 +10,24 @@ methods:
       type: 'object'
   - name: 'hasPlayedBefore'
     description: |
-      Returns whether this player has played on the server before.<br>
-      <br>
+      Returns whether this player has played on the server before.
+      
       The returned boolean may be inaccurate if AdvancedServerList was unable to obtain a valid OfflinePlayer instance.
     returns: 'Boolean indicating whether this player has played on the server before.'
     type:
       name: 'boolean'
   - name: 'isBanned'
     description: |
-      Returns whether this player has been banned from the server.<br>
-      <br>
+      Returns whether this player has been banned from the server.
+      
       The returned boolean may be inaccurate if AdvancedServerList was unable to obtain a valid OfflinePlayer instance.
     returns: 'Boolean indicating whether this player has been banned from the server.'
     type:
       name: 'boolean'
   - name: 'isWhitelisted'
     description: |
-      Returns whether this player is whitelisted on the server.<br>
-      <br>
+      Returns whether this player is whitelisted on the server.
+      
       The returned boolean may be inaccurate if AdvancedServerList was unable to obtain a valid OfflinePlayer instance.
     returns: 'Boolean indicating whether this player is whitelisted on the server.'
     type:
@@ -35,16 +35,19 @@ methods:
 
 inherits:
   'ch.andre601.advancedserverlist.api.objects.GenericPlayer':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer.md'
     list:
-      - 'getName()'
-      - 'getProtocol()'
-      - 'getUUID()'
+      - name: 'getName()'
+        link: 'getname'
+      - name: 'getProtocol()'
+        link: 'getprotocol'
+      - name: 'getUUID()'
+        link: 'getuuid'
 ---
 
 # <api__interface></api__interface> BukkitPlayer
 
 [`GenericPlayer` instance](../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer.md) for the SpigotMC/Paper server implementation of AdvancedServerList.  
-This interface includes a [`OfflinePlayer` instance](#getplayer()) obtained from the server the plugin runs on alongside some getters to get if the player [has played on the server before](#hasplayedbefore()), [is banned](#isbanned()) or [is whitelisted](#iswhitelisted()). These options actually require a proper OfflinePlayer instance to be present or will otherwise default to `false`.
+This interface includes a [`OfflinePlayer` instance](#getplayer) obtained from the server the plugin runs on alongside some getters to get if the player [has played on the server before](#hasplayedbefore), [is banned](#isbanned) or [is whitelisted](#iswhitelisted). These options actually require a proper OfflinePlayer instance to be present or will otherwise default to `false`.
 
 This class is useful for cases where you want to use the OfflinePlayer. Simply cast the GenericPlayer instance to a SpigotPlayer (Granted that it actually is an instance of it to begin with).

docs/api/reference/platform-bukkit/ch.andre601.advancedserverlist.api.bukkit/objects/bukkitserver.md

@@ -1,9 +1,9 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getWorlds'
-    description: 'Returns a <code>Map&lt;String, World&gt;</code> where the key is the name of the World and the value the world of the server.'
+    description: 'Returns a `Map<String, World>` where the key is the name of the World and the value the world of the server.'
     returns: 'Possibly-empty Map containing pairs of Strings and Worlds.'
     type:
       name: 'Map<String, World>'
@@ -11,16 +11,19 @@ methods:
 
 inherits:
   'ch.andre601.advancedserverlist.api.objects.GenericServer':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericserver/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/objects/genericserver.md'
     list:
-      - 'getPlayersOnline()'
-      - 'getPlayersMax()'
-      - 'getHost()'
+      - name: 'getPlayersOnline()'
+        link: 'getplayersonline'
+      - name: 'getPlayersMax()'
+        link: 'getplayersmax'
+      - name: 'getHost()'
+        link: 'gethost'
 ---
 
 # <api__interface></api__interface> BukkitServer
 
 Spigot/Paper specific instance of a [`GenericServer`](../../../api/ch.andre601.advancedserverlist.api/objects/genericserver.md).  
-This interface includes a [Map of Worlds](#getworlds()) the server currently has.
+This interface includes a [Map of Worlds](#getworlds) the server currently has.
 
 This interface is useful for cases where you want to get the worlds of the Server itself, by simply casting your GenericServer instance to a BukkitServer one. Make sure to do proper instanceof checks first before attempting to cast.

docs/api/reference/platform-bungeecord/ch.andre601.advancedserverlist.api.bungeecord/events/postserverlistsetevent.md

@@ -1,12 +1,12 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'PostServerListSetEvent'
     description: 'Constructor for creating a new PostServerListSetEvent instance.'
     parameters:
       - name: 'entry'
-        description: 'The <a href="../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/"><code>ProfileEntry</code></a> used during the PingEvent.'
+        description: 'The [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md) used during the PingEvent.'
         type: ProfileEntry
         attribute:
           - nullable
@@ -14,9 +14,9 @@ constructors:
 methods:
   - name: 'getEntry'
     description: |
-      The <a href="../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/"><code>ProfileEntry</code></a> that was used during the PingEvent handling.<br>
-      <br>
-      The returned value may be <code>null</code> should the PingEvent handling be cancelled at any point (i.e. due to an invalid protocol or because the <a href="../preserverlistsetevent/"><code>PreServerListSetEvent</code></a> has been cancelled).<br>
+      The [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md) that was used during the PingEvent handling.
+      
+      The returned value may be `null` should the PingEvent handling be cancelled at any point (i.e. due to an invalid protocol or because the [`PreServerListSetEvent`](preserverlistsetevent.md) has been cancelled).  
       The values within the ProfileEntry also do not represent what is actually used within the Server list itself, but only the values provided for the PingEvent handling.
     returns: 'Possibly-null ProfileEntry used for the PingEvent.'
     attributes:
@@ -24,12 +24,12 @@ methods:
     type:
       name: 'ProfileEntry'
       type: 'object'
-      link: '../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/'
+      link: '../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md'
 ---
 
 # <api__class></api__class> PostServerListSetEvent
 
 Called **after** the plugin has updated the Server List.
 
-The provided [`ProfileEntry`](#getentry()) may be null due to the PingEvent handling being cancelled (i.e. due to a invalid protocol or due to the [`PreServerListSetEvent`](preserverlistsetevent.md) being cancelled).  
+The provided [`ProfileEntry`](#getentry) may be null due to the PingEvent handling being cancelled (i.e. due to a invalid protocol or due to the [`PreServerListSetEvent`](preserverlistsetevent.md) being cancelled).  
 The entry also only represents the values used during the PingEvent, not the actual content that is being displayed.

docs/api/reference/platform-bungeecord/ch.andre601.advancedserverlist.api.bungeecord/events/preserverlistsetevent.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'PreServerListSetEvent'
@@ -10,15 +10,19 @@ constructors:
 
 inherits:
   'ch.andre601.advancedserverlist.api.events.GenericServerListEvent':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md'
     list:
-      - 'getEntry()'
-      - 'setEntry(ProfileEntry)'
-      - 'isCancelled()'
-      - 'setCancelled(boolean)'
+      - name: 'getEntry()'
+        link: 'getentry'
+      - name: 'setEntry(ProfileEntry)'
+        link: 'setentry'
+      - name: 'isCancelled()'
+        link: 'iscancelled'
+      - name: 'setCancelled(boolean)'
+        link: 'setcancelled'
 ---
 
 # <api__class></api__class> PreServerListSetEvent
 
 Called **before** AdvancedServerList modifies the server list.  
-The provided [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry()) will be the one used for the server list.
+The provided [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry) will be the one used for the server list.

docs/api/reference/platform-bungeecord/ch.andre601.advancedserverlist.api.bungeecord/objects/bungeeplayer.md

@@ -1,13 +1,16 @@
 ---
-template: api-doc.html
+api: true
 
 inherits:
   'ch.andre601.advancedserverlist.api.objects.GenericPlayer':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer.md'
     list:
-      - 'getName()'
-      - 'getProtocol()'
-      - 'getUUID()'
+      - name: 'getName()'
+        link: 'getname'
+      - name: 'getProtocol()'
+        link: 'getprotocol'
+      - name: 'getUUID()'
+        link: 'getuuid'
 ---
 
 # <api__interface></api__interface> BungeePlayer

docs/api/reference/platform-bungeecord/ch.andre601.advancedserverlist.api.bungeecord/objects/bungeeproxy.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getServers'
@@ -11,11 +11,14 @@ methods:
 
 inherits:
   'ch.andre601.advancedserverlist.api.objects.GenericServer':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericserver/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/objects/genericserver.md'
     list:
-      - 'getPlayersOnline()'
-      - 'getPlayersMax()'
-      - 'getHost()'
+      - name: 'getPlayersOnline()'
+        link: 'getplayersonline'
+      - name: 'getPlayersMax()'
+        link: 'getplayersmax'
+      - name: 'getHost()'
+        link: 'gethost'
 ---
 
 # <api__interface></api__interface> BungeeProxy

docs/api/reference/platform-velocity/ch.andre601.advancedserverlist.api.velocity/events/postserverlistsetevent.md

@@ -1,12 +1,12 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'PostServerListSetEvent'
     description: 'Constructor for creating a new PostServerListSetEvent instance.'
     parameters:
       - name: 'entry'
-        description: 'The <a href="../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/"><code>ProfileEntry</code></a> used during the PingEvent.'
+        description: 'The [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md) used during the PingEvent.'
         type: ProfileEntry
         attribute:
           - nullable
@@ -14,9 +14,9 @@ constructors:
 methods:
   - name: 'getEntry'
     description: |
-      The <a href="../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/"><code>ProfileEntry</code></a> that was used during the PingEvent handling.<br>
-      <br>
-      The returned value may be <code>null</code> should the PingEvent handling be cancelled at any point (i.e. due to an invalid protocol or because the <a href="../preserverlistsetevent/"><code>PreServerListSetEvent</code></a> has been cancelled).<br>
+      The [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md) that was used during the PingEvent handling.
+      
+      The returned value may be `null` should the PingEvent handling be cancelled at any point (i.e. due to an invalid protocol or because the [`PreServerListSetEvent`](preserverlistsetevent.md) has been cancelled).  
       The values within the ProfileEntry also do not represent what is actually used within the Server list itself, but only the values provided for the PingEvent handling.
     returns: 'Possibly-null ProfileEntry used for the PingEvent.'
     attributes:
@@ -24,12 +24,12 @@ methods:
     type:
       name: 'ProfileEntry'
       type: 'object'
-      link: '../../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/'
+      link: '../../../api/ch.andre601.advancedserverlist.api/profiles/profileentry/index.md'
 ---
 
 # <api__class></api__class> PostServerListSetEvent
 
 Called **after** the plugin has updated the Server List.
 
-The provided [`ProfileEntry`](#getentry()) may be null due to the PingEvent handling being cancelled (i.e. due to a invalid protocol or due to the [`PreServerListSetEvent`](preserverlistsetevent.md) being cancelled).  
+The provided [`ProfileEntry`](#getentry) may be null due to the PingEvent handling being cancelled (i.e. due to a invalid protocol or due to the [`PreServerListSetEvent`](preserverlistsetevent.md) being cancelled).  
 The entry also only represents the values used during the PingEvent, not the actual content that is being displayed.

docs/api/reference/platform-velocity/ch.andre601.advancedserverlist.api.velocity/events/preserverlistsetevent.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 constructors:
   - name: 'PreServerListSetEvent'
@@ -9,15 +9,19 @@ constructors:
 
 inherits:
   'ch.andre601.advancedserverlist.api.events.GenericServerListEvent':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md'
     list:
-      - 'getEntry()'
-      - 'setEntry(ProfileEntry)'
-      - 'isCancelled()'
-      - 'setCancelled(boolean)'
+      - name: 'getEntry()'
+        link: 'getentry'
+      - name: 'setEntry(ProfileEntry)'
+        link: 'setentry'
+      - name: 'isCancelled()'
+        link: 'iscancelled'
+      - name: 'setCancelled(boolean)'
+        link: 'setcancelled'
 ---
 
 # <api__class></api__class> PreServerListSetEvent
 
 Called **before** AdvancedServerList modifies the server list.  
-The provided [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry()) will be the one used for the server list.
+The provided [`ProfileEntry`](../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent.md#getentry) will be the one used for the server list.

docs/api/reference/platform-velocity/ch.andre601.advancedserverlist.api.velocity/objects/velocityplayer.md

@@ -1,9 +1,9 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getVersion'
-    description: 'Returns the <a href="../../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer/#getprotocol()">protocol version</a> of the player in a readable MC version format (i.e. 1.19.3).'
+    description: 'Returns the [protocol version](../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer.md#getprotocol) of the player in a readable MC version format (i.e. 1.19.3).'
     returns: 'The readable MC version the player uses.'
     type:
       name: 'String'
@@ -11,16 +11,19 @@ methods:
 
 inherits:
   'ch.andre601.advancedserverlist.api.objects.GenericPlayer':
-    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer.md'
     list:
-      - 'getName()'
-      - 'getProtocol()'
-      - 'getUUID()'
+      - name: 'getName()'
+        link: 'getname'
+      - name: 'getProtocol()'
+        link: 'getprotocol'
+      - name: 'getUUID()'
+        link: 'getuuid'
 ---
 
 # <api__interface></api__interface> VelocityPlayer
 
 [`GenericPlayer` instance](../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer.md) for the Velocity proxy implementation of AdvancedServerList.  
-Provides a [`getVersion()` method](#getversion()) to get the MC version used as a readable String (i.e. 1.19.3) rather than just the protocol version.
+Provides a [`getVersion()` method](#getversion) to get the MC version used as a readable String (i.e. 1.19.3) rather than just the protocol version.
 
 To get an instance of this class from a GenericPlayer instance, simply cast it to a VelocityPlayer (Granted that the GenericPlayer instance actually is a VelocityPlayer instance).

docs/api/reference/platform-velocity/ch.andre601.advancedserverlist.api.velocity/objects/velocityproxy.md

@@ -1,5 +1,5 @@
 ---
-template: api-doc.html
+api: true
 
 methods:
   - name: 'getServers'
@@ -11,11 +11,14 @@ methods:
 
 inherits:
   'ch.andre601.advancedserverlist.api.objects.GenericServer':
-    link: '../../../api/objects/genericserver/'
+    link: '../../../api/ch.andre601.advancedserverlist.api/objects/genericserver.md'
     list:
-      - 'getPlayersOnline()'
-      - 'getPlayersMax()'
-      - 'getHost()'
+      - name: 'getPlayersOnline()'
+        link: 'getplayersonline'
+      - name: 'getPlayersMax()'
+        link: 'getplayersmax'
+      - name: 'getHost()'
+        link: 'gethost'
 ---
 
 # <api__interface></api__interface> VelocityProxy

docs/api/reference/structure.md

@@ -54,7 +54,7 @@ There are 5 frontmatter options, each following a specific structure:
 
 - [`Constructors`](#constructors)
 - [`Nested Classes`](#nested-classes)
-- [`Enum Constants`](#enum constants)
+- [`Enum Constants`](#enum-constants)
 - [`Methods`](#methods)
 - [`Inherits`](#inherits)
 

docs/assets/js/repo-stats.js

@@ -1,7 +1,4 @@
 document$.subscribe(async () => {
-    const url = 'https://api.allorigins.win/raw?url='
-    const apiUrl = `https://api.allorigins.win/raw?url=${encodeURIComponent('https://codeberg.org/api/v1/repos/Andre601/asl-api/releases/latest')}`
-
     const repo_stats = document.querySelector('[data-md-component="source"] .md-source__repository');
     
     async function loadCodebergInfo(data) {
@@ -61,7 +58,7 @@ document$.subscribe(async () => {
     }
     
     async function fetchApiInfo() {
-        const tag = await fetch(`${apiUrl}`)
+        const tag = await fetch('https://codeberg.org/api/v1/repos/Andre601/asl-api/releases/latest')
             .then(_ => _.json());
         
         const data = {
@@ -74,8 +71,8 @@ document$.subscribe(async () => {
     
     async function fetchInfo() {
         const [release, repo] = await Promise.all([
-            fetch(`${url}${encodeURIComponent('https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList/releases/latest')}`).then(_ => _.json()),
-            fetch(`${url}${encodeURIComponent('https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList')}`).then(_ => _.json()),
+            fetch('https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList/releases/latest').then(_ => _.json()),
+            fetch('https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList').then(_ => _.json()),
         ]);
         
         const data = {

docs/assets/stylesheets/custom.css

@@ -51,4 +51,14 @@
     text-overflow: ellipsis;
     white-space: nowrap;
     display: block;
+}
+
+.md-banner__inner.md-grid.md-typeset {
+    text-align: center;
+}
+
+.md-typeset .md-button.md-button--icon {
+    padding: .5em;
+    line-height: 0;
+    color: var(--md-default-fg-color);
 }

docs/commands/clearcache.md

@@ -0,0 +1,14 @@
+---
+title: /asl clearcache
+---
+
+# `/asl clearcache`
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.clearcache`
+///
+
+Resets the current Favicon and Player cache.

docs/commands/help.md

@@ -0,0 +1,19 @@
+---
+title: /asl help
+---
+
+# `/asl help [query]`
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.help`
+
+**Arguments:**
+
+- `[query]` - Optional search query to use
+///
+
+Displays information about provided commands.  
+If no query is provided will it list all commands. A page number can be used as query to switch between pages.

docs/commands/index.md

@@ -4,68 +4,8 @@ icon: octicons/rel-file-path-24
 
 # Commands
 
-The plugin adds commands to use for various things related to the plugin itself.  
-The main command is `/advancedserverlist` but an alias called `/asl` is also registered to use.
+AdvancedServerList adds commands that can be accessed via `/advancedserverlist` or `/asl` and provide different functionalities.
 
-## Permissions
+## Available commands
 
-The main permission is `advancedserverlist.admin` for all commands, but you can also grant access to specific commands using `advancedserverlist.command.<subcommand>` instead (i.e. `advancedserverlist.command.help` to grant access to [`/asl help`](#help)).
-
-## Subcommands
-
-The following subcommands are available (Subcommands are case-insensitive):
-
-- [`help`](#help)
-- [`reload`](#reload)
-- [`clearCache`](#clearcache)
-- [`migrate <plugin>`](#migrate)
-- [`profiles <add <profile> | copy <profile> <name> | list>`](#profiles)
-
-### `help`
-
-**Permission:** `advancedserverlist.command.help`
-
-Shows a list of all available [subcommands](#subcommands) for AdvancedServerList.
-
-----
-
-### `reload`
-
-**Permission:** `advancedserverlist.command.reload`
-
-Reloads the plugin's `config.yml` and all available YAML files in the `profiles` folder.
-
-----
-
-### `clearcache`
-
-**Permission:** `advancedserverlist.command.clearcache`
-
-Clears the currently cached favicons and players.
-
-----
-
-### `migrate <plugin>` { #migrate }
-
-**Permission:** `advancedserverlist.command.migrate`
-
-**Arguments:**
-
-- `<plugin>` - The plugin to migrate from.
-
-Migrates files from one plugin over to AdvancedServerList.  
-Check the [Migration Page](../migration/index.md) for a list of supported plugins.
-
-----
-
-### `profiles <add <profile> | copy <profile> <name> | list>` { #profiles }
-
-**Permission:** `advancedserverlist.command.profiles`
-
-**Arguments:**
-
-- `add <profile>` - Creates a new profile with name `<profile>` using the default profile values.
-- `copy <profile> <name>` - Creates a copy of `<profile>` and saves it as `<name>`.
-- `list` - Lists all loaded profiles. The entries have hover text for extra info.
-
-Creates, copies or shows profiles in AdvancedServerList.
+{nav}

docs/commands/migrate.md

@@ -0,0 +1,19 @@
+---
+title: /asl migrate
+---
+
+# `/asl migrate <plugin>`
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.`
+
+**Arguments:**
+
+- `<plugin>` - The plugin to migrate from.
+///
+
+Migrates configuration from the provided plugin to AdvancedServerList.  
+A list of supported plugins and known limitations can be found on the [Migration page](../migration/index.md).

docs/commands/profiles.md

@@ -0,0 +1,108 @@
+---
+title: /asl profiles
+---
+
+# `/asl profiles add <profile>`<br>`/asl profiles copy <profile> <name>`<br>`/asl profiles info <profile>`<br>`/asl profiles list`<br>`/asl profiles set <profile> <option> [value]`
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.profiles`
+
+**Subcommands:**
+
+- [`add <profile>`](#add)
+- [`copy <profile> <name>`](#copy)
+- [`info <profile>`](#info)
+- [`list`](#list)
+- [`set <profile> <option> [value]`](#set)
+///
+
+Creates, copies, lists (info of) or sets values for profiles.
+
+## `/asl profiles add <profile>` { #add }
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.profiles`
+- `advancedserverlist.command.profiles.add`
+
+**Arguments:**
+
+- `<profile>` - Name of the profile to create.
+///
+
+Creates a new profile using default values.  
+[`/asl reload`](reload.md) needs to be executed to load the new profile.
+
+## `/asl profiles copy <profile> <name>` { #copy }
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.profiles`
+- `advancedserverlist.command.profiles.copy`
+
+**Arguments:**
+
+- `<profile>` - Name of the profile to copy.
+- `<name>` - Name of the copy to make.
+///
+
+Creates a copy from the provided profile.  
+[`/asl reload`](reload.md) needs to be executed to load the new profile.
+
+## `/asl profiles info <profile>` { #info }
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.profiles`
+- `advancedserverlist.command.profiles.info`
+
+**Arguments:**
+
+- `<profile>` - The profile to list info from.
+///
+
+<!-- admo:info Only executable by players. -->
+
+Lists currently set values for the provided profile.  
+Each option has hover text to show the value and a click action to receive the matching [`/asl profiles set ...`](#set) command.
+
+## `/asl profiles list` { #list }
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.profiles`
+- `advancedserverlist.command.profiles.list`
+///
+
+Lists all currently loaded profiles.  
+Each profile has a hover text displaying their priority, condition and whether they are considered valid.
+
+## `/asl profiles set <profile> <option> [value]` { #set }
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.profiles`
+- `advancedserverlist.command.profiles.set`
+
+**Arguments:**
+
+- `<profile>` - The profile to modify.
+- `<option>` - The option to modify.
+- `[value]` - Optional value to set. Leave empty to reset the option.
+///
+
+Sets the config option `<option>` to the provided `[value]`. Leaving value empty results in the option being reset to an empty/unset state.  
+[`/asl reload`](reload.md) needs to be executed to apply the changes.

docs/commands/reload.md

@@ -0,0 +1,14 @@
+---
+title: /asl reload
+---
+
+# `/asl reload`
+
+/// info |
+**Permissions:**
+
+- `advancedserverlist.admin`
+- `advancedserverlist.command.reload`
+///
+
+Reloads the config.yml and any YAML file in the profiles folder.

docs/getting-started/index.md

@@ -12,8 +12,7 @@ The guide is designed to be as easy to understand as possible. If you still have
 The first step would be to download the plugin from a download page of your choice.  
 AdvancedServerList is available on the following places (Please note the current status!):
 
-<div class="grid cards" markdown>
-
+/// html | div.grid.cards
 -   [:simple-modrinth: **Modrinth**][modrinth]{ target="_blank" rel="nofollow" }
     
     ----
@@ -38,20 +37,15 @@ AdvancedServerList is available on the following places (Please note the current
     ----
     
     :octicons-alert-24:{ style="color: var(--md-badge-fg--warning);" } **Discontinued!**
+///
 
-</div>
-
-[modrinth]: https://modrinth.com/plugin/advancedserverlist
-[codeberg]: https://codeberg.org/Andre601/AdvancedServerList
 [spigot]: https://www.spigotmc.org/resources/102910/
-[hangar]: https://hangar.papermc.io/Andre_601/AdvancedServerList
 
 The plugin is available for Paper, BungeeCord, Waterfall and Velocity, and has been tested on these platforms. It may support additional forks, but this is not guaranteed.
 
 The plugin also supports these additional plugins. They are all optional.
 
-<div class="grid cards" markdown>
-
+/// html | div.grid.cards
 -   [**PlaceholderAPI**][placeholderapi]{ target="_blank" rel="nofollow" }
     
     ----
@@ -61,7 +55,7 @@ The plugin also supports these additional plugins. They are all optional.
     ----
     
     **Supported on:**  
-    :fontawesome-solid-paper-plane: Paper
+    <!-- icon:paper -->
 
 -   [**ViaVersion**][viaversion]{ target="_blank" rel="nofollow" }
     
@@ -72,7 +66,7 @@ The plugin also supports these additional plugins. They are all optional.
     ----
 
     **Supported on:**  
-    :fontawesome-solid-paper-plane: Paper
+    <!-- icon:paper -->
 
 -   [**PAPIProxyBridge**][papiproxybridge]{ target="_blank" rel="nofollow" }
     
@@ -83,7 +77,7 @@ The plugin also supports these additional plugins. They are all optional.
     ----
 
     **Supported on:**  
-    :simple-spigotmc: BungeeCord, :fontawesome-solid-paper-plane: Velocity
+    <!-- icon:proxies -->
 
 -   [**Maintenance**][maintenance]{ target="_blank" rel="nofollow" }
     
@@ -94,7 +88,7 @@ The plugin also supports these additional plugins. They are all optional.
     ----
 
     **Supported on:**  
-    :fontawesome-solid-paper-plane: Paper, :simple-spigotmc: BungeeCord, :fontawesome-solid-paper-plane: Velocity
+    <!-- icon:all -->
 
 -   [**BanPlugins Addon**][addon]
     
@@ -105,11 +99,10 @@ The plugin also supports these additional plugins. They are all optional.
     ----
 
     **Supported on:**  
-    :fontawesome-solid-paper-plane: Paper, :simple-spigotmc: BungeeCord, :fontawesome-solid-paper-plane: Velocity
+    <!-- icon:all -->
+///
 
-</div>
-
-[addon]: ../addons/banplugins.md
+[addon]: ../addons/first-party/banplugins.md
 
 ## 2. Installation { #installation }
 
@@ -139,7 +132,7 @@ Let's cover the files and folders...
 
 #### Favicons folder
 
-This folder allows you to store PNG images that should be used as favicons by the plugin. A favicon from this folder can be used by referencing the name (Including the `.png` file extension) in the [`favicon` option of the server list profile](../profiles/index.md#favicon).
+This folder allows you to store PNG images that should be used as favicons by the plugin. A favicon from this folder can be used by referencing the name (Including the `.png` file extension) in the [`favicon` option of the server list profile](../profiles/options/favicon.md).
 
 #### Profiles folder and default.yml { #profiles-folder-and-default-yml }
 
@@ -162,9 +155,9 @@ priority: 0
 # Set condition(s) that should return true to display this profile.
 # This allows you to create profiles to only show for specific scenarios (i.e. player is banned).
 #
-# Multiple conditions can be chaing with the keywords 'and', 'or', or their counterparts '&&' and '||'.
+# 'AND'/'&&' and 'OR'/'||' can be used to chain together multiple conditions.
 #
-# No condition or an empty condition will be treated as true by default.
+# Removing the condition option or setting it to an empty String will be treated as a true condition being returned.
 #
 # Read more: https://asl.andre601.ch/profiles/#condition
 #
@@ -192,8 +185,11 @@ profiles:
 
 #
 # Set the "Message of the day" to display.
-# This option supports RGB colors for 1.16+ Servers and clients, including gradients using MiniMessage's <gradient>
-# option.
+# This option supports RGB colors for 1.16+ Servers and clients. More advanced MiniMessage features such as <gradient>
+# can be used for further styling the text.
+#
+# <center> can be put at the start of a line to have AdvancedServerList automatically center the text as good as
+# possible.
 #
 # Only the first two lines will be considered and any additional one is ignored.
 #
@@ -207,20 +203,14 @@ motd:
 
 #
 # Set the Favicon (image on the left of a server entry) to display.
-# This option supports three types of inputs:
+# This option supports three types of input:
 #
-#   1. Name, including .png extension, pointing to an image located in the plugin's favicons folder.
-#   2. "random" to display a random PNG from the favicons folder.
+#   1. Filename, including the .png extension, matching a filename in the favicons folder of the plugin.
+#      - 'random' can be used to have AdvancedServerList select a random image from the favicons folder every time
+#        the server is pinged.
 #   3. URL pointing to an image.
-#   4. Player name, UUID or placeholders returning one of these.
-#      https://mc-heads.net will be used to retrieve an image of the provided name/UUID.
-#
-# Note on favicons not showing:
-#   AdvancedServerList has to create a Favicon object for the Proxy/Server to use which takes time to do so.
-#   To not delay the Proxy/Server from being displayed (increase the loading time on the player end) is this creation
-#   done asynchronously for URL/Player name/UUID. This has the downside that the Proxy/Server may be done handling the
-#   ping before the Favicon is created, causing none to be displayed.
-#   Note that this won't happen with local favicons, as those are created during the plugin's startup.
+#   4. Player name, UUID or a placeholder that returns either.
+#      - https://mc-heads.net will be used to retrieve an image of the provided name/UUID.
 #
 # Any images above or below 64x64 pixels will be automatically resized to these dimensions.
 #
@@ -228,6 +218,15 @@ motd:
 #
 # Read more: https://asl.andre601.ch/profiles/#favicon
 #
+# "The favicon isn't showing!"
+#   This is a side effect of using either URLs or player names/UUIDs for the favicon.
+#   These types require AdvancedServerList to create a new favicon object from scratch. This action takes a significant
+#   amount of time, which can cause the server to show with a huge ping.
+#   To avoid this is this action performed asynchronously. This means that the plugin doesn't wait for the favicon to
+#   be created before continuing, which can result in no favicon being available when it is done handling the ping.
+#   This should only happen for the first ping of a player and subsequent pings should display the favicon, if the
+#   pings are done within the configured cache time (See 'faviconCacheTime' in the config.yml).
+#
 favicon: ''
 
 #
@@ -247,9 +246,18 @@ playerCount:
   #
   hidePlayers: false
   #
+  # Set whether the List of players is shown when hovering over the player count.
+  # Setting this to true will also make the plugin ignore the hover option below.
+  #
+  # If not present, defaults to false.
+  #
+  # Read more: https://asl.andre601.ch/profiles/#hideplayershover
+  #
+  hidePlayersHover: false
+  #
   # Set the lines shown when the player hovers over the player count.
   # Unlike the MOTD option does this one only support basic color and formatting codes. Any RGB colors will be
-  # downsampled to the nearest matching color.
+  # down-sampled to the nearest matching color.
   #
   # If not present or empty (hover: []), defaults to not modifying the hover.
   #
@@ -424,6 +432,14 @@ checkUpdates: true
 #
 debug: false
 
+#
+# Should the "ASL" ASCI art be displayed on plugin startup?
+# Setting this to false will hide the banner.
+#
+# Default: true
+#
+printBanner: true
+
 #
 # Sets how long Favicons should be cached. Value is in minutes with the lowest possible value being 1.
 #
@@ -460,6 +476,12 @@ disableDuringMaintenance:
   #
   hidePlayers: true
   #
+  # Whether hiding player list on hover should be disabled while Maintenance mode is active.
+  #
+  # Default: true
+  #
+  hidePlayersHover: true
+  #
   # Whether player count text changing should be disabled while Maintenance mode is active.
   #
   # Default: true
@@ -483,6 +505,12 @@ disableDuringMaintenance:
   # Default: true
   #
   maxPlayers: true
+  #
+  # Whether the online players feature should be disabled while Maintenance mode is active.
+  #
+  # Default: true
+  #
+  onlinePlayers: true
 
 #
 # DO NOT EDIT!
@@ -490,7 +518,7 @@ disableDuringMaintenance:
 # This is used internally to determine if the config needs to be migrated.
 # Changing or even removing this option could result in your config being broken.
 #
-config-version: 5
+configVersion: 8
 ```
 ///
 
@@ -509,14 +537,14 @@ There are certain files and folders that get created when certain events happen:
 
 Creating your first profile is relatively simple.
 
-It's best to open the `default.yml` file located inside `profiles` with the file editor of your choice ([:simple-vscodium: VSCodeium](https://vscodium.com/) or [:simple-notepadplusplus: Notepad++](https://notepad-plus-plus.org/) are recommended).  
+It's best to open the `default.yml` file located inside `profiles` with the file editor of your choice ([:simple-vscodium: VSCodeium](https://vscodium.com/){ target="_blank" rel="nofollow" } or [:simple-notepadplusplus: Notepad++](https://notepad-plus-plus.org/){ target="_blank" rel="nofollow" } are recommended).  
 This file should contain all available options that you can set and alter.
 
-Edit the options to whatever you like. All text-based options, except [`condition`](../profiles/index.md#condition), support [MiniMessage formatting](../profiles/formatting.md).  
-Hexadecimal (RGB) colors are supported, however, only the [`motd` option](../profiles/index.md#motd) may display them and only for MC 1.16+ clients. Any other option will have the color down-sampled to the nearest supported color code.
+Edit the options to whatever you like. All text-based options, except [`condition`](../profiles/options/condition.md), support [MiniMessage formatting](../profiles/formatting.md).  
+Hexadecimal (RGB) colors are supported, however, only the [`motd` option](../profiles/options/motd.md) may display them and only for MC 1.16+ clients. Any other option will have the color down-sampled to the nearest supported color code.
 
 If you're unsure how a specific option should look like, head over to the [Profiles page](../profiles/index.md) for more information about the general structure.  
-All you need to know is, that a bare-bones server list profile requires a valid [priority](../profiles/index.md#priority) and at least one of the settings to be present.
+All you need to know is, that a bare-bones server list profile requires a valid [priority](../profiles/options/priority.md) and at least one of the other options (except condition) to be present.
 
 To give an example is here a basic profile that only modifies the MOTD and nothing else:
 ```yaml title="default.yml"
@@ -529,10 +557,10 @@ motd:
 
 ### Additional profiles
 
-Additional profiles can be created to display different content under specific situations. To create a new file, either manually create a YAML file in the `profiles` folder, or use [`/asl profiles add <name>`](../commands/index.md#profiles) to have one created for you. In either case is it recommended to only use alphanummeric (`a-z` abd `0-9`) characters, dashes and underscores for the file name. You should also choose a name that fits the purpose of the file (i.e. for a profile that displays stuff when someone is banned, name it `banned.yml`).
+Additional profiles can be created to display different content under specific situations. To create a new file, either manually create a YAML file in the `profiles` folder, or use [`/asl profiles add {name}`](../commands/profiles.md#add) to have one created for you. In either case is it recommended to only use alphanummeric (`a-z` abd `0-9`) characters, dashes and underscores for the file name. You should also choose a name that fits the purpose of the file (i.e. for a profile that displays stuff when someone is banned, name it `banned.yml`).
 
-In case you manually created a YAML file, make sure it contains the [`priority`](../profiles/index.md#priority) setting and one of the other settings, to have a valid profile.  
-You should also add a [`condition`](../profiles/index.md#condition) to ensure that the profile is only loaded when needed. The [Expressions page](../profiles/expressions.md) covers what counts as valid expressions and conditions.  
+In case you manually created a YAML file, make sure it contains the [`priority`](../profiles/options/priority.md) setting and one of the other settings, to have a valid profile.  
+You should also add a [`condition`](../profiles/options/condition.md) to ensure that the profile is only loaded when needed. The [Expressions page](../profiles/expressions.md) covers what counts as valid expressions and conditions.  
 Do note that the plugin goes through the profiles in order of priority, starting with the highest number first, picking the first one that returns a `condition` returning true.
 
 /// info | Note about Condition
@@ -556,7 +584,7 @@ The [Examples page](../examples/index.md) contains more examples of different se
 ## 4. Loading profiles { #loading-profiles }
 
 Once you've set up your server list profile(s) is it time to load it/them.  
-To do this, simply run `/asl reload` as player (Requires permission `advancedserverlist.admin` or `advancedserverlist.command.reload`) or `asl reload` through the Server/Proxy console.
+To do this, simply run [`/asl reload`](../commands/reload.md).
 
 The plugin should then load any valid YAML file inside the `profiles` folder to then use.
 

docs/getting-started/tutorials.md

@@ -22,13 +22,25 @@ you can click the image to be sent to the actual video.
 
 **Video Language:** :flag_gb: English
 
-[![thumbnail](https://img.youtube.com/vi/9cU0uUWHOO0/0.jpg)](https://youtube.com/watch?v=9cU0uUWHOO0){ target="_blank" rel="nofollow" }
+[![thumbnail](https://img.youtube.com/vi/9cU0uUWHOO0/0.jpg){ loading="lazy" }](https://youtube.com/watch?v=9cU0uUWHOO0){ target="_blank" rel="nofollow" }
 
 ### Ajneb97
 
 **Video Language:** :flag_es: Spanish
 
-[![thumbnail](https://img.youtube.com/vi/rIbljm_4HVI/0.jpg)](https://youtube.com/watch?v=rIbljm_4HVI){ target="_blank" rel="nofollow" }
+[![thumbnail](https://img.youtube.com/vi/rIbljm_4HVI/0.jpg){ loading="lazy" }](https://youtube.com/watch?v=rIbljm_4HVI){ target="_blank" rel="nofollow" }
+
+### faajrikha
+
+**Video Language:** :flag_id: Indonesian
+
+[![thumbnail](https://img.youtube.com/vi/-p938rOmqy4/0.jpg){ loading="lazy" }](https://www.youtube.com/watch?v=-p938rOmqy4){ target="_blank" rel="nofollow" }
+
+### FINNI GAMER
+
+**Video Language:** :flag_de: German
+
+[![thumbnail](https://img.youtube.com/vi/1Kh3cPMDd0c/0.jpg){ loading="lazy" }](https://www.youtube.com/watch?v=1Kh3cPMDd0c){ target="_blank" rel="nofollow" }
 
 ## Text Tutorials
 

docs/index.md

@@ -43,25 +43,48 @@ AdvancedServerList supports the following platforms:
 
 ## Pages
 
-<div class="grid cards" markdown>
-
+/// html | div.grid.cards
 -   [:octicons-milestone-24: **Getting Started**](getting-started/index.md)
     
     ----
     
     A simple guide on how to get started with AdvancedServerList.
+    
+    ----
+    
+    **Other Pages:**
+    
+    - [:octicons-project-roadmap-24: Tutorials](getting-started/tutorials.md)
 
 -   [:octicons-rel-file-path-24: **Commands**](commands/index.md)
     
     ----
     
     A list of all available commands in AdvancedServerList.
+    
+    ----
+    
+    **Other Pages:**
+    
+    - [/asl clearcache](commands/clearcache.md)
+    - [/asl help](commands/help.md)
+    - [/asl migrate](commands/migrate.md)
+    - [/asl profiles](commands/profiles.md)
+    - [/asl reload](commands/reload.md)
 
 -   [:octicons-note-24: **Profiles**](profiles/index.md)
     
     ----
     
     Pages containing information about the Server List Profile System and all its available options.
+    
+    ----
+    
+    **Other Pages:**
+    
+    - [:octicons-file-code-24: Expressions](profiles/expressions.md)
+    - [:octicons-pencil-24: Formatting](profiles/formatting.md)
+    - [:material-percent: Placeholders](profiles/placeholders.md)
 
 -   [:octicons-list-unordered-24: **Examples**](examples/index.md)
     
@@ -74,12 +97,37 @@ AdvancedServerList supports the following platforms:
     ----
     
     Pages explaining how to migrate from one version of the plugin to another.
+    
+    ----
+    
+    **Other Pages:**
+    
+    - Plugins
+        - [:octicons-arrow-right-24: MiniMOTD](migration/plugins/minimotd.md)
+        - [:octicons-arrow-right-24: ServerListPlus](migration/plugins/serverlistplus.md)
+    - Versions
+        - [:octicons-arrow-right-24: v3.8.0 to v3.9.0](migration/versions/v3.8.0-to-v3.9.0.md)
+        - [:octicons-arrow-right-24: v3.7.0 to v3.8.0](migration/versions/v3.7.0-to-v3.8.0.md)
+        - [:octicons-arrow-right-24: < v3.7.0 to v3.7.0](migration/versions/pre-v3.7.0-to-v3.7.0.md)
+        - [:octicons-arrow-right-24: v1.9.0 to v1.10.0](migration/versions/v1.9.0-to-v1.10.0.md)
+        - [:octicons-arrow-right-24: v1.5.3 to v1.6.0](migration/versions/v1.5.3-to-v1.6.0.md)
 
 -   [:octicons-command-palette-24: **API**](api/index.md)
     
     ----
     
     Pages all about the API of AdvancedServerList.
+    
+    ----
+    
+    **Other Pages:**
+    
+    - [:octicons-plus-circle-24: Adding Placeholders](api/adding-placeholders.md)
+    - [:octicons-broadcast-24: Listening for Events](api/listening-for-events.md)
+    - [:octicons-log-24: Changelog](api/changelog.md)
+    - [:octicons-link-external-24: Javadocs](api/javadocs.md)
+    - [:simple-codeberg: Source Code](api/source.md)
+    - [:octicons-file-code-24: Reference](api/reference/index.md)
 
 -   [:octicons-plus-circle-24: **Addons**](addons/index.md)
     
@@ -87,10 +135,12 @@ AdvancedServerList supports the following platforms:
     
     Pages listing 1st-party and 3rd-party add-ons for AdvancedServerList.
     
--   [:material-percent: **PlaceholderAPI**](placeholderapi/index.md)
-    
     ----
     
-    Information about available placeholders to use in PlaceholderAPI and how to use placeholders from other plugins in AdvancedServerList using PlaceholderAPI.
-
-</div>
+    **Other Pages:**
+    
+    - First Party
+        - [:octicons-stop-24: BanPlugins Addon](addons/first-party/banplugins.md)
+    - Third Party
+        - [:octicons-eye-closed-24: SayanVanish](addons/third-party/sayanvanish.md)
+///

docs/migration/index.md

@@ -9,8 +9,7 @@ icon: octicons/file-directory-symlink-24
 The below pages show guides on how to migrate from another plugin to AdvancedServerList.  
 These pages may include important information about the migration process and what you may have to do before, during or after the process.
 
-<div class="grid cards" markdown>
-
+/// html | div.grid.cards
 -   [**MiniMOTD**](plugins/minimotd.md)
     
     ----
@@ -22,16 +21,14 @@ These pages may include important information about the migration process and wh
     ----
     
     Migrate from the Plugin [ServerListPlus](https://github.com/Minecrell/ServerListPlus){ target="_blank" rel="nofollow" }.
-
-</div>
+///
 
 ## AdvancedServerList
 
 The below pages show guides on how to migrate from one version to another of AdvancedServerList.  
 These guides are only for the Server List Profile files, as the config.yml gets automatically migrated (Feature since v3.1.0).
 
-<div class="grid cards" markdown>
-
+/// html | div.grid.cards
 -   [**v3.8.0 to v3.9.0**](versions/v3.8.0-to-v3.9.0.md)
     
     ----
@@ -61,5 +58,4 @@ These guides are only for the Server List Profile files, as the config.yml gets
     ----
     
     Migrate from version 1.5.3 to 1.6.0.
-
-</div>
+///

docs/migration/plugins/minimotd.md

@@ -11,7 +11,7 @@ Version `4.10.0` added support for migrating your existing `main.conf` configura
 
 ## How to Migrate
 
-Execute the command [`/asl migrate minimotd`](../../commands/index.md#migrate) to start the migration process. Make sure the `main.conf` file is present in `/plugins/MiniMOTD/` (`minimotd-velocity` on Velocity).
+Execute the command [`/asl migrate minimotd`](../../commands/migrate.md) to start the migration process. Make sure the `main.conf` file is present in `/plugins/MiniMOTD/` (`minimotd-velocity` on Velocity).
 
 ## Example