Modding by Kaupenjoe – Minecraft 1.17.1 Forge Modding Tutorial Setup | Forge Modding 1.17.1 #1

Let’s start minecraft modding with forge for minecraft 117.1 let’s see how to do that alright welcome to the first tutorial in the minecraft forge 117 one series where i basically show you how to set up minecraft modding with forge for minecraft 117.1 and there’s of course a

Few things that we’re going to need so there’s a few download links in the description below and we’re going to go through all of the prerequisites right now we’re going to set up everything so that you can start minecraft in the development environment so like i mentioned there’s a few prerequisites

Number one you’re going to need a jdk like you might know minecraft has been built with java therefore we’re going to need a jdk i really advise you to take the open jdk from adoptium right here basically just making sure that you are on open jdk 16 and then you can go down

Here and then basically choose the version that you need now there’s some differences here of course there’s so there’s linux versions there’s windows versions then there’s also version depending on what your architecture is so x86 would be for 30-bit version and then x64 would be for the 64-bit version

Of the operating system now i have a 64-bit operating system and the msi is going to be the easiest that’s basically file where you can just click and then install so you just download that and install it like any other program once that is installed you’re also going to

Need an ide an ide that is a integrated development environment it is basically a fancy text editor for programming basically and we’re going to be using intellij idea or this tutorial series and the community version here is completely free and open source so this is perfect for us link is of course also

In the description below make sure to download need that yes you do if you’ve never programmed before then you will need to start at some point and with something i can recommend the java tutorial by derek banas incredibly good it’s a good thing i don’t have a java tutorial of my own

Just yet i am planning on something however it’s just not quite ready yet this one will be totally fine otherwise you can of course take a look at anything else really but you will need a little bit of java knowledge otherwise you’re gonna have a very hard time

Understanding what is going on i will still try to explain everything as if you were a beginner i’m gonna try to be beginner friendly as possible however do keep in mind that some java knowledge is very much required and not optional right and then at the end you will need

The minecraft forge of course for the current version we’re going to be programming for minecraft 117.1 maybe if at some point 117.2 comes out there might be some differences i will probably have a pin comment at that point maybe stating the changes or if there’s no changes then you can of

Course just proceed if you’re watching this in the future which is very likely then instead of just one box being here you might have two boxes you will choose the right box because that is usually the recommended build and you’re going to choose the mdk here this will

Redirect you to a new site and then at the top right corner after waiting for six seconds you can click the skip button and then it will download a zip file i’ve already moved the zip file to the folder where i want to have my project and i will simply right click

And i’m going to extract it it’s going to create a new folder and it’s in there i can then delete the zip file if you don’t have a right click functionality then you’re going to need to install a program that will handle zip files i personally use vinrar but you can also

Use something like 7zip for example now i’m going to rename this to forge dash tutorial dot dash 117 one just like that then we’re gonna open the folder as you can see there’s quite a few things in here the first thing we’re gonna do is we’re going to delete all three of those

Files the credits the license and the readme file those are specific to the forge platform however my project is going to have a tiny bit of a different license for example and also different readme this is now fine what you’re going to do then is you’re going to

Start intellij now intellij is probably going to look a little bit different to you than it does to me right now however what is going to be the same is those three buttons the new project button the open button and the get from vcs button now we’re going to choose the open

Button and as you can see it already defaults to where the project is simply locate the folder that has all of the insights here so don’t choose the source of the gradle folder but shows the actual folder where those are located in let me select that and click ok then say

Trust project and then intellij will open and now a few things will happen in the background so it’s going to download a few things it’s going to basically set up a few things now this might take you know just a couple of seconds or it might take up to sort of two minutes

Three minutes depending on how fast your pc is just let this run through just keep be patient and at the end you will either get a build failed or a build successful either of those are fine we’re going to deal with the build failed in just a moment it only took 20

Seconds for me now this is because something has already downloaded so because i’ve set up this project before this is why it only took 20 seconds it might take two minutes for you be patient and wait for the build successful or the build failed build failed we’ll deal with in just a moment

Then i want to mention the warning here so you might get a warning this project is configured with the official obfuscation mappings provided by mojang what does that mean mappings in a very broad overview are basically the names of methods eels and parameters so everything has a certain name

Obfuscation basically is a process where those names are sort of scrambled up so that it’s not really readable for a human this is done so that you can’t just take code from someone else and just use it that’s the like very very high level overview and the mappings

Basically make it so that the code is readable now in the past there were the mcp mappings that were so provided by the mcp team those are however no longer available or 1.17 and upwards there will be only the official mappings as well as parchment mappings now parchment is the official

Mappings including some parameter names which are going to be very useful for us and we’re going to use the parchment mappings however how to set that up we’re going to see in the next tutorial in this tutorial we’ll just set everything up so that we could basically play minecraft in the dev environment

Long story short this warning can basically be ignored if you had a build failure or a build failed then you can do a few things so you can go to the terminal and you can put in dot backslash radalw like that and then gen intellij runs then hit enter now it’s

Going to now download a few things and take a look at a few things this can also take you know 10 seconds or it might take a minute or so and then we go build successful in 41 seconds now if you have a build fail here as well press

The up arrow and try this again so run this again if it still does not work there’s a few things that you can do number one you can delete this.gradle folder here and try to run it again if that still does not work we have a few

Other things that we need to set up here and that is going to be at the moment if we take a look back at the build folder at least for me i have java 8 so currently this runs on java 8 which is of course not quite what i want i

Actually want this to run on java 16. this should only really happen if you have multiple java versions installed on your pc if you followed the 116 tutorials this is where we had jdk 8 installed now we need java 16 so we need the other jdk there’s a few places where

We can basically change this so go to file and then project structure and then as you can see the project sdk is 1.8 the project language level however is 16. so we can basically change this to 16 hit apply and okay and then here under external libraries you can see

That it has a 16 so now it takes the jdk 16. there is however another place where we can change this and that is under settings build execution deployment build tools gradle then as you can see the grail jvm here it simply takes my project sdk so that’s great if it’s not

The case for you you can always change it to the 16 here as well and then everything should work you can then once again try the gen intellij runs once more and if that still does not work then you will most likely have an error

Here and you can then ask a question in the comments i will try to help you best i can right one last setting that you will need to take if this is your first time if you actually expand this java folder here then you can see the package

Structure now this might look different for you and the reason might be because you don’t have the flattened packages disabled so as you can see if i actually enable it like it would be per default then everything would be in one folder so to speak simply turn off flatten

Packages as well as compact middle packages and then everything will look exactly like it does for me right and now we can jump in and start changing some files the first thing that we want to change is in the build.gradle file simply double click to open and then

You’re greeted with this whole mess so this is quite a bit don’t worry about it we’re gonna go through the important bits part by part but firstly i want to draw your attention to these three things here so the version is the version of your mod now this is not

Really doesn’t follow any standard however what is really good is to basically put in the version of minecraft first and then a dash and then put the version of your mod in so i’m gonna do 117 one and then dash 0.0 so this would be the version of our mod

And this is the version of minecraft simply makes it a little bit easier for the user to see okay this is actually a mod for this version of minecraft instead of this version of minecraft the group here refers to the package structure of your mod usually this is a

Reverse domain name so my domain for example is net.tutorials by account joe now i would highly advise not to do this because then people might be saying wait this that’s not by you this is by tutorials by counting so simply put your name in here comm in

There that’s fine do put your name in here and then the mod id here is going to be the thing that is very interesting our mod id is going to be tutorial mod what is very important about the mod id is that it has to be all lowercase and

You can’t have any special characters in there so the only characters that are allowed are underscore dash and then numbers as well however that is it nothing else so you know spaces no no uppercase letters nothing like that so keep this as simple as you can the model

Is something that is very important for us so we will actually have to note that so we can change this here as well so tutorial mod and those three things are now changed correctly the next thing that we’re going to do is we’re going to hit ctrl r to get the replacement menu

Up and then the upper box here we’re going to put in example mod that’s basically the mod id that sort of comes with forge pre-programmed and we’re going to change that everywhere in this file to of course our mod id which is tutorial mod so we’re going to hit

Replace all and then it has been replaced in all the places where it needs to be replaced right now we can go up here to this little elephant that has appeared in the top right corner and simply click it this is going to basically load all of the changes that

We have just done basically the you know changing the name changing the group and the mod id there this should only really take a couple of seconds it shouldn’t be too long especially if you haven’t changed anything drastic here and then the changing of the build.gradle file is

Actually done can now proceed to go into our first class so we’ll open the example mod class by double clicking it and you can see that we are in here this is a normal java class and there’s a few things that we are going to change here

As well so we’re going to right click the example mod name refactor rename and we’re going to call this the tutorial mod class so tutorial mod and then enter it’s very important that you right click refactor rename because otherwise the name of the file will not change so for

Example if i just change this here you can see that a bunch of stuff happens that’s not good and we don’t want that we actually want to right click refactor rename very important next thing we’re going to do is we’re going to delete a bunch of stuff that’s in here so we’re

Going to basically put our cursor right here we’re going to hold shift and then click here so everything including the unq imc method is going to be deleted we’ll also just this is more for me than anything else i’ll format the early brackets correctly we’re gonna get two

Errors here you can simply delete those as well as the comment here and then two more things that we’re going to do is we’re going to basically select everything here starting with fml all the way up to get mod event bus right click refactor introduce a variable

We’re going to call this the event bus because this is something that we’re going to be using in future tutorials quite a bit so this is why it makes sense to basically introduce a variable for it and the other thing that we want to do is we want to we want to select

The example mod here including the quotation marks right click refactor introduce constant and we’re going to call this the mod underscore id and then i’m simply going to move it so i’m going to select it press control x and control v to paste it in here and now we have

Our mod id string right here now of course example mode is not armor id model armada’s tutorial mod now if you know this comment the value here should match an entry in the meta in slash mods.toml file interesting so our mod id is currently tutorial mod and this has

To match in the mods.toml file so if we open the resources folder and then the meta in folder we see there is a mods.tamil file here you double click and open it you can see mod id and i can change this to tutorial mod but this has

To match exactly what we are put in here if this does not match then it will say something like no match in the mods.thomas file found for your mod id something like that and that is of course not what we want so this has to match and then the display name i’m just

Gonna make it tutorial mod that’s gonna be fine so that’s also very important and then last but not least we’re going to change the package up here so this should be the package that you have put in right here select this copy it with

Ctrl c and then ctrl v to paste it in and then i can simply say move to package okay and then over here this will have changed so now my tutorial mod class is in the package net tutorials by carpendra tutorial mod i can then delete the empty packages right here and

Everything is now set up and now we can actually see if minecraft works so to start minecraft we’re going to to the top right here to gradle then we will expand tasks forge radial runs and then run client so simply double click that and then we can minimize this as well

And simply let it run through and there we go minecraft has started successfully i can also click the mods button here and take a look at the tutorial mod so it has been loaded in of course we don’t have any functionality nothing is really happening for with our mod but our mod

Is in the game so that’s pretty cool and now the development environment has been set up so this would actually be it however i will also show you how to set up a github repository this step is optional however highly recommended because having that is number one making it

Fairly easy for other people to basically see what your errors are so you can simply say hey this is my github repository they can simply download it and see everything that you have done so that’s going to be really easy this is why i highly recommend actually making a

Github account link is of course also in the description below and this is going to be really easy simply make an account there log in make sure that you’re logged in and then in intellij you can go to vcs up here and you can say create git repository now you’re going to

Select the folder where the project is in and say okay and now the git repository actually has been created but this is a local repository at the moment so what we can do is we can go to git and we can say github and then say share

Project on github we can click this the repository name is going to be fine i’m going to make this private for the time being if you want to share this with for example me if you have an error or something like that then make this public otherwise this is not going to

Work we could make a description but we’re not going to do that and now we need to add an account so this is something that you might have and you can simply say login via github i will click this and then the jetbrains account management here will open and i

Simply have to click authorize in github you have been successfully authorized but what might happen for you is the github window might open and it’s going to say hey do you really want to authorize you know jetbrains to use this you simply say yes and then everything

Will work you can see now my profile has been added here so share by count joe that is my github name and i can simply click share the background is now creating the actual repository and there you go so add files for initial commit the initial commit is basically the

First draft so to speak of all of your files so we’re simply going to take a look at this this is totally fine and we can simply hit add and everything will now be pushed and there you go successfully share project on github and

If i can now if i now switch to github again there it is so exactly count forge dash tutorial 117.1 so exactly where we have put it and there it is now if you make any changes here you can basically you know add a comment you can

See that the tutorial mod class has now turned blue this simply signifies there’s been a change in this file and we can go to commit on the left here and see oh those are all of the files that have changed and i can simply click the

Check mark and say added a comment and now what’s very important is that once i hit commit here i’ve now committed this change and now the tutorial mod class will no longer be blue however the change i have committed is not yet on the github repository for that we

Actually need to go up here to this little push button this arrow and we need to click it and then as you can see this is the commit i’ve just made and i actually have to simply click the push button here and then it’s going to push

That change to the github repository so if i go back here and i reload you can now see added a comment and i can go in here you can see added a comment and there you go added a comment i can also take a look at this there you go add a

Comment so now the comment is actually in there the change has been noted and is also uploaded on the github repository right all throughout the tutorial series you will of course also have my github repository for this tutorial series available for you to basically well download play around with

Take a look at the code as well so that is also available link is always in the description below as well i will also have individual gists so basically individual pastes of each file that has changed in each tutorial so while the github repository is going to be

Separated into branches so each tutorial will have a separate branch the gists are always only the changes that you will need to do for this particular tutorial if there are any files or anything like that there’s also going to be download links in the description below for each tutorial so no worries

There and yeah if you run into any issues or something like that you can always leave a comment or join the discord server that is also linked in the description below where i can offer you help best i can only on very few cases i’ve not been able to help someone

Set everything up correctly so yeah but that would be it for this tutorial right here i hope you found this useful you learned something new and you were successful setting everything up if there’s anything else please leave a comment down below and i would of course

Also appreciate a like and i will see you in the next tutorial so yeah