net.guizhanss.guizhanlib.minecraft.helper.MaterialHelper Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of GuizhanLib-minecraft Show documentation
The newest version!
package net.guizhanss.guizhanlib.minecraft.helper;

import com.google.common.base.Preconditions;
import lombok.experimental.UtilityClass;
import net.guizhanss.guizhanlib.minecraft.LanguageHelper;
import net.guizhanss.guizhanlib.utils.StringUtil;
import org.bukkit.Material;

import javax.annotation.Nonnull;

/**
 * 物品材料({@link Material})
 *
 * @author ybw0014
 */
@UtilityClass
@SuppressWarnings("ConstantConditions")
public final class MaterialHelper {
    /**
     * 返回材料({@link Material})的中文名称
     *
     * @param mat {@link Material} 材料
     * @return 材料的中文名称，如果获取失败则返回对应的键名
     */
    @Nonnull
    public static String getName(@Nonnull Material mat) {
        return LanguageHelper.getLangOrKey(getKey(mat));
    }

    /**
     * 获取物品材料({@link Material})的键名
     *
     * @param mat {@link Material} 物品材料
     * @return 物品材料的键名
     */
    @Nonnull
    public static String getKey(@Nonnull Material mat) {
        Preconditions.checkArgument(mat != null, "材料不能为空");

        return (mat.isBlock() ? "block" : "item") + "."
            + mat.getKey().getNamespace() + "."
            + mat.getKey().getKey();
    }

    /**
     * 根据给定的材料字符串返回中文名称
     *
     * @param material 材料的{@link String}格式
     * @return 物品材料的中文名称，如果获取失败则返回材料名可读格式
     */
    @Nonnull
    public static String getName(@Nonnull String material) {
        return getName(material, false);
    }

    /**
     * 根据给定的材料字符串返回中文名称
     *
     * @param material    材料的{@link String}格式
     * @param emptyString 是否返回空字符串
     * @return 物品材料的中文名称，如果获取失败则返回材料名可读格式或空字符串
     */
    @Nonnull
    public static String getName(@Nonnull String material, boolean emptyString) {
        Material mat = Material.getMaterial(material);
        if (mat == null) {
            return emptyString ? "" : StringUtil.humanize(material);
        } else {
            return getName(mat);
        }
    }
}