README.md

Workspace Detection

Want to use Datapack Icons only for Minecraft projects? When enabled, this feature automatically switches your active icon theme to mc-dp-icons whenever it detects a Minecraft project in your current workspace. It works by scanning for pack.mcmeta, Bedrock manifest.json, Beet or JMC config files. If not found, it restores your default icon theme. You can define a specific fallback theme in the settings or let the extension default to your previously active theme.

Special Function Icons

By default, .mcfunction files use the standard chain command block icon. Since functions usually make up the vast majority of files in a datapack, it can be difficult to tell your core logic apart from the rest. To help you visually prioritize important files, the extension offers several special command block icons!

Functions listed in your tick.json and load.json files automatically receive repeating and impulse command block icons.

You can also manually assign the repeating and impulse command block icons to any file, alongside three special crowned variants ( ) specifically designed to highlight your most important functions.

To assign a custom icon, right-click any function file and use the Datapack Icons: Set Icon menu. Alternatively, you can use the settings to assign icons by file name. For maximum precision, it is recommended to specify the direct parent folder name (e.g., subfolder/file) rather than using just the file name. GlobPatterns are also supported (e.g., *_setup, *helper*, or phase_[0-9]) to easily match multiple files at once.

Subfolder Icons

Due to VS Code API limitations, special icons can only be assigned to files directly inside a category folder (e.g., data/namespace/item_modifier/file.json). Enabling this option activates a workaround that bypasses this restriction, ensuring that nested files like data/namespace/item_modifier/subfolder/file.json get their specific icon rather than a generic one. Not recommended for extremely large workspaces. This requires a pack.mcmeta file at the root of the pack.

Namespace Icons

Namespace folders (directories directly within data or assets) receive an ender chest icon. This requires a pack.mcmeta file at the root of the pack.

Overlay Icons

Overlay folders (directories at the pack root registered as overlays in pack.mcmeta) receive a glass chest icon.

Christmas Icons

Similar to Minecraft, the extension changes all chest icons to their festive Christmas variants during December 24-26 ( → ). This feature can be disabled or enabled to work at any time in the settings.

Hide Folder Arrows

Hides the default expand/collapse arrows next to folder icons in the VS Code Explorer to make your workspace feel less cluttered.