The Ultimate Portal Plugin
Portals is a modern, flexible portal plugin designed for Paper and Folia servers.
Create custom portals with permissions, cooldowns, entry fees, and pushback mechanics.
Why Choose Portals?
- Advanced Permission System – Fine-grained control over who can use each portal
- Cooldowns & Warmups – Prevent players from using a portal too often or too quickly
- Easy Configuration – Simple setup with intuitive commands and configuration files
- Entity Support – Portals can not only transport players, but also entities
- Modern & Efficient – Minimal performance impact with smart portal detection
- Portal Fees & Economy – Charge players for portal usage with configurable fees
- Pushback Protection – Players can be pushed back when denied portal access
- Seamless World Integration – Works perfectly with any world management plugin
- Notification System – Show custom messages, titles, actionbars… when entering or exiting portals
- No Portal – Use any portal block (e.g. lava, cacti…) without causing damage
Features
- BungeeCord/Velocity support for server switching
- Per-portal permissions, cooldowns, and fees
- Precise teleportation across dimensions
- Pushback protection for denied portal access
- Random teleportation
- Server transfer support
- Smooth portal to portal teleportation
For more information and documentation, visit the Wiki.
What's Next?
Multiverse-Portals Migration – Easy import tool to migrate from Multiverse-Portals
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
|
R
1.7.0
|
14h ago | 1 | |||
|
R
1.6.1
|
14h ago | 1 | |||
|
R
1.6.0
|
14h ago | 1 | |||
|
R
1.5.0
|
14h ago | 1 | |||
|
R
1.4.5
|
14h ago | 1 | |||
|
R
1.4.4
|
14h ago | 1 | |||
|
R
1.4.3
|
14h ago | 1 | |||
|
R
1.4.2
|
14h ago | 1 | |||
|
R
1.4.1
|
14h ago | 1 | |||
|
R
1.4.0
|
14h ago | 1 | |||
|
R
1.3.0
|
14h ago | 1 | |||
|
R
1.2.0
|
14h ago | 1 | |||
|
R
1.1.5
|
14h ago | 1 | |||
|
R
1.1.4
|
14h ago | 1 | |||
|
R
1.1.3
|
14h ago | 1 | |||
|
R
1.1.2
|
14h ago | 1 | |||
|
R
1.1.1
|
14h ago | 1 | |||
|
R
1.1.0
|
14h ago | 1 | |||
|
R
1.0.0
|
14h ago | 1 | |||
|
R
0.3.0
|
14h ago | 1 | |||
|
R
0.2.0
|
14h ago | 1 | |||
|
R
0.1.1
|
14h ago | 1 | |||
|
R
0.1.0
|
14h ago | 1 |
- Add world folder migration by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/100
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.6.1...1.7.0
Update data folder resolving for new versions
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.6.0...1.6.1
- ServiceIO v3 Support
- Multi-currency support
- Added currency argument to portal cost command (
/portal cost <portal> [<cost>] [<currency>])
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.5.0...1.6.0
26.1 Support
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.4.5...1.5.0
- Add error handling for command execution by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/80
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.4.4...1.4.5
- Fix 1.21.4 compat by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/79
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.4.3...1.4.4
- Prevent damage caused by portal blocks by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/67
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.4.2...1.4.3
- Schedule teleport for differing regions by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/62
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.4.1...1.4.2
- Fix folia linked portal teleport by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/61
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.4.0...1.4.1
- Added
/portal notificationcommands - Added
/portal notification list <portal> [<trigger>] - list entries are clickable to make editing notifications easier
- Added
/portal notification remove <portal> <trigger> <notification> - Added
/portal notification set <portal> <trigger> (sound|actionbar|message|title) - sound:
<sound> [<sound-source>] - actionbar:
<message> - message:
<message> - title:
<title> [<subtitle>] [<fade-in>] <stay> <fade-out> - Portal triggers:
entry_failure-> triggered when portal entry was denied (e.g. insufficient funds, lacking permission)entry_success-> successfully entered portalexit-> exited portalteleport_failure-> action failed (for custom implementations / future updates)teleport_success-> action succeeded (e.g. successfully teleported)warmup_failure-> warmup was interrupted by entity leaving the portalwarmup_success-> warmup was fully awaited- Placeholders that are usable in all applicable notifications:
<cooldown>-> the portal cooldown in seconds<warmup>-> the portal warmup in seconds<remaining-cooldown>-> the entity's remaining cooldown for the portal in seconds<remaining-warmup>-> the entity's remaining warmup for the portal in seconds<entity>-> the entity's name<entry-cost>-> the formatted entry cost of the portal<permission>-> the entry permission of the portal (or "undefined" if not set)<portal>-> the name of the portal- Message
portal.warmup.startwas removed in favor of this feature
entry_success message to your portals:/portal notification set <portal> entry_success message <gray><blue>Portals</blue> <dark_gray>»</dark_gray> Do not leave the portal for <green><warmup:'#.##'></green> seconds…</gray>- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.3.0...1.4.0
- Added
/portal debug verbosecommand - Moved
/portal debug-pasteto/portal debug paste
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.2.0...1.3.0
- Add portal warmup (delayed entry action) by @BF-GO in https://github.com/TheNextLvl-net/portals/pull/55
## New Contributors
- @BF-GO made their first contribution in https://github.com/TheNextLvl-net/portals/pull/55
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.1.5...1.2.0
- Refactor command dispatch with async scheduler by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/48
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.1.4...1.1.5
- Update dependency dev.faststats.metrics:bukkit to v0.11.0 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/41
- Update dependency dev.faststats.metrics:bukkit to v0.11.1 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/45
- Update dependency net.thenextlvl:nbt to v4.3.3 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/46
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.1.3...1.1.4
- Update dependency net.thenextlvl:nbt to v4.3.2 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/44
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.1.2...1.1.3
- Integrate error tracking with FastStats by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/43
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.1.1...1.1.2
- Refactored debug serialization to use SNBT by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/32
- Added debug paste uploading by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/34
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.1.0...1.1.1
- Update dependency net.thenextlvl:service-io to v2.4.0 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/28
- Update dependency net.thenextlvl:nbt to v4.0.3 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/30
- Added portal debug-paste command by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/31
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.0.0...1.1.0
- Update Gradle to v9.4.0-milestone-1 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/13
- Update actions/checkout action to v6 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/14
- Update Gradle to v9.4.0-milestone-2 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/15
- Update Gradle to v9.4.0-milestone-3 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/16
- Update plugin com.gradleup.shadow to v9.3.0 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/17
- Added German localization by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/18
- Update dependency net.thenextlvl:nbt to v4 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/19
- Update dependency net.thenextlvl:nbt to v4.0.0-pre2 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/20
- Update plugin io.papermc.hangar-publish-plugin to v0.1.4 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/21
- Update actions/upload-artifact action to v6 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/22
- Update dependency net.thenextlvl:nbt to v4.0.0 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/23
- Update dependency net.thenextlvl:nbt to v4.0.1 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/24
- Update dependency net.thenextlvl:nbt to v4.0.2 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/25
- Update Gradle to v9.4.0-milestone-4 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/26
- Added [faststats.dev](https://faststats.dev/info) integration
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/0.3.0...1.0.0
- Remove redundant
pushBackOnEntryDeniedoption by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/10
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/0.2.0...0.3.0
- Load portal config from JSON file by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/8
- Refactored Bounds API by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/9
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/0.1.1...0.2.0
- Fixed folia teleport portal action by @NonSwag in https://github.com/TheNextLvl-net/portals/pull/7
## New Contributors
- @NonSwag made their first contribution in https://github.com/TheNextLvl-net/portals/pull/7
- Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/0.1.0...0.1.1
- Update dependency com.sk89q.worldedit:worldedit-bukkit to v7.4.0-SNAPSHOT by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/1
- Update Gradle to v9.2.0-rc-2 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/2
- Update Gradle to v9.2.0-rc-3 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/3
- Update actions/upload-artifact action to v5 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/4
- Update Gradle to v9.2.0 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/5
- Update Gradle to v9.3.0-milestone-1 by @renovate[bot] in https://github.com/TheNextLvl-net/portals/pull/6
## New Contributors
- @renovate[bot] made their first contribution in https://github.com/TheNextLvl-net/portals/pull/1
- Full Changelog**: https://github.com/TheNextLvl-net/portals/commits/0.1.0


