Skip to main content

​
GUI Configuration

MultiLang provides a GUI (Graphical User Interface) for players to select their language. This guide covers how to configure and customize the GUI.

​
Overview

The GUI configuration file is located at plugins/MultiLang/gui.yml. In this file, you can add base64 textures for every language that will appear in the GUI.

​
What is Base64?

In simple terms, base64 is a string containing the texture of a player head (skin). It’s used to display custom icons in the language selection GUI.

​
How to Create a Base64

You can generate a base64 from a player head using MineSkin:
  1. Go to MineSkin.org
  2. Upload a skin or select a head
  3. Pick the Texture Signature value (this is your base64)
You can also use existing heads from Minecraft-Heads. In that case, pick the value field instead of the Texture Signature.

​
Visual Guide

Here’s a simple guide showing how to get the base64: Base64 Guide

​
Adding Base64 to a Language

To add a base64 texture to a new language, add it to the gui.yml file: 
base:
  # Existing bases...
  "your-awesome-lang": "your awesome base64"

​
Example

base:
  english: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
  italiano: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
  español: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
  "your-awesome-lang": "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
Make sure that you have already created the language in the languages section of your config.yml before adding it to the GUI.

​
Language Name Matching

The language name in gui.yml must match exactly with the language name in your config.yml languages section. Example: config.yml: 
languages:
  english: "en_us"
  italiano: "it_it"
  español: "es_es"
gui.yml: 
base:
  english: "base64_here"
  italiano: "base64_here"
  español: "base64_here"

​
Complete Example

Here’s a complete example of a GUI configuration: 
base:
  english: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
  italiano: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
  español: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
  français: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
  deutsch: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="

​
Default Base

You can also set a default base64 in your config.yml: 
default-base: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvIn19fQ=="
This will be used for languages that don’t have a specific base64 defined in gui.yml.

​
Best Practices

  1. Use appropriate icons - Choose icons that represent the language (e.g., flag icons, country symbols)
  2. Keep it consistent - Use a consistent style for all language icons
  3. Test the GUI - Always test the GUI in-game to make sure icons display correctly
  4. Match language names - Ensure language names match exactly between config.yml and gui.yml

​
Troubleshooting

Q: Icons aren’t showing up
A: Make sure:
  • The base64 string is correct and complete
  • The language name matches exactly between config.yml and gui.yml
  • You’ve restarted the server after making changes
Q: Some languages don’t have icons
A: Languages without a base64 in gui.yml will use the default-base from config.yml, or show a default head if no default is set. Q: Base64 is invalid
A: Make sure:
  • You copied the complete base64 string
  • You’re using the Texture Signature from MineSkin (not the Texture Value)
  • The base64 is properly formatted