Dock Icon Change

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

53 Downloads

neoforge

Rent Server with this Mod

About this Mod

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.

Available Versions

Dock Icon Change 1.0.0release

MC 1.21.1neoforge

December 31, 2025

How to Install Dock Icon Change on Your Server

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

Set neoforge Loader

In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).

Install Mod

Open the mod browser in the dashboard and search for "Dock Icon Change". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

neoforge

Minecraft Versions

1.21.1

Server-side

✗ Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Dock Icon Change server crashes on startup – what to do?

Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.

Is Dock Icon Change compatible with neoforge?

Dock Icon Change officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Dock Icon Change – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Dock Icon Change consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.