Installation

From Matcha Flavoured Wiki
Jump to navigation Jump to search

Installing Matcha Flavoured requires both its datapack and its resource pack, for Minecraft: Java Edition 26.3, which the pack supports since 1.12.6-alpha. A port to 26.3 was first published as the 1.12.3 alpha, but 1.12.4 and 1.12.5 are for 26.2 only. The instructions below follow the README.[1]

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). From 1.12.3 the files are named MF_DP_…zip and MF_RP_…zip, and the datapack is also published as a mod file (.jar) for Fabric, Forge, NeoForge and Quilt. 1.12.4 and 1.12.5 updated only the datapack: their resource pack was still the 1.12.3 one.[2] 1.12.6-alpha, for 26.3, updates both again, as MFDP_…zip and MFRP_…zip. The datapack targets pack format 121.0 and the resource pack 97.1 (1.12.5 used 107.1 and 88.0, for 26.2).[3][4] From 1.12.7-beta the mod file (…+rdp.jar) contains the resource pack as well as the datapack; the release notes say it "seemed to work! Jank but its fine".[5]

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. A new world set to Hard is put on Normal when the first player joins, except in Hardcore.[6] See Difficulty#No Hard at the start.
  • 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.[7]
  • 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 by the pack's first-load setup, which runs once, when the first player joins a new world. Since 1.12.3 the pack remembers that the rules were set, so they stay as the server owner changed them; in 1.12.2 they were set again whenever a new player joined or a player first joined after an update.[8][9] See Death#Keeping items.

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.[10] 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.
A level number of 10000 shows above the hotbar The resource pack is not active, another resource pack above it sets the level text, or the game language is one whose resource pack file doesn't blank the level text (Finnish, which the pack doesn't translate, or Afrikaans; see Known bugs). The datapack sets every player's level to 10,000 so that anvil work never lacks levels, and the resource pack's language files replace the number with empty text. See Anvil#Experience.[11][12]
Signs being edited and books being read look blank The resource pack from 1.12.7-beta is active. Its text shader, which hid the level number, also hid all solid black interface text; the 1.12.8-beta shader hid such text only near the bottom of the screen, where the level number is drawn, and 1.12.9 has no text shader.[13][14]
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.

References

  1. ↑ README.md
  2. ↑ Matcha Flavoured 1.12.4 release notes: "The RP is unchanged, there no need to update it to 1.12.4"
  3. ↑ MF datapack/pack.mcmeta
  4. ↑ MF resourcepack/pack.mcmeta
  5. ↑ Matcha Flavoured 1.12.7-beta release notes: "I added the RP to the mod folder, I tested it, it seemed to work! Jank but its fine"
  6. ↑ setup/disallow hard on first load.mcfunction
  7. ↑ dimension type/overworld no true darkness.txt
  8. ↑ setup/first load.mcfunction
  9. ↑ setup/update this player.mcfunction
  10. ↑ setup/load.mcfunction
  11. ↑ xp handling/give levels.mcfunction
  12. ↑ lang/en us.json
  13. ↑ core/text.vsh
  14. ↑ Matcha Flavoured 1.12.8-beta release notes: "Signs and Books no longer appear blank"
Matcha Flavoured
About the pack
Getting started
Releases
Development
This wiki
Retrieved from "https://matchaflavou.red/w/Installation"