Teleport Portal System

🌀 Teleport / Portal System — Unity Package

Teleport / Portal System is a ready-to-use Unity package for creating immersive portal-based travel in 3D games.

It allows players to move between linked portal points in the same scene or across different scenes with minimal setup and clear Inspector-driven configuration.

The system is designed to be:

✅ lightweight

✅ easy to understand

✅ quick to set up

✅ practical for both prototypes and production-ready projects

✨ Key Features

🚀 3 Teleport Styles

The package includes three teleport modes:

⚡ Instant Teleport

Instant mode is ideal for fast gameplay and classic trigger-based teleports.

🌑 Fade Teleport

Fade mode adds a clean screen transition, perfect for polished scene changes and cinematic portal travel.

🪄 Smooth Teleport

Smooth mode moves the player toward the target position over time, making teleportation feel more magical, visible, and immersive during gameplay.

🔗 Simple Portal Pairing Workflow

Each portal uses a simple paired-target workflow:

1. 🌀 Place two portal objects in the scene
2. 🎯 Assign the destination transform in the Inspector
3. ✅ The system handles the teleport logic automatically

A built-in cooldown prevents immediate back-teleport loops, which is especially useful when two portals face each other or are placed close together.

💾 Destination Saving

The system supports optional destination saving through PlayerPrefs.

This allows the player to reappear at the last teleport destination after:

🔁 scene reload

🎮 game restart

🌍 scene transition

This feature works together with the included spawn helper.

🌍 Cross-Scene Teleportation

Teleport / Portal System supports teleportation between different scenes.

By assigning a scene name to a portal pair, developers can move the player between levels while preserving destination logic.

This makes the package suitable for:

🏰 hub worlds

🕳️ dungeon entrances

🧩 puzzle transitions

🧙 magical gateways

🚀 sci-fi transport systems

🗺️ exploration-based level design

🎬 Presentation & Feedback

For better player feedback, the package supports:

🌑 fade transitions through CanvasGroup

🔊 optional sound playback through AudioSource

These features are optional, keeping the system lightweight while still allowing developers to add polish without rewriting the core teleport logic.

Runtime validation and warning messages help catch common setup mistakes, such as:

⚠️ missing TeleportManager references

⚠️ unassigned portal targets

⚠️ incorrect scene or destination setup

🧪 Included Demo & Scripts

The package includes a demo scene and supporting scripts for quick testing:

🎮 basic player movement

📷 camera look

📍 spawn restoration

🌀 TeleportManager prefab

The code is organized, documented, and easy to extend.

👨‍💻 Who Is This For?

This package is suitable for:

🟢 beginners who want a simple drag-and-drop portal system

🟡 indie developers building prototypes

🔵 developers who need a clean base system to customize

🟣 production projects that require portal or teleport mechanics

🎮 Perfect For These Game Types

Teleport / Portal System is a practical solution for:

🧙 fantasy games

🚀 sci-fi experiences

🧩 puzzle projects

🌲 exploration games

⚔️ action adventures

🧪 prototype scenes

🌀 portal-based gameplay systems

✅ Summary

Teleport / Portal System is built to save setup time, reduce repetitive logic, and provide a clear foundation for portal mechanics inside Unity.

It gives developers a simple, flexible, and polished way to add portals, gateways, teleport zones, and cross-scene travel to their games.