?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Dock Icon Change

Dock Icon Change

Client-only mod that swaps Minecraft’s macOS Dock icon at startup.

49
1
49
1

Compatibility

Minecraft: Java Edition

1.21.1

Platforms

Supported environments

Client-side

Links

Report issues View source

Creators

Details

Licensed MIT
Published 5 months ago

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