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.icoThe 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.
File requirements
Section titled “File requirements”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 or update the icon
Section titled “Publish or update the 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 result
Section titled “Check the result”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. |