SimplePortals
Modern, lightweight and highly optimized portal system
Author: Aquiles |
Version: 1.0.0 |
Compatibility: 1.19.4 to 1.21.11+ (and forks)
Support Discord
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Looking for a
simple ,
fast , and
modern portal plugin without outdated systems or unnecessary bloat?
SimplePortals is a lightweight portal engine built from scratch for modern Minecraft servers, focused on
performance ,
clean configuration , and
easy portal creation .
Create cuboid portals with a selector wand, send players to local destinations or proxy servers, and configure advanced portal actions directly from
portals.yml .
⚡ Why choose SimplePortals?
Built for modern versions from 1.19.4 up to 1.21.11+.
Optimized chunk-based portal lookup for efficient movement checks.
Folia-aware and compatible with modern Paper forks.
Very simple creation flow : select region, create portal, done.
Advanced actions available without forcing complexity on basic usage.
Performance
Yes
Usually mixed
Version Support
1.19.4 - 1.21.11+
Often legacy-oriented
Folia Compatibility
Yes
Rare / partial
Simple Portal Creation
Yes
Often more complex
Proxy Destinations
Yes
Not always
MiniMessage + Legacy Colors
Yes
Usually limited
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Main Features
Fast and Easy Portal Creation
Use /portal wand to get the selector axe.
Select point 1 and point 2 with the wand.
Create the portal with /portal create desti:<destination> block:WATER .
Optional automatic replacement of air blocks inside the region.
Modern Selector Preview
Cuboid selection preview with particles .
Block face hologram-style displays for selected points.
Coordinate display above the selected block.
Portal Actions
Every portal can be configured individually in
portals.yml :
Messages
Titles and subtitles
Sounds
BossBars
Commands
Potion effects
Cooldowns
Permissions
Sneaking conditions
Deny messages
Text Formatting Support
Legacy colors (&) supported in messages.yml and portals.yml .
MiniMessage supported in messages.yml and portals.yml .
Use modern formatting for titles, messages, bossbars, and more.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands and Permissions
Main Command:
/simpleportals
/portal (alias)
Commands:
/portal help - Show help menu (simpleportals.command.help )
/portal wand - Get the selector wand (simpleportals.command.wand )
/portal create desti:<destination> [block:<type>] - Create a portal from your selection (simpleportals.command.create )
/portal reload - Reload config, messages and portals (simpleportals.command.reload )
/portal show <radius> - Show nearby portals (simpleportals.command.show )
/portal remove <name> - Remove a portal (simpleportals.command.remove )
/portal delete <name> - Alias of remove (simpleportals.command.remove )
/portal setblock <portal> <block> - Change a portal trigger block (simpleportals.command.setblock )
/portal tp <destination> - Teleport directly to a destination (simpleportals.command.tp )
/portal destination create <name> - Create a local destination (simpleportals.command.destination.create )
/portal destination remove <name> - Remove a destination (simpleportals.command.destination.remove )
Portal Use Permission:
simpleportals.use - Allows players to use portals
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Supported Trigger Blocks
WATER
LAVA
AIR
NETHER_PORTAL
END_PORTAL
END_GATEWAY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Example Creation Flow
Run /portal wand
Left click a block for point 1
Right click another block for point 2
Create a destination with /portal destination create spawn
Create the portal with /portal create desti:spawn block:WATER
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Spoiler: Click to view screenshots
Example Portal Configuration
Code (YAML):
portals :
example :
enabled
: true
destination
: spawn
world
: world
trigger-blocks
: - WATER
min :
x
: 100
y
: 64
z
: 100
max :
x
: 102
y
: 66
z
: 102
settings :
cooldown-seconds
: 3
required-permission
:
""
conditions :
enabled
: false
sneaking-required
: false
deny-message
:
""
actions :
message :
enabled
: true
text
:
"<green>Welcome to the portal!"
title :
enabled
: true
title
:
"<aqua>Teleporting..."
subtitle
:
"<gray>Please wait"
fade-in
: 10
stay
: 40
fade-out
: 10
sound :
enabled
: true
sound
:
"ui.button.click"
volume
: 1.0
pitch
: 1.0
bossbar :
enabled
: false
text
:
""
color
: BLUE
style
: SOLID
seconds
: 3
commands :
enabled
: false
run-as-console
: true
list
:
[
]
effects :
enabled
: true
list :
- type
: DARKNESS
duration-seconds
: 2
amplifier
: 0
ambient
: false
particles
: true
icon
: true
- type
: SLOWNESS
duration-seconds
: 2
amplifier
: 1
ambient
: false
particles
: true
icon
: true
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Installation
Download the SimplePortals.jar file.
Place it inside your server's plugins folder.
Start the server.
Create your destinations and portals.
Enjoy a clean and modern portal system.
✅ Compatibility
Minecraft 1.19.4 up to 1.21.11+
Paper , Folia , and modern forks
Designed for servers that want performance first
⚠️ Note: This plugin is focused on modern server software and performance-oriented setups.