Skip to content

Dock Icon Change

By TelTelTey317Owner

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

<1,000 downloads Updated

No ratings yet

Be the first to rate it.

Rate it

Community listing page

Community listing page, reviews may not be monitored by the author.

About

Description

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