Teleport structure

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.