Tags

Wyck models Minecraft tags with two types:

• TagKey: a named reference to a tag, like minecraft:logs. It points at a tag and does not carry its contents.
• TagSet: a group of entries that is either an explicit set of elements or a reference to a named tag.

TagSet wraps vanilla’s HolderSet and TagKey, which is either an inline list, or a tag. Anywhere worldgen accepts a group of blocks, it accepts either form.

Tag Keys

A TagKey is a ResourceKey plus the registry the tag lives in.

Examples.java Java Copy

import dev.wyck.tags.TagKey;
import dev.wyck.keys.ResourceKey;
import org.bukkit.Tag;

// Reference a vanilla tag by identifier.
TagKey logs = TagKey.blocks(ResourceKey.of("minecraft:logs"));

// Or reuse a Bukkit tag constant.
TagKey leaves = TagKey.blocks(Tag.LEAVES);

Tag Sets

A TagSet holds one of two things, and isBlockSet() or isTag() tell you which:

• A set of elements: listed explicitly, e.g. stone and dirt.
• A tag reference: a TagKey pointing at a named tag.

Examples.java Java Copy

import dev.wyck.tags.TagSet;
import dev.wyck.keys.ResourceKey;
import org.bukkit.Material;

// An explicit set of blocks — no name, so it cannot be registered.
TagSet<Material> ores = TagSet.ofBlocks(Material.IRON_ORE, Material.GOLD_ORE);

// A reference to a tag that already exists.
TagSet<Material> logs = TagSet.ofBlockTag(ResourceKey.of("minecraft:logs"));

Registering a Tag Set

register() binds a named set of elements into the registry as a new tag, afterwards the tag behaves like any other tag.

Examples.java Java Copy

import dev.wyck.tags.TagSet;
import dev.wyck.keys.ResourceKey;
import org.bukkit.Material;

TagSet.ofBlocks(ResourceKey.of("wyck:test_tag"), Material.STONE, Material.DIRT)
  .register();

      // Now referenceable like any other tag.
      TagSet<Material> reference = TagSet.ofBlockTag(ResourceKey.of("wyck:test_tag"));

Here’s an example of creating (and registering) a TagSet with a builder:

Examples.java Java Copy

import dev.wyck.tags.TagSet;
import dev.wyck.keys.ResourceKey;
import org.bukkit.Material;

TagSet<Material> tag = TagSet.blocks()
  .resourceKey(ResourceKey.of("wyck:my_tag"))
  .values(Material.STONE, Material.DIRT)
  .register(); // Use #build() instead if you don't want to register it!

Adding to an Existing Tag

append() adds a named set of elements to the tag already registered under that key, keeping the tag’s existing entries. If no tag exists under the key, it creates one.

Anything already using the tag sees the new entries, including structures in worlds that are already loaded.

Examples.java Java Copy

import dev.wyck.biome.Biome;
import dev.wyck.keys.ResourceKey;
import dev.wyck.tags.TagSet;

TagSet.ofBiomes(
  ResourceKey.of("minecraft", "has_structure/village_plains"),
  Biome.reference(ResourceKey.of("wyck", "example"))
).append();