Dock Icon Change

Quick rating

Dock Icon Change

No reviews yet

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

Mod Loaders
NeoForge
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Required
Server Unsupported

About

Project Details

Type
Mod
License
MIT License
Latest Version
1.0.0
Authors

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

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.

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
CurseForge
Modrinth
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works