Dock Icon Change

Dock 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

1. Place your PNG here:

• config/dock_icon.png

1. 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.