<div align="center"> <h1>🌀 SimplePortals</h1> <h3>Modern, lightweight and highly optimized portal system</h3> <b>Compatibility:</b> 1.19.4 to 26.2+ (and forks) <p><a href="https://discord.gg/Wq9AHJP6VJ">🎮 Support Discord</a></p> </div> --- 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 | | **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> ` - 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 ```yml 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"