TeleportAPI

TeleportAPI is a comprehensive library designed for developers who require precise control over entity and structure teleportation. It moves beyond simple coordinate shifts, offering advanced handling of collision logic, NBT data, and cross-dimensional travel.

Core Features:

Placement & Collision Logic: Choose exactly how the teleported structure interacts with the destination environment using three distinct modes:

• FORCE_REPLACE: The teleported structure takes absolute priority, overwriting any existing blocks at the destination.
• PRESERVE_EXISTING (Recommended): Ensures that blocks already present at the destination are protected and not overwritten.
• PRESERVE_LIST: Smart conditional replacement. Priority is given to the structure, but specific blocks (defined in your list) at the destination will remain untouched.

  “Teleport with Air” Support: Crucial for structure integrity. You can enable air block calculation to ensure empty spaces are transferred (essential for FORCE_REPLACE) or disable it to only move solid blocks.

• Flexible Structure Selection: Define what gets teleported. The API supports:
• Full Transfer: Teleport everything within the bounds.
• Array-Based Filtering: Use custom arrays to validate blocks before teleportation (e.g., if a block matches criteria X, it stays; otherwise, it moves).

Safety & Integrity:

• Automatic NBT persistence for all entities.
• Seamless interdimensional travel (handled via a single parameter).
• Safe region updates to prevent duplication or corruption.

🚧 Active Development & Feedback This library is a work in progress, and I am actively looking to add new features, helper methods, and integrations. If you find functionality missing or have a specific use case not covered by the current API, please leave a comment or open an issue. Your feedback is crucial for future updates.

⚠️ Developer Note: This library exposes complex logic via specific methods and parameters (including custom arrays for filtering). Please refer to the Source Code and README for the exact method signatures and usage examples.

Source code | README