Ethereal Portals

Ethereal Portals transforms server travel into a magical experience with craftable portal items, customizable networks, and stunning visual effects. Now players can create their own personal portal networks!

✨ Key Features

🔮 Craftable Portal Crystals (NEW!)

Players can now craft their own Portal Crystals and place them anywhere! Simply craft a Portal Crystal with a Nether Star, Ender Pearls, Amethyst Shards, and Crying Obsidian. Rename the crystal in an anvil to name your portal network (e.g., "Home", "Shop", "Farm"), then right-click to place portals anywhere in the world. Portals are automatically numbered (Home #1, Home #2, etc.) and can be broken by punching to retrieve the crystal. Perfect for giving players personal fast-travel networks without admin intervention!

Portal Groups & Smart Teleportation

Create portal groups to organize your travel network. With 2 portals, teleport directly to your destination. With 3 or more portals, a beautiful GUI opens where players can choose where to go - complete with custom icons, coordinates, and world information.

Stunning Visual Effects

Every portal comes alive with animated particle spirals and floating text displays showing the portal name. When players teleport, they're greeted with particle bursts and enchanting sound effects that make every journey feel magical.

Custom Icons

Personalize your portals with custom player head textures. Add any base64 texture to create unique icons for castles, shops, farms, or any destination in your world.

Easy to Use

Simple commands with full tab completion make portal creation effortless. Use absolute coordinates, relative positioning with ~, or let tab completion suggest your current location. Creating a portal network has never been easier.

Flexible Configuration

Adjust portal hitboxes, teleportation cooldowns, message frequencies, and enable/disable craftable portals to perfectly match your server's needs. Everything is configurable without touching the code.

Multi-World Support

Seamlessly teleport between the Overworld, Nether, End, and any custom worlds. Your portal network spans across dimensions.

🎯 Perfect For

• Survival servers wanting player-driven fast travel with craftable items
• Hub servers with multiple game modes or areas
• Creative servers with large build showcases
• RPG servers needing magical transportation
• SMP servers where players want personal portal networks
• Any server that wants beautiful, functional portals with or without admin management

Whether you're building a small SMP or a massive network server, Ethereal Portals scales with your needs while keeping the experience magical and intuitive for your players.

🚀 Quick Start

For Players (Craftable Portals):

1. Craft a Portal Crystal:

   [Ender Pearl]     [Crying Obsidian]  [Ender Pearl]
   [Amethyst Shard]  [Nether Star]      [Amethyst Shard]
   [Ender Pearl]     [Crying Obsidian]  [Ender Pearl]
   

2. Rename it in an anvil to "Home" (or any name you want)

3. Right-click on a block to place your first portal (Home #1)

4. Place more portals with the same item name to create a network

5. Walk into any portal and experience the magic!

6. Break portals by punching the invisible armor stand at the center to retrieve your crystal

For Admins (Command Portals):

Create a portal group:

/portal group create hub

Add portals to the group:

/portal group add hub Spawn 0 64 0
/portal group add hub Shopping 500 65 -200
/portal group add hub Arena -300 70 400

Give players portal items:

/portal give PlayerName Home

Walk into any portal and experience the magic!

📋 Main Commands

• /portal group create <name> - Create a new portal group
• /portal group add <group> <name> <x> <y> <z> [world] [icon] - Add a portal
• /portal group list [group] - View all groups or portals
• /portal give <player> [name] - Give a portal crystal to a player (NEW!)
• /portal icon add <name> <base64> - Add custom portal icons
• /portal icon list - Browse all custom icons

Full command list and permissions available in the documentation.

💎 Why Choose Ethereal Portals?

✅ Player-driven - Let players craft their own portal networks

✅ Beautiful by default - Stunning effects without any configuration

✅ Intuitive design - Players understand it instantly

✅ Highly configurable - Adapt it to your server's style

✅ Cross-world travel - Seamless dimension hopping

✅ Customizable - Make every portal unique with custom icons

✅ Breakable & Retrievable - Portal items can be picked up and moved

✅ Performance optimized - Async teleportation, efficient visual effects

✅ Permission system - Full control over who can craft, place, and use portals

✅ Personal networks - Each player can have their own "Home", "Shop", "Farm" portal groups

---

Ready to make your server travel magical? Download Ethereal Portals today and let your players create their own mystical travel networks!