程序坞图标更改

程序坞图标更改

仅在客户端使用的模组,在启动时替换 Minecraft 的 macOS Dock 图标。

Dock 图标(NeoForge,macOS)

一个仅适用于 macOS 的客户端模组,在启动时替换 Minecraft 的 Dock 图标。如果你想为整合包、服务器品牌或个人审美定制 Dock 图标,这个模组可以让它自动且安全地实现。

功能

  • 仅限 macOS;在其他操作系统上不做任何操作
  • 仅客户端;专用服务器安全
  • 加载自定义 PNG 并在启动时替换 Dock 图标
  • 健壮的错误处理(图片缺失或无效时绝不崩溃)
  • 游戏内重载命令,便于快速迭代

使用方法

  1. 将你的 PNG 放在此处:
    • config/dock_icon.png
  2. 启动游戏——Dock 图标会自动更新。

推荐图片:方形 PNG,512×512 或 1024×1024,带透明通道。

配置

文件:config/dockicon-client.toml

  • iconPath(字符串) 你的 PNG 路径。 相对路径从 config/ 文件夹解析。支持 ~。

命令

  • /dockicon reload 无需重启游戏即可重载图标。

启动器说明(Prism 等)

某些启动器需要 JVM 参数才能启用 Apple Dock API。请添加:

-Djava.awt.headless=false --add-exports=java.desktop/com.apple.eawt=ALL-UNNAMED

启动时会显示警告界面,其中包含“不再显示”复选框。