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
- 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.
No gallery available for this project.