Перейти к содержимому
Mineforgian

Teleport structure

An advanced teleportation system that allows players to build and link physical structures in the world to create a network of instant travel points.

Загрузки
263
Подписчики
1
Обновлён
17 июня 2025 г.
Лицензия
All-Rights-Reserved

Опубликован 4 мая 2025 г.

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

Ченджлог

1.1Релиз1.21.8, 1.21.9, 1.21.10 · 17 июня 2025 г.
  • Updated to support Minecraft versions from 1.16.5 to 1.21.x.
1.0Релиз1.20.4, 1.20.5, 1.20.6 · 17 июня 2025 г.

Changelog - Version 1.0 (Initial Public Release)

Release Date: June 17, 2025

This is the first stable public release of the TeleportStructure plugin. The entire codebase has been reworked from the ground up to achieve stability, flexibility, and functionality.

✨ Features & Core Mechanics

  • Structure-Based Teleportation: Players no longer use commands to teleport. Travel occurs through physical interaction with a player-built portal structure.
  • Intuitive Portal Creation: A user-friendly creation process via the /portal create <name> command, which provides a special tool for linking two points.
  • Graphical User Interface (GUI): The /portal list command now opens a convenient menu displaying all of a player's portals, their status, and coordinates, with full page support.
  • Public & Private Portals: Players can control access to their portals with the /portal public <name> command.
  • Customizable Sounds & Effects: Added beautiful, configurable sound and particle effects for all key actions (setting a point, creating a portal, teleporting), all managed in config.yml.
  • Destruction Mechanic: An optional feature has been added where a portal is automatically deleted if one of its structure blocks is broken.

⚙️ Flexibility & Configuration

  • Centralized config.yml: Nearly every aspect of the plugin is configurable through one convenient file.
  • Customizable Structures: Administrators can define any material for the center and border blocks of the portal structure.
  • Cross-World Control: An option (allow-cross-world) has been added to the config to permit or forbid the creation of portals between different worlds.
  • Full Localization: All user-facing messages have been moved to config.yml, supporting customization and color codes.

🛡️ Administration & Security

  • Granular Permissions System: Full permission support has been added for every command and action, with a clear separation between player and admin permissions.
  • Admin Commands: Implemented commands for server management:
    • /portal reload - Reloads the configuration.
    • /portal list <player> - Views another player's portal list.
    • Admins with the teleportstructure.admin.remove permission can delete any portal.
  • Reliability: Implemented checks for duplicate portals, player portal limits, and other logical safeguards.

🚀 Technical Improvements

  • Stable Entity Handling: The mechanism for spawning and removing invisible armor stands now correctly handles chunk loading and unloading, preventing trigger loss.
  • Data Migration: A system for automatically migrating data from the earliest versions of the plugin to the new format has been built in.
  • Clean Code Architecture: The code is organized into logical managers (PortalManager, TeleportManager, ConfigManager, PortalGUI, etc.) for easy maintenance and future development.

Thank you for using TeleportStructure! Future versions are planned to include an interactive GUI, economy support, and much more.

1.0-SNAPSHOTАльфа1.20.4, 1.20.5, 1.20.6 · 4 мая 2025 г.
  • First version of the plugin.

Комментарии

Загружаем…