-
Notifications
You must be signed in to change notification settings - Fork 5
Explanation
Summoning Rituals lets you add custom summoning recipes for items and mobs.
It has a native KubeJS integration for adding new recipes and also two events to enhance the functionality even further.
The Altar block is fully automatable and accepts items from Hoppers and all kinds of item pipes. It's essential to insert the Catalyst last because this will start the craft.
A Catalyst is an item that is inserted last into the altar in order to start the ritual.
Every recipe needs a Catalyst and it has a maximum amount of one. So even if a player has a whole stack of the Catalyst item in their hands, the Altar will only take one item of this stack.
The Catalyst will pop out of the Altar if any of the ritual conditions are not met.
Ritual outputs are divided into item outputs and mob outputs. They also support special NBT so you can even spawn mobs with more health than usual.
The offset of an output defines the position relative to the Altar to shift the origin of the output spawn.
By default, all outputs will spawn directly above the Altar. An offset of e.g. 3, 2, -5 will shift that position to 3 blocks on the x-axis, 2 blocks on the y-axis and 5 negative blocks on the z-axis.
The spread of an output defines the random distribution around the origin position (after the offset). For mob outputs, each mob will be treated individually. Item outputs are grouped in stacks of a maximum of 4 items.
By default, all outputs will have a spread of 1, 0, 1 which means they can spread a bit on the horizontal axes.
Inputs are generally considered items only. They define the items placed inside the Altar and later consumed when the ritual is complete.
Sacrifices refer to mob inputs. Since they can't be placed inside the Altar, they have to be placed nearby the Altar in a specific Sacrifice Region defined per recipe.
The Sacrifice Region defines the area around the altar where mobs can be placed in order to be consumed by the ritual.
The default region is 3, 2, 3 which actually resolves to 5x3x5 because the origin is the center of the altar.