The mod supports NeoForge and Fabric (*) mod loaders. Follow either mod loader's installation guide, then download the mod file for your Minecraft version from CurseForge or Modrinth, and install it into the .minecraft/mods folder.

(*) Fabric API is not required.

Run the game once to create the configuration file. By default, the window title will be set to Minecraft . Unlike in vanilla 1.15.2 onwards, the title will not change when you enter a world/server.

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

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

Only edit text inside quotes or apostrophes.

You can use the following special tokens in the title configuration entry:

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

If any of the tokens aren't working, search the game log for CustomWindowTitle and you should see the reason, otherwise please file an issue on the issue tracker with as many details as possible.

This feature is currently not supported in Minecraft 1.20+.

You must create two PNG images with sizes 16x16 and 32x32 pixels. The images must be saved with transparency even if they don't use it, otherwise the icons will appear corrupted. In Krita for example, you must check Store alpha channel (transparency) when saving the image.

The icon16 and icon32 configuration entries point to the PNG files relative to the .minecraft/config folder. For example, if you place the two icons in a folder named customwindowtitle as follows:

• .minecraft/config/customwindowtitle-client.toml
• .minecraft/config/customwindowtitle/icon16.png
• .minecraft/config/customwindowtitle/icon32.png

Then, the two icon entries should look like this:

icon16 = 'customwindowtitle/icon16.png'  
icon32 = 'customwindowtitle/icon32.png'

These screenshots were taken using the following example configuration:

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

The mod sources are organized into 3 projects:

• src/ contains common source files and mixins
• Fabric/src/ contains source files specific for Fabric
• NeoForge/src/ contains source files specific for NeoForge

The assemble Gradle task creates a single .jar file for both mod loaders in the build/dist folder.

When building against a Minecraft version that is only supported by one mod loader, open gradle.properties and comment or remove either neoForgeVersion or fabricVersion to disable them.