Skip to content

Game icon

Place a Windows ICO file at branding/icon.ico under the client resource root. With resources.pack.path = "client", use:

client/
└── branding/
└── icon.ico

The client selects the file automatically and applies it to the running game’s window and taskbar icon. Your launcher’s icon is configured separately when packaging the launcher.

The file must be a valid, non-empty Windows ICO, up to 4 MiB in size. Include several image sizes, such as 16×16, 32×32, 48×48 and 256×256 pixels. Windows selects an image for the requested icon size and display scaling.

Missing, unreadable, oversized or invalid files use the built-in icon.

Publish the resources and restart the server to select the new release. Clients apply the icon on their next launch or when reconnecting installs the updated release. An icon-only update does not require a GTA restart.

The icon uses the same packaging and encryption settings as the other client resources. With encryption enabled, it is decoded in memory when loaded.

To restore the default icon, remove branding/icon.ico from the client sources and publish a new release.

Check the running game’s taskbar icon and its window icon in windowed mode. If the icon looks blurred at a particular display scale, include an appropriate image size in the ICO file.

If the built-in icon appears instead, check the file’s location, format and size, then confirm that the client received the release containing your changes. The client logs identify read and decoding failures:

Message Check
Could not load project icon Check the reported reason, including an empty file, the size limit or a read failure.
Project icon could not be decoded Export the image as a valid Windows ICO and publish it again.