---

---

Description

This is a mod API that provides easily customizable and server-sided portals to any custom dimension.
This mod is required server side only, and is thus compatible with any client, Vanilla included.
This mod can be used as a dependency for another mod/datapack, or bundled in a modpack with a custom datapack or with mods that require it.

Check out the usage details below or on the Wiki!

Features

• Allows the creation of portals with a custom frame that are linked for a specific dimension.
• Choose the frame blocks simply with a block tag! Multiple blocks are allowed!
• Required only server side!
• Fully compatible with both modded and Vanilla clients.
• Easy to use with either a mod or a datapack.

Usage

You can find up-to-date examples for both a datapack and a mod on the Wiki.

Datapack

It's very easy to make use of this mod API with a custom datapack:

1. Create a datapack following this tutorial.
2. Create a custom dimension type with this generator.
3. Create a custom dimension with this generator.
4. Create a custom block tag for the portal frame. You can add multiple blocks and other block tags too!
5. Make sure all the JSON files you created in the previous steps are called the exact same.

That's it! When the datapack is loaded along with this mod, all dimensions will be loaded, and it'll be possible to create portals with the specified frame blocks!
You can also add multiple dimensions, each with its custom portal definition: just make sure that, for each one, the dimension files and the block tag file are called the same.

Mod

Making a mod that leverages this API is simple.
Follow the instructions in the datapack section above, but put the files under resources/data/mod_id/.
Making a mod rather than a datapack might be useful for adding extra functionality regarding your dimension.

There are also a few useful utility methods available, for which you can check out the Javadoc for more details.

Compatibilities

Mod	Loader	Compatibility
Crying Portals	All	Incompatible
Immersive Portals	All	Incompatible
Very Many Players	Fabric	Compatible with use_async_portals=false
Canary	Forge	Compatible with fast portals disabled

Dependencies

Mod	Loader	Requirement
Cobweb	All	Required

License and right of use

Feel free to use this mod for any modpack or video, just be sure to give credit and possibly link here.
This project is published under the GNU General Public License v3.0.

Support us