1.0
Compatibility
Changes
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 listcommand 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.removepermission 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.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:u7oLr0uJ:59fWpGZw"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:u7oLr0uJ:59fWpGZw"
}

