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
Datapack
It's very easy to make use of this mod API with a custom datapack:
- Create a datapack following this tutorial.
- Create a custom dimension type with this generator.
- Create a custom dimension with this generator.
- Create a custom block tag for the portal frame. You can add multiple blocks and other block tags too!
- 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.
You can check out a working example here.
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
