Installation

Installing Matcha Flavoured requires both its datapack and its resource pack, for Minecraft: Java Edition 26.2. The instructions below follow the README.

Files

Up to 1.12.1-alpha, the download was a single archive that works as both the datapack and the resource pack. From 1.12.2-beta they are separate Modrinth files (Matcha_DP_…zip and Matcha_RP_…zip). The datapack targets pack format 107.1 and the resource pack 88.0.

New world

1. When creating the world, open the More tab, click Datapacks and then Open Pack Folder.
2. Copy the zipped datapack into that folder and move it to the Selected column.
3. Add the resource pack in Options → Resource Packs.
4. Create the world. If chat shows "Matcha Flavoured is now loaded on version …", the pack is working. If textures are missing, the resource pack is not active.

Existing world

Select the world, click Edit and then Open World Folder, and copy the datapack into the datapacks folder. The README advises against adding the pack to an existing world, because items have been "shuffled around"; players who do so should enable cheats to fix what breaks.

Modrinth launcher

The Modrinth app installs the pack only as a resource pack, because datapacks are per-world. The datapack must still be added to each world by hand.

Servers

Place the datapack in the world's datapacks folder and have players use the resource pack. The README notes a known problem on Purpur servers, where keep inventory is set per dimension and must be set manually. See Multiplayer.

Options

• Difficulty: the pack reads the world difficulty on load. After changing it, reload the world (or run /reload). The load message confirms the difficulty. See Difficulty.
• True darkness: to turn it off, delete data/minecraft/dimension_type/overworld.json in the datapack and rename overworld_no_true_darkness.txt to overworld.json, then restart the world.
• Accessibility: the README links an accessible version of the resource pack and a community resource pack with vanilla-style textures.
• Gamerules such as keep inventory are set only the first time the pack loads, so they can be changed afterward.

Updating

Replace both the datapack and resource pack files. Seeing a name such as item.kleispack.filler means only the datapack was updated. Items from before 1.12.2 may need /trigger update_item. See Updating items.

Troubleshooting

Symptom	Likely cause
No "Matcha Flavoured is now loaded" message in chat	The datapack is not enabled in this world. The message is printed by the pack's load function, so it appears on every world load and /reload once the datapack is active. See #Existing world.
The message appears, but items show plain vanilla textures or raw names such as item.kleispack.…	The resource pack is not active. Names and textures come from the resource pack, so both halves are needed.
Textures work, but the pack's recipes, items and advancements are missing	Only the resource pack is installed; add the datapack to the world.
Mobs behave differently from what the wiki describes	The pack reads the difficulty only when it loads. Reload the world or run /reload after changing it.
Everything works, but it is unclear what to do next	See Guide for new players and the advancements.