Prepare distribution

.github/workflows/build.yml

@@ -38,7 +38,7 @@ jobs:
           ORG_GRADLE_PROJECT_signingKey: ${{ secrets.SIGNING_KEY }}
           ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.SIGNING_PASSWORD }}
       - name: Publish Snapshot
-        if: ${{ runner.os == 'Linux' && env.STATUS != 'release' && github.event_name == 'push' && github.ref == 'refs/heads/main' }}
+        if: ${{ runner.os == 'Linux' && env.STATUS != 'release' && github.event_name == 'push' && github.ref == 'refs/heads/cloud-beta' }}
         run: ./gradlew publishToSonatype
         env:
           ORG_GRADLE_PROJECT_sonatypeUsername: ${{ secrets.SONATYPE_USERNAME }}

.github/workflows/upload-release-assets-.yml

@@ -1,7 +1,7 @@
 name: Upload release assets
 on:
     release:
-        types: [published]
+        types: [published, prereleased]
 jobs:
     upload_asset:
         runs-on: ubuntu-latest
@@ -41,6 +41,6 @@ jobs:
                 game_endpoint: minecraft
                 token: ${{ secrets.CURSEFORGE_TOKEN }}
                 display_name: FastAsyncVoxelSniper ${{ github.event.release.tag_name }}
-                release_type: release
+                release_type: beta
                 changelog: "Click here to view changelog: https://github.com/IntellectualSites/fastasyncvoxelsniper/releases/tag/${{ github.event.release.tag_name }}"
                 changelog_type: markdown

build.gradle.kts

@@ -59,7 +59,7 @@ configurations.all {
 }
 
 group = "com.intellectualsites.fastasyncvoxelsniper"
-version = "2.9.5-SNAPSHOT"
+version = "3.0.0-SNAPSHOT"
 
 bukkit {
     name = "FastAsyncVoxelSniper"
@@ -205,7 +205,7 @@ modrinth {
     projectId.set("fastasyncvoxelsniper")
     versionName.set("${project.version}")
     versionNumber.set("${project.version}")
-    versionType.set("release")
+    versionType.set("beta") // TODO Change after 3.x release
     uploadFile.set(file("build/libs/${rootProject.name}-${project.version}.jar"))
     gameVersions.addAll(supportedVersions)
     loaders.addAll(listOf("paper", "purpur", "spigot"))
@@ -221,7 +221,7 @@ hangarPublish {
     publications.register("plugin") {
         version.set(project.version as String)
         id.set("FastAsyncVoxelSniper")
-        channel.set("Release")
+        channel.set("Prerelease") // TODO Change after 3.x release
         changelog.set("The changelog is available on GitHub: https://github" +
                 ".com/IntellectualSites/fastasyncvoxelsniper/releases/tag/${project.version}")
         apiKey.set(System.getenv("HANGAR_TOKEN"))

src/main/java/com/thevoxelbox/voxelsniper/CommandRegistrar.java

@@ -44,7 +44,7 @@ public CommandRegistrar(VoxelSniperPlugin plugin, CommandRegistry registry) {
     /**
      * Register the suggestions and parsers into the command manager.
      *
-     * @since TODO
+     * @since 3.0.0
      */
     public void registerSuggestionsAndParsers() {
         registerBiomeTypeArgument();

src/main/java/com/thevoxelbox/voxelsniper/VoxelSniperPlugin.java

@@ -264,7 +264,7 @@ public PatternParser getPatternParser() {
      * Return the command manager.
      *
      * @return the command manager
-     * @since TODO
+     * @since 3.0.0
      */
     public CommandRegistry getCommandRegistry() {
         return this.commandRegistry;

src/main/java/com/thevoxelbox/voxelsniper/brush/BrushRegistry.java

@@ -30,7 +30,7 @@ public void register(BrushProperties properties) {
      * Return the unique brushes properties.
      *
      * @return the unique brushes properties
-     * @since TODO
+     * @since 3.0.0
      */
     public Set<BrushProperties> getUniqueBrushesProperties() {
         return uniqueBrushesProperties;

src/main/java/com/thevoxelbox/voxelsniper/brush/PerformerBrush.java

@@ -13,15 +13,15 @@ public interface PerformerBrush extends Brush {
      * Return the performer.
      *
      * @return the performer
-     * @since TODO
+     * @since 3.0.0
      */
     Performer getPerformer();
 
     /**
      * Set the performer.
      *
      * @param performer the performer
-     * @since TODO
+     * @since 3.0.0
      */
     void setPerformer(Performer performer);
 

src/main/java/com/thevoxelbox/voxelsniper/command/CommandRegistry.java

@@ -96,7 +96,7 @@ public CommandRegistry(VoxelSniperPlugin plugin) {
      * Initialize the command registry.
      *
      * @throws Exception initialization exception
-     * @since TODO
+     * @since 3.0.0
      */
     public void initialize() throws Exception {
         this.commandManager = createCommandManager();
@@ -418,7 +418,7 @@ private void postprocessPerformer(
      * Register the elements from a voxel command element into the command manager.
      *
      * @param voxelCommandElement the voxel command element
-     * @since TODO
+     * @since 3.0.0
      */
     public void register(VoxelCommandElement voxelCommandElement) {
         annotationParser.parse(voxelCommandElement);
@@ -428,7 +428,7 @@ public void register(VoxelCommandElement voxelCommandElement) {
      * Return the command manager.
      *
      * @return the command manager
-     * @since TODO
+     * @since 3.0.0
      */
     public BukkitCommandManager<SniperCommander> getCommandManager() {
         return commandManager;
@@ -438,7 +438,7 @@ public BukkitCommandManager<SniperCommander> getCommandManager() {
      * Return the annotation parser.
      *
      * @return the annotation parser
-     * @since TODO
+     * @since 3.0.0
      */
     public AnnotationParser<SniperCommander> getAnnotationParser() {
         return annotationParser;

src/main/java/com/thevoxelbox/voxelsniper/command/VoxelMethodCommandExecutionHandler.java

@@ -19,7 +19,7 @@ public class VoxelMethodCommandExecutionHandler<C> extends MethodCommandExecutio
      *
      * @param context the context
      * @throws Exception instantiation exception
-     * @since TODO
+     * @since 3.0.0
      */
     public VoxelMethodCommandExecutionHandler(
             CommandMethodContext<C> context,

src/main/java/com/thevoxelbox/voxelsniper/command/argument/AbstractFileArgument.java

@@ -27,7 +27,7 @@ public abstract class AbstractFileArgument implements VoxelCommandElement {
      * @param plugin    the plugin
      * @param rootPath  the root path
      * @param extension the extension
-     * @since TODO
+     * @since 3.0.0
      */
     public AbstractFileArgument(VoxelSniperPlugin plugin, Path rootPath, String extension) {
         this.plugin = plugin;

src/main/java/com/thevoxelbox/voxelsniper/command/argument/AbstractPatternArgument.java

@@ -31,7 +31,7 @@ public abstract class AbstractPatternArgument<T extends Pattern> implements Voxe
      * @param plugin                   the plugin
      * @param factory                  the factory
      * @param parseExceptionCaptionKey the parse exception caption key
-     * @since TODO
+     * @since 3.0.0
      */
     public AbstractPatternArgument(VoxelSniperPlugin plugin, AbstractFactory<T> factory, String parseExceptionCaptionKey) {
         this.plugin = plugin;

src/main/java/com/thevoxelbox/voxelsniper/command/argument/AbstractRegistryArgument.java

@@ -25,7 +25,7 @@ public abstract class AbstractRegistryArgument<T extends Keyed> implements Voxel
      * @param plugin                   the plugin
      * @param registry                 the registry
      * @param parseExceptionCaptionKey the parse exception caption key
-     * @since TODO
+     * @since 3.0.0
      */
     public AbstractRegistryArgument(VoxelSniperPlugin plugin, NamespacedRegistry<T> registry, String parseExceptionCaptionKey) {
         this.plugin = plugin;

src/main/java/com/thevoxelbox/voxelsniper/command/argument/BiomeTypeArgument.java

@@ -16,7 +16,7 @@ public class BiomeTypeArgument extends AbstractRegistryArgument<BiomeType> {
      * Create a biome type argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public BiomeTypeArgument(VoxelSniperPlugin plugin) {
         super(plugin, BiomeType.REGISTRY, "voxelsniper.command.invalid-biome");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/BlockArgument.java

@@ -18,7 +18,7 @@ public class BlockArgument extends AbstractPatternArgument<BaseBlock> {
      * Create a block argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public BlockArgument(VoxelSniperPlugin plugin) {
         super(plugin, WorldEdit.getInstance().getBlockFactory(), "voxelsniper.command.invalid-block");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/BlockTypeArgument.java

@@ -16,7 +16,7 @@ public class BlockTypeArgument extends AbstractRegistryArgument<BlockType> {
      * Create a block type argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public BlockTypeArgument(VoxelSniperPlugin plugin) {
         super(plugin, BlockType.REGISTRY, "voxelsniper.command.invalid-block-type");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/BrushPropertiesArgument.java

@@ -25,7 +25,7 @@ public class BrushPropertiesArgument implements VoxelCommandElement {
      * Create a brush properties argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public BrushPropertiesArgument(VoxelSniperPlugin plugin) {
         this.plugin = plugin;

src/main/java/com/thevoxelbox/voxelsniper/command/argument/EntityClassArgument.java

@@ -45,7 +45,7 @@ public static List<Class<?>> getEntityClassHierarchy(Class<? extends Entity> ent
      * Create a toolkit argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public EntityClassArgument(VoxelSniperPlugin plugin) {
         this.plugin = plugin;

src/main/java/com/thevoxelbox/voxelsniper/command/argument/EntityTypeArgument.java

@@ -16,7 +16,7 @@ public class EntityTypeArgument extends AbstractRegistryArgument<EntityType> {
      * Create an entity type argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public EntityTypeArgument(VoxelSniperPlugin plugin) {
         super(plugin, EntityType.REGISTRY, "voxelsniper.command.invalid-entity");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/PatternArgument.java

@@ -17,7 +17,7 @@ public class PatternArgument extends AbstractPatternArgument<Pattern> {
      * Create a pattern argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public PatternArgument(VoxelSniperPlugin plugin) {
         super(plugin, plugin.getPatternParser(), "voxelsniper.command.invalid-pattern");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/SignFileArgument.java

@@ -16,7 +16,7 @@ public class SignFileArgument extends AbstractFileArgument {
      * Create a sign file argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public SignFileArgument(VoxelSniperPlugin plugin) {
         super(plugin, plugin.getDataFolder().toPath().resolve("signs/"), ".vsign");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/StencilFileArgument.java

@@ -16,7 +16,7 @@ public class StencilFileArgument extends AbstractFileArgument {
      * Create a stencil file argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public StencilFileArgument(VoxelSniperPlugin plugin) {
         super(plugin, plugin.getDataFolder().toPath().resolve("stencils/"), ".vstencil");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/StencilListFileArgument.java

@@ -16,7 +16,7 @@ public class StencilListFileArgument extends AbstractFileArgument {
      * Create a stencil file argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public StencilListFileArgument(VoxelSniperPlugin plugin) {
         super(plugin, plugin.getDataFolder().toPath().resolve("stencilLists/"), ".txt");

src/main/java/com/thevoxelbox/voxelsniper/command/argument/ToolkitArgument.java

@@ -21,7 +21,7 @@ public class ToolkitArgument implements VoxelCommandElement {
      * Create a toolkit argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public ToolkitArgument(VoxelSniperPlugin plugin) {
         this.plugin = plugin;

src/main/java/com/thevoxelbox/voxelsniper/command/argument/VoxelCommandElementParseException.java

@@ -17,7 +17,7 @@ public class VoxelCommandElementParseException extends IllegalArgumentException
      *
      * @param input        the input
      * @param errorMessage the error message
-     * @since TODO
+     * @since 3.0.0
      */
     public VoxelCommandElementParseException(String input, Component errorMessage) {
         this.input = input;
@@ -28,7 +28,7 @@ public VoxelCommandElementParseException(String input, Component errorMessage) {
      * Return the input.
      *
      * @return the input
-     * @since TODO
+     * @since 3.0.0
      */
     public String getInput() {
         return input;
@@ -38,7 +38,7 @@ public String getInput() {
      * Return the error message.
      *
      * @return the error message
-     * @since TODO
+     * @since 3.0.0
      */
     public Component getErrorMessage() {
         return errorMessage;

src/main/java/com/thevoxelbox/voxelsniper/command/argument/VoxelListBlocksArgument.java

@@ -27,7 +27,7 @@ public class VoxelListBlocksArgument implements VoxelCommandElement {
      * Create a voxel list blocks argument.
      *
      * @param plugin the plugin
-     * @since TODO
+     * @since 3.0.0
      */
     public VoxelListBlocksArgument(VoxelSniperPlugin plugin) {
         this.plugin = plugin;
@@ -82,7 +82,7 @@ public BlockWrapper[] parseVoxelListBlock(CommandContext<SniperCommander> comman
      *
      * @param block  the block
      * @param remove whether the block should be removed or not
-     * @since TODO
+     * @since 3.0.0
      */
     public record BlockWrapper(BlockState block, boolean remove) {
 

src/main/java/com/thevoxelbox/voxelsniper/command/argument/annotation/DynamicRange.java

@@ -10,7 +10,7 @@
 /**
  * Used to specify min and max field values of numerical.
  *
- * @since TODO
+ * @since 3.0.0
  */
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.PARAMETER)
@@ -20,15 +20,15 @@
      * Return the minimum field value accepted by the parser.
      *
      * @return minimum field value
-     * @since TODO
+     * @since 3.0.0
      */
     @NonNull String min() default "";
 
     /**
      * Return the maximum field value accepted by the parser.
      *
      * @return maximum field value
-     * @since TODO
+     * @since 3.0.0
      */
     @NonNull String max() default "";
 

src/main/java/com/thevoxelbox/voxelsniper/command/argument/annotation/RequireToolkit.java

@@ -8,7 +8,7 @@
 /**
  * Used to specify toolkit requirement.
  *
- * @since TODO
+ * @since 3.0.0
  */
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.METHOD, ElementType.TYPE})

src/main/java/com/thevoxelbox/voxelsniper/performer/PerformerRegistry.java

@@ -31,7 +31,7 @@ public void register(PerformerProperties properties) {
      * Return the unique performer properties.
      *
      * @return the unique performer properties
-     * @since TODO
+     * @since 3.0.0
      */
     public Set<PerformerProperties> getUniquePerformerProperties() {
         return uniquePerformerProperties;

src/main/java/com/thevoxelbox/voxelsniper/sniper/Sniper.java

@@ -59,7 +59,7 @@ public Sniper(UUID uuid) {
      * Create a sniper from a player.
      *
      * @param player the player
-     * @since TODO
+     * @since 3.0.0
      */
     public Sniper(Player player) {
         this.uuid = player.getUniqueId();

src/main/java/com/thevoxelbox/voxelsniper/sniper/SniperCommander.java

@@ -13,15 +13,15 @@ public interface SniperCommander {
      * Return the command sender
      *
      * @return the command sender
-     * @since TODO
+     * @since 3.0.0
      */
     CommandSender getCommandSender();
 
     /**
      * Create a parser context from the sniper commander.
      *
      * @return the parser context
-     * @since TODO
+     * @since 3.0.0
      */
     default ParserContext createParserContext() {
         CommandSender sender = getCommandSender();

src/main/java/com/thevoxelbox/voxelsniper/sniper/SniperRegistry.java

@@ -39,7 +39,7 @@ public void unregister(Sniper sniper) {
      *
      * @param commandSender the command sender
      * @return the sniper commander
-     * @since TODO
+     * @since 3.0.0
      */
     public SniperCommander getSniperCommander(CommandSender commandSender) {
         return commandSender instanceof Player player