Kyanite Portals
by Kyanite Mods
Kyanite Portals is a Fabric library for creating custom portals, built first to support the Deeper Darker mod and later made available to other developers.
What it does
The library provides a modular system in which a developer registers a set of components: a portal frame part, a portal generator, an ignition source and a tester. The generator decides how a portal is built, while the tester checks whether the portal interior is valid and triggers actions and client-side effects such as travel sound and nausea.
It was created because the Custom Portal API did not cover everything Deeper Darker needed, including multiple ignition sources, correct checking of the inner portal contents, execution of custom code during travel, and generating a portal inside a dimension's bounds. Kyanite Portals is open source under the MIT License, and its source code, issue tracker and wiki are public. A server running it needs every connecting player to have it too.
The author notes that the library is still in beta and recommends a different library until it is fully stable. Updates are planned to improve JSON integration, refactor some methods and add new features. Files are published for 1.20.1, 1.20.2, 1.21, 1.21.1, 1.21.9, 1.21.10 and 1.21.11, with 0.1.8+1.21.11 for 1.21.11 as the latest file on the beta channel.
Key features
Custom portal creation
Developers can define new portal types with their own frame shapes, ignition methods and travel behavior.
Modular registration
Each part of a portal, including its generator and tester, is registered as a separate component that can be swapped.
Custom travel code
Code can run when an entity travels through a portal, which the Custom Portal API did not allow for Deeper Darker.
Client-side effects
The tester can trigger travel sounds and nausea effects on the client, so entering a portal feels distinct.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Kyanite Portals suits mod developers who need portals with custom ignition, validation or travel logic. It is a library and adds no portal content to the game on its own.
How it compares
Immersive Portals Updated and Immersive Portals both run on client and server, are open source under the Apache License 2.0, and target Fabric for 1.20 – 1.21.1 and 1.16.5 – 1.21.1 respectively. Immersive Portal Gun is also client and server, open source under the MIT License, and covers 1.19.4 – 1.20.4 on Fabric.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Kyanite Portals | Fabric | 1.20.1 – 1.21.11 | Client and server | 2026-07-31 |
| Immersive Portals Updated | Fabric | 1.20 – 1.21.1 | Client and server | 2026-08-18 |
| Immersive Portals | Fabric | 1.16.5 – 1.21.1 | Client and server | 2025-11-21 |
| Immersive Portal Gun | Fabric | 1.19.4 – 1.20.4 | Client and server | 2024-02-16 |
Questions
Does Kyanite Portals require Fabric API?
Does a server need Kyanite Portals?
Is Kyanite Portals stable enough for production?
In the catalog
Kyanite Portals is one of 3,932 Transportation mods on ModsFinder, and one of 2,390 Transportation mods for Fabric. 19,862 mods support Minecraft 1.21.11.
Similar mods
What the author says
Kyanite Portals is a library that allows you to easily create custom portals. WARNING: Library is in beta and currently only made for Deeper and Darker. It will receive updates in the future to improve JSON integration, refactor certain methods, and add new features. I recommend instead using a different library…
Official listing
- Modrinth page
- modrinth.com/mod/kyanite-portals
- Owner
- Kyanite Mods
- Published
- 2026-01-05
- Updated on Modrinth
- 2026-07-31
- Facts verified
- 2026-10-15