TeleportStructure

Build Your Own Travel Network!

---

TeleportStructure introduces a balanced and immersive fast-travel system, moving away from simple commands. Players must gather resources and build physical structures in the world to create a permanent and rewarding travel network. It's the perfect solution for survival servers where convenience must be earned.

---

Features

• Structure-Based Teleportation: No more teleport commands! Travel happens by physically interacting with player-built structures in the world.
• Fully Configurable: Almost every aspect is customizable in a detailed config.yml, including portal materials, player limits, cooldowns, and all messages.
• Survival Mechanics: Enable options like delete-on-break, where destroying a portal's structure block will permanently remove the portal, and allow-cross-world to control inter-dimensional travel.
• Visual & Audio Effects: Make teleportation feel rewarding with configurable sounds and particle effects for creating and using portals.
• Player-Managed Portals: Players can set their portals to public or private and view all their portals in an intuitive /portal list GUI.
• Admin-Friendly: A full suite of permissions and commands allows server staff to manage any portal and reload the configuration on the fly.
• Lightweight & Performant: Designed to be efficient and have a minimal impact on your server's performance.

---

How It Works (A Quick Guide)

Click to see the creation process...

1. Build the Structures: First, a player must build two identical structures in the world. By default, this is a Stone surrounded by 8 Gold Blocks.

2. Link the Points: Using the /portal create <name> command, the player receives a special tool. They then left-click on the center block of the first structure and right-click on the center block of the second structure to create a permanent link.

3. Travel Instantly: That's it! To teleport, the player simply steps into the space above one of the structures and is instantly transported to the other.

---

Commands & Permissions

Player Commands

• /portal create <name>

  • Description: Starts the portal creation process and gives the player the linking tool.
  • Permission: teleportstructure.command.create

• /portal remove <name>

  • Description: Removes one of your own portals.
  • Permission: teleportstructure.command.remove

• /portal list

  • Description: Opens a GUI listing all of your created portals and their details.
  • Permission: teleportstructure.command.list

• /portal public <name>

  • Description: Toggles one of your portals between public and private status.
  • Permission: teleportstructure.command.public

• /portal help

  • Description: Shows the command help message.
  • Permission: teleportstructure.command.help

Admin Commands

• /portal list <player>

  • Description: Lists all portals owned by a specific player.
  • Permission: teleportstructure.admin.list

• /portal remove <portal_name>

  • Description: Forcefully removes any portal by its name. Requires admin permission to remove portals owned by other players.
  • Permission: teleportstructure.admin.remove

• /portal reload

  • Description: Reloads the config.yml file from disk.
  • Permission: teleportstructure.admin.reload