ShapedPortals

Nether and End portals in any shape

ShapedPortals lets players light portals in frames of any closed shape. An obsidian arch or circle becomes a Nether portal, and a closed ring of End Portal Frames opens to the End.

Minecraft still picks where each Nether portal leads and builds a normal rectangular exit there.

Build portals in any shape

Nether portals

Build a closed frame in any outline, then light it.

• Frames use obsidian, crying obsidian or blocks you choose
• Light it with flint and steel or a fire charge
• You can also allow dispensers, lava and explosions
• The inside must be one connected opening
• Corners can be left out
• Holds 2 to 256 portal blocks by default
• Fits within 64 by 64 by default

End portals

Place the last Eye of Ender in a closed, flat ring of End Portal Frames.

• The ring can be any outline
• Frames can face any direction
• Corners can be left out
• Holds 1 to 256 portal blocks by default
• Fits within 64 by 64 by default

Repair and protection

• Portals will self-repair if blocks were removed by another plugin
• Breaking the frame or placing a block inside removes the portal
• A background check catches WorldEdit changes
• Claim plugins are respected by portal creation
• Everyone can create shaped portals by default
• Turn on or off portals per-world

Staff tools

• A portal list with world, size and creator
• Click a portal to teleport beside that portal
• An in-game editor for every setting
• Edit any message in game
• File edits hotload and bad edits are ignored
• Each player can pick their own language

Getting started

1. Stop the server and put the jar in plugins/.
2. Start the server. The first start downloads its libraries.
3. As an operator, open /sp config to check frame blocks, size limits and worlds.
4. Build a flat, upright obsidian frame in any closed shape and light it.

Commands and permissions

Commands

Aliases: /sp and /shapedportal

/sp status                       Show portal counts and results
/sp config                       Open the settings editor
/sp portals [page]               List saved portals
/sp teleport <id or prefix>      Go to a safe spot beside a portal
/sp language                     Open language controls
/sp language self <lang|reset>   Pick your own language
/sp language server <lang>       Set the server language
/sp language server edit [lang]  Edit messages in game
/sp language update              Check translation updates
/sp debug dump [upload=false]    Create a report and upload it
/volmit plugins                  Shared tools for Volmit plugins

Permissions

Permission                     Default   Allows
shapedportals.create           everyone  Create portals
shapedportals.command          everyone  Help and status
shapedportals.language.self    everyone  Pick your own language
shapedportals.config           op        Settings, server language, messages
shapedportals.portals          op        List saved portals
shapedportals.teleport         op        Teleport to portals
shapedportals.teleport.unsafe  op        Accept an unsafe landing
shapedportals.debug            op        Diagnostic reports
shapedportals.update           op        Update notices

Compatibility and limits

Runs on: Paper, Purpur, Leaf, Folia, Canvas, Spigot

Minecraft: 26.1 to 26.3 on Java 25

Optional: Wormholes, React

• Platforms One jar runs on all six. On Folia, the whole frame must sit inside one region when it is lit.
• Integrations Wormholes 2.0.7 or newer links shaped Nether portals both ways in the worlds it pairs. Its portal replacement setting must be on. Portals Wormholes links are run by Wormholes and leave the /sp portals list.
• Languages English plus 17 translations. Set one for the server or let each player pick. You can add your own language files alongside the included ones.
• Network Downloads its libraries on first start and checks GitHub for updates. Debug reports upload to mclo.gs unless you add upload=false.
• Limits Vertical End portals and 3D shapes are not supported. Portals are capped at 4,096 inside blocks and 512 per side.