SimplePortals

Modern, lightweight and highly optimized portal system

Compatibility: 1.19.4 to 1.21.11+ (and forks)

Support Discord

---

SimplePortals is a lightweight portal engine built from scratch for modern Minecraft servers, focused on performance, clean configuration, and easy portal creation.

Create cuboid portals with a selector wand, send players to local destinations or proxy servers, and configure advanced portal actions directly from portals.yml.

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

• Use /portal wand to get the selector axe
• Select point 1 and point 2 with the wand
• Create the portal with /portal create desti:<destination> block:WATER
• Optional automatic replacement of air blocks inside the region

Portal Actions

Every portal can be configured individually in portals.yml:

• Messages
• Titles and subtitles
• Sounds
• BossBars
• Commands
• Potion effects like darkness, slowness, and more
• Cooldowns
• Permissions
• Sneaking conditions
• Deny messages

Text Formatting Support

• Legacy colors (&) supported in messages.yml and portals.yml
• MiniMessage supported in messages.yml and portals.yml
• Use modern formatting for titles, messages, bossbars, and more

---

Commands and Permissions

Main Command:

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

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

---

Example Creation Flow

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 1.21.11+
• Paper
• Folia
• Modern forks