
Dock Icon Change
Java mod listed for Minecraft 1.21. Downloads from the MC Java Mods app on Android.
⬇ Download on ModrinthDock Icon (NeoForge, macOS)
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.
Features
- macOS‑only; does nothing on other OSes
- Client‑only; dedicated servers are safe
- Loads a custom PNG and swaps the Dock icon at startup
- Robust error handling (never crashes on missing/invalid image)
- In‑game reload command for quick iteration
How to Use
- Place your PNG here:
- config/dock_icon.png
- Launch the game — the Dock icon updates automatically.
Recommended image: square PNG, 512×512 or 1024×1024 with transparency.
Configuration
File: config/dockicon-client.toml
- iconPath (string) Path to your PNG. Relative paths are resolved from the config/ folder. ~ is supported.
Commands
- /dockicon reload Reloads the icon without restarting the game.
Launcher Notes (Prism, etc.)
Some launchers require JVM arguments to enable the Apple Dock API. Add:
-Djava.awt.headless=false --add-exports=java.desktop/com.apple.eawt=ALL-UNNAMED
A warning screen appears on startup and includes a “don’t show again” checkbox.
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as dockicon-1.0.0.jar — drop this file into the mods folder
- Download size: 446 KB
- Download link checked 22 Oct 2026 — working
These come from our own check of the pack file, not from the source page.