Wiki 9Minecraft Wiki 9Minecraft

Custom Portals Wiki & Guide

Java EditionMod

Adds colored portal blocks and runes for creating custom dimensional gateways.

DownloadCustom Portals

Get the files on 9Minecraft

Contents (9)
  1. Guides
  2. Processes
  3. Items
  4. Blocks
  5. Configuration
  6. Customportals:Config
  7. Frequently asked questions
  8. Related mods

Guides

Step-by-step, in-game.

Build a Flat Portal on the Ground or CeilingUnderstanding Portal Orientation Portals in this mod aren't limited to vertical frames—you can build them lying flat…Connect Multiple Portals with Different ColorsUsing Dye Colors to Organize Routes Each dye color creates a separate portal network. This means you can build…Create Your First Portal Between Two BasesBuilding the Portal Frame Start by choosing a block type for your frame—this can be any solid block like stone,…Use Runes to Enhance Your PortalsWhat Runes Do Runes are special additions that modify portal behavior and functionality. They can enhance your…

Recipes

Every recipe the mod adds, grouped by how it is made.

Crafting · 37

Items

EGHIPS

E

Enhancer Rune

G

Gate Rune

H

Haste Rune

I

Infinity Rune

P

Portal Catalyst (Black)Portal Catalyst (Blue)Portal Catalyst (Brown)Portal Catalyst (Cyan)Portal Catalyst (Gray)Portal Catalyst (Green)Portal Catalyst (Light Blue)Portal Catalyst (Light Gray)Portal Catalyst (Lime)Portal Catalyst (Magenta)Portal Catalyst (Orange)Portal Catalyst (Pink)Portal Catalyst (Purple)Portal Catalyst (Red)Portal Catalyst (White)Portal Catalyst (Yellow)

S

Strong Enhancer Rune

Blocks

BCEGHILMOPRSWY

B

Black PortalBlue PortalBrown Portal

C

Cyan Portal

E

Enhancer Rune

G

Gate RuneGray PortalGreen Portal

H

Haste Rune

I

Infinity Rune

L

Light Blue PortalLight Gray PortalLime Portal

M

Magenta Portal

O

Orange Portal

P

Pink PortalPurple Portal

R

Red Portal

S

Strong Enhancer Rune

W

White Portal

Y

Yellow Portal

Configuration

Every setting in the mod config file, with what it changes.

OptionWhat it does
defaultRangeDefault Portal Range (In Blocks)
filteredBlocksFiltered Blocks
muteAmbientSoundsMute Ambient Portal Sound Effects
muteTeleportSoundsMute Player Teleport Sound Effects
rangeWithEnhancerPortal Range With Enhancer Rune
rangeWithStrongEnhancerPortal Range With Strong Enhancer Rune
unlimitedRangePortals Always Have Unlimited Range
alwaysInterdimPortals Always Link Across Dimensions
alwaysHastePortals Always Teleport Instantly
privatePortalsPrivate Portals
redstoneRedstone...
isWhitelistWhitelist or Blacklist

Customportals:Config

OptionWhat it does
falseBlacklist
generalGeneral
block_filter_settingsPortal Frames
range_settingsPortal Range
trueWhitelist

Frequently asked questions

How do I create my first portal?
Build a frame from any single block type (like obsidian, stone, or wood), then use dye on the frame to activate it with a color. The portal will link to any other portal with the same frame block and dye color, creating a two-way connection.
Can portals be any shape?
Yes, portals can be any shape as long as the entire frame is made from the same block type. They can be rectangular, circular, diagonal, or even completely irregular – the shape doesn't matter, only the block material and color.
What happens if I have multiple portals with the same color and block?
All portals sharing the same block type and color form a network, and stepping into any of them will randomly teleport you to one of the others in that group. If you want separate portal pairs, use different dye colors or different frame blocks.
Can I make a flat portal on the ground or ceiling?
Yes, portals work in any orientation. You can build them horizontally on the ground or ceiling by arranging your frame blocks in a flat pattern, then activate with dye just like a vertical portal.
What are runes and how do I use them?
Runes are special enhancements you can place on or near portals to modify their behavior – such as preventing random teleportation, restricting who can use them, or changing their effects. Check your guides on portal enhancement for specific rune placement and effects.
Do I need specific materials to build a portal frame?
No, you can use almost any block type for the frame – stone, wood, obsidian, dirt, or anything else. Different blocks don't affect function, only aesthetics and the color-coding system for linking portals.
Can I remove or change a portal's color after creating it?
Yes, you can use a different dye color on an existing portal to change its link group, or remove the dye entirely to deactivate it. The frame blocks remain unchanged.
Do Custom Portals work across dimensions?
Custom portals link within the same dimension – a portal in the Overworld connects to other Overworld portals with matching block and color, but not to portals in the Nether or End.
What's the performance impact of having many portals?
Custom portals are generally lightweight, but having dozens of large portals or complex rune setups in the same area may cause minor lag. Performance impact is minimal compared to other mods.
Can I make a portal that only I can use?
Yes, runes can restrict portal access to specific players or teams. Refer to your rune enhancement guide for the exact rune types and placement needed for access control.