Minecraft Window Title Customization

Installation

The mod is compatible with NeoForge and Fabric () mod loaders. After installing the appropriate loader, download the mod file for your Minecraft version and place it in the .minecraft/mods folder.

() Fabric API is not required for operation.

Configuration Settings

Run the game once to automatically create the configuration file. By default, the window title will display as Minecraft . Unlike the standard Minecraft behavior starting from version 1.15.2, the title will not change when entering a world or server.

To change the title or icon, navigate to the .minecraft/config folder, open the customwindowtitle-client.toml file in a text editor. You will see the following parameters:

title = 'Minecraft {mcversion}'
icon16 = ''
icon32 = ''

Only modify text inside quotes or apostrophes.

Changing Window Title

In the title parameter, you can use special tokens:

• {mcversion} - current Minecraft version
• {modversion:<mod_id>} - version of installed mod with identifier <mod_id>
• {username} - current username

If any tokens are not working, check the game log for the keyword CustomWindowTitle to identify the cause. In case of issues, create a report with detailed description.

Window Icon Configuration

Minecraft 1.21+

This feature is only available in Custom Window Title version 1.4.0 and newer.

Create a square PNG image with dimensions that are powers of two (for example, 32x32 or 48x48). Place the PNG file in the .minecraft/config folder directly or in a subfolder.

The icon must be saved with transparency support, even if not used, otherwise the image may be corrupted or not displayed. For example, in Krita, you need to check the Store alpha channel (transparency) option when saving.

The icon parameter points to the PNG file path relative to the .minecraft/config folder.

For example, if you placed the icon in .minecraft/config/customwindowtitle/icon.png, the setting should look like this:

icon = 'customwindowtitle/icon.png'

Minecraft 1.20

This feature is not available in Minecraft 1.20.

Minecraft 1.19 and older

Instead of one icon parameter, two parameters icon16 and icon32 are used for icons sized 16x16 and 32x32 respectively.

Examples

The following screenshots were taken using example configuration:

title = "Minecraft {mcversion} - Custom Window Title {modversion:customwindowtitle}"