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.