

About
Arbitrary Portals allows players to create nether portals of all different shapes and sizes, removing the needless rectangular restriction imposed by the vanilla game.
Usage
Build a portal frame in any shape you want (even containing holes), and then light it as normal! By default, the frame must be made of Obsidian, contain at least 6 blocks inside (like Vanilla's smallest 2x3 portal) and not be larger than 21x21 inside (Vanilla's maximum portal size) All of these options are configurable! See the Config section below for more information
Commands and Permissions
| Command | Description | Permission | Default |
|---|---|---|---|
| /arbitraryPortalsReload | Reloads the config file | arbitraryPortals.reload |
OP |
Config
# The maximum dimensions of the portal (default: 21 from largest Vanilla 21x21 portal)
maxWidth: 21
maxHeight: 21
# The total portals blocks inside a portal (default: 6 from smallest Vanilla 2x3 portal)
minPortalSize: 6
# List of blocks that can be used to build a nether portal
# Needs to be a valid material from https://jd.papermc.io/paper/1.20/org/bukkit/Material.html
portalFrameMaterials:
- OBSIDIAN
# - CRYING_OBSIDIAN
Shoutouts
While this plugin closely resembles Xisumavoid's "Custom Nether Portals" datapack, I actually started work on this months before he released his, and had the idea for years before that. Still, though, all of the Vanilla Tweaks datapacks are awesome and everyone should definitely check them out https://vanillatweaks.net/picker/datapacks/
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as ArbitraryPortals-2.0.0.jar — drop this file into the mods folder
- Download size: 8 KB
- Download link checked 29 Aug 2026 — working
These come from our own check of the pack file, not from the source page.