personthecat.catlib.util.McUtils Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of catlib-quilt Show documentation
Utilities for serialization, commands, noise generation, IO, and some new data types.
The newest version!
package personthecat.catlib.util;

import dev.architectury.injectables.annotations.ExpectPlatform;
import lombok.experimental.UtilityClass;
import net.minecraft.class_1959;
import org.jetbrains.annotations.NotNull;
import personthecat.catlib.registry.DynamicRegistries;
import personthecat.catlib.exception.BiomeTypeNotFoundException;
import personthecat.catlib.exception.MissingOverrideException;
import personthecat.catlib.mixin.BiomeAccessor;

import java.io.File;
import java.util.List;
import java.util.Optional;
import java.util.stream.Collectors;
import java.util.stream.StreamSupport;

import static personthecat.catlib.exception.Exceptions.noBiomeTypeNamed;
import static personthecat.catlib.util.Shorthand.getEnumConstant;

@UtilityClass
@SuppressWarnings("unused")
public class McUtils {

    /**
     * @return A {@link File} pointing to the game's config directory.
     */
    @ExpectPlatform
    public static File getConfigDir() {
        throw new MissingOverrideException();
    }

    /**
     * @return The name of the current platform, e.g. forge.
     */
    @ExpectPlatform
    public static String getPlatform() {
        throw new MissingOverrideException();
    }

    /**
     * @param id The id of the mod being researched.
     * @return Whether the given mod is currently installed.
     */
    @ExpectPlatform
    public static boolean isModLoaded(final String id) {
       throw new MissingOverrideException();
    }

    /**
     * @return Whether the game is currently running on a dedicated server.
     */
    @ExpectPlatform
    public static boolean isDedicatedServer() {
        throw new MissingOverrideException();
    }

    /**
     * @return Whether the game is currently running on the client side.
     */
    public static boolean isClientSide() {
        return !isDedicatedServer();
    }

    /**
     * @throws BiomeTypeNotFoundException If the biome type does not exist.
     * @param id The name of the biome type being researched.
     * @return The given biome type, or else throws.
     */
    @NotNull
    public static class_1959.class_1961 assertBiomeType(final String id) {
        return getBiomeType(id).orElseThrow(() -> noBiomeTypeNamed(id));
    }

    /**
     * @param id The name of the biome type being researched.
     * @return The given biome type, or else {@link Optional#empty}.
     */
    public static Optional getBiomeType(final String id) {
        return getEnumConstant(id, class_1959.class_1961.class);
    }

    /**
     * @param type The type of biome being researched.
     * @return A list of biomes for the given category.
     */
    public static List getBiomes(final class_1959.class_1961 type) {
        return StreamSupport.stream(DynamicRegistries.BIOMES.spliterator(), false)
            .filter(biome -> ((BiomeAccessor) (Object) biome).getBiomeCategory().equals(type))
            .collect(Collectors.toList());
    }
}