Simple Custom Portal
by Unfamily
Simple Custom Portal lets pack developers define portal blocks in JSON files, each one sending the player to a chosen dimension on NeoForge for 1.21.1.
What it does
Each portal is described in a JSON file placed in the portals folder, and every entry must carry an id that no other entry uses. A definition names the portal blocks it accepts, the destination dimension by its resource key, and the coordinates used on arrival. Because the destination is a resource key, a portal can lead to vanilla dimensions such as minecraft:overworld or to custom dimensions added by other mods.
Optional fields shape how the portal is built and how it behaves. A base block can replace an empty floor to form a safe-zone capsule, and a capsule block can fill the walls and ceiling. A sound can be attached to the portal block for placing, breaking and stepping, with glass as the default. The mod also reads an externalScriptsPath setting from its config, and portal definitions can be reloaded live with a command, so changes apply without restarting the game.
Install the mod on the client and on the server, since the environment is client and server. It is released under the MIT License and is open source, with public links for the source code and issue tracker. Files exist only for NeoForge 1.21.1, and the latest file is 1.0.0.0.0, published on 2026-02-09.
Key features
JSON portal definitions
Each portal is described in a JSON file with a unique id, so pack developers add portals without writing code.
Custom destinations
A portal sends the player to a dimension given by its resource key, including vanilla dimensions and custom ones.
Safe-zone capsules
Optional base and capsule blocks build a floor, walls and ceiling around the arrival point, and empty spaces are replaced or filled.
Portal sounds
An optional sound is attached to the portal block for placing, breaking and stepping, with glass as the default.
Live reload
Portal definitions reload with a command, so edits take effect without restarting the game.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
Nothing Dimension is a client and server mod for NeoForge 1.21.1 that adds a dimension, and it is open source under the GNU General Public License v3.0 only. Server Swapper is also client and server for NeoForge 1.21.1, but it is closed, released under All rights reserved. Custom Portals Foxified is client and server for NeoForge 1.21.1 and open source under the GNU General Public License v3.0 or later, so its license differs from this mod's MIT License.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Simple Custom Portal | NeoForge | 1.21.1 | Client and server | 2026-02-09 |
| Nothing Dimension | NeoForge | 1.21.1 | Client and server | 2024-09-08 |
| Server Swapper | NeoForge | 1.21.1 | Client and server | 2025-06-27 |
| Custom Portals Foxified | NeoForge | 1.21.1 | Client and server | 2026-04-28 |
Questions
Does Simple Custom Portal need to be installed on both sides?
Which game versions does Simple Custom Portal support?
How are portal definitions changed without a restart?
In the catalog
Simple Custom Portal is one of 3,932 Transportation mods on ModsFinder, and one of 1,743 Transportation mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
More from Unfamily
Similar mods
What the author says
Add custom portal blocks to your pack: each block teleports to a dimension you choose (e.g. custom dimensions, Nether, End) at the same x, y, z. For pack creators: define portals in JSON (id, destination, optional base/capsule blocks, sound, usable dimensions, default return). Files go in a configurable directory —…
Official listing
- Modrinth page
- modrinth.com/mod/simple-custom-portal
- Owner
- Unfamily
- Published
- 2026-02-07
- Updated on Modrinth
- 2026-02-09
- Facts verified
- 2026-10-15