Topic category: User side tutorials
JEI API integration for Custom Crafting
You will need java knowledge for this tutorial.
In the tutorial, I will assume you know how to create a variable and know basic java syntax. However, I am open to helping everybody, so if you need extra guidance. Add my discord (in profile).
Before we get started, you will need these elements and textures;
- GUI element and texture
- Block
- Working procedure recipes in-game
Now lets get started 😋,
First, we have to install the JEI API in our MCreator workspace.
To do this go to,
Now open the "build.gradle" file with notepad (or any other alternative),
Now add the following,
repositories {
maven {
// location of the maven that hosts JEI files
name = "Progwml6 maven"
url = "https://dvs1.progwml6.com/files/maven/"
}
maven {
// location of a maven mirror for JEI files, as a fallback
name = "ModMaven"
url = "https://modmaven.k-4u.nl"
}
}
compileOnly fg.deobf("mezz.jei:jei-1.15.2:6.0.0.4:api")
// at runtime, use the full JEI jar
runtimeOnly fg.deobf("mezz.jei:jei-1.15.2:6.0.0.4")
Keep in mind, you can change, "6.0.0.4" to any compatible JEI version.
Now add the above snippets so your build.gradle file looks similar to this,
buildscript {
repositories {
maven { url = 'https://files.minecraftforge.net/maven' }
jcenter()
mavenCentral()
}
dependencies {
classpath group: 'net.minecraftforge.gradle', name: 'ForgeGradle', version: '3.+', changing: true
}
}
repositories {
maven {
name = "Progwml6 maven"
url = "https://dvs1.progwml6.com/files/maven/"
}
maven {
name = "ModMaven"
url = "https://modmaven.k-4u.nl"
}
}
apply plugin: 'net.minecraftforge.gradle'
apply plugin: 'eclipse'
version = '1.0'
group = 'com.yourname.modid'
archivesBaseName = 'modid'
sourceCompatibility = targetCompatibility = compileJava.sourceCompatibility = compileJava.targetCompatibility = '1.8'
minecraft {
mappings channel: 'snapshot', version: '20200514-1.15.1'
runs {
client {
workingDirectory project.file('run')
property 'forge.logging.markers', 'REGISTRIES'
property 'forge.logging.console.level', 'debug'
mods {
examplemod {
source sourceSets.main
}
}
}
server {
workingDirectory project.file('run')
property 'forge.logging.markers', 'REGISTRIES'
property 'forge.logging.console.level', 'debug'
mods {
examplemod {
source sourceSets.main
}
}
}
}
}
dependencies {
minecraft 'net.minecraftforge:forge:1.15.2-31.2.0'
compileOnly fg.deobf("mezz.jei:jei-1.15.2:6.0.0.4:api")
runtimeOnly fg.deobf("mezz.jei:jei-1.15.2:6.0.0.4")
}
apply from: 'mcreator.gradle'
Now you should be done with the build.gradle file!🤪🤪 All you have to do now is save and close the file and open the MCreator workspace again. Finally, build the workspace by clicking the hammer in the top right corner!😎😎
If you get an error, 😡🤬, post your build.gradle file in the comments. And I will try to respond quick!
Now we have to create our plugin, recipe/s, and category 😀. So let's create a custom element and name it "JeiPlugin",
Now optimize the code to look similar to this, and remove the constructor😱😱😱. Also add, "@mezz.jei.api.JeiPlugin" to the top;
package net.mcreator.jeitest;
@mezz.jei.api.JeiPlugin
public class JeiPlugin {
}
Now that we have a clean slate to work with, we can follow (not copy) the template at the end of the post.
An explanation for each method follows;
Blue Text = Important
Green Text = Self explanatory or a simple method
JeiPlugin Class Methods,
getPluginUid - Well, you provide a ResourceLocation for your plugin...
registerCategories - This method register's category of your crafting. For example in vanilla minecraft, the crafting table category, furnace table category, and a blast furnace.*This does not provide JEI with an extra tab (see registerRecipeCatalysts for that)*.
registerRecipes - This method registers the recipe. For example, when you click on a torch in JEI you can see the stick + coal recipe. In the template we register a list of all of our recipes. To add a recipe, add another;
private List<[YOURBLOCK]JeiCategory.[YOURBLOCK]RecipeWrapper> generate[YOURBLOCK]Recipes() {
List<[YOURBLOCK]JeiCategory.[YOURBLOCK]RecipeWrapper> recipes = new ArrayList<>();
ArrayList<ItemStack> inputs = new ArrayList<>();
ArrayList<ItemStack> outputs = new ArrayList<>();
inputs.add(new ItemStack([ANYINPUTITEM));
outputs.add(new ItemStack([ANYOUTPUTITEM]));
recipes.add(new [YOURBLOCK]JeiCategory.[YOURBLOCK]RecipeWrapper(inputs, outputs));
return recipes;
}
However, to add more inputs/outputs, add another;
inputs.add(new ItemStack([ANYINPUTITEM]));
or
outputs.add(new ItemStack([ANYOUTPUTITEM]));
To the correlated list
registerRecipeCatalysts - This provides JEI with the tab for the recipes. I.e. the Crafting Table tab. This parameter;
new ItemStack([YOURBLOCK].block)
is the block/icon the tab shows. Similar but different to the Creative tabs.
JeiCategory sub-class methods,
getUid - Well, returns the Uid variable...
getRecipeClass - returns our "recipe wrapper"
getTitle = returns the title of our GUI
getBackground- returns the background texture of the GUI
getIcon = returns null if you want to have your block as the icon. If you want a custom icon, return the icon ResourceLocation (I won't be covering that, if you need help add my discord).
setIngredients - This may be the most important method, it allows you to set the inputs and outputs of your gui. To add more inputs, see the "registerRecipes" method.
setRecipes - This also tops the most important method, it provides JEI the layout of your gui. To add more slots add additional init and set corresponding to the slot coordinates in the GUI texture. I.e this;
IGuiItemStackGroup stacks = iRecipeLayout.getItemStacks();
stacks.init(input1, true, [IN1SLOTX], [IN1SLOTY]);
stacks.init(output1, false, [OUT1SLOTX], [OUT1SLOTY]);
//...
stacks.set(input1, iIngredients.getInputs(VanillaTypes.ITEM).get(0));
stacks.set(output1, iIngredients.getOutputs(VanillaTypes.ITEM).get(0));
//...
to this;
IGuiItemStackGroup stacks = iRecipeLayout.getItemStacks();
stacks.init(input1, true, [IN1SLOTX], [IN1SLOTY]);
stacks.init(input2, true, [IN2SLOTX], [IN2SLOTY]);
stacks.init(output1, false, [OUT1SLOTX], [OUT1SLOTY]);
//...
stacks.set(input1, iIngredients.getInputs(VanillaTypes.ITEM).get(0));
stacks.set(input2, iIngredients.getInputs(VanillaTypes.Item).get(1)); //+1 from previous variable.
stacks.set(output1, iIngredients.getOutputs(VanillaTypes.ITEM).get(0));
//...
You need to create another variable, "input2", that corresponds to that slotID. If you need help add my discord (in profile).
That should cover a lot, a may be missing something so if anything jumps out comment below. If you have any questions/additions comment below or add my discord. Thanks!
TEMPLATE BELOW
Key;
Basics,
[MODID] = Your modid i.e. mobench
[YOURBLOCK] = Your block name, i.e. InfuseBlock
[YOURBLOCKLOWERCASE] = Your block name no capitals, i.e. infuseblock
[YOURBLOCKNAMEINGAME] = The title of your block, i.e. Crafting Bench and Infuse Bench
[GUIFILELOCATION] = Where the GUI texture is stored, i.e. "textures/infuse_bench_gui.png"
[GUIWIDTH] = The width of the GUI, i.e 176
[GUIHEIGHT] = The height of the GUI, i.e. 166
//... = You can add on to these elements
You should have, {Number of items in recipe = Number of slots in gui}
You can have more than provided two items in the template. If you need help with how to do this, ask below or add my discord (in profile).
@mezz.jei.api.JeiPlugin
public class JeiPlugin implements IModPlugin {
public static IJeiHelpers jeiHelper;
@Override
public ResourceLocation getPluginUid() {
return new ResourceLocation("[MODID]", "default");
}
@Override
public void registerCategories(IRecipeCategoryRegistration registration) {
jeiHelper = registration.getJeiHelpers();
registration.addRecipeCategories(new [YOURBLOCK]JeiCategory(jeiHelper.getGuiHelper()));
}
@Override
public void registerRecipes(IRecipeRegistration registration) {
registration.addRecipes(generate[YOURBLOCK]Recipes(), [YOURBLOCK]JeiCategory.Uid);
// ...
}
private List<[YOURBLOCK]JeiCategory.[YOURBLOCK]RecipeWrapper> generate[YOURBLOCK]Recipes() {
List<[YOURBLOCK]JeiCategory.[YOURBLOCK]RecipeWrapper> recipes = new ArrayList<>();
ArrayList<ItemStack> inputs = new ArrayList<>();
ArrayList<ItemStack> outputs = new ArrayList<>();
inputs.add(new ItemStack([ANYINPUTITEM]));
outputs.add(new ItemStack([ANYOUTPUTITEM]));
// ...
recipes.add(new [YourBlock]JeiCategory.[YourBlock]RecipeWrapper(inputs, outputs));
return recipes;
}
@Override
public void registerRecipeCatalysts(IRecipeCatalystRegistration registration) {
registration.addRecipeCatalyst(new ItemStack([YOURBLOCK].block), [YOURBLOCK]JeiCategory.Uid);
}
public static class [YOURBLOCK]JeiCategory implements IRecipeCategory<[YOURBLOCK]JeiCategory.[YOURBLOCK]RecipeWrapper> {
private static ResourceLocation Uid = new ResourceLocation("[MODID]", "[YOURBLOCKLOWERCASE]category");
private static final int input1 = 0; // THE NUMBER = SLOTID
private static final int output1 = 1; // THE NUMBER = SLOTID
// ...
private final String title;
private final IDrawable background;
public [YOURBLOCK]JeiCategory(IGuiHelper guiHelper) {
this.title = "[YOURBLOCKNAMEINGAME]";
this.background = guiHelper.createDrawable(new ResourceLocation("[MODID]", "[GUIFILELOCATION].png"), 0, 0, [GUIWIDTH], [GUIHEIGHT]);
}
@Override
public ResourceLocation getUid() {
return Uid;
}
@Override
public Class<? extends [YOURBLOCK]RecipeWrapper> getRecipeClass() {
return [YOURBLOCK]JeiCategory.[YOURBLOCK]RecipeWrapper.class;
}
@Override
public String getTitle() {
return title;
}
@Override
public IDrawable getBackground() {
return background;
}
@Override
public IDrawable getIcon() {
return null;
}
@Override
public void setIngredients([YOURBLOCK]RecipeWrapper recipeWrapper, IIngredients iIngredients) {
iIngredients.setInputs(VanillaTypes.ITEM, recipeWrapper.getInput());
iIngredients.setOutputs(VanillaTypes.ITEM, recipeWrapper.getOutput());
}
@Override
public void setRecipe(IRecipeLayout iRecipeLayout, [YOURBLOCK]RecipeWrapper recipeWrapper, IIngredients iIngredients) {
IGuiItemStackGroup stacks = iRecipeLayout.getItemStacks();
stacks.init(input1, true, [IN1SLOTX], [IN1SLOTY]);
stacks.init(output1, false, [OUT1SLOTX], [OUT1SLOTY]);
// ...
stacks.set(input1, iIngredients.getInputs(VanillaTypes.ITEM).get(0));
stacks.set(output1, iIngredients.getOutputs(VanillaTypes.ITEM).get(0));
// ...
}
public static class [YOURBLOCK]RecipeWrapper {
private List<ItemStack> input;
private List<ItemStack> output;
public [YourBlock]RecipeWrapper(List<ItemStack> input, List<ItemStack> output) {
this.input = input;
this.output = output;
}
public List<ItemStack> getInput() {
return input;
}
public List<ItemStack> getOutput() {
return output;
}
}
}
}
MAKE SURE TO ADD THESE BARE MINIMUM IMPORTS😁😁😁!
import mezz.jei.api.IModPlugin;
import mezz.jei.api.constants.VanillaTypes;
import mezz.jei.api.gui.IRecipeLayout;
import mezz.jei.api.gui.drawable.IDrawable;
import mezz.jei.api.gui.ingredient.IGuiItemStackGroup;
import mezz.jei.api.helpers.IGuiHelper;
import mezz.jei.api.helpers.IJeiHelpers;
import mezz.jei.api.ingredients.IIngredients;
import mezz.jei.api.recipe.category.IRecipeCategory;
import mezz.jei.api.registration.IRecipeCatalystRegistration;
import mezz.jei.api.registration.IRecipeCategoryRegistration;
import mezz.jei.api.registration.IRecipeRegistration;
import net.minecraft.item.ItemStack;
import net.minecraft.item.Items;
import net.minecraft.util.ResourceLocation;
import java.util.ArrayList;
import java.util.List;
PROOF OF WORKING
[NEW TEMPLATE] CODE PROOF
[OLD] CODE PROOF
MIRROR LINKS FOR IMAGES;
lol :P
Please I need help, I keep getting errors and strange things. Could u add me as a friend on Discord? I already asked you but you're not responding... My pseudo is Player Max = new Steve();#2102
good job! 👍
I just came to this page again while moderating, and I must say this is really well structured tutorial :D
Thanks lol😅! It is my first tutorial, I tried to explain what every method does so it is easier to customize for themselves🤷♂️. I'm glad for good response!
[New Template added]
New Template allows multiple input slots now supported. Before you were stuck to 1 input, 1 output.
New Template also makes it easier to add new Recipes.
can you update the pastebin?
Sure I'll add currently working code with 2 recipes😝 😜
*Added*
New Template with working and tested code😍. *CONTAINS 2 RECIPES*
*Kept*
Old Template with working and tested code. I wanted to keep in case anyone wanted to look through it and see why it wasn't working and learn from it😊!
can you also update the pastebin?
And there is something important you missed. Your class would be deleted each time you regenerate code since it doesn't extend mod element. You would have to make a custom package. So if your package is com.your.mod, you need to create a new package at com.your.* so it doesn't get counted as mod element and deleted. Also you could create a empty class by clicking the package in the code browser you want to create it in
I've rebuilt the workspace about 5 times and have had no issues (even when refactoring to 1.14.4 to test).
Sure, but how much harder is it, and more fun to delete the constructor 😱😱😱😱.
What do you mean update the pastebin?
As long as the custom code mod element is registered in the workspace and name is preserved it is fine this way :) Alternative is making a class outside "MCreator's" package too, but I don't see a need for this in this case.
Yes I have had no problems with rebuilding the workspace using cmd and refactoring. I appreciate the clarification👍