---
title: Cosmic Invocation
hide_meta: true
---

Cosmic Invocation is the process of generating config files for all loaded mods. In the older versions,
players had to construct and activate their own Transfinite Altar to enrich the multiverse with modded content;
now this process is performed automatically by a special Cosmic Altar.

In singleplayer, invocation happens on the first couple of ticks of the first world created on a new game instance
(since config files are shared between all the worlds on an instance). On a server, it is performed the instant the first player
joins the game.

Currently, the config files and therefore types of modded content which the invocation is able to scan for and introduce to dimensions are:
* blocks,
* fluids,
* mobs,
* sounds,
* items,
* particles,
* status effects,
* block tags,
* structures plus some of their additional data,
* biomes and surface rules for them.

Blocks are auto-assigned tags needed for the generator to know which parts of worldgen are they usable for ("full", "laggy" etc.,
see the page on [configuring the mod](Configuring-the-mod)), plus checked for different traits (being a flower, rotatable, dyeable etc.).
Mobs are auto-tagged with their spawn group (monsters, underwater creatures etc.). Music is also auto-chosen from the list of sounds,
although the way the game checks for that is currently imperfect (it just checks if the ID of the sound event contains the
substrings "music" or "disc"). When scanning for biomes, the game ignores all the ones from Infinite Dimensions itself as to not
introduce mod-generated biomes into the pool of ones to choose from when you specifically want to _not_ generate one; a similar thing happens
with structures.

All the entries in all these lists are assigned the default weight of 1.0. You're free to edit these weights as you wish after
the invocation if you want to tweak the rarity of certain blocks/mobs/etc. or disable some of them from appearing in mod's dimensions
altogether (set the weight to 0.0 for that).

## Known issues with invocation
* Invocation only happens once per game folder. As such, if you add new mods to the instance after you already loaded worlds on it once,
invocation will not happen again. This especially stands for the default Minecraft launcher by Mojang, which by design only uses one.
To force the invocation to happen again, you can either construct and activate the Transfinite Altar, or delete the file
`config/infinity/modular/invocation.lock` and relaunch the game.
    * Note that such reinvocation will not touch any of the existing files, only add new ones. As such, it is useful by itself only when
    adding new mods to the instance. If you update one of the mods (including Infinite Dimensions!) to a newer version that brings
    more content, or *especially* if you remove mods, you have to purge the `/config/modular` folder entirely to do a successful reinvocation.
* Starting at version 2.1.0 of the mod, Infinite Dimensions will automatically delete all modular configs and issue reinvocation
if it detects that the version of those configs (set in the invocation lock) is outdated. If you make changes to your modular configs,
do a backup of them before updating the mod!