Description

Gallery

Changelog

Versions

The Ultimate Portal Plugin

Name: Portals
Author: NonSwag

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

Game Version

Mod Loader

Release Channel

Name	Game version	Platforms	Published	Downloads	Actions
R 1.7.0	26.2 26.1.x 1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.6.1	26.1.x 1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.6.0	26.1.x 1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.5.0	26.1.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.4.5	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.4.4	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.4.3	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.4.2	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.4.1	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.4.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.3.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.2.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.1.5	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.1.4	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.1.3	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.1.2	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.1.1	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.1.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 1.0.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 0.3.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 0.2.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 0.1.1	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report
R 0.1.0	1.21.x	Folia Paper	11h ago	1	Download Open in new tab Copy link Report

[1.7.0] 1.7.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.6.1] 1.6.1 by NonSwag on Oct 15, 2026

Download

# What's Changed
Update data folder resolving for new versions

Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.6.0...1.6.1

[1.6.0] 1.6.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.5.0] 1.5.0 by NonSwag on Oct 15, 2026

Download

## What's Changed
26.1 Support

Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.4.5...1.5.0

[1.4.5] 1.4.5 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.4.4] 1.4.4 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.4.3] 1.4.3 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.4.2] 1.4.2 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.4.1] 1.4.1 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.4.0] 1.4.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

Added /portal notification commands
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 portal
exit -> exited portal
teleport_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 portal
warmup_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.start was removed in favor of this feature

The same message can be recreated by adding a 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

[1.3.0] 1.3.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

Added /portal debug verbose command
Moved /portal debug-paste to /portal debug paste

Full Changelog**: https://github.com/TheNextLvl-net/portals/compare/1.2.0...1.3.0

[1.2.0] 1.2.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.1.5] 1.1.5 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.1.4] 1.1.4 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.1.3] 1.1.3 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.1.2] 1.1.2 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.1.1] 1.1.1 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.1.0] 1.1.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[1.0.0] 1.0.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[0.3.0] 0.3.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

Remove redundant pushBackOnEntryDenied option 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

[0.2.0] 0.2.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[0.1.1] 0.1.1 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

[0.1.0] 0.1.0 by NonSwag on Oct 15, 2026

Download

## What's Changed

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

Portals

The Ultimate Portal Plugin

Why Choose Portals?

Features

What's Next?

All Versions

No compatible versions found

🌟 Related Projects

Click Villagers

Better Boat Movement

WildRTP

AxShulkers