feat(api)!: bump to 20.0.0-SNAPSHOT

Updates API to align with Minecraft 26.2 breaking changes. Removes ProcessorType and ProcessorTypes, collapsing their functionality into Processors. Processor parsing and serialization updated accordingly.

See: https://minecraft.wiki/w/Java_Edition_26.2-snapshot-1

Author: gabizou

gradle.properties

@@ -1,5 +1,5 @@
 group=org.spongepowered
-version=19.0.0-SNAPSHOT
+version=20.0.0-SNAPSHOT
 organization=SpongePowered
 projectUrl=https://www.spongepowered.org
 projectDescription=A plugin API for Minecraft: Java Edition

src/main/java/org/spongepowered/api/registry/RegistryTypes.java

@@ -195,7 +195,6 @@
 import org.spongepowered.api.world.generation.structure.StructureType;
 import org.spongepowered.api.world.generation.structure.jigsaw.JigsawPool;
 import org.spongepowered.api.world.generation.structure.jigsaw.ProcessorList;
-import org.spongepowered.api.world.generation.structure.jigsaw.ProcessorType;
 import org.spongepowered.api.world.schematic.PaletteType;
 import org.spongepowered.api.world.server.WorldArchetypeType;
 import org.spongepowered.api.world.teleport.TeleportHelperFilter;
@@ -272,8 +271,6 @@ public final class RegistryTypes {
 
     public static final DefaultedRegistryType<ProcessorList> PROCESSOR_LIST = RegistryTypes.minecraftKeyInServer("worldgen/processor_list");
 
-    public static final DefaultedRegistryType<ProcessorType> PROCESSOR_TYPE = RegistryTypes.minecraftKeyInGame("worldgen/structure_processor");
-
     public static final DefaultedRegistryType<ProfessionType> PROFESSION_TYPE = RegistryTypes.minecraftKeyInGame("villager_profession");
 
     public static final DefaultedRegistryType<PushReaction> PUSH_REACTION = RegistryTypes.spongeKeyInGame("push_reaction");

src/main/java/org/spongepowered/api/world/generation/structure/jigsaw/Processor.java

@@ -24,24 +24,71 @@
  */
 package org.spongepowered.api.world.generation.structure.jigsaw;
 
+import org.spongepowered.api.ResourceKey;
+import org.spongepowered.api.Sponge;
 import org.spongepowered.api.data.persistence.DataContainer;
+import org.spongepowered.api.data.persistence.DataView;
+import org.spongepowered.api.registry.RegistryHolder;
+
+import java.io.IOException;
 
 /**
  * A structure processor affecting blocks in a structure.
+ *
+ * <p>Minecraft 26.2-snapshot-1 collapsed the previous split between a
+ * processor instance and a standalone "processor type" object. A processor now
+ * carries its own codec, and the vanilla {@code
+ * minecraft:worldgen/structure_processor} registry stores those codecs keyed
+ * by {@link ResourceKey resource keys}. See {@link Processors} for the set of
+ * vanilla-provided processor IDs.</p>
  */
 public interface Processor {
 
     /**
-     * Returns the type of processor
+     * Parses a {@link Processor} of the given registry ID from a serialized
+     * {@link DataView configuration}.
+     *
+     * <p>The {@link RegistryHolder} is required because processor codecs may
+     * reference holder entries from other registries (tags, block states,
+     * etc.) during deserialization.</p>
+     *
+     * @param registries the registry holder used to resolve holder references
+     * @param id the registry ID of the processor, as registered in {@code
+     *     minecraft:worldgen/structure_processor} (see {@link Processors})
+     * @param config the serialized processor configuration
+     * @return the parsed processor
+     * @throws IOException if the configuration is malformed or the ID is
+     *     unknown
+     */
+    static Processor parse(final RegistryHolder registries, final ResourceKey id, final DataView config) throws IOException {
+        return Sponge.game().factoryProvider().provide(Factory.class).parse(registries, id, config);
+    }
+
+    /**
+     * Returns the registry ID of this processor.
+     *
+     * <p>This is the key under which this processor's codec is registered in
+     * the {@code minecraft:worldgen/structure_processor} registry.</p>
      *
-     * @return The type of processor
+     * @return the processor registry ID
      */
-    ProcessorType type();
+    ResourceKey type();
 
     /**
-     * Returns the processor configuration
+     * Returns the processor configuration.
      *
-     * @return The processor configuration
+     * @return the processor configuration
      */
     DataContainer toContainer();
+
+    /**
+     * Implementation-provided factory for {@link Processor}.
+     */
+    interface Factory {
+
+        /**
+         * @see Processor#parse(RegistryHolder, ResourceKey, DataView)
+         */
+        Processor parse(RegistryHolder registries, ResourceKey id, DataView config) throws IOException;
+    }
 }

src/main/java/org/spongepowered/api/world/generation/structure/jigsaw/ProcessorType.java

@@ -0,0 +1,65 @@
+/*
+ * This file is part of SpongeAPI, licensed under the MIT License (MIT).
+ *
+ * Copyright (c) SpongePowered <https://www.spongepowered.org>
+ * Copyright (c) contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package org.spongepowered.api.world.generation.structure.jigsaw;
+
+import org.spongepowered.api.ResourceKey;
+
+/**
+ * Registry IDs of the vanilla {@link Processor structure processors}.
+ *
+ * <p>Since Minecraft 26.2-snapshot-1, processor kinds are no longer
+ * represented by a per-kind object in SpongeAPI — the vanilla registry stores
+ * codecs directly. This class holds the stable {@link ResourceKey} identifiers
+ * of the processors provided by vanilla, suitable for passing to
+ * {@link Processor#parse(org.spongepowered.api.registry.RegistryHolder,
+ * ResourceKey, org.spongepowered.api.data.persistence.DataView)}.</p>
+ */
+public final class Processors {
+
+    public static final ResourceKey BLACKSTONE_REPLACE = ResourceKey.minecraft("blackstone_replace");
+
+    public static final ResourceKey BLOCK_AGE = ResourceKey.minecraft("block_age");
+
+    public static final ResourceKey BLOCK_IGNORE = ResourceKey.minecraft("block_ignore");
+
+    public static final ResourceKey BLOCK_ROT = ResourceKey.minecraft("block_rot");
+
+    public static final ResourceKey CAPPED = ResourceKey.minecraft("capped");
+
+    public static final ResourceKey GRAVITY = ResourceKey.minecraft("gravity");
+
+    public static final ResourceKey JIGSAW_REPLACEMENT = ResourceKey.minecraft("jigsaw_replacement");
+
+    public static final ResourceKey LAVA_SUBMERGED_BLOCK = ResourceKey.minecraft("lava_submerged_block");
+
+    public static final ResourceKey NOP = ResourceKey.minecraft("nop");
+
+    public static final ResourceKey PROTECTED_BLOCKS = ResourceKey.minecraft("protected_blocks");
+
+    public static final ResourceKey RULE = ResourceKey.minecraft("rule");
+
+    private Processors() {
+    }
+}