---

Looking for a modern portal plugin that is fast, clean, and easy to use? SimplePortals is a lightweight portal engine built from scratch for modern Minecraft servers, designed around performance, simple configuration, and flexible portal actions.

Create cuboid portals with a selector wand, teleport players to local destinations or proxy servers, and fully customize portal behavior directly from portals.yml.

⚡ Why choose SimplePortals?

Unlike older or more complex portal plugins, SimplePortals focuses on doing one thing extremely well: creating and managing portals with excellent performance and minimal setup.

Feature	🟢 SimplePortals	Traditional Portal Plugins
Performance Focus	Yes	Usually mixed
Modern Version Support	1.19.4 - 26.1+	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

Create portals in seconds with a simple in-game workflow:

• Use /portal wand to receive the selector axe.
• Select point 1 and point 2 with the wand.
• Create a portal with /portal create desti:<destination> block:WATER.
• Optionally replace air blocks inside the selected region automatically.

🎯 Advanced Portal Actions

Each portal can be customized individually inside portals.yml with powerful built-in actions:

• Chat messages
• Titles and subtitles
• Sounds
• BossBars
• Console or player commands
• Potion effects such as darkness, slowness, and more
• Cooldowns
• Permissions
• Sneaking requirements
• Deny messages

🎨 Modern Text Formatting Support

Style your portals exactly the way you want:

• Full support for Legacy colors (&)
• Full support for MiniMessage
• Use modern formatting in messages, titles, bossbars, and more

🌐 Flexible Destinations

SimplePortals supports both local and network-based teleportation:

• Teleport players to local destinations
• Send players through proxy destinations
• Keep portal setups clean and organized

🪶 Lightweight and Modern

Built for current Minecraft server software with efficiency in mind:

• Clean and lightweight codebase
• Great fit for modern servers
• Compatible with Paper, Folia, and modern forks

---

💻 Commands and Permissions

Main Commands:

• /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

SimplePortals supports the following trigger blocks out of the box:

• WATER
• LAVA
• AIR
• NETHER_PORTAL
• END_PORTAL
• END_GATEWAY

---

🛠️ Example Creation Flow

Create your first portal in just a few steps:

1. Run /portal wand
2. Left click a block for point 1
3. Right click another block for point 2
4. Create a destination with /portal destination create spawn
5. Create the portal with /portal create desti:spawn block:WATER

Simple, fast, and ready to use.

---

⚙️ Example Portal Configuration

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

1. Download the SimplePortals.jar file
2. Place it inside your server plugins folder
3. Start the server
4. Create your destinations and portals
5. Enjoy a clean and modern portal system

---

✅ Compatibility

• Minecraft 1.19.4 to 26.1+
• Paper
• Folia
• Modern forks