EasyPortal Mod

✨ Features

• Custom Shapes: Break free from rectangles! Draw any portal shape you want.
• Visual Design GUI: Design your portal frame block-by-block using an easy-to-use interface.
• Security System:
  • Mark portals as Private to restrict access.
  • Set a PIN Code for guest access.
  • Owners bypass PIN entry automatically.
  • Session-based authentication (enter PIN once per session).
• Flexible Linking:
  • OneWay: Teleport to a specific destination.
  • Link: Create bi-directional connections between two portals.
  • 1:1 Enforcement: Ensures portals are exclusively linked pairs.
• Advanced Placement:
  • Preview Mode: See a ghost version of your portal before building.
  • Rotation: Rotate portals to face any direction (North, South, East, West).
  • Orientation: Toggle between Vertical (Walls) and Horizontal (Floor/Ceiling) placement.
• Survival Friendly: Consumes the required blocks from your inventory (Creative mode bypasses this).
• Immersive Visuals: Custom particle colors for each portal.

🚀 Installation

1. Make sure you have Minecraft 1.21.1 and Fabric Loader installed.
2. Install Fabric API.
3. Download easyportal-1.21.1.jar and place it in your .minecraft/mods folder.
4. Launch the game!

📖 How to Use

1. Open the Portal Designer

press the default keybind: [Right Shift]

2. Design Your Portal

• Draw: Use Left-Click to place frame blocks on the grid and Right-Click to erase.
• Select Blocks: Choose from the block palette on the right.
• Properties:
  • Name: Give your portal a unique name (e.g., "HomeBase").
  • Type:
    • OneWay: Teleports to a set destination.
    • Link: Connects to another portal with a matching name.
  • Destination: The name of the target portal or location.
  • Color: Pick a custom color for portal particles.

3. Setup Security (Optional)

Expand the Security section:

• Check Private Portal.
• Enter a PIN Code.
• Result: Only you (the owner) can enter freely. Others must enter the PIN to use the portal.

4. Build It

1. Click PREVIEW & PLACE.
2. You will see a ghostly outline of your portal.
3. Position: Look around to place it.
4. Rotate: Press [R] to rotate.
5. Orientation: Press [Middle Mouse Button] to switch between Vertical (Wall) and Horizontal (Floor).
6. Build: Right-Click to confirm and build.

• Note: You must have the required blocks in your inventory!

5. Managing Portals

• List Portals: view via the Global Dashboard (Keybind: [Right-Shift] - Check Controls).
• Delete: use the Dashboard.
• Admin Bypass: Server Operators (OP Level 2+) can bypass PIN protection on any portal.

🛠️ Commands

🤝 Permissions

• easyportal.admin: Allows bypassing PIN protection and managing other players' portals.