ModsFinder

Dock Icon Change

by TelTelTey317

Dock Icon Change replaces the Minecraft icon in the macOS Dock at startup with a custom PNG image chosen by the player.

NeoForgeClient-side onlyMIT LicenseOpen source1.21.1

What it does

The mod is client-side only, so only the player's game needs it and servers can run without it. It targets macOS: on other operating systems it does nothing to the icon. Players point it at a custom PNG, and the Dock icon updates automatically each time the game launches. A recommended image is a square PNG at 512×512 or 1024×1024 with transparency.

Some launchers need JVM arguments before the Apple Dock API can be used, namely a flag that turns off headless mode and an export entry for the Apple extensions of the desktop module. The mod shows a warning screen at startup, which includes a checkbox to stop it from appearing again. Released under the MIT License, the code is open source. Files exist for NeoForge 1.21.1 only, with 1.0.0 as the latest file from 2025-12-31.

Key features

  1. Custom Dock icon

    Swaps the macOS Dock icon at game startup for a PNG image of the player's choice.

  2. Automatic icon update

    The new icon is applied each time the game launches, without further setup.

  3. In-game reload command

    A command reloads the icon while the game is running, which speeds up testing a new image.

  4. Startup warning screen

    A warning appears at startup and includes a checkbox to hide it in later launches.

Compatibility

Latest build for each game version and loader.

1.21.11.0.0
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Use cases

Modpack branding

Modpack makers and personal players can use a custom icon as a visual identity on macOS.

Personal aesthetic

A player who wants a distinct look for the Minecraft Dock entry can supply their own artwork.

Who it’s for: Players on macOS who want a custom Dock icon for Minecraft, including modpack makers using a branded icon. Since the mod is client-side, servers do not need it and players can join without installing it.

Questions

Does Dock Icon Change need to be installed on the server?

No. Only the player's game needs it, and servers run without it. Dedicated servers are safe to run without it.

Does Dock Icon Change work on other operating systems?

No. It replaces the icon only on macOS and has no effect on other operating systems.

Why does the launcher need extra JVM arguments?

Some launchers require a headless-off flag and an export entry for the Apple desktop extensions before the Dock API the mod uses can be reached.

What the author says

A client-only mod for macOS that replaces Minecraft’s Dock icon on startup. If you want a custom Dock icon for your modpack, server branding, or personal aesthetic, this makes it automatic and safe. Recommended image: square PNG, 512×512 or 1024×1024 with transparency.
TelTelTey317, on the Modrinth page

Official listing

Owner
TelTelTey317
Published
2025-12-31
Updated on Modrinth
2025-12-31
Facts verified
2026-10-15
Open on ModrinthCompare