This is what you do if you want to change the server icon of your Minecraft server. The icon shows next to your server name in the Multiplayer server list. Minecraft reads it from a file called server-icon.png in your server's root directory. This works on Java Edition only. Bedrock Edition servers don't use server icons.
Preparing Your Server Icon
Minecraft only loads a 64x64 PNG. It ignores any other size or format.
- Open your image in an image editor and resize it to
64x64pixels. - Save it as a PNG named
server-icon.png.
Use a square image for the best result. Wide or tall images will look squashed once resized to 64x64. Transparent backgrounds stay transparent.
Uploading Your Server Icon
- Log in to the GhostCap Panel and
Stopyour Minecraft server. - Go to
File Manager. You can also use SFTP if you prefer. - Upload
server-icon.pngto the root directory of your server, next toserver.properties. Replace the old file if there is one. Startyour server.
Troubleshooting
The New Icon Doesn't Show
- Restart your server after changing the icon. Minecraft loads
server-icon.pngwhen the server starts. - In the Multiplayer menu, click
Refresh. Your game keeps the old icon until it pings the server again. - Check the file name. It must be
server-icon.pngin lowercase. Windows hides file extensions by default, so make sure the file isn't namedserver-icon.png.png.
Couldn't Load Server Icon
If your Console shows Couldn't load server icon or Must be 64 pixels wide, the file is the wrong size or format. Make sure it's a PNG that is exactly 64x64 pixels and upload it again.
Only Minecraft Java Edition servers use server-icon.png. Bedrock Edition servers don't read this file.
