Skip to content

Favicons

Minecrell edited this page Apr 29, 2021 · 11 revisions

Contents: Introduction | Favicon Sources | Configuration | Player Heads | Additional Examples

As of ServerListPlus v3.2, you can add multiple (randomly chosen) favicons to you server status. The plugin can load them from different sources, for example files, folders or URLs. Here is an example:

As you can see, Notch's head is displayed there. You can use the player's head as your favicon - refer to Player Heads for more information about this feature.

Favicon Sources

ServerListPlus can load the plugin from a lot of different sources.

  • Files - Load from a specified file name or file path. Supported formats: .png (recommended), .jpg, .bmp, .gif (not animated)
  • Folders - Search for favicon images in the specified folder.
  • URLs - Load from the Internet using a specified URL.
  • Heads - Load favicon using a skin name. See Player Heads for more information. v3.2.2+
  • Helms - Works like Heads but adds the helm to the favicon additionally. v3.2.2+
  • Encoded - Advanced use only. Embed favicons directly into your configuration as Base64 encoded image string.

Configuration

The configuration of the favicons is done in the Favicon section of the server status configuration. You can add a new list with entries for all of the supported sources above. If you add multiple sources one will be randomly chosen. Please refer to the examples for some examples.

There are also additional settings in the plugin configuration: v3.2.2+

  • RecursiveFolderSearch - Also searches for favicons in sub folders when using the Folders source.
  • SkinSource - The URL where the plugin gets the Minecraft Skins. Mojang's URL by default.
  • ResizeStrategy - The plugin will resize too small or too big favicons by default (SCALE). If you don't want that set it to NONE.

Player Heads

Requires ServerListPlus v3.2.2 or newer. See the page history for older versions of the plugin. (Updating is recommended.)

Do you want to use the head of the player as favicon? That's easy! You can do this directly without any additional third-party services!

  1. Display the default head (Steve) as default favicon (for unknown players) - skip this step if you want to use your server icon instead.
    Add this to your Default configuration section:
  Favicon:
    Heads:
    # Default skin
    - steve
  1. Display the player's head as favicon!
    Add this to your Personalized configuration section:
  Favicon:
    # Use the head of the player's skin
    Heads:
    - '%uuid%'

Note: If you want to add the helm of the skin to the favicon you can use Helms instead of Heads.

Additional Examples

Here are some additional examples of the favicon configuration so you can understand it better:

Use 2 randomly chosen favicons from favicon1.png and favicon2.png in the plugin folder.

  Favicon:
    # The file names here should be relative to the plugin folder.
    Files:
    - favicon1.png
    - favicon2.png

Load all favicon files from the icons folder of the plugin.

  Favicon:
    # The file names here should be relative to the plugin folder.
    Folders:
    - icons

Remove favicon

If you have a favicon set by default but want to remove it (e.g. for a virtual host) you can use:

  Favicon: off

Or alternatively:

  Favicon:
    Disabled: yes

Display a perspective head of the player using Visage.

Note: This service is not provided by us, but it is open source. We have no control over the returned images.
Use it at your own risk.

  1. Display the default perspective head (Steve) as default favicon (for unknown players) - skip this step if you want to use your server icon instead.
    Add this to your Default configuration section:
  Favicon:
    URLs:
    # Visage uses X-Steve to indicate the default skin
    - https://visage.surgeplay.com/head/64/X-Steve
  1. Display the player's perspective head as favicon!
    Add this to your Personalized configuration section:
  Favicon:
    URLs:
    - https://visage.surgeplay.com/head/64/%_uuid_%

Note: You must use https, and not http. The helm will always be included in the response. At this time, there is no way to disable it.

You can also display a bust of the player, by using /bust/64/ instead of /head/64/, like below:

  Favicon:
    URLs:
    - https://visage.surgeplay.com/bust/64/%_uuid_%