Data Packs - Tags

Tags are a vanilla Minecraft feature, used to give properties to specific items (if within the tags\items directory) or blocks (if within tags\blocks directory). Item tags also used for Ore Dictionary behaviors. Tags apply a property based on the file name: \data\minecolonies\tags\blocks\concrete.json applies a #minecolonies:concrete tag to all blocks matching the Resource Locations contained within it or within Block Tags matching that Resource Location, and that #minecolonies:concrete block tag determines what materials a Concrete Mixer can mine.

All Tag JSONs operate in merge mode by default. They can instead override, removing any other blocks or items from JSONs matching that name that were loaded first. To use override mode, you must explicitly set "replace": true in addition to the "values": "" name-value pair. This "replace" name is not mandatory for merge mode, but for ease of readability, it's strongly encouraged to use "replace": false if intentionally adding to existing Tags.

The only other supported name-value pair for a Tag JSON is the "value": Name. This accepts an Array of identifiers or tags as individual Resource Location strings. These string must contain the namespace and an item identifier in resource location format, matching either a single object of that tag's type, or another Tag prefixed by the # symbol. Missing or mistyped targets may cause the file to be ignored, or for Minecraft to throw an error on world load. Use the Advanced Tooltip functionality (F3 + H) in Minecraft to turn on display of Resource Locations in item tooltips for help finding specific strings.

A typical tag file to add cobblestone and every type of vanilla anvil to a Tag would thus look like:

{
    "replace": false,
    "values": [
      "minecraft:cobblestone",
      "#minecraft:anvil"
    ]
}

While this example works for both Blocks and Items, it's a rare exception. Block Tags and Item Tags are entirely different things, and while some Block Tags have Item Tag equivalents, many do not. Some mods will only use Item Tags or Block Tags; some items, even vanilla items, have different Resource Locations when in Item form than in Block form.

Block Tags

Block Tags are loaded in the tags/blocks directory. MineColonies reads the following Block Tags:

Item Tags

Item Tags are loaded in the tags\items directory. MineColonies reads the following Item Tags:

Some Vanilla and Forge Item Tags are very expansive, or are used by some mods in ways that might surprise you. See list of tags for Minecraft behaviors.

Crafter Item Tags

Additionally, some Item Tags are used to control what recipes can be taught to a worker by a player in-game. Each worker has a different set of tags. For a full list, see here.

A few colonists have other hard-coded rules that are not dependent on tags. The Blacksmith can make all tools, swords, armor, hoes, and shields. Cook will always accept recipes for items that have valid foods as results.

If changes are needed or you think there is content missing, feel free to edit this page or submit an issue for us to make edits. - MineColonies Wiki Team