Go back to using placeholders

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

.github/ISSUE_TEMPLATE/api_support.yml

@@ -9,7 +9,7 @@ body:
         Please make sure you've checked the following things first:
         
         - You're using the latest release of AdvancedServerList [[Download from Modrinth](https://modrinth.com/plugin/advancedserverlist)] and the right API version.
-        - You're using a supported Proxy/Server version. As of right now is only 1.19.x supported.
+        - You're using a supported Proxy/Server version. As of right now is only 1.19+ supported.
         - The Feature you suggest hasn't been suggested before.
   - type: dropdown
     attributes:

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -9,7 +9,7 @@ body:
         Please make sure you've checked the following things first:
         
         - You're using the latest release of AdvancedServerList [[Download from Modrinth](https://modrinth.com/plugin/advancedserverlist)]
-        - You're using a supported Proxy/Server version. As of right now is only 1.19.x supported.
+        - You're using a supported Proxy/Server version. As of right now is only 1.19+ supported.
         - The issue happens with just AdvancedServerList installed.
   - type: dropdown
     attributes:

.github/ISSUE_TEMPLATE/config.yml

@@ -5,4 +5,4 @@ contact_links:
     url: https://discord.gg/6dazXp6
   - name: Wiki
     about: Check the Wiki for explanations about the features and examples.
-    url: https://github.com/Andre601/AdvancedServerList/wiki
+    url: https://docs.andre601.ch/AdvancedServerList

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -9,7 +9,7 @@ body:
         Please make sure you've checked the following things first:
         
         - You're using the latest release of AdvancedServerList [[Download from Modrinth](https://modrinth.com/plugin/advancedserverlist)]
-        - You're using a supported Proxy/Server version. As of right now is only 1.19.x supported.
+        - You're using a supported Proxy/Server version. As of right now is only 1.19+ supported.
         - The Feature you suggest hasn't been suggested before.
   - type: dropdown
     attributes:

.github/assets/MODRINTH.md

@@ -4,19 +4,19 @@ AdvancedServerList is a plugin that allowys you to customize your server's MOTD,
 ## Supported Platforms
 
 <a href="https://www.spigotmc.org" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/spigot_vector.svg" width="64" alt="platform-spigot" title="Tested on Spigot">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/spigot_vector.svg&w=64 alt="platform-spigot" title="Tested on Spigot">
 </a>
 <a href="https://papermc.io" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/paper_vector.svg" width="64" alt="platform-paper" title="Tested on Paper">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/paper_vector.svg&w=64 alt="platform-paper" title="Tested on Paper">
 </a>
 <a href="https://www.spigotmc.org" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/bungeecord_vector.svg" width="64" alt="platform-bungeecord" title="Tested on BungeeCord">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/bungeecord_vector.svg&w=64 alt="platform-bungeecord" title="Tested on BungeeCord">
 </a>
 <a href="https://www.papermc.io" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/waterfall_vector.svg" width="64" alt="platform-waterfall" title="Tested on Waterfall">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/waterfall_vector.svg&w=64 alt="platform-waterfall" title="Tested on Waterfall">
 </a>
 <a href="https://velocitypowered.com" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/velocity_vector.svg" width="64" alt="platform-velocity" title="Tested on Velocity">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/supported/velocity_vector.svg&w=64 alt="platform-velocity" title="Tested on Velocity">
 </a>
 
 ## What is a Server List Profile?
@@ -24,12 +24,14 @@ A Server List Profile refers to a YAML file located in the plugin's `profiles` d
 It allows you to configure specific aspects of the server display in the MC-Client's multiplayer server list, such as the MOTD, player count text, player count hover or Favicon.
 
 > [*Read More*][profiles]
+
 ### Conditions
 Thanks to conditions can you determine when a profile should be displayed in the player’s server list, to allow displaying specific text (i.e. a warning when they are using an outdated version).
 
 When multiple profiles exist that have valid conditions will the one with the highest priority (Higher number = higher priority) be selected. Having no conditions makes the profile automatically return true.
 
 > [*Read More*][conditions]
+
 ### Placeholders
 Placeholders can be used within conditions to further customize them. They can also be used in any other text option (motd, playerCount and players) to display their respective values.
 The format is `${<target> <identifier>}` which was adopted from BungeeTabListPlus. Depending on what platform you use the plugin on are only specific placeholders available.
@@ -37,17 +39,20 @@ The format is `${<target> <identifier>}` which was adopted from BungeeTabListPlu
 When using the SpigotMC/PaperMC version can you also use placeholders from [PlaceholderAPI][placeholderapi] using its `%<identifier>_<values>%` placeholder format. PlaceholderAPI needs to be installed for that.
 
 > [*Read More*][placeholders]
+
 ### Formatting
 The plugin uses the MiniMessage format for a consistent, easy way of formatting your text.
 Only certain options are usable for each option. As an example does motd support HEX colours and gradients, while the other options only support default colour codes.
 
 > [*Read More*][minimessage]
+
 ## Dependencies
 
 | Dependency       | Platforms     | Required? |
-| ---------------- | ------------- | --------- |
+|------------------|---------------|-----------|
 | [ProtocolLib]    | Spigot        | Yes       |
 | [PlaceholderAPI] | Spigot, Paper | No        |
+| [ViaVersion]     | Spigot, Paper | No        |
 
 ## Statistics
 
@@ -58,31 +63,42 @@ You can disable this in the global bStats config file located in `/plugins/bstat
 - [Paper/Spigot][bstats-spigot]
 - [Velocity][bstats-velocity]
 
+## Videos
+Do you have your own video to share? Contact me and I will add it to this section.
+
+<details><summary>Click to Show/Hide Videos</summary>
+
+Spanish Video by Ajneb97
+<iframe width="560" height="auto" src="https://www.youtube.com/embed/rIbljm_4HVI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+
+</details>
+
 ## Screenshots
 
 <a href="https://modrinth.com/plugin/advancedserverlist/gallery" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/modrinth-gallery_vector.svg" width="208" alt="gallery" title="Check out the Gallery">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/modrinth-gallery_vector.svg&w=208" alt="gallery" title="Check out the Gallery">
 </a>
 
 ## Support
 <a href="https://discord.gg/6dazXp6" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/social/discord-singular_vector.svg" width="64" alt="discord" title="Join my Discord Server">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/social/discord-singular_vector.svg&w=64" alt="discord" title="Join my Discord Server">
 </a>
 <a href="https://app.revolt.chat/invite/74TpERXA" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/social/revolt-singular_vector.svg" width="64" alt="revolt" title="Join my Revolt Server">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/social/revolt-singular_vector.svg&w=64" alt="revolt" title="Join my Revolt Server">
 </a>
 <a href="https://blobfox.coffee/@andre_601" target="_blank">
-  <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/social/mastodon-singular_vector.svg" width="64" alt="revolt" title="Chat with me on Mastodon">
+  <img src="https://wsrv.nl/?url=https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact-minimal/social/mastodon-singular_vector.svg&w=64" alt="revolt" title="Chat with me on Mastodon">
 </a>
 
 <!-- Links -->
-[profiles]: https://andre601.ch/AdvancedServerList/profiles
-[conditions]: https://andre601.ch/AdvancedServerList/profiles/#conditions
-[placeholders]: https://andre601.ch/AdvancedServerList/profiles/placeholders
-[minimessage]: https://andre601.ch/AdvancedServerList/profiles/formatting
+[profiles]: https://docs.andre601.ch/AdvancedServerList/latest/profiles
+[conditions]: https://docs.andre601.ch/AdvancedServerList/latest/profiles/#conditions
+[placeholders]: https://docs.andre601.ch/AdvancedServerList/latest/profiles/placeholders
+[minimessage]: https://docs.andre601.ch/AdvancedServerList/latest/profiles/formatting
 
 [protocollib]: https://www.spigotmc.org/resources/1997/
 [placeholderapi]: https://www.spigotmc.org/resources/6245/
+[viaversion]: https://www.spigotmc.org/resources/19254/
 
 [bstats]: https://bstats.org
 [bstats-bungee]: https://bstats.org/plugin/bungeecord/AdvancedServerList/15585

.github/assets/pr-comments/building.md

@@ -0,0 +1,7 @@
+<!-- pr-build comment -->
+
+![badge]
+
+Building jar file from Pull request. Please wait...
+
+[badge]: https://img.shields.io/badge/Building...-0d1117?style=for-the-badge&labelColor=7a8490&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiBmaWxsPSIjZmZmZmZmIj48cGF0aCBkPSJNNC43NSAyaDE0LjVhLjc1Ljc1IDAgMCAxIDAgMS41aC0uNzV2Mi45ODJhNC43NSA0Ljc1IDAgMCAxLTIuMjE1IDQuMDE3bC0yLjA0NCAxLjI5YS4yNS4yNSAwIDAgMCAwIC40MjJsMi4wNDQgMS4yOWE0Ljc1IDQuNzUgMCAwIDEgMi4yMTUgNC4wMTdWMjAuNWguNzVhLjc1Ljc1IDAgMCAxIDAgMS41SDQuNzVhLjc1Ljc1IDAgMCAxIDAtMS41aC43NXYtMi45ODJhNC43NSA0Ljc1IDAgMCAxIDIuMjE1LTQuMDE3bDIuMDQ0LTEuMjlhLjI1LjI1IDAgMCAwIDAtLjQyMmwtMi4wNDQtMS4yOUE0Ljc1IDQuNzUgMCAwIDEgNS41IDYuNDgyVjMuNWgtLjc1YS43NS43NSAwIDAgMSAwLTEuNVpNMTcgMy41SDd2Mi45ODJBMy4yNSAzLjI1IDAgMCAwIDguNTE2IDkuMjNsMi4wNDQgMS4yOWExLjc1IDEuNzUgMCAwIDEgMCAyLjk2bC0yLjA0NCAxLjI5QTMuMjUgMy4yNSAwIDAgMCA3IDE3LjUxOFYyMC41aDEwdi0yLjk4MmEzLjI1IDMuMjUgMCAwIDAtMS41MTYtMi43NDhsLTIuMDQ0LTEuMjlhMS43NSAxLjc1IDAgMCAxIDAtMi45NmwyLjA0NC0xLjI5QTMuMjUgMy4yNSAwIDAgMCAxNyA2LjQ4MloiPjwvcGF0aD48L3N2Zz4=

.github/assets/pr-comments/failed.md

@@ -0,0 +1,12 @@
+<!-- pr-build comment -->
+![badge]
+
+**Compiling of jar files failed!**  
+Please check the logs below for any errors.
+
+| Name   | Link                             |
+| ------ | -------------------------------- |
+| Commit | {{ .commit }}                    |
+| Logs   | {{ .logs | mdlink "View Logs" }} |
+
+[badge]: https://img.shields.io/badge/Build_Failure!-0d1117?style=for-the-badge&labelColor=f85149&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiBmaWxsPSIjZmZmZmZmIj48cGF0aCBkPSJNNS43MiA1LjcyYS43NS43NSAwIDAgMSAxLjA2IDBMMTIgMTAuOTRsNS4yMi01LjIyYS43NDkuNzQ5IDAgMCAxIDEuMjc1LjMyNi43NDkuNzQ5IDAgMCAxLS4yMTUuNzM0TDEzLjA2IDEybDUuMjIgNS4yMmEuNzQ5Ljc0OSAwIDAgMS0uMzI2IDEuMjc1Ljc0OS43NDkgMCAwIDEtLjczNC0uMjE1TDEyIDEzLjA2bC01LjIyIDUuMjJhLjc1MS43NTEgMCAwIDEtMS4wNDItLjAxOC43NTEuNzUxIDAgMCAxLS4wMTgtMS4wNDJMMTAuOTQgMTIgNS43MiA2Ljc4YS43NS43NSAwIDAgMSAwLTEuMDZaIj48L3BhdGg+PC9zdmc+

.github/assets/pr-comments/success.md

@@ -0,0 +1,15 @@
+<!-- pr-build comment -->
+![badge]
+
+The compiling of the jar files was successful!  
+You can find a direct download for the artifact below.
+
+File expires: `{{ .expire | date "02 Jan 2006 15:04 MST" }}`
+
+| Name     | Link                                         |
+| -------- | -------------------------------------------- |
+| Commit   | {{ .commit }}                                |
+| Logs     | {{ .logs | mdlink "View Logs" }}             |
+| Download | {{ .download | mdlink "Download Artifact" }} |
+
+[badge]: https://img.shields.io/badge/Build_Success!-0d1117?style=for-the-badge&labelColor=3fb950&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiBmaWxsPSIjZmZmZmZmIj48cGF0aCBkPSJNMjEuMDMgNS43MmEuNzUuNzUgMCAwIDEgMCAxLjA2bC0xMS41IDExLjVhLjc0Ny43NDcgMCAwIDEtMS4wNzItLjAxMmwtNS41LTUuNzVhLjc1Ljc1IDAgMSAxIDEuMDg0LTEuMDM2bDQuOTcgNS4xOTVMMTkuOTcgNS43MmEuNzUuNzUgMCAwIDEgMS4wNiAwWiI+PC9wYXRoPjwvc3ZnPg==

.github/dependabot.yml

@@ -17,21 +17,13 @@ updates:
       - 'Type: Update Dependency'
       - 'Target: Core'
   - package-ecosystem: maven
-    directory: "/paper"
+    directory: "/bukkit"
     schedule:
       interval: daily
     open-pull-requests-limit: 10
     labels:
       - 'Type: Update Dependency'
-      - 'Target: PaperMC'
-  - package-ecosystem: maven
-    directory: "/spigot"
-    schedule:
-      interval: daily
-    open-pull-requests-limit: 10
-    labels:
-      - 'Type: Update Dependency'
-      - 'Target: Spigot'
+      - 'Target: Bukkit'
   - package-ecosystem: maven
     directory: "/velocity"
     schedule:

.github/labeler.yml

@@ -0,0 +1,14 @@
+"Target: All":
+  - all: ["bukkit/**", "bungeecord/**", "core/**", "velocity/**"]
+
+"Target: Bukkit":
+  - all: ["bukkit/**", "!bungeecord/**", "!core/**", "!velocity/**"]
+
+"Target: BungeeCord":
+  - all: ["!bukkit/**", "bungeecord/**", "!core/**", "!velocity/**"]
+
+"Target: Core":
+  - all: ["!bukkit/**", "!bungeecord/**", "core/**", "!velocity/**"]
+
+"Target: Velocity":
+  - all: ["!bukkit/**", "!bungeecord/**", "!core/**", "velocity/**"]

.github/workflows/create-pr-artifact.yml

@@ -28,9 +28,11 @@ permissions:
 jobs:
   buildArtifacts:
     runs-on: ubuntu-latest
+    outputs:
+      comment_id: ${{ steps.comment.outputs.comment-id }}
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: refs/pull/${{ github.event.pull_request.number }}/merge
       - name: Find Comment
@@ -52,13 +54,7 @@ jobs:
           issue-number: ${{ github.event.pull_request.number }}
           comment-id: ${{ steps.find-comment.outputs.comment-id }}
           edit-mode: replace
-          body: |-
-            <!-- pr-build comment -->
-            ![badge]
-            
-            Please wait while we're building the Jar files for this Pull request...
-            
-            [badge]: https://img.shields.io/badge/Building...-0d1117?style=for-the-badge&labelColor=7a8490&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiBmaWxsPSIjZmZmZmZmIj48cGF0aCBkPSJNNC43NSAyaDE0LjVhLjc1Ljc1IDAgMCAxIDAgMS41aC0uNzV2Mi45ODJhNC43NSA0Ljc1IDAgMCAxLTIuMjE1IDQuMDE3bC0yLjA0NCAxLjI5YS4yNS4yNSAwIDAgMCAwIC40MjJsMi4wNDQgMS4yOWE0Ljc1IDQuNzUgMCAwIDEgMi4yMTUgNC4wMTdWMjAuNWguNzVhLjc1Ljc1IDAgMCAxIDAgMS41SDQuNzVhLjc1Ljc1IDAgMCAxIDAtMS41aC43NXYtMi45ODJhNC43NSA0Ljc1IDAgMCAxIDIuMjE1LTQuMDE3bDIuMDQ0LTEuMjlhLjI1LjI1IDAgMCAwIDAtLjQyMmwtMi4wNDQtMS4yOUE0Ljc1IDQuNzUgMCAwIDEgNS41IDYuNDgyVjMuNWgtLjc1YS43NS43NSAwIDAgMSAwLTEuNVpNMTcgMy41SDd2Mi45ODJBMy4yNSAzLjI1IDAgMCAwIDguNTE2IDkuMjNsMi4wNDQgMS4yOWExLjc1IDEuNzUgMCAwIDEgMCAyLjk2bC0yLjA0NCAxLjI5QTMuMjUgMy4yNSAwIDAgMCA3IDE3LjUxOFYyMC41aDEwdi0yLjk4MmEzLjI1IDMuMjUgMCAwIDAtMS41MTYtMi43NDhsLTIuMDQ0LTEuMjlhMS43NSAxLjc1IDAgMCAxIDAtMi45NmwyLjA0NC0xLjI5QTMuMjUgMy4yNSAwIDAgMCAxNyA2LjQ4MloiPjwvcGF0aD48L3N2Zz4=
+          body-path: .github/assets/pr-comments/building.md
       - name: Set up JDK 1.16
         uses: actions/setup-java@v3
         with:
@@ -78,23 +74,27 @@ jobs:
           name: AdvancedServerList-Artifacts
           path: '*/target/AdvancedServerList-*.jar'
           if-no-files-found: error
+  commentOnFail:
+    needs: [buildArtifacts]
+    if: failure()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          ref: refs/pull/${{ github.event.pull_request.number }}/merge
+      - name: Render Markdown Template
+        id: render
+        uses: chuhlomin/render-template@v1.7
+        with:
+          template: './.github/assets/pr-comments/failed.md'
+          vars: |
+            commit: ${{ github.event.pull_request.head.sha }}
+            logs: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
       - name: Update Comment (Failure)
-        if: failure()
         uses: peter-evans/create-or-update-comment@v3
         with:
           issue-number: ${{ github.event.pull_request.number }}
-          comment-id: ${{ steps.comment.outputs.comment-id }}
+          comment-id: ${{ needs.buildArtifacts.outputs.comment_id }}
           edit-mode: replace
-          body: |-
-            <!-- pr-build comment -->
-            ![badge]
-            
-            The Build of this Pull request failed.  
-            Please check the below linked logs for a possible cause.
-            
-            | Name   | Link                                                                                |
-            | ------ | ----------------------------------------------------------------------------------- |
-            | Commit | ${{ github.event.pull_request.head.sha }}                                           |
-            | Logs   | ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} |
-            
-            [badge]: https://img.shields.io/badge/Build_Failure!-0d1117?style=for-the-badge&labelColor=f85149&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiBmaWxsPSIjZmZmZmZmIj48cGF0aCBkPSJNNS43MiA1LjcyYS43NS43NSAwIDAgMSAxLjA2IDBMMTIgMTAuOTRsNS4yMi01LjIyYS43NDkuNzQ5IDAgMCAxIDEuMjc1LjMyNi43NDkuNzQ5IDAgMCAxLS4yMTUuNzM0TDEzLjA2IDEybDUuMjIgNS4yMmEuNzQ5Ljc0OSAwIDAgMS0uMzI2IDEuMjc1Ljc0OS43NDkgMCAwIDEtLjczNC0uMjE1TDEyIDEzLjA2bC01LjIyIDUuMjJhLjc1MS43NTEgMCAwIDEtMS4wNDItLjAxOC43NTEuNzUxIDAgMCAxLS4wMTgtMS4wNDJMMTAuOTQgMTIgNS43MiA2Ljc4YS43NS43NSAwIDAgMSAwLTEuMDZaIj48L3BhdGg+PC9zdmc+
+          body: ${{ steps.render.outputs.result }}

.github/workflows/docs-deploy.yml

@@ -17,7 +17,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python 3.7
         uses: actions/setup-python@v4
         with:
@@ -31,5 +31,9 @@ jobs:
         run: |
           python -m pip install --upgrade pip setuptools
           python -m pip install -r requirements.txt
+      - name: Set up Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "actions@github.com"
       - name: Deploy Files
         run: mkdocs gh-deploy --force

.github/workflows/pr-comment.yml

@@ -16,9 +16,11 @@ jobs:
     if: github.event.workflow_run.conclusion == 'success'
     runs-on: ubuntu-latest
     steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
       - name: Get Artifact and Pull request info
         env:
-          GITHUB_TOKEN: ${{ github.token }} # No idea why this is set here when ${{ secrets.GITHUB_TOKEN }} is a thing...
+          GITHUB_TOKEN: ${{ github.token }} # Needs to be set as env variable so that 'gh api' can be used.
           WORKFLOW_RUN_EVENT_OBJ: ${{ toJSON(github.event.workflow_run) }}
           OWNER: ${{ github.repository_owner }}
           REPO: ${{ github.event.repository.name }}
@@ -72,28 +74,26 @@ jobs:
           echo "Comment ID: ${{ steps.find-comment.outputs.comment-id }}"
           echo "Comment Author: ${{ steps.find-comment.outputs.comment-author }}"
           echo "Comment created at: ${{ steps.find-comment.outputs.comment-created-at }}"
-      - name: Update Comment
+      - name: Render Markdown Template
+        id: render
+        uses: chuhlomin/render-template@v1.7
         env:
           JOB_PATH: "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ env.PREVIOUS_JOB_ID }}"
-          ARTIFACT_URL: "${{ github.server_url }}/${{ github.repository }}/suites/${{ env.SUITE_ID }}/artifacts/${{ env.ARTIFACT_ID }}"
+          ARTIFACT_URL: "https://nightly.link/${{ github.repository }}/suites/${{ env.SUITE_ID }}/artifacts/${{ env.ARTIFACT_ID }}"
           ARTIFACT_EXPIRE_DATE: "${{ env.ARTIFACT_EXPIRE_DATE }}"
           HEAD_SHA: "${{ env.HEAD_SHA }}"
+        with:
+          template: './.github/assets/pr-comments/success.md'
+          timezone: Europe/Zurich
+          vars: |
+            commit: ${{ env.HEAD_SHA }}
+            logs: ${{ env.JOB_PATH }}
+            download: ${{ env.ARTIFACT_URL }}
+            expire: ${{ env.ARTIFACT_EXPIRE_DATE }}
+      - name: Update Comment
         uses: peter-evans/create-or-update-comment@v3
         with:
           issue-number: ${{ env.PR_NUMBER }}
           comment-id: ${{ steps.find-comment.outputs.comment-id }}
           edit-mode: replace
-          body: |-
-            <!-- pr-build comment -->
-            ![badge]
-            
-            Build Successful! You can find a link to the downloadable artifact below.  
-            Expire Date: `${{ env.ARTIFACT_EXPIRE_DATE }}`
-            
-            | Name     | Link                    |
-            | -------- | ----------------------- |
-            | Commit   | ${{ env.HEAD_SHA }}     |
-            | Logs     | ${{ env.JOB_PATH }}     |
-            | Download | ${{ env.ARTIFACT_URL }} |
-            
-            [badge]: https://img.shields.io/badge/Build_Success!-0d1117?style=for-the-badge&labelColor=3fb950&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiBmaWxsPSIjZmZmZmZmIj48cGF0aCBkPSJNMjEuMDMgNS43MmEuNzUuNzUgMCAwIDEgMCAxLjA2bC0xMS41IDExLjVhLjc0Ny43NDcgMCAwIDEtMS4wNzItLjAxMmwtNS41LTUuNzVhLjc1Ljc1IDAgMSAxIDEuMDg0LTEuMDM2bDQuOTcgNS4xOTVMMTkuOTcgNS43MmEuNzUuNzUgMCAwIDEgMS4wNiAwWiI+PC9wYXRoPjwvc3ZnPg==
+          body: ${{ steps.render.outputs.result }}

.github/workflows/release.yml

@@ -17,7 +17,7 @@ jobs:
       plugin_release: ${{ steps.github-release.outputs.PLUGIN_RELEASE }}
     steps:
     - name: Checkout Repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
     - name: Get Version from Release
       id: github-release
       run: |
@@ -50,61 +50,55 @@ jobs:
             loaders: |
               bungeecord
               waterfall
-          - platforms: Spigot, Paper
+            dependencies: 'papiproxybridge@1.3(optional)'
+          - platforms: Spigot, Paper, Folia
             directory: bukkit
             loaders: |
               spigot
               paper
+              folia
+            dependencies: ''
           - platforms: Velocity
             directory: velocity
             loaders: velocity
+            dependencies: 'papiproxybridge@1.3(optional)'
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Get Jar files
       uses: actions/download-artifact@v3
       with:
         name: asl-files
     - name: Upload AdvancedServerList v${{ needs.buildJars.outputs.plugin_release }} (${{ matrix.loaders }}) to GitHub and Modrinth
       if: '!github.event.release.prerelease'
-      uses: Kir-Antipov/mc-publish@v3.2
+      uses: Kir-Antipov/mc-publish@v3.3
       with:
         name: ${{ github.event.release.tag_name }} (${{ matrix.platforms }})
         version: ${{ needs.buildJars.outputs.plugin_release }}
         version-type: release
         files: ${{ matrix.directory}}/target/AdvancedServerList-*.jar
-        files-secondary: ""
         loaders: ${{ matrix.loaders }}
-        version-resolver: releases
-        game-versions: |
-          1.19
-          1.19.1
-          1.19.2
-          1.19.3
-          1.19.4
+        game-version-filter: releases
+        game-versions: '>=1.19'
         java: 16
+        dependencies: ${{ matrix.dependencies }}
         modrinth-id: xss83sOY
         modrinth-featured: false
         modrinth-token: ${{ secrets.MODRINTH_TOKEN }}
         github-token: ${{ secrets.GITHUB_TOKEN }}
     - name: Upload AdvancedServerList v${{ needs.buildJars.outputs.plugin_release }} (${{ matrix.loaders }}) to GitHub and Modrinth [Pre-Release]
       if: 'github.event.release.prerelease'
-      uses: Kir-Antipov/mc-publish@v3.2
+      uses: Kir-Antipov/mc-publish@v3.3
       with:
         name: ${{ github.event.release.tag_name }} (${{ matrix.platforms }})
         version: ${{ needs.buildJars.outputs.plugin_release }}
         version-type: beta
         files: ${{ matrix.directory }}/target/AdvancedServerList-*.jar
-        files-secondary: ""
         loaders: ${{ matrix.loaders }}
-        version-resolver: releases
-        game-versions: |
-          1.19
-          1.19.1
-          1.19.2
-          1.19.3
-          1.19.4
+        game-version-filter: releases
+        game-versions: '>=1.19'
         java: 16
+        dependencies: ${{ matrix.dependencies }}
         modrinth-id: xss83sOY
         modrinth-featured: false
         modrinth-token: ${{ secrets.MODRINTH_TOKEN }}
@@ -128,4 +122,4 @@ jobs:
       - name: Execute HangarUploader.jar
         run: java -jar HangarUploader.jar ${{ secrets.HANGAR_TOKEN }} ${{ needs.buildJars.outputs.plugin_release }} ${{ github.event.release.prerelease }}
         env:
-          GITHUB_RELEASE_BODY: ${{ github.event.release.body }}
+          GITHUB_RELEASE_BODY: ${{ github.event.release.body }}

.woodpecker/publish_assets.yml

@@ -0,0 +1,58 @@
+when:
+  - event: tag
+    branch: master
+
+steps:
+  createFiles:
+    image: maven:3.9.4-eclipse-temurin-17
+    commands:
+      # Create the jar files.
+      - mvn clean install
+  #uploadFiles:
+  #  image: badouralix/curl-jq
+  #  secrets:
+  #    - cb_token
+  #  commands:
+  #    # Get release info and setup env vars.
+  #    - |-
+  #      export JSON=`curl --location "https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList/releases?limit=10" \
+  #      --header 'Authorization: token $CB_TOKEN' \
+  #      --header 'Accept: application/json' -s -S \
+  #      --fail-with-body | jq ".[] | select (.tag_name==\"$CI_COMMIT_TAG\").")`
+  #    - export PLUGIN_CHANGELOG=$( echo $JSON | jq -r '.body' )
+  #    - export PLUGIN_PRE_RELEASE=$( echo $JSON | jq -r '.prerelease' )
+  #    - export RELEASE_ID=$( echo $JSON | jq -r '.id' )
+  #    # Upload release assets to Codeberg release
+  #    - |-
+  #      curl -X POST --location "https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList/releases/$RELEASE_ID/assets" \
+  #      --header "Authorization: token $CB_TOKEN" \
+  #      --header "Content-Type: multipart/form-data" -s -S \
+  #      --form "attachment=@bukkit/target/AdvancedServerList-Bukkit-${CI_COMMIT_TAG##v}.jar;type=application/octet-stream" \
+  #      --fail-with-body
+  #    - |-
+  #      curl -X POST --location "https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList/releases/$RELEASE_ID/assets" \
+  #      --header "Authorization: token $CB_TOKEN" \
+  #      --header "Content-Type: multipart/form-data" -s -S \
+  #      --form "attachment=@bungeecord/target/AdvancedServerList-BungeeCord-${CI_COMMIT_TAG##v}.jar;type=application/octet-stream" \
+  #      --fail-with-body
+  #    - |-
+  #      curl -X POST --location "https://codeberg.org/api/v1/repos/Andre601/AdvancedServerList/releases/$RELEASE_ID/assets" \
+  #      --header "Authorization: token $CB_TOKEN" \
+  #      --header "Content-Type: multipart/form-data" -s -S \
+  #      --form "attachment=@velocity/target/AdvancedServerList-Velocity-${CI_COMMIT_TAG##v}.jar;type=application/octet-stream" \
+  #      --fail-with-body
+  uploadToModrinthAndMaven:
+    image: eclipse-temurin
+    secrets:
+      - cb_token
+      - modrinth_api_token
+      - hangar_api_token
+    commands:
+      # Move VersionUploader.jar
+      - cd version-uploader/target/
+      - mv VersionUploader.jar ../../
+      - cd ../../
+      # Create Modrinth releases
+      - java -jar VersionUploader.jar --modrinth
+      # Create Hangar release
+      - java -jar VersionUploader.jar --hangar

.woodpecker/publish_docs.yml

@@ -0,0 +1,28 @@
+when:
+  - branch: master
+    event: push
+    path:
+      include: ['requirements.txt', 'mkdocs.yml', 'docs/**']
+
+steps:
+  buildDocs:
+    image: python
+    secrets:
+      - cb_token
+    commands:
+      - chmod -R a+w .
+      - git config --global --add safe.directory /woodpecker/src/codeberg.org/Andre601/blog-source/website
+      - git config --global user.email "github@andre601.ch"
+      - git config --global user.name "CI Website Builder"
+      - git fetch --unshallow
+      - git clone -b pages https://codeberg.org/Andre601/AdvancedServerList.git site
+      - chmod -R a+w site
+      - python -m pip install --upgrade pip
+      - python -m pip install -r requirements.txt
+      - mkdocs build
+      - mv domains site/.domains
+      - cd site
+      - git remote set-url origin https://$CB_TOKEN@codeberg.org/Andre601/AdvancedServerList.git
+      - git add --all
+      - git commit -m "Update AdvancedServerList Docs ($( env TZ=Europe/Zurich date +"%d.%m.%Y" )) [CI SKIP]"
+      - git push

README.md

@@ -10,10 +10,6 @@ AdvancedServerList is a plugin that allowys you to customize your server's MOTD,
 <a href="https://hangar.papermc.io/Andre_601/AdvancedServerList" target="_blank">
   <img src="https://cdn.jsdelivr.net/gh/Andre601/devins-badges@13e0142/assets/compact/available/hangar_vector.svg" height="46" alt="hangar" title="Available on Hangar">
 </a>
-<br>
-<a href="https://www.spigotmc.org/resources/102910" target="_blank">
-  <img src="https://cdn.jsdelivr.net/gh/Andre601/devins-badges@b9ff12b/assets/compact/available/spigot_vector.svg" height="46" alt="spigot" title="Available on SpigotMC">
-</a>
 
 ## Supported Platforms
 
@@ -64,11 +60,13 @@ Only certain options are usable for each option. As an example does motd support
 
 ## Dependencies
 
-| Dependency       | Platforms     | Required? |
-|------------------|---------------|-----------|
-| [ProtocolLib]    | Spigot        | Yes       |
-| [PlaceholderAPI] | Spigot, Paper | No        |
-| [ViaVersion]     | Spigot, Paper | No        |
+| Dependency        | Platforms                           | Required? |
+|-------------------|-------------------------------------|-----------|
+| [ProtocolLib]     | Spigot                              | Yes       |
+| [PlaceholderAPI]  | Spigot, Paper                       | No        |
+| [ViaVersion]      | Spigot, Paper                       | No        |
+| [PAPIProxyBridge] | Spigot, Paper, BungeeCord, Velocity | No        |
+| [Maintenance]     | Spigot, Paper, BungeeCord, Velocity | No        |
 
 ## Statistics
 
@@ -97,16 +95,18 @@ You can disable this in the global bStats config file located in `/plugins/bstat
 </a>
 
 <!-- Links -->
-[profiles]: https://www.andre601.ch/AdvancedServerList/profiles/
-[conditions]: https://www.andre601.ch/AdvancedServerList/profiles/#conditions
-[placeholders]: https://www.andre601.ch/AdvancedServerList/profiles/placeholders/
-[minimessage]: https://www.andre601.ch/AdvancedServerList/profiles/formatting/
+[profiles]: https://asl.andre601.ch/profiles/
+[conditions]: https://asl.andre601.ch/profiles/#conditions
+[placeholders]: https://asl.andre601.ch/profiles/placeholders/
+[minimessage]: https://asl.andre601.ch/profiles/formatting/
 
 [modrinth]: https://modrinth.com/plugin/advancedserverlist
 
-[protocollib]: https://www.spigotmc.org/resources/1997/
+[protocollib]: https://hangar.papermc.io/dmulloy2/ProtocolLib
 [placeholderapi]: https://www.spigotmc.org/resources/6245/
-[viaversion]: https://www.spigotmc.org/resources/19254/
+[viaversion]: https://hangar.papermc.io/ViaVersion/ViaVersion
+[papiproxybridge]: https://hangar.papermc.io/William278/PAPIProxyBridge
+[maintenance]: https://hangar.papermc.io/kennytv/Maintenance
 
 [bstats]: https://bstats.org
 [bstats-bungee]: https://bstats.org/plugin/bungeecord/AdvancedServerList/15585

bukkit/pom.xml

@@ -75,20 +75,20 @@
         </dependency>
         <dependency>
             <groupId>ch.andre601.asl-api</groupId>
-            <artifactId>platform-spigot</artifactId>
+            <artifactId>platform-bukkit</artifactId>
             <version>${api.version}</version>
             <scope>compile</scope>
         </dependency>
         <dependency>
             <groupId>io.papermc.paper</groupId>
             <artifactId>paper-api</artifactId>
-            <version>1.19.3-R0.1-SNAPSHOT</version>
+            <version>1.20-R0.1-SNAPSHOT</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>org.spigotmc</groupId>
             <artifactId>spigot-api</artifactId>
-            <version>1.19-R0.1-SNAPSHOT</version>
+            <version>1.20-R0.1-SNAPSHOT</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -100,7 +100,7 @@
         <dependency>
             <groupId>com.comphenix.protocol</groupId>
             <artifactId>ProtocolLib</artifactId>
-            <version>5.0.0-SNAPSHOT</version>
+            <version>5.0.0</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -118,13 +118,13 @@
         <dependency>
             <groupId>com.viaversion</groupId>
             <artifactId>viaversion-api</artifactId>
-            <version>4.6.2</version>
+            <version>4.7.0</version>
             <scope>provided</scope>
         </dependency>
     </dependencies>
 
     <build>
-        <finalName>AdvancedServerList-Bukkit-${plugin.version}${project.build.commit}</finalName>
+        <finalName>AdvancedServerList-Bukkit-${plugin.version}</finalName>
         <resources>
             <resource>
                 <filtering>true</filtering>
@@ -143,7 +143,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.4.1</version>
+                <version>3.5.0</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <relocations>
@@ -174,4 +174,4 @@
         </plugins>
     </build>
 
-</project>
+</project>

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/BukkitCore.java

@@ -25,6 +25,7 @@
 
 package ch.andre601.advancedserverlist.bukkit;
 
+import ch.andre601.advancedserverlist.bukkit.objects.WorldCache;
 import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
 import org.bukkit.plugin.java.JavaPlugin;
 
@@ -33,4 +34,6 @@ import org.bukkit.plugin.java.JavaPlugin;
  * Allows me to have BukkitCore<?> for whenever I also need a JavaPlugin (i.e. registering events).
  * See JoinEvent class for an example.
 */
-public abstract class BukkitCore<F> extends JavaPlugin implements PluginCore<F>{}
+public abstract class BukkitCore<F> extends JavaPlugin implements PluginCore<F>{
+    public abstract WorldCache getWorldCache();
+}

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/listeners/JoinEvent.java

@@ -23,10 +23,9 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bukkit.events;
+package ch.andre601.advancedserverlist.bukkit.listeners;
 
 import ch.andre601.advancedserverlist.bukkit.BukkitCore;
-import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
 import org.bukkit.Bukkit;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/listeners/LoadEvent.java

@@ -23,41 +23,52 @@
  *
  */
 
-package ch.andre601.advancedserverlist.spigot.events;
+package ch.andre601.advancedserverlist.bukkit.listeners;
 
-import ch.andre601.advancedserverlist.bukkit.events.JoinEvent;
+import ch.andre601.advancedserverlist.bukkit.BukkitCore;
+import ch.andre601.advancedserverlist.bukkit.objects.placeholders.PAPIPlaceholders;
 import ch.andre601.advancedserverlist.spigot.SpigotCore;
-import ch.andre601.advancedserverlist.bukkit.objects.PAPIPlaceholders;
+import ch.andre601.advancedserverlist.spigot.listeners.ProtocolLibEvents;
 import com.comphenix.protocol.ProtocolLibrary;
+import org.bukkit.Bukkit;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.event.server.ServerLoadEvent;
-import org.bukkit.plugin.PluginManager;
 
 public class LoadEvent implements Listener{
     
-    private final SpigotCore plugin;
+    private final BukkitCore<?> plugin;
     
-    public LoadEvent(SpigotCore plugin){
+    private LoadEvent(BukkitCore<?> plugin){
         this.plugin = plugin;
         plugin.getServer().getPluginManager().registerEvents(this, plugin);
     }
     
+    public static void init(BukkitCore<?> plugin){
+        new LoadEvent(plugin);
+    }
+    
     @EventHandler
     public void onServerLoad(ServerLoadEvent event){
-        PluginManager manager = plugin.getServer().getPluginManager();
+        JoinEvent.init(plugin);
+        WorldEvents.init(plugin);
         
-        if(!manager.isPluginEnabled("ProtocolLib")){
+        // Populate WorldCache with all loaded worlds
+        Bukkit.getWorlds().forEach(world -> plugin.getWorldCache().addWorld(world.getName(), world));
+        
+        if(!(plugin instanceof SpigotCore spigotCore))
+            return;
+        
+        if(!Bukkit.getPluginManager().isPluginEnabled("ProtocolLib")){
             plugin.getCore().getPlugin().getPluginLogger().warn("ProtocolLib not found! AdvancedServerList requires it to work on Spigot!");
-    
-            manager.disablePlugin(plugin);
+            
+            Bukkit.getPluginManager().disablePlugin(plugin);
             return;
         }
         
-        JoinEvent.init(plugin);
-        ProtocolLibEvents.init(plugin, ProtocolLibrary.getProtocolManager());
+        ProtocolLibEvents.init(spigotCore, ProtocolLibrary.getProtocolManager());
         
-        if(manager.isPluginEnabled("PlaceholderAPI"))
-            plugin.setPapiPlaceholders(PAPIPlaceholders.init(plugin));
+        if(Bukkit.getPluginManager().isPluginEnabled("PlaceholderAPI"))
+            spigotCore.setPapiPlaceholders(PAPIPlaceholders.init(spigotCore));
     }
 }

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/listeners/PreServerListSetEventImpl.java

@@ -23,8 +23,9 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bungeecord.events;
+package ch.andre601.advancedserverlist.bukkit.listeners;
 
+import ch.andre601.advancedserverlist.api.bukkit.events.PreServerListSetEvent;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 
 public class PreServerListSetEventImpl extends PreServerListSetEvent{

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/listeners/WorldEvents.java

@@ -0,0 +1,57 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2023 Andre_601
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+
+package ch.andre601.advancedserverlist.bukkit.listeners;
+
+import ch.andre601.advancedserverlist.bukkit.BukkitCore;
+import org.bukkit.Bukkit;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.world.WorldLoadEvent;
+import org.bukkit.event.world.WorldUnloadEvent;
+
+public class WorldEvents implements Listener{
+    
+    private final BukkitCore<?> plugin;
+    
+    private WorldEvents(BukkitCore<?> plugin){
+        this.plugin = plugin;
+        Bukkit.getPluginManager().registerEvents(this, plugin);
+    }
+    
+    public static void init(BukkitCore<?> plugin){
+        new WorldEvents(plugin);
+    }
+    
+    @EventHandler
+    public void onWorldLoad(WorldLoadEvent event){
+        plugin.getWorldCache().addWorld(event.getWorld().getName(), event.getWorld());
+    }
+    
+    @EventHandler
+    public void onWorldUnload(WorldUnloadEvent event){
+        plugin.getWorldCache().removeWorld(event.getWorld().getName());
+    }
+}

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/objects/WorldCache.java

@@ -0,0 +1,50 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2023 Andre_601
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+
+package ch.andre601.advancedserverlist.bukkit.objects;
+
+import org.bukkit.World;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public record WorldCache(Map<String, World> worlds){
+    
+    public WorldCache(){
+        this(new HashMap<>());
+    }
+    
+    public boolean containsWorld(String key){
+        return worlds().containsKey(key);
+    }
+    
+    public void addWorld(String key, World world){
+        worlds().put(key, world);
+    }
+    
+    public void removeWorld(String key){
+        worlds().remove(key);
+    }
+}

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/objects/impl/BukkitPlayerImpl.java

@@ -23,21 +23,21 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bukkit.objects;
+package ch.andre601.advancedserverlist.bukkit.objects.impl;
 
+import ch.andre601.advancedserverlist.api.bukkit.objects.BukkitPlayer;
 import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
 import ch.andre601.advancedserverlist.core.profiles.players.GenericPlayerImpl;
-import ch.andre601.advancedserverlist.spigot.objects.SpigotPlayer;
 import org.bukkit.OfflinePlayer;
 
-public class SpigotPlayerImpl extends GenericPlayerImpl implements SpigotPlayer{
+public class BukkitPlayerImpl extends GenericPlayerImpl implements BukkitPlayer{
     
     private final OfflinePlayer player;
     private boolean playedBefore = false;
     private boolean banned = false;
     private boolean whitelisted = false;
     
-    public SpigotPlayerImpl(OfflinePlayer player, CachedPlayer cachedPlayer, int protocol){
+    public BukkitPlayerImpl(OfflinePlayer player, CachedPlayer cachedPlayer, int protocol){
         this.player = player;
     
         this.name = player == null ? cachedPlayer.getName() : player.getName();

bukkit/src/main/java/ch/andre601/advancedserverlist/bukkit/objects/impl/BukkitServerImpl.java

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

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

@@ -23,12 +23,12 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bukkit.objects;
+package ch.andre601.advancedserverlist.bukkit.objects.placeholders;
 
 import ch.andre601.advancedserverlist.api.PlaceholderProvider;
+import ch.andre601.advancedserverlist.api.bukkit.objects.BukkitPlayer;
 import ch.andre601.advancedserverlist.api.objects.GenericPlayer;
 import ch.andre601.advancedserverlist.api.objects.GenericServer;
-import ch.andre601.advancedserverlist.spigot.objects.SpigotPlayer;
 
 public class BukkitPlayerPlaceholders extends PlaceholderProvider{
     
@@ -42,7 +42,8 @@ public class BukkitPlayerPlaceholders extends PlaceholderProvider{
     
     @Override
     public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server){
-        SpigotPlayer bukkitPlayer = (SpigotPlayer)player;
+        if(!(player instanceof BukkitPlayer bukkitPlayer))
+            return null;
         
         return switch(placeholder){
             case "name" -> bukkitPlayer.getName();
@@ -55,7 +56,7 @@ public class BukkitPlayerPlaceholders extends PlaceholderProvider{
         };
     }
     
-    private String returnValue(SpigotPlayer player, Object value){
+    private String returnValue(BukkitPlayer player, Object value){
         return player.getPlayer() == null ? null : String.valueOf(value);
     }
 }

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

@@ -0,0 +1,90 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2023 Andre_601
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+
+package ch.andre601.advancedserverlist.bukkit.objects.placeholders;
+
+import ch.andre601.advancedserverlist.api.bukkit.objects.BukkitServer;
+import ch.andre601.advancedserverlist.api.PlaceholderProvider;
+import ch.andre601.advancedserverlist.api.objects.GenericPlayer;
+import ch.andre601.advancedserverlist.api.objects.GenericServer;
+import org.bukkit.Bukkit;
+import org.bukkit.World;
+
+public class BukkitServerPlaceholders extends PlaceholderProvider{
+    
+    private BukkitServerPlaceholders(){
+        super("server");
+    }
+    
+    public static BukkitServerPlaceholders init(){
+        return new BukkitServerPlaceholders();
+    }
+    
+    @Override
+    public String parsePlaceholder(String placeholders, GenericPlayer player, GenericServer server){
+        if(!(server instanceof BukkitServer bukkitServer))
+            return null;
+        
+        String[] args = placeholders.split("\\s", 2);
+        
+        return switch(args[0]){
+            case "playersOnline" -> {
+                if(args.length >= 2){
+                    int players = 0;
+                    for(int i = 1; i < args.length; i++){
+                        World world = bukkitServer.getWorlds().get(args[i]);
+                        if(world == null)
+                            continue;
+                        
+                        players += world.getPlayers().size();
+                    }
+                    
+                    yield String.valueOf(players);
+                }
+                
+                yield String.valueOf(bukkitServer.getPlayersOnline());
+            }
+            case "playersMax" -> {
+                if(args.length >= 2)
+                    yield null;
+                
+                yield String.valueOf(bukkitServer.getPlayersMax());
+            }
+            case "host" -> {
+                if(args.length >= 2)
+                    yield null;
+                
+                yield bukkitServer.getHost();
+            }
+            case "whitelistEnabled" -> {
+                if(args.length >= 2)
+                    yield null;
+                
+                yield String.valueOf(Bukkit.hasWhitelist());
+            }
+            default -> null;
+        };
+    }
+}

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

@@ -23,12 +23,13 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bukkit.objects;
+package ch.andre601.advancedserverlist.bukkit.objects.placeholders;
 
 import ch.andre601.advancedserverlist.api.objects.GenericPlayer;
 import ch.andre601.advancedserverlist.api.objects.GenericServer;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 import ch.andre601.advancedserverlist.bukkit.BukkitCore;
+import ch.andre601.advancedserverlist.bukkit.objects.impl.BukkitPlayerImpl;
 import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
 import ch.andre601.advancedserverlist.core.objects.GenericServerImpl;
 import ch.andre601.advancedserverlist.core.parsing.ComponentParser;
@@ -36,7 +37,7 @@ import ch.andre601.advancedserverlist.core.profiles.ServerListProfile;
 import ch.andre601.advancedserverlist.core.profiles.profile.ProfileManager;
 import ch.andre601.advancedserverlist.core.profiles.replacer.StringReplacer;
 import ch.andre601.advancedserverlist.spigot.SpigotCore;
-import ch.andre601.advancedserverlist.spigot.events.ProtocolLibEvents;
+import ch.andre601.advancedserverlist.spigot.listeners.ProtocolLibEvents;
 import com.comphenix.protocol.ProtocolLibrary;
 import com.viaversion.viaversion.api.Via;
 import me.clip.placeholderapi.PlaceholderAPI;
@@ -92,7 +93,7 @@ public class PAPIPlaceholders<F> extends PlaceholderExpansion{
         int online = Bukkit.getOnlinePlayers().size();
         int max = Bukkit.getMaxPlayers();
         GenericServer server = new GenericServerImpl(online, max, host);
-        GenericPlayer player = new SpigotPlayerImpl(pl, cached, protocol);
+        GenericPlayer player = new BukkitPlayerImpl(pl, cached, protocol);
         
         ServerListProfile profile = ProfileManager.resolveProfile(plugin.getCore(), player, server);
         if(profile == null)
@@ -134,7 +135,8 @@ public class PAPIPlaceholders<F> extends PlaceholderExpansion{
         if(plugin instanceof SpigotCore)
             return ProtocolLibrary.getProtocolManager().getProtocolVersion(player);
         
-        // getProtocolVersion is only in Paper, so this is only called when main class isn't SpigotCore
+        // getProtocolVersion is only in Paper, so this is only called when main class isn't SpigotCore.
+        // Also, ViaVersion is not present, so the player protocol *should* be the same as the server.
         return Bukkit.getUnsafe().getProtocolVersion();
     }
     

bukkit/src/main/java/ch/andre601/advancedserverlist/paper/PaperCore.java

@@ -27,14 +27,18 @@ package ch.andre601.advancedserverlist.paper;
 
 import ch.andre601.advancedserverlist.bukkit.BukkitCore;
 import ch.andre601.advancedserverlist.bukkit.commands.CmdAdvancedServerList;
-import ch.andre601.advancedserverlist.bukkit.events.JoinEvent;
+import ch.andre601.advancedserverlist.bukkit.listeners.JoinEvent;
+import ch.andre601.advancedserverlist.bukkit.listeners.LoadEvent;
+import ch.andre601.advancedserverlist.bukkit.listeners.WorldEvents;
 import ch.andre601.advancedserverlist.bukkit.logging.BukkitLogger;
-import ch.andre601.advancedserverlist.bukkit.objects.BukkitPlayerPlaceholders;
-import ch.andre601.advancedserverlist.bukkit.objects.PAPIPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.placeholders.BukkitPlayerPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.placeholders.BukkitServerPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.placeholders.PAPIPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.WorldCache;
 import ch.andre601.advancedserverlist.core.AdvancedServerList;
 import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
 import ch.andre601.advancedserverlist.core.profiles.favicon.FaviconHandler;
-import ch.andre601.advancedserverlist.paper.events.PaperPingEvent;
+import ch.andre601.advancedserverlist.paper.listeners.PaperPingEvent;
 import org.bstats.bukkit.Metrics;
 import org.bstats.charts.SimplePie;
 import org.bukkit.util.CachedServerIcon;
@@ -46,12 +50,13 @@ public class PaperCore extends BukkitCore<CachedServerIcon>{
     private final PluginLogger logger = new BukkitLogger(getLogger());
     
     private AdvancedServerList<CachedServerIcon> core;
-    private FaviconHandler<CachedServerIcon> faviconHandler;
+    private FaviconHandler<CachedServerIcon> faviconHandler = null;
     private PAPIPlaceholders<CachedServerIcon> papiPlaceholders = null;
+    private WorldCache worldCache = null;
     
     @Override
     public void onEnable(){
-        this.core = AdvancedServerList.init(this, BukkitPlayerPlaceholders.init());
+        this.core = AdvancedServerList.init(this, BukkitPlayerPlaceholders.init(), BukkitServerPlaceholders.init());
         
         if(getServer().getPluginManager().isPluginEnabled("PlaceholderAPI"))
             papiPlaceholders = PAPIPlaceholders.init(this);
@@ -64,6 +69,9 @@ public class PaperCore extends BukkitCore<CachedServerIcon>{
             papiPlaceholders = null;
         }
         
+        if(worldCache != null)
+            worldCache = null;
+        
         getCore().disable();
     }
     
@@ -78,7 +86,7 @@ public class PaperCore extends BukkitCore<CachedServerIcon>{
     
     @Override
     public void loadEvents(){
-        JoinEvent.init(this);
+        LoadEvent.init(this);
         PaperPingEvent.init(this);
     }
     
@@ -134,4 +142,12 @@ public class PaperCore extends BukkitCore<CachedServerIcon>{
     public String getLoader(){
         return "paper";
     }
+    
+    @Override
+    public WorldCache getWorldCache(){
+        if(worldCache != null)
+            return worldCache;
+        
+        return (worldCache = new WorldCache());
+    }
 }

bukkit/src/main/java/ch/andre601/advancedserverlist/paper/listeners/PaperEventWrapper.java

@@ -23,14 +23,16 @@
  *
  */
 
-package ch.andre601.advancedserverlist.paper.events;
+package ch.andre601.advancedserverlist.paper.listeners;
 
 import ch.andre601.advancedserverlist.api.events.GenericServerListEvent;
 import ch.andre601.advancedserverlist.api.objects.GenericServer;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 import ch.andre601.advancedserverlist.bukkit.BukkitCore;
-import ch.andre601.advancedserverlist.bukkit.events.PreServerListSetEventImpl;
-import ch.andre601.advancedserverlist.bukkit.objects.SpigotPlayerImpl;
+import ch.andre601.advancedserverlist.bukkit.listeners.PreServerListSetEventImpl;
+import ch.andre601.advancedserverlist.bukkit.objects.impl.BukkitServerImpl;
+import ch.andre601.advancedserverlist.bukkit.objects.impl.BukkitPlayerImpl;
+import ch.andre601.advancedserverlist.core.events.PingEventHandler;
 import ch.andre601.advancedserverlist.core.interfaces.events.GenericEventWrapper;
 import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
 import ch.andre601.advancedserverlist.core.parsing.ComponentParser;
@@ -45,11 +47,9 @@ import org.bukkit.OfflinePlayer;
 import org.bukkit.util.CachedServerIcon;
 
 import java.awt.image.BufferedImage;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
+import java.util.*;
 
-public class PaperEventWrapper implements GenericEventWrapper<CachedServerIcon, SpigotPlayerImpl>{
+public class PaperEventWrapper implements GenericEventWrapper<CachedServerIcon, BukkitPlayerImpl>{
     
     private final PaperCore plugin;
     private final PaperServerListPingEvent event;
@@ -89,7 +89,7 @@ public class PaperEventWrapper implements GenericEventWrapper<CachedServerIcon,
     }
     
     @Override
-    public void setPlayers(List<String> lines, SpigotPlayerImpl player, GenericServer server){
+    public void setPlayers(List<String> lines, BukkitPlayerImpl player, GenericServer server){
         event.getPlayerSample().clear();
         List<PlayerProfile> players = new ArrayList<>(lines.size());
         
@@ -130,6 +130,14 @@ public class PaperEventWrapper implements GenericEventWrapper<CachedServerIcon,
         return false;
     }
     
+    @Override
+    public boolean isMaintenanceModeActive(){
+        if(!Bukkit.getPluginManager().isPluginEnabled("Maintenance"))
+            return false;
+        
+        return PingEventHandler.getMaintenanceUtil().isMaintenanceEnabled();
+    }
+    
     @Override
     public int getProtocolVersion(){
         return event.getClient().getProtocolVersion();
@@ -151,7 +159,7 @@ public class PaperEventWrapper implements GenericEventWrapper<CachedServerIcon,
     }
     
     @Override
-    public String parsePAPIPlaceholders(String text, SpigotPlayerImpl player){
+    public String parsePAPIPlaceholders(String text, BukkitPlayerImpl player){
         if(plugin.getServer().getPluginManager().isPluginEnabled("PlaceholderAPI"))
             return PlaceholderAPI.setPlaceholders(player.getPlayer(), text);
         
@@ -169,10 +177,15 @@ public class PaperEventWrapper implements GenericEventWrapper<CachedServerIcon,
     }
     
     @Override
-    public SpigotPlayerImpl createPlayer(CachedPlayer player, int protocol){
+    public BukkitPlayerImpl createPlayer(CachedPlayer player, int protocol){
         OfflinePlayer pl = Bukkit.getOfflinePlayer(player.getUuid());
         
-        return new SpigotPlayerImpl(pl.hasPlayedBefore() ? pl : null, player, protocol);
+        return new BukkitPlayerImpl(pl.hasPlayedBefore() ? pl : null, player, protocol);
+    }
+    
+    @Override
+    public GenericServer createGenericServer(int playersOnline, int playersMax, String host){
+        return new BukkitServerImpl(plugin.getWorldCache().worlds(), playersOnline, playersMax, host);
     }
     
     @Override

bukkit/src/main/java/ch/andre601/advancedserverlist/paper/listeners/PaperPingEvent.java

@@ -23,7 +23,7 @@
  *
  */
 
-package ch.andre601.advancedserverlist.paper.events;
+package ch.andre601.advancedserverlist.paper.listeners;
 
 import ch.andre601.advancedserverlist.core.events.PingEventHandler;
 import ch.andre601.advancedserverlist.paper.PaperCore;

bukkit/src/main/java/ch/andre601/advancedserverlist/spigot/SpigotCore.java

@@ -28,12 +28,14 @@ package ch.andre601.advancedserverlist.spigot;
 import ch.andre601.advancedserverlist.bukkit.BukkitCore;
 import ch.andre601.advancedserverlist.bukkit.commands.CmdAdvancedServerList;
 import ch.andre601.advancedserverlist.bukkit.logging.BukkitLogger;
-import ch.andre601.advancedserverlist.bukkit.objects.BukkitPlayerPlaceholders;
-import ch.andre601.advancedserverlist.bukkit.objects.PAPIPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.placeholders.BukkitPlayerPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.placeholders.BukkitServerPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.placeholders.PAPIPlaceholders;
+import ch.andre601.advancedserverlist.bukkit.objects.WorldCache;
 import ch.andre601.advancedserverlist.core.AdvancedServerList;
 import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
 import ch.andre601.advancedserverlist.core.profiles.favicon.FaviconHandler;
-import ch.andre601.advancedserverlist.spigot.events.LoadEvent;
+import ch.andre601.advancedserverlist.bukkit.listeners.LoadEvent;
 import com.comphenix.protocol.wrappers.WrappedServerPing;
 import net.kyori.adventure.platform.bukkit.BukkitAudiences;
 import org.bstats.bukkit.Metrics;
@@ -49,6 +51,7 @@ public class SpigotCore extends BukkitCore<WrappedServerPing.CompressedImage>{
     private AdvancedServerList<WrappedServerPing.CompressedImage> core;
     private FaviconHandler<WrappedServerPing.CompressedImage> faviconHandler = null;
     private PAPIPlaceholders<WrappedServerPing.CompressedImage> papiPlaceholders = null;
+    private WorldCache worldCache = null;
     
     @Override
     public void onEnable(){
@@ -65,7 +68,7 @@ public class SpigotCore extends BukkitCore<WrappedServerPing.CompressedImage>{
             }catch(ClassNotFoundException ignored){}
         }
         
-        this.core = AdvancedServerList.init(this, BukkitPlayerPlaceholders.init());
+        this.core = AdvancedServerList.init(this, BukkitPlayerPlaceholders.init(), BukkitServerPlaceholders.init());
     }
     
     @Override
@@ -75,6 +78,9 @@ public class SpigotCore extends BukkitCore<WrappedServerPing.CompressedImage>{
             papiPlaceholders = null;
         }
         
+        if(worldCache != null)
+            worldCache = null;
+        
         getCore().disable();
     }
     
@@ -90,7 +96,7 @@ public class SpigotCore extends BukkitCore<WrappedServerPing.CompressedImage>{
     
     @Override
     public void loadEvents(){
-        new LoadEvent(this);
+        LoadEvent.init(this);
     }
     
     @Override
@@ -146,6 +152,14 @@ public class SpigotCore extends BukkitCore<WrappedServerPing.CompressedImage>{
         return "spigot";
     }
     
+    @Override
+    public WorldCache getWorldCache(){
+        if(worldCache != null)
+            return worldCache;
+        
+        return (worldCache = new WorldCache());
+    }
+    
     public void setPapiPlaceholders(PAPIPlaceholders<WrappedServerPing.CompressedImage> papiPlaceholders){
         this.papiPlaceholders = papiPlaceholders;
     }

bukkit/src/main/java/ch/andre601/advancedserverlist/spigot/listeners/ProtocolLibEventWrapper.java

@@ -23,34 +23,35 @@
  *
  */
 
-package ch.andre601.advancedserverlist.spigot.events;
+package ch.andre601.advancedserverlist.spigot.listeners;
 
 import ch.andre601.advancedserverlist.api.events.GenericServerListEvent;
 import ch.andre601.advancedserverlist.api.objects.GenericServer;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 import ch.andre601.advancedserverlist.bukkit.BukkitCore;
-import ch.andre601.advancedserverlist.bukkit.events.PreServerListSetEventImpl;
+import ch.andre601.advancedserverlist.bukkit.listeners.PreServerListSetEventImpl;
+import ch.andre601.advancedserverlist.bukkit.objects.impl.BukkitServerImpl;
+import ch.andre601.advancedserverlist.core.events.PingEventHandler;
 import ch.andre601.advancedserverlist.core.interfaces.events.GenericEventWrapper;
 import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
 import ch.andre601.advancedserverlist.core.parsing.ComponentParser;
 import ch.andre601.advancedserverlist.core.profiles.replacer.StringReplacer;
 import ch.andre601.advancedserverlist.spigot.SpigotCore;
-import ch.andre601.advancedserverlist.bukkit.objects.SpigotPlayerImpl;
+import ch.andre601.advancedserverlist.bukkit.objects.impl.BukkitPlayerImpl;
 import com.comphenix.protocol.events.PacketEvent;
-import com.comphenix.protocol.wrappers.AdventureComponentConverter;
+import com.comphenix.protocol.wrappers.WrappedChatComponent;
 import com.comphenix.protocol.wrappers.WrappedGameProfile;
 import com.comphenix.protocol.wrappers.WrappedServerPing;
 import me.clip.placeholderapi.PlaceholderAPI;
 import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.serializer.gson.GsonComponentSerializer;
 import org.bukkit.Bukkit;
 import org.bukkit.OfflinePlayer;
 
 import java.awt.image.BufferedImage;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
+import java.util.*;
 
-public class ProtocolLibEventWrapper implements GenericEventWrapper<WrappedServerPing.CompressedImage, SpigotPlayerImpl>{
+public class ProtocolLibEventWrapper implements GenericEventWrapper<WrappedServerPing.CompressedImage, BukkitPlayerImpl>{
     
     private final SpigotCore plugin;
     private final PacketEvent event;
@@ -77,7 +78,7 @@ public class ProtocolLibEventWrapper implements GenericEventWrapper<WrappedServe
     
     @Override
     public void setMotd(Component component){
-        ping.setMotD(AdventureComponentConverter.fromComponent(component));
+        ping.setMotD(WrappedChatComponent.fromJson(GsonComponentSerializer.gson().serialize(component)));
     }
     
     @Override
@@ -92,7 +93,7 @@ public class ProtocolLibEventWrapper implements GenericEventWrapper<WrappedServe
     }
     
     @Override
-    public void setPlayers(List<String> lines, SpigotPlayerImpl player, GenericServer server){
+    public void setPlayers(List<String> lines, BukkitPlayerImpl player, GenericServer server){
         List<WrappedGameProfile> players = new ArrayList<>(lines.size());
         
         for(String line : lines){
@@ -133,6 +134,14 @@ public class ProtocolLibEventWrapper implements GenericEventWrapper<WrappedServe
         return event.getPlayer().getAddress() == null;
     }
     
+    @Override
+    public boolean isMaintenanceModeActive(){
+        if(!Bukkit.getPluginManager().isPluginEnabled("Maintenance"))
+            return false;
+        
+        return PingEventHandler.getMaintenanceUtil().isMaintenanceEnabled();
+    }
+    
     @Override
     public int getProtocolVersion(){
         return ping.getVersionProtocol();
@@ -154,7 +163,7 @@ public class ProtocolLibEventWrapper implements GenericEventWrapper<WrappedServe
     }
     
     @Override
-    public String parsePAPIPlaceholders(String text, SpigotPlayerImpl player){
+    public String parsePAPIPlaceholders(String text, BukkitPlayerImpl player){
         if(plugin.getServer().getPluginManager().isPluginEnabled("PlaceholderAPI"))
             return PlaceholderAPI.setPlaceholders(player.getPlayer(), text);
         
@@ -176,10 +185,15 @@ public class ProtocolLibEventWrapper implements GenericEventWrapper<WrappedServe
     }
     
     @Override
-    public SpigotPlayerImpl createPlayer(CachedPlayer player, int protocol){
+    public BukkitPlayerImpl createPlayer(CachedPlayer player, int protocol){
         OfflinePlayer pl = Bukkit.getOfflinePlayer(player.getUuid());
         
-        return new SpigotPlayerImpl(pl.hasPlayedBefore() ? pl : null, player, protocol);
+        return new BukkitPlayerImpl(pl.hasPlayedBefore() ? pl : null, player, protocol);
+    }
+    
+    @Override
+    public GenericServer createGenericServer(int playersOnline, int playersMax, String host){
+        return new BukkitServerImpl(plugin.getWorldCache().worlds(), playersOnline, playersMax, host);
     }
     
     @Override

bukkit/src/main/java/ch/andre601/advancedserverlist/spigot/listeners/ProtocolLibEvents.java

@@ -23,7 +23,7 @@
  *
  */
 
-package ch.andre601.advancedserverlist.spigot.events;
+package ch.andre601.advancedserverlist.spigot.listeners;
 
 import ch.andre601.advancedserverlist.core.events.PingEventHandler;
 import ch.andre601.advancedserverlist.spigot.SpigotCore;
@@ -36,14 +36,14 @@ import org.bukkit.Bukkit;
 import org.bukkit.event.Listener;
 
 import java.net.InetSocketAddress;
-import java.util.HashMap;
 import java.util.Map;
+import java.util.TreeMap;
 
 public class ProtocolLibEvents implements Listener{
     
     private final ProtocolManager protocolManager;
     
-    private static final Map<String, String> hostAddresses = new HashMap<>();
+    private static final Map<String, String> hostAddresses = new TreeMap<>(String.CASE_INSENSITIVE_ORDER);
     
     private ProtocolLibEvents(SpigotCore plugin, ProtocolManager protocolManager){
         this.protocolManager = protocolManager;

bukkit/src/main/resources/paper-plugin.yml

@@ -6,21 +6,19 @@ description: '${plugin.description}'
 main: 'ch.andre601.advancedserverlist.paper.PaperCore'
 loader: 'ch.andre601.advancedserverlist.paper.ASLLoader'
 
-api-version: 1.19
+api-version: '1.19'
 
 dependencies:
-  - name: PlaceholderAPI
-    required: false
-    bootstrap: false
-  - name: ViaVersion
-    required: false
-    bootstrap: false
-
-load-after:
-  - name: PlaceholderAPI
-    bootstrap: false
-  - name: ViaVersion
-    bootstrap: false
+  server:
+    PlaceholderAPI:
+      load: BEFORE
+      required: false
+    ViaVersion:
+      load: BEFORE
+      required: false
+    Maintenance:
+      load: BEFORE
+      required: false
 
 # The below stuff is NOT used by Paper plugin.
 commands:

bukkit/src/main/resources/plugin.yml

@@ -20,6 +20,7 @@ libraries:
 softdepend:
   - 'ProtocolLib'
   - 'PlaceholderAPI'
+  - 'Maintenance'
 
 commands:
   advancedserverlist:

bungeecord/pom.xml

@@ -117,7 +117,7 @@
     </dependencies>
 
     <build>
-        <finalName>AdvancedServerList-BungeeCord-${plugin.version}${project.build.commit}</finalName>
+        <finalName>AdvancedServerList-BungeeCord-${plugin.version}</finalName>
         <resources>
             <resource>
                 <filtering>true</filtering>
@@ -133,7 +133,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.4.1</version>
+                <version>3.5.0</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <relocations>

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

@@ -26,10 +26,11 @@
 package ch.andre601.advancedserverlist.bungeecord;
 
 import ch.andre601.advancedserverlist.bungeecord.commands.CmdAdvancedServerList;
-import ch.andre601.advancedserverlist.bungeecord.events.JoinEvent;
-import ch.andre601.advancedserverlist.bungeecord.events.PingEvent;
+import ch.andre601.advancedserverlist.bungeecord.listeners.JoinEvent;
+import ch.andre601.advancedserverlist.bungeecord.listeners.PingEvent;
 import ch.andre601.advancedserverlist.bungeecord.logging.BungeeLogger;
 import ch.andre601.advancedserverlist.bungeecord.objects.BungeePlayerPlaceholders;
+import ch.andre601.advancedserverlist.bungeecord.objects.BungeeServerPlaceholders;
 import ch.andre601.advancedserverlist.core.AdvancedServerList;
 import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
 import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
@@ -49,7 +50,7 @@ public class BungeeCordCore extends Plugin implements PluginCore<Favicon>{
     
     @Override
     public void onEnable(){
-        this.core = AdvancedServerList.init(this, BungeePlayerPlaceholders.init());
+        this.core = AdvancedServerList.init(this, BungeePlayerPlaceholders.init(), BungeeServerPlaceholders.init());
     }
     
     @Override

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

@@ -23,13 +23,15 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bungeecord.events;
+package ch.andre601.advancedserverlist.bungeecord.listeners;
 
 import ch.andre601.advancedserverlist.api.objects.GenericServer;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 import ch.andre601.advancedserverlist.bungeecord.BungeeCordCore;
 import ch.andre601.advancedserverlist.bungeecord.objects.BungeePlayerImpl;
 import ch.andre601.advancedserverlist.api.events.GenericServerListEvent;
+import ch.andre601.advancedserverlist.bungeecord.objects.BungeeProxyImpl;
+import ch.andre601.advancedserverlist.core.events.PingEventHandler;
 import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
 import ch.andre601.advancedserverlist.core.interfaces.events.GenericEventWrapper;
 import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
@@ -40,11 +42,14 @@ import net.kyori.adventure.text.serializer.bungeecord.BungeeComponentSerializer;
 import net.md_5.bungee.api.Favicon;
 import net.md_5.bungee.api.ServerPing;
 import net.md_5.bungee.api.chat.TextComponent;
+import net.md_5.bungee.api.config.ServerInfo;
+import net.md_5.bungee.api.connection.ProxiedPlayer;
 import net.md_5.bungee.api.event.ProxyPingEvent;
 
 import java.awt.image.BufferedImage;
 import java.net.InetSocketAddress;
 import java.util.List;
+import java.util.Map;
 import java.util.UUID;
 
 public class BungeeEventWrapper implements GenericEventWrapper<Favicon, BungeePlayerImpl>{
@@ -128,6 +133,14 @@ public class BungeeEventWrapper implements GenericEventWrapper<Favicon, BungeePl
         return protocol == null;
     }
     
+    @Override
+    public boolean isMaintenanceModeActive(){
+        if(plugin.getProxy().getPluginManager().getPlugin("Maintenance") == null)
+            return false;
+        
+        return PingEventHandler.getMaintenanceUtil().isMaintenanceEnabled();
+    }
+    
     @Override
     public int getProtocolVersion(){
         return this.protocol.getProtocol();
@@ -150,7 +163,25 @@ public class BungeeEventWrapper implements GenericEventWrapper<Favicon, BungeePl
     
     @Override
     public String parsePAPIPlaceholders(String text, BungeePlayerImpl player){
-        return text;
+        if(plugin.getProxy().getPluginManager().getPlugin("PAPIProxyBridge") == null)
+            return text;
+        
+        if(!PingEventHandler.getPAPIUtil().isCompatible())
+            return text;
+        
+        String server = PingEventHandler.getPAPIUtil().getServer();
+        if(server == null || server.isEmpty())
+            return text;
+        
+        ServerInfo serverInfo = plugin.getProxy().getServerInfo(server);
+        if(serverInfo == null || serverInfo.getPlayers().isEmpty())
+            return text;
+        
+        ProxiedPlayer carrier = PingEventHandler.getPAPIUtil().getPlayer(serverInfo.getPlayers());
+        if(carrier == null)
+            return text;
+        
+        return PingEventHandler.getPAPIUtil().parse(text, carrier.getUniqueId(), player.getUUID());
     }
     
     @Override
@@ -168,6 +199,13 @@ public class BungeeEventWrapper implements GenericEventWrapper<Favicon, BungeePl
         return new BungeePlayerImpl(player, protocol);
     }
     
+    @Override
+    public GenericServer createGenericServer(int playersOnline, int playersMax, String host){
+        Map<String, ServerInfo> servers = plugin.getProxy().getServers();
+        
+        return new BungeeProxyImpl(servers, playersOnline, playersMax, host);
+    }
+    
     @Override
     public Favicon createFavicon(BufferedImage image) throws IllegalArgumentException{
         return Favicon.create(image);

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

@@ -23,7 +23,7 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bungeecord.events;
+package ch.andre601.advancedserverlist.bungeecord.listeners;
 
 import ch.andre601.advancedserverlist.bungeecord.BungeeCordCore;
 import net.md_5.bungee.api.connection.ProxiedPlayer;

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

@@ -23,7 +23,7 @@
  *
  */
 
-package ch.andre601.advancedserverlist.bungeecord.events;
+package ch.andre601.advancedserverlist.bungeecord.listeners;
 
 import ch.andre601.advancedserverlist.bungeecord.BungeeCordCore;
 import ch.andre601.advancedserverlist.core.events.PingEventHandler;

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

@@ -23,11 +23,13 @@
  *
  */
 
-package ch.andre601.advancedserverlist.velocity.events;
+package ch.andre601.advancedserverlist.bungeecord.listeners;
 
+import ch.andre601.advancedserverlist.api.bungeecord.events.PreServerListSetEvent;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 
 public class PreServerListSetEventImpl extends PreServerListSetEvent{
+    
     public PreServerListSetEventImpl(ProfileEntry entry){
         super(entry);
     }

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/objects/BungeeProxyImpl.java

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

bungeecord/src/main/java/ch/andre601/advancedserverlist/bungeecord/objects/BungeeServerPlaceholders.java

@@ -0,0 +1,93 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2023 Andre_601
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+
+package ch.andre601.advancedserverlist.bungeecord.objects;
+
+import ch.andre601.advancedserverlist.api.PlaceholderProvider;
+import ch.andre601.advancedserverlist.api.bungeecord.objects.BungeeProxy;
+import ch.andre601.advancedserverlist.api.objects.GenericPlayer;
+import ch.andre601.advancedserverlist.api.objects.GenericServer;
+import net.md_5.bungee.api.config.ServerInfo;
+
+import java.net.InetSocketAddress;
+
+public class BungeeServerPlaceholders extends PlaceholderProvider{
+    
+    private BungeeServerPlaceholders(){
+        super("server");
+    }
+    
+    public static BungeeServerPlaceholders init(){
+        return new BungeeServerPlaceholders();
+    }
+    
+    @Override
+    public String parsePlaceholder(String placeholder, GenericPlayer player, GenericServer server){
+        if(!(server instanceof BungeeProxy proxy))
+            return null;
+        
+        String[] args = placeholder.split("\\s", 2);
+        
+        return switch(args[0]){
+            case "playersOnline" -> {
+                if(args.length >= 2){
+                    int players = 0;
+                    
+                    for(int i = 1; i < args.length; i++){
+                        ServerInfo info = proxy.getServers().get(args[i]);
+                        if(info == null)
+                            continue;
+                        
+                        players += info.getPlayers().size();
+                    }
+                    
+                    yield String.valueOf(players);
+                }
+                
+                yield String.valueOf(proxy.getPlayersOnline());
+            }
+            case "playersMax" -> {
+                // ServerInfo doesn't provide the max players that could join, so we won't allow an extra argument
+                if(args.length >= 2)
+                    yield null;
+                
+                yield String.valueOf(proxy.getPlayersMax());
+            }
+            case "host" -> {
+                if(args.length > 2)
+                    yield null;
+                
+                if(args.length == 2){
+                    ServerInfo info = proxy.getServers().get(args[1]);
+                    
+                    yield String.valueOf(((InetSocketAddress)info.getSocketAddress()).getHostString());
+                }
+                
+                yield proxy.getHost();
+            }
+            default -> null;
+        };
+    }
+}

bungeecord/src/main/resources/bungee.yml

@@ -3,4 +3,8 @@ author: 'Andre_601'
 version: '${plugin.version}'
 description: '${plugin.description}'
 
+softDepends:
+  - PAPIProxyBridge
+  - Maintenance
+
 main: 'ch.andre601.advancedserverlist.bungeecord.BungeeCordCore'

core/pom.xml

@@ -48,6 +48,14 @@
             <id>flexver-repo</id>
             <url>https://repo.sleeping.town/</url>
         </repository>
+        <repository>
+            <id>papiproxybridge-repo</id>
+            <url>https://repo.william278.net/releases/</url>
+        </repository>
+        <repository>
+            <id>sonatype</id>
+            <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
+        </repository>
     </repositories>
     
     <dependencies>
@@ -66,19 +74,19 @@
         <dependency>
             <groupId>net.kyori</groupId>
             <artifactId>adventure-api</artifactId>
-            <version>4.13.1</version>
+            <version>4.14.0</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>net.kyori</groupId>
             <artifactId>adventure-text-minimessage</artifactId>
-            <version>4.13.1</version>
+            <version>4.14.0</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>net.kyori</groupId>
             <artifactId>adventure-text-serializer-legacy</artifactId>
-            <version>4.13.1</version>
+            <version>4.14.0</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -96,13 +104,25 @@
         <dependency>
             <groupId>com.unascribed</groupId>
             <artifactId>flexver-java</artifactId>
-            <version>1.1.0</version>
+            <version>1.1.1</version>
             <scope>compile</scope>
         </dependency>
         <dependency>
             <groupId>com.google.guava</groupId>
             <artifactId>guava</artifactId>
-            <version>31.1-jre</version>
+            <version>32.1.2-jre</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>net.william278</groupId>
+            <artifactId>papiproxybridge</artifactId>
+            <version>1.3</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>eu.kennytv.maintenance</groupId>
+            <artifactId>maintenance-api</artifactId>
+            <version>4.2.0-SNAPSHOT</version>
             <scope>provided</scope>
         </dependency>
         
@@ -116,7 +136,7 @@
     </dependencies>
 
     <build>
-        <finalName>AdvancedServerList-Core-${plugin.version}${project.build.commit}</finalName>
+        <finalName>AdvancedServerList-Core-${plugin.version}</finalName>
         <resources>
             <resource>
                 <filtering>true</filtering>
@@ -132,7 +152,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.4.1</version>
+                <version>3.5.0</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <filters>

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

@@ -37,6 +37,8 @@ import ch.andre601.advancedserverlist.core.profiles.players.PlayerHandler;
 import java.io.IOException;
 import java.io.InputStream;
 import java.nio.file.Path;
+import java.util.Arrays;
+import java.util.List;
 import java.util.Properties;
 
 public class AdvancedServerList<F>{
@@ -51,20 +53,19 @@ public class AdvancedServerList<F>{
     
     private String version;
     
-    private AdvancedServerList(PluginCore<F> plugin, PlaceholderProvider placeholders){
+    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.api.addPlaceholderProvider(placeholders);
-        this.api.addPlaceholderProvider(new ServerPlaceholders());
+        placeholders.forEach(this.api::addPlaceholderProvider);
         
         load();
     }
     
-    public static <F> AdvancedServerList<F> init(PluginCore<F> plugin, PlaceholderProvider placeholders){
-        return new AdvancedServerList<>(plugin, placeholders);
+    public static <F> AdvancedServerList<F> init(PluginCore<F> plugin, PlaceholderProvider... placeholders){
+        return new AdvancedServerList<>(plugin, Arrays.asList(placeholders));
     }
     
     public PluginCore<F> getPlugin(){
@@ -125,6 +126,16 @@ public class AdvancedServerList<F>{
             return;
         }
         
+        if(getFileHandler().isOldConfig()){
+            getPlugin().getPluginLogger().info("Detected old config.yml. Attempting to migrate...");
+            if(getFileHandler().migrateConfig()){
+                getPlugin().getPluginLogger().info("Migration completed successfully!");
+            }else{
+                getPlugin().getPluginLogger().warn("Couldn't migrate config.yml! Check previous lines for errors.");
+                return;
+            }
+        }
+        
         if(getFileHandler().loadProfiles()){
             getPlugin().getPluginLogger().info("Successfully loaded " + getFileHandler().getProfiles().size() + " profiles!");
         }else{
@@ -153,7 +164,7 @@ public class AdvancedServerList<F>{
     
         getPlugin().getPluginLogger().info("AdvancedServerList is ready!");
         
-        if(getFileHandler().getBoolean("check_updates"))
+        if(getFileHandler().getBoolean("checkUpdates"))
             this.updateChecker = new UpdateChecker(this);
     }
     

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

@@ -32,6 +32,8 @@ import java.util.concurrent.ThreadFactory;
 public class UpdateCheckThread implements ThreadFactory{
     @Override
     public Thread newThread(@NotNull Runnable r){
-        return new Thread(r, "AdvancedServerList Update-Thread");
+        Thread t = new Thread(r, "AdvancedServerList-UpdateThread");
+        t.setDaemon(true);
+        return t;
     }
 }

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

@@ -52,7 +52,7 @@ public class UpdateChecker{
     private final String url = "https://api.modrinth.com/v2/project/advancedserverlist/version?loaders=[\"%s\"]";
     private final OkHttpClient client = new OkHttpClient();
     
-    private final AdvancedServerList core;
+    private final AdvancedServerList<?> core;
     private final PluginLogger logger;
     private final String loader;
     
@@ -65,7 +65,7 @@ public class UpdateChecker{
     
     private final ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor(new UpdateCheckThread());
     
-    public UpdateChecker(AdvancedServerList core){
+    public UpdateChecker(AdvancedServerList<?> core){
         this.core = core;
         this.logger = core.getPlugin().getPluginLogger();
         this.loader = core.getPlugin().getLoader();

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

@@ -36,7 +36,7 @@ public class CommandHandler{
     
     private final List<PluginCommand> subCommands = new ArrayList<>();
     
-    public CommandHandler(AdvancedServerList core){
+    public CommandHandler(AdvancedServerList<?> core){
         subCommands.add(new Help());
         subCommands.add(new Reload(core));
         subCommands.add(new ClearCache(core));
@@ -78,7 +78,7 @@ public class CommandHandler{
             sender.sendMsg();
             sender.sendMsg("<aqua>/asl <white>help <grey>- Shows this help");
             sender.sendMsg();
-            sender.sendMsg("<aqua>/asl <white>reload <grey>- Reloads the plugin and clears caches");
+            sender.sendMsg("<aqua>/asl <white>reload <grey>- Reloads the config.yml and profiles");
             sender.sendMsg();
             sender.sendMsg("<aqua>/asl <white>clearCache <grey>- Clears the Player and Favicon cache");
         }
@@ -86,9 +86,9 @@ public class CommandHandler{
     
     private static class Reload extends PluginCommand{
         
-        private final AdvancedServerList core;
+        private final AdvancedServerList<?> core;
         
-        public Reload(AdvancedServerList core){
+        public Reload(AdvancedServerList<?> core){
             super("reload");
             
             this.core = core;
@@ -110,21 +110,15 @@ public class CommandHandler{
                 sender.sendErrorMsg("<red>Error while loading profile(s)!");
             }
             
-            core.clearFaviconCache();
-            sender.sendPrefixedMsg("<green>Successfully cleared Favicon Cache!");
-            
-            core.clearPlayerCache();
-            sender.sendPrefixedMsg("<green>Successfully cleared Player Cache!");
-            
             sender.sendPrefixedMsg("<green>Reload complete!");
         }
     }
     
     private static class ClearCache extends PluginCommand{
         
-        private final AdvancedServerList core;
+        private final AdvancedServerList<?> core;
         
-        public ClearCache(AdvancedServerList core){
+        public ClearCache(AdvancedServerList<?> core){
             super("clearCache");
             
             this.core = core;

core/src/main/java/ch/andre601/advancedserverlist/core/compat/maintenance/MaintenanceUtil.java

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

core/src/main/java/ch/andre601/advancedserverlist/core/compat/papi/PAPICache.java

@@ -0,0 +1,49 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2023 Andre_601
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+
+package ch.andre601.advancedserverlist.core.compat.papi;
+
+import java.util.function.Supplier;
+
+public class PAPICache{
+    
+    private CacheValue cache = null;
+    
+    public PAPICache(){}
+    
+    public String get(Supplier<String> supplier){
+        if(cache == null || cache.isExpired())
+            cache = new CacheValue(supplier.get(), System.currentTimeMillis());
+        
+        return cache.server();
+    }
+    
+    private record CacheValue(String server, long timestamp){
+        // Consider the cache expired if it is older than 5 seconds.
+        public boolean isExpired(){
+            return (timestamp < 0L) || System.currentTimeMillis() - timestamp >= 5000L;
+        }
+    }
+}

core/src/main/java/ch/andre601/advancedserverlist/core/compat/papi/PAPIUtil.java

@@ -0,0 +1,87 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2023 Andre_601
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+
+package ch.andre601.advancedserverlist.core.compat.papi;
+
+import net.william278.papiproxybridge.api.PlaceholderAPI;
+
+import java.util.*;
+import java.util.concurrent.CancellationException;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionException;
+
+public class PAPIUtil{
+    
+    private final PlaceholderAPI papi;
+    
+    private final PAPICache cache = new PAPICache();
+    
+    public PAPIUtil(){
+        this.papi = PlaceholderAPI.createInstance();
+    }
+    
+    // Make sure the version of PAPIProxyBridge we get has the required methods we need...
+    @SuppressWarnings("BooleanMethodIsAlwaysInverted")
+    public boolean isCompatible(){
+        try{
+            papi.getClass().getMethod("findServers");
+            return true;
+        }catch(NoSuchMethodException ex){
+            return false;
+        }
+    }
+    
+    public String getServer(){
+        return cache.get(() -> {
+            List<String> servers;
+            try{
+                servers = papi.findServers().getNow(Collections.emptyList());
+            }catch(CancellationException | CompletionException ex){
+                return null;
+            }
+            
+            if(servers == null || servers.isEmpty())
+                return null;
+            
+            return servers.get(0);
+        });
+    }
+    
+    public <P> P getPlayer(Collection<P> players){
+        if(players.isEmpty())
+            return null;
+        
+        return List.copyOf(players).get(0);
+    }
+    
+    public String parse(String text, UUID carrier, UUID player){
+        try{
+            CompletableFuture<String> future = papi.formatPlaceholders(text, carrier, player);
+            return future.getNow(text);
+        }catch(IllegalArgumentException | CancellationException | CompletionException ex){
+            return text;
+        }
+    }
+}

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

@@ -29,9 +29,10 @@ import ch.andre601.advancedserverlist.api.events.GenericServerListEvent;
 import ch.andre601.advancedserverlist.api.objects.GenericPlayer;
 import ch.andre601.advancedserverlist.api.objects.GenericServer;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
+import ch.andre601.advancedserverlist.core.compat.maintenance.MaintenanceUtil;
 import ch.andre601.advancedserverlist.core.interfaces.core.PluginCore;
 import ch.andre601.advancedserverlist.core.interfaces.events.GenericEventWrapper;
-import ch.andre601.advancedserverlist.core.objects.GenericServerImpl;
+import ch.andre601.advancedserverlist.core.compat.papi.PAPIUtil;
 import ch.andre601.advancedserverlist.core.parsing.ComponentParser;
 import ch.andre601.advancedserverlist.core.profiles.ServerListProfile;
 import ch.andre601.advancedserverlist.core.profiles.profile.ProfileManager;
@@ -39,8 +40,11 @@ import ch.andre601.advancedserverlist.core.profiles.replacer.StringReplacer;
 
 public class PingEventHandler{
     
+    private static PAPIUtil papiUtil = null;
+    private static MaintenanceUtil maintenanceUtil = null;
+    
     public static <F, P extends GenericPlayer> void handleEvent(GenericEventWrapper<F, P> event){
-        if(event.isInvalidProtocol())
+        if(event.isInvalidProtocol() || event.isMaintenanceModeActive())
             return;
         
         PluginCore<F> plugin = event.getPlugin();
@@ -53,7 +57,7 @@ public class PingEventHandler{
             plugin.getCore().getPlayerHandler().getCachedPlayer(event.getPlayerIP()),
             event.getProtocolVersion()
         );
-        GenericServer server = new GenericServerImpl(online, max, host);
+        GenericServer server = event.createGenericServer(online, max, host);
         
         ServerListProfile profile = ProfileManager.resolveProfile(plugin.getCore(), player, server);
         
@@ -73,7 +77,7 @@ public class PingEventHandler{
             event.setMaxPlayers(max);
         }
         
-        GenericServer finalServer = new GenericServerImpl(online, max, host);
+        GenericServer finalServer = event.createGenericServer(online, max, host);
         
         if(ProfileManager.checkOption(entry.motd())){
             event.setMotd(
@@ -124,4 +128,18 @@ public class PingEventHandler{
         
         event.updateEvent();
     }
+    
+    public static PAPIUtil getPAPIUtil(){
+        if(papiUtil != null)
+            return papiUtil;
+        
+        return (papiUtil = new PAPIUtil());
+    }
+    
+    public static MaintenanceUtil getMaintenanceUtil(){
+        if(maintenanceUtil != null)
+            return maintenanceUtil;
+        
+        return (maintenanceUtil = new MaintenanceUtil());
+    }
 }

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

@@ -0,0 +1,75 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2022-2023 Andre_601
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+
+package ch.andre601.advancedserverlist.core.file;
+
+import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
+import org.spongepowered.configurate.ConfigurateException;
+import org.spongepowered.configurate.ConfigurationNode;
+import org.spongepowered.configurate.NodePath;
+import org.spongepowered.configurate.transformation.ConfigurationTransformation;
+import org.spongepowered.configurate.transformation.TransformAction;
+
+public class ConfigMigrator{
+    
+    public static final int LATEST = 1;
+    
+    private ConfigMigrator(){}
+    
+    public static ConfigurationTransformation.Versioned create(){
+        return ConfigurationTransformation.versionedBuilder()
+            .versionKey("configVersion")
+            .addVersion(LATEST, oneToTwo())
+            .build();
+    }
+    
+    public static ConfigurationTransformation oneToTwo(){
+        return ConfigurationTransformation.builder()
+            .addAction(NodePath.path("unknown_player"), (path, value) -> new Object[]{"unknownPlayer", "name"})
+            .addAction(NodePath.path("unknown_player_uuid"), (path, value) -> new Object[]{"unknownPlayer", "uuid"})
+            .addAction(NodePath.path("disable_cache"), TransformAction.rename("disableCache"))
+            .addAction(NodePath.path("check_updates"), TransformAction.rename("checkUpdates"))
+            .addAction(NodePath.path("send_statistics"), TransformAction.rename("sendStatistics"))
+            .addAction(NodePath.path(), (path, value) -> {
+                value.node("configVersion").set(LATEST);
+                
+                return null;
+            })
+            .build();
+    }
+    
+    public static <N extends ConfigurationNode> N updateNode(final N node, PluginLogger logger) throws ConfigurateException{
+        if(!node.virtual()){
+            final ConfigurationTransformation.Versioned versioned = create();
+            final int startVersion = versioned.version(node);
+            versioned.apply(node);
+            final int endVersion = versioned.version(node);
+            if(startVersion < endVersion)
+                logger.info("Migrated config.yml from " + startVersion + " to " + endVersion);
+        }
+        
+        return node;
+    }
+}

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

@@ -30,7 +30,9 @@ import ch.andre601.advancedserverlist.core.interfaces.PluginLogger;
 import ch.andre601.advancedserverlist.core.profiles.ServerListProfile;
 import ch.andre601.advancedserverlist.api.profiles.ProfileEntry;
 import ch.andre601.advancedserverlist.core.profiles.profile.ProfileSerializer;
+import org.spongepowered.configurate.ConfigurateException;
 import org.spongepowered.configurate.ConfigurationNode;
+import org.spongepowered.configurate.yaml.NodeStyle;
 import org.spongepowered.configurate.yaml.YamlConfigurationLoader;
 
 import java.io.File;
@@ -38,13 +40,16 @@ import java.io.IOException;
 import java.io.InputStream;
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.nio.file.StandardCopyOption;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
 import java.util.ArrayList;
 import java.util.Comparator;
 import java.util.List;
 
 public class FileHandler{
     
-    private final AdvancedServerList plugin;
+    private final AdvancedServerList<?> plugin;
     private final PluginLogger logger;
     
     private final Path config;
@@ -54,7 +59,7 @@ public class FileHandler{
     
     private ConfigurationNode node = null;
     
-    public FileHandler(AdvancedServerList core){
+    public FileHandler(AdvancedServerList<?> core){
         this.plugin = core;
         this.logger = core.getPlugin().getPluginLogger();
         
@@ -68,7 +73,7 @@ public class FileHandler{
     
     public boolean loadConfig(){
         logger.info("Loading config.yml...");
-        File folder = config.toFile().getParentFile();
+        File folder = plugin.getPlugin().getFolderPath().toFile();
         if(!folder.exists() && !folder.mkdirs()){
             logger.warn("Couldn't create folder for plugin. Is it missing Write permissions?");
             return false;
@@ -82,6 +87,7 @@ public class FileHandler{
                 }
                 
                 Files.copy(stream, config);
+                logger.info("Created new config.yml!");
             }catch(IOException ex){
                 logger.warn("Cannot create config.yml for plugin.", ex);
                 return false;
@@ -112,6 +118,26 @@ public class FileHandler{
         return reloadProfiles();
     }
     
+    public boolean migrateConfig(){
+        YamlConfigurationLoader loader = YamlConfigurationLoader.builder()
+            .path(config)
+            .nodeStyle(NodeStyle.BLOCK)
+            .build();
+        
+        if(!makeBackup())
+            return false;
+        
+        try{
+            node = ConfigMigrator.updateNode(loader.load(), logger);
+            loader.save(node);
+            
+            return true;
+        }catch(ConfigurateException ex){
+            logger.warn("Error while trying to migrate config.yml.", ex);
+            return false;
+        }
+    }
+    
     public boolean reloadConfig(){
         return (node = getConfigurationNode(config)) != null;
     }
@@ -164,4 +190,36 @@ public class FileHandler{
     public boolean getBoolean(Object... path){
         return node.node(path).getBoolean();
     }
+    
+    public boolean isOldConfig(){
+        return node.node("configVersion").virtual() || node.node("configVersion").getInt(0) < ConfigMigrator.LATEST;
+    }
+    
+    private boolean makeBackup(){
+        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!");
+            return false;
+        }
+        
+        String date = DateTimeFormatter.ISO_LOCAL_DATE_TIME.format(LocalDateTime.now());
+        
+        File configBackup = new File(backups, "config_" + date.replace(":", "_") + ".yml");
+        try{
+            if(!configBackup.exists() && !configBackup.createNewFile()){
+                logger.warn("Cannot create backup file for config.yml!");
+                return false;
+            }
+            
+            Files.copy(config, configBackup.toPath(), StandardCopyOption.REPLACE_EXISTING);
+            logger.info("Saved backup as '" + configBackup.getName() + "'!");
+            
+            return true;
+        }catch(IOException ex){
+            logger.warn("Encountered IOException while trying to create a backup.", ex);
+            return false;
+        }
+    }
 }

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

@@ -41,7 +41,7 @@ public interface PluginCore<F>{
     
     void clearFaviconCache();
     
-    AdvancedServerList getCore();
+    AdvancedServerList<F> getCore();
     
     Path getFolderPath();
     

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

@@ -59,6 +59,8 @@ public interface GenericEventWrapper<F, P extends GenericPlayer>{
     
     boolean isInvalidProtocol();
     
+    boolean isMaintenanceModeActive();
+    
     int getProtocolVersion();
     
     int getOnlinePlayers();
@@ -75,6 +77,8 @@ public interface GenericEventWrapper<F, P extends GenericPlayer>{
     
     P createPlayer(CachedPlayer player, int protocol);
     
+    GenericServer createGenericServer(int playersOnline, int playersMax, String host);
+    
     F createFavicon(BufferedImage image) throws Exception;
     
     default String resolveHost(InetSocketAddress address){

core/src/main/java/ch/andre601/advancedserverlist/core/profiles/conditions/Expression.java

@@ -127,12 +127,24 @@ public class Expression{
                 return left.equals(right);
             }
         },
+        EQUALS_IGNORE_CASE('~', '='){
+            @Override
+            public boolean evaluate(String left, String right){
+                return left.equalsIgnoreCase(right);
+            }
+        },
         NOT_EQUAL('!', '='){
             @Override
             public boolean evaluate(String left, String right){
                 return !left.equals(right);
             }
         },
+        NOT_EQUAL_IGNORE_CASE('!', '~'){
+            @Override
+            public boolean evaluate(String left, String right){
+                return !left.equalsIgnoreCase(right);
+            }
+        },
         GREATER('>', '\0'){
             @Override
             public boolean evaluate(String left, String right){
@@ -172,7 +184,7 @@ public class Expression{
         public static Operator getOperand(char first, char second){
             for(Operator operator : VALUES){
                 if(operator.first == first){
-                    if((!operator.hasSecond() && second != '=') || operator.second == second)
+                    if((!operator.hasSecond() && second != '=' && second != '~') || operator.second == second)
                         return operator;
                 }
             }

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

@@ -39,32 +39,27 @@ import java.io.InputStream;
 import java.net.URL;
 import java.net.URLConnection;
 import java.util.Locale;
-import java.util.concurrent.ExecutionException;
-import java.util.concurrent.TimeUnit;
+import java.util.concurrent.*;
 import java.util.function.Function;
 
 public class FaviconHandler<F>{
     
-    private final Cache<String, F> favicons = CacheBuilder.newBuilder()
+    private final Cache<String, CompletableFuture<F>> favicons = CacheBuilder.newBuilder()
         .expireAfterWrite(5, TimeUnit.MINUTES)
         .build();
     
-    private final AdvancedServerList core;
+    private final AdvancedServerList<F> core;
+    private final ThreadPoolExecutor faviconThreadPool;
     
-    public FaviconHandler(AdvancedServerList core){
+    public FaviconHandler(AdvancedServerList<F> core){
         this.core = core;
+        this.faviconThreadPool = createFaviconThreadPool();
     }
     
     public F getFavicon(String input, Function<BufferedImage, F> function){
         try{
-            return favicons.get(input, () -> {
-                BufferedImage image = resolveImage(core, input);
-                if(image == null)
-                    return null;
-                
-                return function.apply(image);
-            });
-        }catch(ExecutionException ignored){
+            return favicons.get(input, () -> convert(input, function)).getNow(null);
+        }catch(ExecutionException e){
             return null;
         }
     }
@@ -73,7 +68,17 @@ public class FaviconHandler<F>{
         favicons.invalidateAll();
     }
     
-    private BufferedImage resolveImage(AdvancedServerList core, String input){
+    private CompletableFuture<F> convert(String input, Function<BufferedImage, F> function){
+        return CompletableFuture.supplyAsync(() -> {
+            BufferedImage img = resolveImage(core, input);
+            if(img == null)
+                return null;
+            
+            return function.apply(img);
+        }, faviconThreadPool);
+    }
+    
+    private BufferedImage resolveImage(AdvancedServerList<F> core, String input){
         InputStream stream;
         
         if(input.toLowerCase(Locale.ROOT).startsWith("https://")){
@@ -126,7 +131,7 @@ public class FaviconHandler<F>{
         }
     }
     
-    private InputStream getFromUrl(AdvancedServerList core, String url){
+    private InputStream getFromUrl(AdvancedServerList<F> core, String url){
         try{
             URL faviconUrl = new URL(url);
             URLConnection connection = faviconUrl.openConnection();
@@ -140,4 +145,12 @@ public class FaviconHandler<F>{
             return null;
         }
     }
+    
+    private ThreadPoolExecutor createFaviconThreadPool(){
+        return new ThreadPoolExecutor(3, 3, 60L, TimeUnit.SECONDS, new LinkedBlockingDeque<>(1024), r -> {
+            Thread t = new Thread(r, "AdvancedServerList-FaviconThread");
+            t.setDaemon(true);
+            return t;
+        });
+    }
 }

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

@@ -31,33 +31,31 @@ import ch.andre601.advancedserverlist.core.objects.CachedPlayer;
 import com.google.gson.Gson;
 import io.leangen.geantyref.TypeToken;
 
+import java.io.BufferedReader;
 import java.io.BufferedWriter;
 import java.io.IOException;
-import java.io.Reader;
 import java.lang.reflect.Type;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.UUID;
+import java.util.*;
 
 public class PlayerHandler{
     
-    private final AdvancedServerList core;
+    private final AdvancedServerList<?> core;
     private final PluginLogger logger;
     private final Path cache;
-    private List<CachedPlayer> cachedPlayers = new ArrayList<>();
     
     private final Type listType = new TypeToken<ArrayList<CachedPlayer>>(){}.getType();
     private final Gson gson = new Gson();
     
     // UUID of MHF_Question
-    private final String defaultUUID = "606e2ff0-ed77-4842-9d6c-e1d3321c7838";
+    private final UUID defaultUUID = UUID.fromString("606e2ff0-ed77-4842-9d6c-e1d3321c7838");
     
+    private List<CachedPlayer> cachedPlayers = new ArrayList<>();
     private CachedPlayer defaultPlayer = null;
     
-    public PlayerHandler(AdvancedServerList core){
+    public PlayerHandler(AdvancedServerList<?> core){
         this.core = core;
         this.logger = core.getPlugin().getPluginLogger();
         this.cache = core.getPlugin().getFolderPath().resolve("playercache.json");
@@ -69,13 +67,13 @@ public class PlayerHandler{
             return;
         }
         
-        if(core.getFileHandler().getBoolean("disable_cache")){
+        if(core.getFileHandler().getBoolean("disableCache")){
             logger.info("'disable_cache' is set to true. Skipping playercache.json loading...");
             return;
         }
     
         try{
-            Reader reader = Files.newBufferedReader(cache);
+            BufferedReader reader = Files.newBufferedReader(cache);
             
             cachedPlayers = gson.fromJson(reader, listType);
             
@@ -85,6 +83,14 @@ public class PlayerHandler{
             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?");
+            // Create new ArrayList instance to avoid further issues.
+            cachedPlayers = new ArrayList<>();
+            return;
+        }
+        
         logger.info("Loaded %d players into cache!", cachedPlayers.size());
     }
     
@@ -94,7 +100,7 @@ public class PlayerHandler{
             return;
         }
         
-        if(core.getFileHandler().getBoolean("disable_cache")){
+        if(core.getFileHandler().getBoolean("disableCache")){
             logger.info("'disable_cache' is set to true. Skipping saving of cached players...");
             return;
         }
@@ -110,14 +116,14 @@ public class PlayerHandler{
     }
     
     public void addPlayer(String ip, String name, UUID uuid){
-        if(contains(ip) || core.getFileHandler().getBoolean("disable_cache"))
+        if(contains(ip) || core.getFileHandler().getBoolean("disableCache"))
             return;
         
         cachedPlayers.add(new CachedPlayer(ip, name, uuid));
     }
     
     public CachedPlayer getCachedPlayer(String key){
-        if(!contains(key) || core.getFileHandler().getBoolean("disable_cache"))
+        if(!contains(key) || core.getFileHandler().getBoolean("disableCache"))
             return getDefaultPlayer();
         
         for(CachedPlayer player : cachedPlayers){
@@ -157,8 +163,8 @@ public class PlayerHandler{
         
         return (defaultPlayer = new CachedPlayer(
             "0.0.0.0",
-            core.getFileHandler().getString("Anonymous", "unknown_player"),
-            convertToUUID(core.getFileHandler().getString(defaultUUID, "unknown_player_uuid"))
+            core.getFileHandler().getString("Anonymous", "unknownPlayer", "name"),
+            convertToUUID(core.getFileHandler().getString(defaultUUID.toString(), "unknownPlayer", "uuid"))
         ));
     }
     
@@ -167,7 +173,7 @@ public class PlayerHandler{
             return UUID.fromString(uuid);
         }catch(IllegalArgumentException ex){
             // This is always a valid UUID.
-            return UUID.fromString(defaultUUID);
+            return defaultUUID;
         }
     }
     

core/src/main/resources/config.yml

@@ -1,27 +1,25 @@
 #
-# Used for when AdvancedServerList doesn't have a cached player to use for ${player name}
+# Used for when AdvancedServerList doesn't have a cached player to use for player placeholders.
 #
-# Defaults to 'Anonymous' when not present.
-#
-unknown_player: "Anonymous"
-
-#
-# UUID used for when AdvancedServerList doesn't have a cached player to use for the ${player uuid}
-# placeholder.
-#
-# Defaults to the UUID of MHF_Question (606e2ff0-ed77-4842-9d6c-e1d3321c7838) when not present.
-#
-unknown_player_uuid: "606e2ff0-ed77-4842-9d6c-e1d3321c7838"
+unknownPlayer:
+  #
+  # The name to use. Defaults to Anonymous.
+  #
+  name: "Anonymous"
+  #
+  # The UUID to use. Defaults to 606e2ff0-ed77-4842-9d6c-e1d3321c7838 (UUID of MHF_Question).
+  #
+  uuid: "606e2ff0-ed77-4842-9d6c-e1d3321c7838"
 
 #
 # Should the Caching of players be disabled?
 #
 # When set to true will AdvancedServerList not load any players from the cache.data file (if present) nor save any to it.
-# Placeholders that rely on the player being cached (such as ${player isWhitelisted}) will not work while this option is enabled.
+# Placeholders that rely on the player being cached (such as ${player name}) will not work while this option is enabled.
 #
 # Defaults to false when not present.
 #
-disable_cache: false
+disableCache: false
 
 #
 # Should AdvancedServerList check for new versions?
@@ -31,4 +29,12 @@ disable_cache: false
 #
 # Defaults to false when not present.
 #
-check_updates: true
+checkUpdates: true
+
+#
+# DO NOT EDIT!
+#
+# 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: 2

docs/.overrides/api-doc.html

@@ -0,0 +1,35 @@
+{% 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') }}
+    {% endif %}
+    {% if page.meta.classes %}
+      {{ info.summary('Class Summary', page.meta.classes, details_type='class') }}
+    {% endif %}
+    {% if page.meta.enums %}
+      {{ info.summary('Enum Constant Summary', page.meta.enums, details_type='enum') }}
+    {% endif %}
+    {% if page.meta.methods or page.meta.inherits %}
+      {{ info.summary('Method Summary', page.meta.methods, page.meta.inherits, details_type='method') }}
+    {% endif %}
+    <!--
+      Detailed object info
+    -->
+    {% if page.meta.constructors %}
+      {{ info.info('Constructor Detail', page.meta.constructors) }}
+    {% endif %}
+    {% if page.meta.enums %}
+      {{ info.info('Enum Constant Detail', page.meta.enums, true) }}
+    {% endif %}
+    {% if page.meta.methods %}
+      {{ info.info('Method Detail', page.meta.methods)}}
+    {% endif %}
+  {% endif %}
+{% endblock %}

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

@@ -0,0 +1,203 @@
+{% macro summary(title, summaries, inherits, details_type = 'unknown') -%}
+  <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 %}
+                {% else %}
+                  {% set modifiers.name = modifiers.name ~ "void" %}
+                {% endif %}
+                
+                {% set desc = "" %}
+                {% if 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, enum = false) -%}
+  <h2 id="{{ title | lower() | replace(' ', '-') | e}}">
+    {{ title }}
+  </h2>
+  {% for detail in details %}
+    <div class="api-detail">
+      {% set final_name = namespace(name = "") %}
+      {% if 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 not enum %}
+        {% set final_name.name = final_name.name ~ ")" %}
+      {% endif %}
+      
+      <h3 id="{{ final_name.name | lower() | replace(' ', '-') | e }}">
+        {% for attribute in detail.attributes %}
+          <api__{{- attribute -}}></api__{{- attribute -}}>
+        {% endfor %}
+        
+        {% if enum %}
+          <api__static></api__static> <api__final></api__final>
+        {% endif %}
+        
+        {% if detail.type %}
+          {% 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 %}
+        {% endif %}
+        <code>{{ final_name.name | e }}</code><a href="#{{ final_name.name | lower() | replace(' ', '-') | e }}" class="headerlink" title="Permanent link">¶</a>
+      </h3>
+      
+      {% 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/partials/source.html

@@ -0,0 +1,17 @@
+<a
+  href="{{ config.repo_url}}"
+  title="{{ lang.t('source') }}"
+  class="md-source"
+  target="_blank"
+  rel="nofollow noreferral noopener"
+>
+  <div class="md-source__icon md-icon">
+    {% set icon = config.theme.icon.repo or "fontawesome/brands/git-alt" %}
+    {% include ".icons/" ~ icon ~ ".svg" %}
+  </div>
+  <div class="md-source__repository">
+    {{ config.repo_name }}
+    <ul class="md-source__facts" data-md-component="codeberg-stats">
+    </ul>
+  </div>
+</a>

docs/.pages.yml

@@ -0,0 +1,9 @@
+nav:
+  - Home:
+    - index.md
+    - commands.md
+  - profiles
+  - examples
+  - migration
+  - api
+  - placeholderapi 

docs/api/.pages.yml

@@ -0,0 +1,2 @@
+nav:
+  - ...

docs/api/changelog.md

@@ -1,14 +1,36 @@
+---
+icon: octicons/log-24
+---
+
 # Changelog
 
 This page lists the recent changes made towards the AdvancedServerListAPI.  
 They are ordered newest to oldest.
 
+## v3.0.0
+
+### :octicons-alert-24:{ .changelog-breaking title="Breaking Changes" } Breaking Changes { #v3-breaking }
+
+- Removed `platform-spigot` API in favour of a more generic sounding `platform-bukkit`
+- Renamed all platform-specific packages from `ch.andre601.advancedserverlist.<platform>` to `ch.andre601.advancedserverlist.api.<platform>`
+
+### :octicons-plus-circle-24:{ .changelog-added title="Added" } Added { #v3-added }
+
+- New platform-specific `GenericServer` instances with their own methods to use.
+    - `BukkitServer` - Contains a `getWorlds()` method that returns a `Map<String, World>` of all loaded worlds in the server.
+    - `BungeeProxy` - Contains a `getServers()` method that returns a `Map<String, ServerInfo>` of all known Servers for BungeeCord.
+    - `VelocityProxy` - Contains a `getServers()` method that returns a `Map<String, RegisteredServer>` of all known Servers for Velocity.
+
+### :octicons-trash-24:{ .changelog-removed title="Removed" } Removed { #v3-removed }
+
+- All previously deprecated `getX()` methods from the `ProfileEntry` record
+
 ## v2.1.0
 
-### :octicons-pencil-24:{ .changelog-changed title="Changed" } Changed { #v-changed }
+### :octicons-pencil-24:{ .changelog-changed title="Changed" } Changed { #v2.1.0-changed }
 
 - Turned `ProfileEntry` class into a record
-    - Former `getX()` methods are now deprecated in favour of the recor's own `x()` methods (i.e. `getMotd()` -> `motd()`)
+    - Former `getX()` methods are now deprecated in favour of the record's own `x()` methods (i.e. `getMotd()` -> `motd()`)
 
 ## v2.0.0
 
@@ -57,4 +79,4 @@ Templates for changelog
 ### :octicons-pencil-24:{ .changelog-changed title="Changed" } Changed { #v-changed }
 ### :octicons-trash-24:{ .changelog-removed title="Removed" } Removed { #v-removed }
 
--->
+-->

docs/api/index.md

@@ -1,3 +1,7 @@
+---
+icon: octicons/command-palette-24
+---
+
 # API
 
 AdvancedServerList v2 introduced a new API that plugins can hook into to use.  
@@ -9,7 +13,9 @@ Add the following to your `build.gradle` or `pom.xml` file to use the API:
 
 === ":simple-gradle: Gradle"
     
-    Make sure to replace `{version}` with the latest version available in the [GitHub Repository][api-repo].
+    [![latest_release][release]][api-repo]
+    
+    Make sure to replace `{version}` with the version displayed above.
     
     ```groovy title="build.gradle"
     repositorories {
@@ -20,15 +26,17 @@ Add the following to your `build.gradle` or `pom.xml` file to use the API:
         implementation 'ch.andre601.asl-api:api:{version}'
         
         // Optional platform dependencies
+        implementation 'ch.andre601.asl-api:platform-bukkit:{version}'
         implementation 'ch.andre601.asl-api:platform-bungeecord:{version}'
-        implementation 'ch.andre601.asl-api:platform-spigot:{version}'
         implementation 'ch.andre601.asl-api:platform-velocity:{version}'
     }
     ```
 
 === ":simple-apachemaven: Maven"
     
-    Make sure to replace `{version}` with the latest version available in the [GitHub Repository][api-repo].
+    [![latest_release][release]][api-repo]
+    
+    Make sure to replace `{version}` with the version displayed above.
     
     ```xml title="pom.xml"
     <repositories>
@@ -48,12 +56,12 @@ Add the following to your `build.gradle` or `pom.xml` file to use the API:
       <!-- Optional platform dependencies -->
       <dependency>
         <groupId>ch.andre601.asl-api</groupId>
-        <artifactId>platform-bungeecord</artifactId>
+        <artifactId>platform-bukkit</artifactId>
         <version>{version}</version>
       </dependency>
       <dependency>
         <groupId>ch.andre601.asl-api</groupId>
-        <artifactId>platform-spigot</artifactId>
+        <artifactId>platform-bungeecord</artifactId>
         <version>{version}</version>
       </dependency>
       <dependency>
@@ -64,6 +72,7 @@ Add the following to your `build.gradle` or `pom.xml` file to use the API:
     </dependencies>
     ```
 
+[release]: https://img.shields.io/github/v/tag/Andre601/asl-api?labelColor=252631&color=292a36&style=for-the-badge&label=Latest%20Release:
 [api-repo]: https://github.com/Andre601/asl-api
 
 ## Add own placeholders

docs/api/reference/.pages.yml

@@ -0,0 +1,6 @@
+nav:
+  - index.md
+  - api: api
+  - platform-bukkit: platform-bukkit
+  - platform-bungeecord: platform-bungeecord
+  - platform-velocity: platform-velocity

docs/api/reference/api/.pages.yml

@@ -0,0 +1,3 @@
+nav:
+  - index.md
+  - ch.andre601.advancedserverlist.api: ch.andre601.advancedserverlist.api

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

@@ -0,0 +1,54 @@
+---
+template: api-doc.html
+
+methods:
+  - name: 'get'
+    description: |
+      Retrieve the instance used of this API.<br>
+      If no instance has been made so far will a new one be created.
+    returns: 'Instance of this API.'
+    attributes:
+      - static
+    type:
+      name: 'AdvancedServerListAPI'
+      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.
+    parameters:
+      - name: 'placeholderProvider'
+        description: 'The <a href="./../placeholderprovider/"><code>PlaceholderProvider</code></a> 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.'
+    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.'
+    parameters:
+      - name: 'identifier'
+        description: 'The identifier to find a matching <a href="./../placeholderprovider/"><code>PlaceholderProvider</code></a> for.'
+        type: String
+    returns: 'Possibly-null <a href="./../placeholderprovider/"><code>PlaceholderProvider</code> instance</a>.'
+    attributes:
+      - nullable
+    type:
+      name: PlaceholderProvider
+      type: object
+      link: './../placeholderprovider'
+---
+
+# <api__class></api__class> AdvancedServerListAPI
+
+Core class of the API for AdvancedServerList.  
+Use [`get()`](#get) to retrieve the instance currently used.

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

@@ -0,0 +1,45 @@
+---
+template: api-doc.html
+
+methods:
+  - name: 'getEntry'
+    description: 'Gets the <a href="../../profiles/profileentry/"><code>ProfileEntry</code></a> currently set.'
+    returns: The currently used ProfileEntry.
+    type:
+      name: ProfileEntry
+      type: object
+      link: '../../profiles/profileentry/'
+  - name: 'setEntry'
+    description: |-
+      Sets the new <a href="../../profiles/profileentry/"><code>ProfileEntry</code></a> to use.<br>
+      This may not be <code>null</code>.
+    parameters:
+      - name: 'entry'
+        description: 'The new <a href="../../profiles/profileentry/"><code>ProfileEntry</code></a> to use.'
+        type: ProfileEntry
+        attributes:
+          - notnull
+    throws:
+      - name: 'IllegalArgumentException'
+        description: 'When the provided ProfileEntry is <code>null</code>'
+    type:
+      name: 'void'
+  - name: 'isCancelled'
+    description: Returns whether this event has been cancelled or not.
+    returns: Whether this event has been cancelled or not.
+    type:
+      name: boolean
+  - name: 'setCancelled'
+    description: Sets the event's cancel state
+    parameters:
+      - name: 'cancelled'
+        description: 'Boolean to set the event''s cancelled state.'
+        type: boolean
+    type:
+      name: 'void'
+---
+
+# <api__interface></api__interface> GenericServerListEvent
+
+Interface used for the platform-specific PreServerListSetEvent instances.  
+This allows the plugin to pull common info such as ProfileEntry or if the event has been cancelled by another plugin.

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

@@ -0,0 +1,13 @@
+---
+template: 'api-doc.html'
+
+constructors:
+  - name: 'InvalidPlaceholderProviderException'
+    parameters:
+      - name: msg
+        type: String
+---
+
+# <api__class></api__class> InvalidPlaceholderProviderException
+
+RuntimeException thrown whenever an invalid [`PlaceholderProvider`](../placeholderprovider.md) has been given.

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

@@ -0,0 +1,42 @@
+---
+template: api-doc.html
+
+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: '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.
+    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: 'UUID of the player'
+    type:
+      name: UUID
+      type: object
+---
+
+# <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.
+
+The following values will always be present, no matter the platform this interface is used on:
+
+- [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

@@ -0,0 +1,27 @@
+---
+template: api-doc.html
+
+methods:
+  - name: 'getPlayersOnline'
+    description: 'Returns the number of players currently online on the server.'
+    returns: 'Number of players online on the server.'
+    type:
+      name: int
+  - name: 'getPlayersMax'
+    description: 'Returns the number of total players that can join the server.'
+    returns: 'Number of total players that can join the server.'
+    type:
+      name: int
+  - name: 'getHost'
+    description: 'Returns the IP/Domain that got pinged by the player.'
+    returns: 'Possibly-null String containing the IP/Domain that got pinged by the player'
+    attributes:
+      - nullable
+    type:
+      name: 'String'
+      type: 'object'
+---
+
+# <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.

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

@@ -0,0 +1,51 @@
+---
+template: api-doc.html
+
+enums:
+  - name: 'true'
+    description: 'Boolean value <code>true</code>'
+  - name: 'false'
+    description: 'Boolean value <code>false</code>'
+  - name: 'not_set'
+    description: 'Boolean value <code>null</code>'
+
+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.'
+    parameters:
+      - name: 'bool'
+        description: 'The <code>Boolean</code> value to receive a NullBool instance for.'
+        type: Boolean
+        attributes:
+          - nullable
+    attributes:
+      - static
+    type:
+      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.'
+    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.
+    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>.'
+        type: boolean
+    type:
+      name: 'boolean'
+      type: 'primitive'
+---
+
+# <api__enum></api__enum> NullBool
+
+Enum used to return a `Boolean` value with a default one should no value be set.

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

@@ -0,0 +1,50 @@
+---
+template: api-doc.html
+
+constructors:
+  - name: 'PlaceholderProvider'
+    description: 'Constructor used to set the identifier for the class extending the PlaceholderProvider class itself.'
+    parameters:
+      - name: 'identifier'
+        description: 'The identifier to use for the placeholder. Cannot be empty.'
+        type: String
+        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.
+    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.'
+      - name: 'server'
+        type: GenericServer
+        description: 'The <a href="./../objects/genericserver/"><code>GenericServer</code> instance</a> used.'
+    returns: 'Possibly-parsed or possibly-null String to replace the placeholder with.'
+    attributes:
+      - nullable
+      - abstract
+    type:
+      name: 'String'
+      type: 'object'
+  - name: 'getIdentifier'
+    description: 'Returns the identifier used by this PlaceholderProvider instance.'
+    returns: 'String representing the identifier of this PlaceholderProvider instance.'
+    type:
+      name: 'String'
+      type: 'object'
+---
+
+# <api__abstract></api__abstract> <api__class></api__class> PlaceholderProvider
+
+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.

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

@@ -0,0 +1,142 @@
+---
+template: api-doc.html
+
+constructors:
+  - name: 'Builder'
+  
+methods:
+  - name: 'setMotd'
+    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.
+    returns: 'This Builder after the motd has been set. Useful for chaining.'
+    parameters:
+      - name: 'motd'
+        description: 'The MOTD to use.'
+        type: 'List<String>'
+        attributes:
+          - notnull
+    throws:
+      - name: 'IllegalArgumentException'
+        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+    type:
+      name: 'Builder'
+      type: 'object'
+  - name: 'setPlayers'
+    description: |
+      Sets the players (lines) to use for the hover.<br>
+      <br>
+      Set to an empty list to not change the hover text.
+    returns: 'This Builder after the players have been set. Useful for chaining.'
+    parameters:
+      - name: 'players'
+        description: 'The lines to set for the hover.'
+        type: 'List<String>'
+        attributes:
+          - notnull
+    throws:
+      - name: 'IllegalArgumentException'
+        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+    type:
+      name: 'Builder'
+      type: 'object'
+  - name: 'setPlayerCountText'
+    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.
+    returns: 'This Builder after the player count text has been set. Useful for chaining.'
+    parameters:
+      - name: 'playerCountText'
+        description: 'The text to show in the player count.'
+        type: String
+        attributes:
+          - nullable
+    type:
+      name: 'Builder'
+      type: 'object'
+  - name: 'setFavicon'
+    description: |
+      Sets the value to use for the favicon.<br>
+      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.</li>
+      </ul>
+    returns: 'This Builder after the favicon has been set. Useful for chaining.'
+    parameters:
+      - name: 'favicon'
+        description: 'The favicon to set'
+        type: String
+        attributes:
+          - nullable
+    type:
+      name: 'Builder'
+      type: 'object'
+  - name: 'setHidePlayersEnabled'
+    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.
+    returns: 'This Builder after the NullBool has been set. Useful for chaining.'
+    parameters:
+      - name: 'hidePlayersEnabled'
+        description: 'Whether the player count should be hidden or not.'
+        type: NullBool
+        attributes:
+          - notnull
+    throws:
+      - name: 'IllegalArgumentException'
+        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+    type:
+      name: 'Builder'
+      type: 'object'
+  - name: 'setExtraPlayersEnabled'
+    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.
+    returns: 'This Builder after the NullBool has been set. Useful for chaining.'
+    parameters:
+      - name: 'extraPlayersEnabled'
+        description: 'Whether the extra players feature should be enabled or not.'
+        type: NullBool
+        attributes:
+          - notnull
+    throws:
+      - name: 'IllegalArgumentException'
+        description: 'Thrown by the <code>CheckUtil</code> in case <code>null</code> has been provided as parameter.'
+    type:
+      name: 'Builder'
+      type: 'object'
+  - name: 'setExtraPlayers'
+    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>.<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>.
+    returns: 'This Builder after the extra player count has been set. Useful for chaining.'
+    parameters:
+      - name: 'extraPlayersCount'
+        description: 'The number of extra players to use.'
+        type: Integer
+        attributes:
+          - nullable
+    type:
+      name: 'Builder'
+      type: 'object'
+  - 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>.'
+    type:
+      name: 'ProfileEntry'
+      type: 'object'
+      link: './..'
+---
+
+# <api__class></api__class> Builder
+
+Builder class to create a new [`ProfileEntry` instance](index.md).

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

@@ -0,0 +1,175 @@
+---
+template: api-doc.html
+
+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.
+    parameters:
+      - name: 'motd'
+        description: 'The MOTD to use.'
+        type: 'List<String>'
+        attributes:
+          - notnull
+      - name: 'players'
+        description: 'The players (Lines) to show in the hover.'
+        type: 'List<String>'
+        attributes:
+          - notnull
+      - name: 'playerCountText'
+        description: 'The text to display instead of the player count.'
+        type: String
+        attributes:
+          - nullable
+      - name: 'favicon'
+        description: 'The favicon to use.'
+        type: String
+        attributes:
+          - nullable
+      - name: 'hidePlayersEnabled'
+        description: 'Whether player count should be hidden.'
+        type: NullBool
+        attributes:
+          - notnull
+      - name: 'extraPlayersEnabled'
+        description: 'Whether the extra players option should be enabled.'
+        type: NullBool
+        attributes:
+          - notnull
+      - name: 'extraPlayersCount'
+        description: 'The number to add to the online players for the max players number.'
+        type: Integer
+        attributes:
+          - nullable
+    seealso:
+      - name: 'ProfileEntry.Builder'
+        link: './builder/'
+
+classes:
+  - name: 'Builder'
+    description: 'Builder class to create a new ProfileEntry instance.'
+    type: 'static class'
+    link: 'builder/'
+
+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/"><code>NullBool.NOT_SET</code></a></li>
+        <li><a href="#extraplayersenabled()"><code>extraPlayersEnabled</code></a>: <a href="../../objects/nullbool/"><code>NullBool.NOT_SET</code></a></li>
+        <li><a href="#extraplayerscount()"><code>extraPlayersCount</code></a>: <code>null</code></li>
+      </ul>
+    returns: 'New ProfileEntry instance with empty/null values defined'
+    attributes:
+      - static
+    type:
+      name: 'ProfileEntry'
+      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.
+    returns: 'A copy of this ProfileEntry instance.'
+    seealso:
+      - name: '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>
+      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.'
+    type:
+      name: 'Builder'
+      type: 'object'
+      link: './builder/'
+  - name: 'motd'
+    description: 'Gets the currently set MOTD of this ProfileEntry.'
+    returns: 'The current MOTD used by this ProfileEntry.'
+    type:
+      name: 'List<String>'
+      type: 'object'
+  - name: 'players'
+    description: 'Gets the currently set players of this ProfileEntry.'
+    returns: 'The current list of players used by this ProfileEntry.'
+    type:
+      name: 'List<String>'
+      type: 'object'
+  - name: 'playerCountText'
+    description: 'Gets the currently set player count text of this ProfileEntry.'
+    returns: 'The current player count text used by this ProfileEntry.'
+    type:
+      name: 'String'
+      type: 'object'
+  - name: 'favicon'
+    description: |
+      Gets the currently set favicon of this ProfileEntry.<br>
+      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>
+    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>.
+    returns: 'Whether the player count should be hidden or not in this ProfileEntry.'
+    type:
+      name: 'NullBool'
+      type: 'object'
+      link: '../../objects/nullbool/'
+  - 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>.
+    returns: 'Whether the extra players feature should be used or not in this ProfileEntry.'
+    type:
+      name: 'NullBool'
+      type: 'object'
+      link: '../../objects/nullbool/'
+  - 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.'
+    attributes:
+      - nullable
+    type:
+      name: 'Integer'
+      type: 'object'
+  - name: 'isInvalid'
+    description: |
+      Whether this ProfileEntry is considered invalid or not.<br>
+      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.
+    returns: 'Whether this ProfileEntry is invalid or not.'
+    type:
+      name: 'boolean'
+      type: 'primitive'
+---
+
+# <api__record></api__record> ProfileEntry
+
+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.

docs/api/reference/api/index.md

@@ -0,0 +1,7 @@
+# API Module
+
+The `api` module is the main part of the AdvancedServerList API. It contains all necessary classes and methods you would want to use to interact with AdvancedServerList.
+
+## Module Structure
+
+{nav}

docs/api/reference/index.md

@@ -0,0 +1,12 @@
+---
+icon: octicons/file-code-24
+---
+
+# API Reference
+
+This page contains the various classes and methods that the AdvancedServerList API provides to you for use.  
+Please note that while the nav and page content is auto-generated, the data used for the page content is not. So information may be out of date.
+
+## API Structure
+
+{nav}

docs/api/reference/platform-bukkit/.pages.yml

@@ -0,0 +1,3 @@
+nav:
+  - index.md
+  - ch.andre601.advancedserverlist.api.bukkit: ch.andre601.advancedserverlist.api.bukkit

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

@@ -0,0 +1,36 @@
+---
+template: api-doc.html
+
+constructors:
+  - name: 'PreServerListSetEvent'
+    parameters:
+      - name: 'entry'
+        type: ProfileEntry
+
+methods:
+  - name: 'getHandlerList'
+    returns: 'Static <code>HandlerList</code> instance.'
+    attributes:
+      - static
+    type:
+      name: 'HandlerList'
+      type: 'object'
+
+inherits:
+  'ch.andre601.advancedserverlist.api.events.GenericServerListEvent':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent/'
+    list:
+      - 'getEntry()'
+      - 'setEntry(ProfileEntry)'
+      - 'isCancelled()'
+      - 'setCancelled(boolean)'
+  'org.bukkit.event.Event':
+    link: 'https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/Event.html'
+    list:
+      - '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.

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

@@ -0,0 +1,50 @@
+---
+template: api-doc.html
+
+methods:
+  - name: 'getPlayer'
+    description: 'Gives the OfflinePlayer embedded in this BukkitPlayer.'
+    returns: 'OfflinePlayer instance'
+    type:
+      name: 'OfflinePlayer'
+      type: 'object'
+  - name: 'hasPlayedBefore'
+    description: |
+      Returns whether this player has played on the server before.<br>
+      <br>
+      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>
+      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>
+      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:
+      name: 'boolean'
+
+inherits:
+  'ch.andre601.advancedserverlist.api.objects.GenericPlayer':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer/'
+    list:
+      - 'getName()'
+      - 'getProtocol()'
+      - '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 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

@@ -0,0 +1,26 @@
+---
+template: api-doc.html
+
+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.'
+    returns: 'Possibly-empty Map containing pairs of Strings and Worlds.'
+    type:
+      name: 'Map<String, World>'
+      type: 'object'
+
+inherits:
+  'ch.andre601.advancedserverlist.api.objects.GenericServer':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericserver/'
+    list:
+      - 'getPlayersOnline()'
+      - 'getPlayersMax()'
+      - '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 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-bukkit/index.md

@@ -0,0 +1,7 @@
+# Bukkit Module
+
+The `platform-bukkit` module contains classes for platform-specific things such as Server events or a Server-specific CachedPlayer instance.
+
+## Module Structure
+
+{nav}

docs/api/reference/platform-bungeecord/.pages.yml

@@ -0,0 +1,3 @@
+nav:
+  - index.md
+  - ch.andre601.advancedserverlist.api.bungeecord: ch.andre601.advancedserverlist.api.bungeecord

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

@@ -0,0 +1,24 @@
+---
+template: api-doc.html
+
+constructors:
+  - name: 'PreServerListSetEvent'
+    parameters:
+      - name: 'entry'
+        type: ProfileEntry
+
+
+inherits:
+  'ch.andre601.advancedserverlist.api.events.GenericServerListEvent':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent/'
+    list:
+      - 'getEntry()'
+      - 'setEntry(ProfileEntry)'
+      - 'isCancelled()'
+      - 'setCancelled(boolean)'
+---
+
+# <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.

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

@@ -0,0 +1,17 @@
+---
+template: api-doc.html
+
+inherits:
+  'ch.andre601.advancedserverlist.api.objects.GenericPlayer':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer/'
+    list:
+      - 'getName()'
+      - 'getProtocol()'
+      - 'getUUID()'
+---
+
+# <api__interface></api__interface> BungeePlayer
+
+[`GenericPlayer` instance](../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer.md) for the BungeeCord proxy implementation of AdvancedServerList.
+
+To get an instance of this class from a GenericPlayer instance, simply cast it to a BungeePlayer (Granted that the GenericPlayer instance actually is a BungeePlayer instance).

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

@@ -0,0 +1,21 @@
+---
+template: api-doc.html
+
+methods:
+  - name: 'getServers'
+    description: 'Returns a <code>Map&lt;String, ServerInfo&gt;</code> where the key is the name of the server and the value the ServerInfo of the proxy.'
+    returns: 'Possibly-empty Map containing pairs of Strings and ServerInfos.'
+    type:
+      name: 'Map<String, ServerInfo>'
+      type: 'object'
+
+inherits:
+  'ch.andre601.advancedserverlist.api.objects.GenericServer':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericserver/'
+    list:
+      - 'getPlayersOnline()'
+      - 'getPlayersMax()'
+      - 'getHost()'
+---
+
+# <api__interface></api__interface> BungeeProxy

docs/api/reference/platform-bungeecord/index.md

@@ -0,0 +1,7 @@
+# BungeeCord Module
+
+The `platform-bungeecord` module contains classes for platform-specific things such as Proxy events or a Proxy-specific CachedPlayer instance.
+
+## Module Structure
+
+{nav}

docs/api/reference/platform-velocity/.pages.yml

@@ -0,0 +1,3 @@
+nav:
+  - index.md
+  - ch.andre601.advancedserverlist.api.velocity: ch.andre601.advancedserverlist.api.velocity

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

@@ -0,0 +1,23 @@
+---
+template: api-doc.html
+
+constructors:
+  - name: 'PreServerListSetEvent'
+    parameters:
+      - name: 'entry'
+        type: ProfileEntry
+
+inherits:
+  'ch.andre601.advancedserverlist.api.events.GenericServerListEvent':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/events/genericserverlistevent/'
+    list:
+      - 'getEntry()'
+      - 'setEntry(ProfileEntry)'
+      - 'isCancelled()'
+      - 'setCancelled(boolean)'
+---
+
+# <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.

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

@@ -0,0 +1,26 @@
+---
+template: api-doc.html
+
+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).'
+    returns: 'The readable MC version the player uses.'
+    type:
+      name: 'String'
+      type: 'object'
+
+inherits:
+  'ch.andre601.advancedserverlist.api.objects.GenericPlayer':
+    link: '../../../../api/ch.andre601.advancedserverlist.api/objects/genericplayer/'
+    list:
+      - 'getName()'
+      - 'getProtocol()'
+      - '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.
+
+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

@@ -0,0 +1,21 @@
+---
+template: api-doc.html
+
+methods:
+  - name: 'getServers'
+    description: 'Returns a <code>Map&lt;String, RegisteredServer&gt;</code> where the key is the name of the server and the value the RegisteredServer of the proxy.'
+    returns: 'Possibly-empty Map containing pairs of Strings and RegisteredServers.'
+    type:
+      name: 'Map<String, RegisteredServer>'
+      type: 'object'
+
+inherits:
+  'ch.andre601.advancedserverlist.api.objects.GenericServer':
+    link: '../../../api/objects/genericserver/'
+    list:
+      - 'getPlayersOnline()'
+      - 'getPlayersMax()'
+      - 'getHost()'
+---
+
+# <api__interface></api__interface> VelocityProxy

docs/api/reference/platform-velocity/index.md

@@ -0,0 +1,7 @@
+# Velocity Module
+
+The `platform-velocity` module contains classes for platform-specific things such as Proxy events or a Proxy-specific CachedPlayer instance.
+
+## Module Structure
+
+{nav}

docs/api/reference/structure.md

@@ -0,0 +1,195 @@
+# API Reference Docs Structure
+
+The Reference docs follow a specific mixture of manually created and auto-generated page content.
+
+A page may look something like this:
+```markdown
+---
+constructors:
+  - name: 'Constructor'
+    description: 'Creates a new instance of this class.'
+
+methods:
+  - name: 'getString'
+    description: 'Gets a String.'
+    type:
+      name: String
+      type: object
+---
+
+# <api__class></api__class> Constructor
+
+An example class to show how the page structure may look like.
+```
+
+## custom HTML tags
+
+There is a collection of custom HTML tags that are used to render specific text in certain styles.  
+Below is a list of all custom tags. Note that these tags only render on the actual site and not within the repository.
+
+- `<api__class></api__class>`: <api__class></api__class>
+- `<api__interface></api__interface>`: <api__interface></api__interface>
+- `<api__enum></api__enum>`: <api__enum></api__enum>
+- `<api__record></api__record>`: <api__record></api__record>
+- `<api__abstract></api__abstract>`: <api__abstract></api__abstract>
+- `<api__static></api__static>`: <api__static></api__static>
+- `<api__final></api__final>`: <api__final></api__final>
+- `<api__notnull></api__notnull>`: <api__notnull></api__notnull>
+- `<api__nullable></api__nullable>`: <api__nullable></api__nullable>
+
+In addition are there two classes used within `span` tags to colour the text, to indicate their type:
+
+- `<span class="api-type__object">Object</span>`: <span class="api-type__object">Object</span>
+- `<span class="api-type__primitive">Object</span>`: <span class="api-type__primitive">Primitive</span>
+
+## Auto-generated content
+
+The page template used checks for specific YAML frontmatter in the page to include other templates.  
+These templates pull the data from the YAML frontmatter to generate the page content which is then appendet to the already existing page content.
+
+There are 5 frontmatter options, each following a specific structure:
+
+- [`Constructors`](#constructors)
+- [`Nested Classes`](#nested-classes)
+- [`Enum Constants`](#enum constants)
+- [`Methods`](#methods)
+- [`Inherits`](#inherits)
+
+### Constructors
+
+```yaml
+constructors:
+  - name: '<string>'
+    description: '<string>'
+    parameters:
+      - name: '<string>'
+        description: '<string>'
+        type: '<string>'
+        attributes:
+          - '<string>'
+    throws:
+      - name: '<string>'
+        description: '<string>'
+    seealos:
+      - name: '<string>'
+        link: '<string>'
+```
+
+**Options:**
+
+- `name` - The name to display for the Constructor summary and detail. This should include any parameters the Constructor has, but without any parameter name.
+- `description` - The description to display for the Constructor.
+- `parameters` - List of parameters to display.
+    - `name` - Name of the parameter to display.
+    - `description` - Description of the parameter.
+    - `type` - The type this parameter is.
+    - `attributes` - List of attributes (i.e. nullability) to display. The provided values will be turned into `<api__{name}></api__{name}>` tags that will be prependet to the parameter name.
+- `throws` - List of possible throws to display.
+    - `name` - Name of the throw to display.
+    - `description` - Description of the throw.
+- `seealso` - List of "See also" text to display.
+    - `name` - Name of the See also link.
+    - `link` - Link (Relative, absolute or URL) to use for the See also text.
+
+### Nested Classes
+
+```yaml
+classes:
+  - name: '<string>'
+    description: '<string>'
+    type: '<string>'
+    link: '<string>'
+```
+
+**Options:**
+
+- `name` - The name to display for the Nested Classes Summary.
+- `description` - The description of the nested class.
+- `type` - Modifier and type of the nested class.
+- `link` - Link to the nested class.
+
+### Enum Constants
+
+```yaml
+enums:
+  - name: '<string>'
+    description: '<string>'
+    type: '<string>'
+    seealso:
+      - name: '<string>'
+        link: '<string>'
+```
+
+**Options:**
+
+- `name` - The name to display for the Constructor summary and detail. This should include any parameters the Constructor has, but without any parameter name.
+- `description` - The description to display for the Constructor.
+- `type` - The return type to display. Will default to `{{ page.title }}` if not set.
+- `seealso` - List of "See also" text to display.
+    - `name` - Name of the See also link.
+    - `link` - Link (Relative, absolute or URL) to use for the See also text.
+
+### Methods
+
+```yaml
+methods:
+  - name: '<string>'
+    description: '<string>'
+    type:
+      name: '<string>'
+      type: '<string>'
+      link: '<string>'
+    attributes:
+      - '<string>'
+    parameters:
+      - name: '<string>'
+        description: '<string>'
+        type: '<string>'
+        attributes:
+          - '<string>'
+    returns: '<string>'
+    throws:
+      - name: '<string>'
+        description: '<string>'
+    seealos:
+      - name: '<string>'
+        link: '<string>'
+```
+
+**Options:**
+
+- `name` - The name to display for the Constructor summary and detail. This should include any parameters the Constructor has, but without any parameter name.
+- `description` - The description to display for the Constructor.
+- `type` - Options for object type to display.
+    - `name` - Displayed name of the object.
+    - `type` - Object type. Can be either `object` or `primitive` which would be used in a class name for styling.
+    - `link` - Link (Relative, absolute or URL) to use for the type name.
+- `attributes` - List of attributes (i.e. nullability) to display. The provided values will be turned into `<api__{name}></api__{name}>` tags that will be prependet to the name.
+- `parameters` - List of parameters to display.
+    - `name` - Name of the parameter to display.
+    - `description` - Description of the parameter.
+    - `type` - The type this parameter is.
+    - `attributes` - List of attributes (i.e. nullability) to display. The provided values will be turned into `<api__{name}></api__{name}>` tags that will be prependet to the parameter name.
+- `returns` - Possible return values.
+- `throws` - List of possible throws to display.
+    - `name` - Name of the throw to display.
+    - `description` - Description of the throw.
+- `seealso` - List of "See also" text to display.
+    - `name` - Name of the See also link.
+    - `link` - Link (Relative, absolute or URL) to use for the See also text.
+
+### Inherits
+
+```yaml
+inherits:
+  '<string>':
+    link: '<string>'
+    methods:
+      - '<string>'
+```
+
+**Options:**
+
+- `inherits.<string>` - Classpath used to display in the text `Methods inherited from <string>`
+- `link` - Link to use for the classpath text.
+- `methods` - List of strings to display. Each will be linked using `{link}#{method}`

docs/assets/.pages.yml

@@ -0,0 +1 @@
+hide: true