Game Servers & OuiPanel•December 12, 2025• 20 views

How to add an icon to your Minecraft server

How to add an icon to your Minecraft server

How to Add an Icon to Your Minecraft Server

Estimated Time: 5 minutes
Difficulty: Beginner ⭐

📋 Introduction

The server icon is the small image that appears in the Minecraft multiplayer server list. It allows players to easily recognize your server among others.

Edition Icon Support File Format
☕ Java Edition ✅ Supported server-icon.png PNG 64×64
🪨 Bedrock Edition ❌ Not Supported — —

⚠️ Important: Minecraft Bedrock Edition does not support custom server icons. Only official partner servers (Hive, CubeCraft, etc.) have them through a special agreement with Mojang.

☕ Java Edition Server

The 3 Mandatory Rules

Your icon must strictly adhere to these criteria:

Criterion Required Value
📐 Dimensions Exactly 64 × 64 pixels
🖼️ Format PNG only (.png)
📝 File Name server-icon.png (exactly)

💡 Tip: Icons support transparency (PNG with transparent background).

🚀 Installation in 4 Steps

Step 1: Prepare Your Image

Use an Online Converter (Recommended)

These tools automatically resize and convert your image to the correct format:

Tool Link
🔧 MC Utils mcutils.com/server-icon-converter
🔧 Xyrios xyrios.com/minecraft/tools/server_icon
🔧 Online PNG Tools onlinepngtools.com/resize-png

Procedure:

  1. Go to one of the above tools
  2. Upload your image (logo, drawing, etc.)
  3. The tool automatically converts it to 64×64 pixels
  4. Download the server-icon.png file to your computer

Check Your Image Dimensions

On Windows:

  1. Right-click on the file → Properties
  2. Tab Details
  3. Verify that the dimensions show 64 x 64

On macOS:

  1. Right-click → Get Info
  2. Check the dimensions in the "More Info" section

Step 2: Stop Your Server

  1. Log in to OuiPanel
  2. Select your Minecraft server
  3. Click Stop and wait for complete shutdown

⚠️ The server must be stopped before uploading the icon.

Step 3: Upload the Icon

  1. In OuiPanel, go to the File Manager
  2. You are in the root directory of your server (you should see files like server.jar, server.properties, etc.)
  3. Click Upload or Send a file
  4. Select your server-icon.png file
  5. Ensure the file appears at the root:
📁 Server Root
├── 📄 server.jar
├── 📄 server.properties
├── 📄 eula.txt
├── 🖼️ server-icon.png    ← Your icon here!
├── 📁 world/
├── 📁 plugins/
└── ...

⚠️ Watch the Name! The file must be named exactly server-icon.png (all lowercase, with the hyphen).

Step 4: Restart and Verify

  1. In OuiPanel, click Start to restart your server
  2. Launch Minecraft Java Edition on your PC
  3. Go to Multiplayer
  4. Click Refresh (or remove/re-add your server)
  5. ✅ Your icon will display next to the server name!

🪨 Bedrock Edition Server

Why Doesn't It Work?

Minecraft Bedrock Dedicated Server does not support custom server icons. This is a limitation from Mojang, not OuiHeberg.

Bedrock players will only see the default Minecraft icon in their server list.

Alternative: GeyserMC

If you absolutely want a visible icon for Bedrock players, you can use GeyserMC:

  1. Host a Java Edition server (Paper, Spigot, etc.)
  2. Install the Geyser and Floodgate plugins
  3. Set up your server-icon.png as usual
  4. Bedrock players can join your Java server and will see the icon

📖 GeyserMC allows Bedrock players to join Java servers. More information at geysermc.org

🔧 Troubleshooting

Icon Not Displaying

❌ Issue ✅ Solution
Incorrect file name Rename to exactly server-icon.png
Wrong dimensions Use a converter to get 64×64
Incorrect format Ensure it's a true PNG (not a renamed JPG)
Wrong location Place at the root of the server, not in a subfolder
Minecraft cache Delete the server from the list and re-add it
Server not restarted Restart the server after uploading

How to Check If My Image Is Really in PNG?

If you are unsure about the actual format of your image:

  1. Use one of the mentioned online converters above
  2. Upload your image
  3. Download the result → you will have a true PNG file 64×64

Blurry Icon

  • Use a high-quality source image (at least 256×256 pixels)
  • Opt for simple designs with few details
  • Use contrasting colors

💡 Design Tips

The icon is only 64×64 pixels, so keep a simple and readable design:

Server Type Icon Ideas
🏕️ Survival Pickaxe, heart, hut
⚔️ PvP Sword, flames, skull
🎨 Creative Colorful block, palette
🎮 Mini-games Star, trophy
🎭 Roleplay Character, scroll

Best practices:

  • ✅ Bright and contrasting colors
  • ✅ Simple and recognizable shapes
  • ✅ Very short text (1-2 letters max) or no text
  • ❌ Avoid details too fine (invisible at 64×64)

📝 Summary

✅ Java Edition:
   1. Convert the image to 64×64 PNG → mcutils.com
   2. Name the file "server-icon.png"
   3. Stop the server in OuiPanel
   4. Upload to the root via the file manager
   5. Restart the server
   6. Refresh the list in Minecraft

❌ Bedrock Edition:
   Not supported by Mojang.
   Alternative → Use GeyserMC on a Java server.

📚 Useful Links

Resource Link
MC Utils Converter mcutils.com/server-icon-converter
Xyrios Converter xyrios.com/minecraft/tools/server_icon
GeyserMC (crossplay) geysermc.org
Back to Documentation