cloud.commandframework.fabric.argument.server.Vec2dArgument Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of cloud-fabric Show documentation
Command framework and dispatcher for the JVM
The newest version!
//
// MIT License
//
// Copyright (c) 2022 Alexander Söderberg & 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 cloud.commandframework.fabric.argument.server;

import cloud.commandframework.ArgumentDescription;
import cloud.commandframework.arguments.CommandArgument;
import cloud.commandframework.context.CommandContext;
import cloud.commandframework.fabric.argument.FabricArgumentParsers;
import cloud.commandframework.fabric.data.Coordinates;
import java.util.List;
import java.util.function.BiFunction;
import net.minecraft.class_243;
import org.checkerframework.checker.nullness.qual.NonNull;
import org.checkerframework.checker.nullness.qual.Nullable;

/**
 * An argument for resolving {@link cloud.commandframework.fabric.data.Coordinates.CoordinatesXZ} from 2 doubles.
 *
 * @param  the sender type
 * @since 1.5.0
 */
public final class Vec2dArgument extends CommandArgument {

    private final boolean centerIntegers;

    Vec2dArgument(
            final boolean required,
            final @NonNull String name,
            final @NonNull String defaultValue,
            final @Nullable BiFunction, String, List> suggestionsProvider,
            final @NonNull ArgumentDescription defaultDescription,
            final boolean centerIntegers
    ) {
        super(
                required,
                name,
                FabricArgumentParsers.vec2(centerIntegers),
                defaultValue,
                Coordinates.CoordinatesXZ.class,
                suggestionsProvider,
                defaultDescription
        );
        this.centerIntegers = centerIntegers;
    }

    /**
     * Get whether integers will be centered to x.5. Defaults to false.
     *
     * @return whether integers will be centered
     * @since 1.5.0
     */
    public boolean centerIntegers() {
        return this.centerIntegers;
    }

    /**
     * Create a new {@link cloud.commandframework.fabric.argument.server.Vec2dArgument.Builder}.
     *
     * @param name Name of the argument
     * @param   Command sender type
     * @return Created builder
     * @since 1.5.0
     */
    public static  @NonNull cloud.commandframework.fabric.argument.server.Vec2dArgument.Builder builder(final @NonNull String name) {
        return new cloud.commandframework.fabric.argument.server.Vec2dArgument.Builder<>(name);
    }

    /**
     * Create a new required {@link Vec2dArgument}.
     *
     * @param name Component name
     * @param   Command sender type
     * @return Created argument
     * @since 1.5.0
     */
    public static  @NonNull Vec2dArgument of(final @NonNull String name) {
        return Vec2dArgument.builder(name).asRequired().build();
    }

    /**
     * Create a new required {@link Vec2dArgument}.
     *
     * @param name           Component name
     * @param centerIntegers whether to center integers to x.5.
     * @param             Command sender type
     * @return Created argument
     * @since 1.5.0
     */
    public static  @NonNull Vec2dArgument of(final @NonNull String name, final boolean centerIntegers) {
        return Vec2dArgument.builder(name).centerIntegers(centerIntegers).asRequired().build();
    }

    /**
     * Create a new optional {@link Vec2dArgument}.
     *
     * @param name Component name
     * @param   Command sender type
     * @return Created argument
     * @since 1.5.0
     */
    public static  @NonNull Vec2dArgument optional(final @NonNull String name) {
        return Vec2dArgument.builder(name).asOptional().build();
    }

    /**
     * Create a new optional {@link Vec2dArgument}.
     *
     * @param name           Component name
     * @param centerIntegers whether to center integers to x.5.
     * @param             Command sender type
     * @return Created argument
     * @since 1.5.0
     */
    public static  @NonNull Vec2dArgument optional(final @NonNull String name, final boolean centerIntegers) {
        return Vec2dArgument.builder(name).centerIntegers(centerIntegers).asOptional().build();
    }

    /**
     * Create a new optional {@link Vec2dArgument} with the specified default value.
     *
     * @param name         Component name
     * @param defaultValue default value, y will be ignored as it is always 0
     * @param           Command sender type
     * @return Created argument
     * @since 1.5.0
     */
    public static  @NonNull Vec2dArgument optional(final @NonNull String name, final @NonNull class_243 defaultValue) {
        return Vec2dArgument.builder(name).asOptionalWithDefault(defaultValue).build();
    }

    /**
     * Create a new optional {@link Vec2dArgument} with the specified default value.
     *
     * @param name           Component name
     * @param defaultValue   default value, y will be ignored as it is always 0
     * @param centerIntegers whether to center integers to x.5.
     * @param             Command sender type
     * @return Created argument
     * @since 1.5.0
     */
    public static  @NonNull Vec2dArgument optional(
            final @NonNull String name,
            final boolean centerIntegers,
            final @NonNull class_243 defaultValue
    ) {
        return Vec2dArgument.builder(name).centerIntegers(centerIntegers).asOptionalWithDefault(defaultValue).build();
    }

    /**
     * Builder for {@link Vec2dArgument}.
     *
     * @param  sender type
     * @since 1.5.0
     */
    public static final class Builder extends TypedBuilder> {

        private boolean centerIntegers = false;

        Builder(final @NonNull String name) {
            super(Coordinates.CoordinatesXZ.class, name);
        }

        /**
         * Set whether integers will be centered to x.5. Will be false by default if unset.
         *
         * @param centerIntegers whether integers will be centered
         * @return this builder
         * @since 1.5.0
         */
        public @NonNull cloud.commandframework.fabric.argument.server.Vec2dArgument.Builder centerIntegers(final boolean centerIntegers) {
            this.centerIntegers = centerIntegers;
            return this;
        }

        /**
         * Get whether integers will be centered to x.5. Defaults to false.
         *
         * @return whether integers will be centered
         * @since 1.5.0
         */
        public boolean centerIntegers() {
            return this.centerIntegers;
        }

        /**
         * Sets the command argument to be optional, with the specified default value.
         *
         * @param defaultValue default value, y will be ignored as it is always 0
         * @return this builder
         * @see CommandArgument.Builder#asOptionalWithDefault(String)
         * @since 1.5.0
         */
        public @NonNull cloud.commandframework.fabric.argument.server.Vec2dArgument.Builder asOptionalWithDefault(final @NonNull class_243 defaultValue) {
            return this.asOptionalWithDefault(String.format(
                    "%.10f %.10f",
                    defaultValue.field_1352,
                    defaultValue.field_1350
            ));
        }

        /**
         * Build a new {@link Vec2dArgument}.
         *
         * @return Constructed argument
         * @since 1.5.0
         */
        @Override
        public @NonNull Vec2dArgument build() {
            return new Vec2dArgument<>(
                    this.isRequired(),
                    this.getName(),
                    this.getDefaultValue(),
                    this.getSuggestionsProvider(),
                    this.getDefaultDescription(),
                    this.centerIntegers()
            );
        }
    }
}