Getting Started

Instillation

Install the mod and its two dependencies Architectury and Rhino.
Make you use the most resent version of each mods for your version.
If you are using 1.16 fabric then use this instead.

When you first install KubeJS, you will need to launch Minecraft with the mods (and the game not crashing) to generate the some folders and files.

The `kubejs` folder

Finding it

Everything you do in KubeJS in located in the kubejs folder in your instance.

In PolyMC the file structure will look like polymc > instances > instance name > minecraft > kubejs In CurseForge launcher the file structure will look like curseforge > minecraft > instances > instance name > kubejs In both of these cases the instance name is the name of the instance

From now on this will be referenced as the kubejs folder.

The contents of it

startup_scripts

Scripts that get loaded once during game startup Used for adding items and other things that can only happen while the game is loading Can reload code not in an event with /kubejs reload_startup_scripts To reload all the code you must restart the game client_scripts

Scripts that get loaded every time client resources reload Used for:

JEI events tooltips other client side things Can reload code not in an event with /kubejs reload client_scripts Can reload all the code in client_scripts with F3+T server_scripts

Scripts that get loaded every time server resources reload (world load, /reload) Used for modifying:

recipes tags loot tables handling server events Can reload code not in an event with /kubejs reload server_scripts Can be all the code in server_scripts with /reload exported

Data dumps like texture atlases end up here config

KubeJS config storage. This is also the only directory that scripts can access other than world directory assets

Acts as a resource pack you can put any client resources in here, like:

textures

Example: assets/kubejs/textures/item/test_item.png models lang etc. Can be reloaded by pressing F3 + T Can reload only the lang files (so faster) /kubejs reload lang Read more about it here. data

Acts as a datapack you can put any server resources in here, like:

loot tables

Example: data/kubejs/loot_tables/blocks/test_block.json functions etc Can be reloaded with /reload Read more about it here. README.txt

Contains the information here

You can find type-specific logs in logs/kubejs/ directory

Other Useful Tools

Code is just a language that computers can understand. However, the grammar of the language, called syntax for code, is very precise. When you code has a syntactical error, the computer does not know what to do and will probably do something that you do not desire.

With KubeJS we will be writing a lot of code, so it important to avoid these errors. Luckily, there are tools called code editors, that can help us write code correctly.

Writing Your First Script

If you have launched the game at least once before you will find kubejs/server_scripts/example_server_script.js It looks like this:

// priority: 0

settings.logAddedRecipes = true
settings.logRemovedRecipes = true
settings.logSkippedRecipes = false
settings.logErroringRecipes = true

console.info('Hello, World! (You will see this line every time server resources reload)')

onEvent('recipes', event => {
	// Change recipes here
})

onEvent('item.tags', event => {
	// Get the #forge:cobblestone tag collection and add Diamond Ore to it
	// event.get('forge:cobblestone').add('minecraft:diamond_ore')

	// Get the #forge:cobblestone tag collection and remove Mossy Cobblestone from it
	// event.get('forge:cobblestone').remove('minecraft:mossy_cobblestone')
})

Lets break it down:

// priority: 0

Makes it so that if you have multiple server scripts, this script gets loaded first If you have only one server_script, this has no effect settings.logAddedRecipes = true
settings.logRemovedRecipes = true
settings.logSkippedRecipes = false
settings.logErroringRecipes = true

sets settings for what messages are logged You can remove all four of these lines if you want and it will only change what is put into the logs console.info('Hello, World! (You will see this line every time server resources reload)')

Prints the message in the log This line is useless other then example and should be removed eventually onEvent('recipes', event => {

This makes an event listener for the recipes event, and will run the code inside when and only when the recipes event is triggered This is triggered when server resources reload

Which happens when the world load or the /reload command is used // Change recipes here

comment, an code in a line following // will be considered a comment and will not be run Used for taking notes as you write the code })

Indicates the end of the 'recipes' event listener

onEvent('item.tags', event => {
// Get the #forge:cobblestone tag collection and add Diamond Ore to it
// event.get('forge:cobblestone').add('minecraft:diamond_ore')

// Get the #forge:cobblestone tag collection and remove Mossy Cobblestone from it
// event.get('forge:cobblestone').remove('minecraft:mossy_cobblestone')
})

Same thing as the other one but for the item.tags event You can find the list of all event here

Finally Writing Code For Real

Lets start off by adding a recipe to craft flint from three gravel.

To do so, insert this code right after the recipes event.

event.shapeless("flint", ["gravel", "gravel", "gravel"])

It should look like this:

// priority: 0

settings.logAddedRecipes = true
settings.logRemovedRecipes = true
settings.logSkippedRecipes = false
settings.logErroringRecipes = true

console.info('Hello, World! (You will see this line every time server resources reload)')

onEvent('recipes', event => {
	// Change recipes here
	event.shapeless("flint", ["gravel", "gravel", "gravel"])
})

onEvent('item.tags', event => {
	// Get the #forge:cobblestone tag collection and add Diamond Ore to it
	// event.get('forge:cobblestone').add('minecraft:diamond_ore')

	// Get the #forge:cobblestone tag collection and remove Mossy Cobblestone from it
	// event.get('forge:cobblestone').remove('minecraft:mossy_cobblestone')
})

Now lets test it!

Run the command /reload in game, then try crafting three gravel together in any order.

But how does it work?

event

This is a variable that created with the arrow expression in onEvent('recipes', event => {...

You can have the name be what every you choose, as long as it matches everywhere .

The dot operator is used for calling a method of an object In this case event is the object and shapeless is the method shapeless(

This is the method that is called by the dot operator on the event It is taking two arguments, that being an item result and a array input "

Indicates the start of a string flint

The contents of the string You can use create:flour , if it is from a different mod (flint is the same as minecraft:flint, and both are valid)
"

Signifies the end of the string. A string is simply a sequence of characters, or letters You can read more about strings in JS here. ,

separates different arguments in the method. [

Signifies the start of the array. An array holds multiple values or any type, including other arrays. You can read more about arrays in JS here. "gravel", "gravel", "gravel"

The contents of the array Arrays can hold an indefinite number of elements ]

Closing the array )

Closing the method

There you go! You can make custom shapeless recipes!

If you want to make other types of recipes, learn about it here, and if you have an addon that adds more recipe types, loot at its mod page, or here.