PortaisCore – Advanced Custom Portal Plugin for Minecraft

Version: 1.1.0
Compatibility: Paper / Spigot 1.20.x
Java: 17+

Create fully customizable portals for your Minecraft server with advanced teleportation systems, permissions, particles, sounds, VIP destinations, random teleports, command execution, and much more.

PortaisCore allows server owners to create immersive and optimized portal systems without requiring complicated setups.

---

Features

✅ Custom Portal Regions
Create portals using a selection tool and define custom areas where players are teleported instantly.

✅ Multiple Portal Types

• Warp portals (/warp)
• Multiverse teleport portals (/mvtp)
• Command portals (execute any command)

✅ Instant Teleport System
Players are teleported immediately when touching the portal region.

✅ VIP Destinations
VIP players can be redirected to special destinations automatically.

✅ Random Destinations
Create mining portals, dungeon systems, or random teleport hubs.

✅ Custom Sounds & Particles
Add immersive visual and sound effects to your portals.

✅ Portal Permissions
Restrict portals to specific players or permission groups.

✅ Custom Messages
Send messages using:

• Chat
• ActionBar
• Titles

✅ Cooldown System
Prevent portal spam with configurable cooldowns.

✅ Highly Configurable
Customize nearly everything using config.yml and portais.yml.

---

Dependencies

| Plugin | Required | Usage |
| --------------------- | ---------- | ----------------------------- |
| Paper / Spigot 1.20.x | ✅ Yes | Server base |
| EssentialsX | ❌ Optional | Warp system (/warp) |
| Multiverse-Core | ❌ Optional | World teleportation (/mvtp) |
| PlaceholderAPI | ❌ Optional | Dynamic placeholders |

---

Commands

| Command | Description | Permission |
| -------------------------------------------- | ---------------------------- | ---------------- |
| /portais criar <name> <type> <destination> | Create a portal | portais.create |
| /portais deletar <name> | Delete a portal | portais.delete |
| /portais editar <name> <property> <value> | Edit portal properties | portais.edit |
| /portais listar | List all portals | portais.use |
| /portais info <name> | View portal details | portais.use |
| /portais reload | Reload plugin configurations | portais.reload |

---

Portal Types

warp

Teleport players using a warp plugin:

/warp <destination>

Example:

/portais criar spawn warp spawn

---

mvtp

Teleport players between worlds using Multiverse:

/mvtp <player> <world>

Example:

/portais criar mines mvtp mines_world

---

comando

Execute any custom command.

Use {player} as a placeholder.

Example:

/portais criar vip comando /warp vip
/portais criar kit comando /kit vip {player}

---

Portal Selection System

Creating portals is simple:

Step 1

Get the selection tool:

GOLDEN_AXE

Step 2

Left-click a block to set Position 1

Step 3

Right-click a block to set Position 2

Step 4

Create the portal:

/portais criar <name> <type> <destination>

The selected region becomes an active portal area. Players entering the region will be teleported automatically.

---

Permissions

| Permission | Description | Default |
| ---------------- | -------------------------------------------- | -------- |
| portais.admin | Full access (includes all permissions below) | OP |
| portais.create | Create portals | OP |
| portais.delete | Delete portals | OP |
| portais.edit | Edit portals | OP |
| portais.reload | Reload configurations | OP |
| portais.use | Use portals | Everyone |

Restrict a portal to specific players:

/portais editar myPortal permissao portais.vip

Then give the permission:

portais.vip

to your VIP group.

---

Editable Portal Properties

Use:

/portais editar <name> <property> <value>

| Property | Description |
| ------------------- | ------------------------------- |
| destino | Portal destination |
| delay | Teleport delay |
| cooldown | Cooldown between uses |
| permissao | Required permission |
| ativo | Enable/disable portal |
| mensagem | Teleport message |
| tipo-mensagem | CHAT / ACTIONBAR / TITLE |
| cancelar-se-mover | Cancel teleport if player moves |
| particulas | Enable particles |
| tipo-particula | Bukkit particle type |
| som | Enable sounds |
| som-entrada | Portal enter sound |
| som-teleporte | Teleport sound |
| destino-vip | VIP destination |
| permissao-vip | VIP permission |
| mundo-permitido | Allowed world |
| destino-aleatorio | Enable random destinations |

---

Advanced Examples

Random Mining Portal

/portais criar mines comando /tp {player} 0 65 0
/portais editar mines destino-aleatorio true
/portais editar mines adicionar-destino /mvtp {player} mines1
/portais editar mines adicionar-destino /mvtp {player} mines2
/portais editar mines adicionar-destino /mvtp {player} mines3

---

VIP Portal

/portais criar hub warp hub
/portais editar hub destino-vip warp hubvip
/portais editar hub permissao-vip group.vip

---

Confirmation Portal

/portais criar dungeon mvtp dungeon_world
/portais editar dungeon delay 5
/portais editar dungeon cancelar-se-mover true
/portais editar dungeon mensagem &aWelcome to the dungeon!
/portais editar dungeon tipo-mensagem TITLE

---

Configuration Files

config.yml

Customize:

• Messages
• Sounds
• Particles
• Titles
• Cooldowns
• Teleport settings
• General plugin behavior

---

portais.yml

All portals are automatically saved in:

portais.yml

Features:

• Automatic save every 5 minutes (configurable)
• Save on server shutdown
• Persistent portal system

---

PortaisCore is designed to be lightweight, optimized, and easy to configure while providing advanced portal features for survival, prison, RPG, factions, and network servers.