/* * This file is licensed under the MIT License, part of Roughly Enough Items. * Copyright (c) 2018, 2019, 2020 shedaniel * * 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 me.shedaniel.rei.api; import me.shedaniel.rei.impl.Internals; import me.shedaniel.rei.utils.CollectionUtils; import me.shedaniel.rei.utils.FormattingUtils; import net.fabricmc.api.EnvType; import net.fabricmc.api.Environment; import net.minecraft.ChatFormatting; import net.minecraft.client.gui.chat.NarratorChatListener; import net.minecraft.core.Registry; import net.minecraft.network.chat.Component; import net.minecraft.network.chat.TextComponent; import net.minecraft.resources.ResourceLocation; import net.minecraft.world.item.Item; import net.minecraft.world.item.ItemStack; import net.minecraft.world.item.Items; import org.jetbrains.annotations.ApiStatus; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; import java.util.Collection; import java.util.List; import java.util.Map; import java.util.Set; @Environment(EnvType.CLIENT) public interface ClientHelper { /** * @return the instance of {@link me.shedaniel.rei.api.ClientHelper} */ static ClientHelper getInstance() { return Internals.getClientHelper(); } /** * Checks if cheating is enabled * * @return whether cheating is enabled */ boolean isCheating(); /** * Sets current cheating mode * Should save the config in {@link ConfigManager}. * * @param cheating the new cheating mode */ void setCheating(boolean cheating); @Deprecated @ApiStatus.ScheduledForRemoval List getInventoryItemsTypes(); /** * Opens a recipe viewing screen: * Opens {@link me.shedaniel.rei.gui.PreRecipeViewingScreen} if not set * Opens {@link me.shedaniel.rei.gui.RecipeViewingScreen} if set to default * Opens {@link me.shedaniel.rei.gui.VillagerRecipeViewingScreen} if set to villager * * @param map the map of recipes */ @ApiStatus.ScheduledForRemoval @Deprecated void openRecipeViewingScreen(Map, List> map); /** * Tries to cheat stack using either packets or commands. * * @param stack the stack to cheat in * @return whether it failed */ boolean tryCheatingEntry(EntryStack stack); default boolean tryCheatingStack(ItemStack stack) { return tryCheatingEntry(EntryStack.create(stack)); } /** * Finds recipe for the stack and opens the recipe screen. * * @param stack the stack to find recipe for * @return whether the stack has any recipes to show */ @Deprecated @ApiStatus.ScheduledForRemoval default boolean executeRecipeKeyBind(EntryStack stack) { return openView(ViewSearchBuilder.builder().addRecipesFor(stack).setOutputNotice(stack).fillPreferredOpenedCategory()); } @Deprecated @ApiStatus.ScheduledForRemoval default boolean executeRecipeKeyBind(ItemStack stack) { return executeRecipeKeyBind(EntryStack.create(stack)); } /** * Finds usage for the stack and opens the recipe screen. * * @param stack the stack to find usage for * @return whether the stack has any usages to show */ @Deprecated @ApiStatus.ScheduledForRemoval default boolean executeUsageKeyBind(EntryStack stack) { return openView(ViewSearchBuilder.builder().addUsagesFor(stack).setInputNotice(stack).fillPreferredOpenedCategory()); } @Deprecated @ApiStatus.ScheduledForRemoval default boolean executeUsageKeyBind(ItemStack stack) { return executeUsageKeyBind(EntryStack.create(stack)); } /** * Gets the mod from an item * * @param item the item to find * @return the mod name */ default String getModFromItem(Item item) { if (item.equals(Items.AIR)) return ""; return getModFromIdentifier(Registry.ITEM.getKey(item)); } /** * Tries to delete the player's cursor item */ void sendDeletePacket(); /** * Gets the formatted mod from an item * * @param item the item to find * @return the mod name with blue and italic formatting */ default Component getFormattedModFromItem(Item item) { String mod = getModFromItem(item); if (mod.isEmpty()) return NarratorChatListener.NO_TITLE; return new TextComponent(mod).withStyle(ChatFormatting.BLUE, ChatFormatting.ITALIC); } /** * Gets the formatted mod from an identifier * * @param identifier the identifier to find * @return the mod name with blue and italic formatting */ default Component getFormattedModFromIdentifier(ResourceLocation identifier) { String mod = getModFromIdentifier(identifier); if (mod.isEmpty()) return NarratorChatListener.NO_TITLE; return new TextComponent(mod).withStyle(ChatFormatting.BLUE, ChatFormatting.ITALIC); } /** * Gets the mod from a modid * * @param modid the modid of the mod * @return the mod name with blue and italic formatting */ default Component getFormattedModFromModId(String modid) { String mod = getModFromModId(modid); if (mod.isEmpty()) return NarratorChatListener.NO_TITLE; return new TextComponent(mod).withStyle(ChatFormatting.BLUE, ChatFormatting.ITALIC); } default List appendModIdToTooltips(List components, String modId) { final String modName = ClientHelper.getInstance().getModFromModId(modId); boolean alreadyHasMod = false; for (Component s : components) if (FormattingUtils.stripFormatting(s.getString()).equalsIgnoreCase(modName)) { alreadyHasMod = true; break; } if (!alreadyHasMod) components.add(ClientHelper.getInstance().getFormattedModFromModId(modId)); return components; } /** * Gets the mod from an identifier * * @param identifier the identifier to find * @return the mod name */ default String getModFromIdentifier(ResourceLocation identifier) { if (identifier == null) return ""; return getModFromModId(identifier.getNamespace()); } /** * Gets the mod from a modid * * @param modid the modid of the mod * @return the mod name */ String getModFromModId(String modid); /** * Finds all recipes and open them in a recipe screen. * * @return whether there are any recipes to show */ @Deprecated @ApiStatus.ScheduledForRemoval default boolean executeViewAllRecipesKeyBind() { return openView(ViewSearchBuilder.builder().addAllCategories().fillPreferredOpenedCategory()); } @Deprecated @ApiStatus.ScheduledForRemoval default boolean executeViewAllRecipesFromCategory(ResourceLocation category) { return openView(ViewSearchBuilder.builder().addCategory(category).fillPreferredOpenedCategory()); } @Deprecated @ApiStatus.ScheduledForRemoval default boolean executeViewAllRecipesFromCategories(List categories) { return openView(ViewSearchBuilder.builder().addCategories(categories).fillPreferredOpenedCategory()); } boolean openView(ViewSearchBuilder builder); boolean canUseMovePackets(); interface ViewSearchBuilder { static ViewSearchBuilder builder() { return Internals.createViewSearchBuilder(); } ViewSearchBuilder addCategory(ResourceLocation category); ViewSearchBuilder addCategories(Collection categories); default ViewSearchBuilder addAllCategories() { return addCategories(CollectionUtils.map(RecipeHelper.getInstance().getAllCategories(), RecipeCategory::getIdentifier)); } @NotNull Set getCategories(); ViewSearchBuilder addRecipesFor(EntryStack stack); @NotNull List getRecipesFor(); ViewSearchBuilder addUsagesFor(EntryStack stack); @NotNull List getUsagesFor(); ViewSearchBuilder setPreferredOpenedCategory(@Nullable ResourceLocation category); @Nullable ResourceLocation getPreferredOpenedCategory(); ViewSearchBuilder fillPreferredOpenedCategory(); ViewSearchBuilder setInputNotice(@Nullable EntryStack stack); @Nullable EntryStack getInputNotice(); ViewSearchBuilder setOutputNotice(@Nullable EntryStack stack); @Nullable EntryStack getOutputNotice(); @NotNull Map, List> buildMap(); } }