Examples - Andre601/AdvancedServerList GitHub Wiki

wiki-moved Wiki moved!

The wiki has been moved to a new location and can be found here: https://docs.andre601.ch/AdvancedServerList

About

Note

These examples only work for the latest version (1.10.0)!

This page lists some examples you may want to use for your proxy or server.

Feel free to suggest additional examples on my Discord Server in the #advancedserverlist channel.

Table of Contents


Versions

Some examples about version-related things.

Different List for outdated Clients

You may want to display a separate MOTD or text for incompatible client versions.
This example here shows a separate MOTD and player count message for when the player's client version is older than what the server supports.

priority: 1

# Display this profile, if the version of the player is below 760 (1.19.1)
conditions:
  - '${player protocol} < 760'

motd:
  - <red>You are using an outdated client!
  - <red>Please update to 1.19.1 to join.

playerCount:
  text: '<red>Outdated Client!'

Different MOTD for < 1.16

This profile would display a MOTD without HEX colours if the player's version is below 735 (1.16).

priority: 1

# Display this profile, if the version of the player is below 735 (1.16)
conditions:
  - '${player protocol} < 735'

motd:
  - <grey>Welcome to <aqua>YourServer.com</aqua>!
  - <grey>Enjoy your stay.

Spigot/PaperMC

Examples that can be used with the Spigot or PaperMC version.

Different profile for banned Player

Displays a separate profile for when the player has been banned from the server.

priority: 1

conditions:
  - '${player isBanned} = true'

motd:
  - <red>You have been <bold>BANNED</bold>!
  - <red>Go away.

# Don't show the player count to the banned player.
playerCount:
  hidePlayers: true

Other

Some misc examples.

Different profile for different host

Display a different profile when the playing pings a specific domain/IP.

priority: 1

conditions:
  - '${server host} = other.example.com'

motd:
  - <grey>Please use <aqua>mc.example.com
  - <grey>to join our server.

Different profile for known player

Display a different profile, if the player pinging the server is "known" by AdvancedServerList (Has joined before with the same IP).

priority: 1

conditions:
  - `${player name} != Anonymous` # "Anonymous" should be replaced with whatever you use in 'unknown_player'

motd:
  - <grey>Hello there <aqua>${player name}</aqua>!
  - <grey>It's nice to see you again.

playerCount:
  hover:
    - '<grey>Welcome back <aqua>${player name}</aqua>!'
    - '<grey>'
    - '<grey>Come and join <aqua>${server playersOnline}'
    - '<aqua>other players</aqua> <grey>on the Server!'

Random MOTD but same hover

v1.10.0 of AdvancedServerList introduced an option called profiles. It allows you to create multiple variants of an MOTD, playercount, etc. while also supporting the normal (global) options as a fallback.

The following example will create a profile that has a randomized MOTD, but the same hover for both:

priority: 1

profiles:
  - motd:
      - 'A randomized MOTD.'
      - 'Lines change, but hover is the same.'
  - motd: ['Different Syntax.', 'May be more readable.']

playerCount:
  hover:
    - 'This player count hover always'
    - 'stays the same, no matter what'
    - 'MOTD is being used here.'
⚠️ **GitHub.com Fallback** ⚠️