#831: Add a standard of annotations for Minecraft experimental things and API

By: Doc <nachito94@msn.com>
Also-by: 2008Choco <hawkeboyz2@hotmail.com>

paper-api/src/main/java/org/bukkit/MinecraftExperimental.java

@@ -0,0 +1,27 @@
+package org.bukkit;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+import org.jetbrains.annotations.ApiStatus;
+
+/**
+ * Indicates that the annotated element (class, method, field, etc.) is part of a
+ * <a href="https://minecraft.fandom.com/wiki/Experimental_Gameplay">minecraft experimental feature</a>
+ * and is subject to changes by Mojang.
+ * <p>
+ * <b>Note:</b> Elements marked with this annotation require the use of a datapack or otherwise
+ * non-standard feature to be enabled on the server.
+ *
+ * @see <a href="https://www.minecraft.net/en-us/article/testing-new-minecraft-features/feature-toggles-java-edition">Features Toggles - Minecraft Article</a>
+ */
+@Documented
+@Retention(RetentionPolicy.CLASS)
+@Target({
+        ElementType.TYPE, ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.FIELD, ElementType.PACKAGE
+})
+@ApiStatus.Internal
+public @interface MinecraftExperimental {
+}