New in V2.2. Place portals at any location in the scene, configure jump targets (scene + landing point) via the properties panel, and enable same-scene instant teleportation or cross-scene spatial jumps. End users trigger them by clicking after publishing.
Placing a Portal
Portal
- Click Portal in the toolbar
- Select the target position and orientation in the scene, then click Set Portal
- After the portal is created, the current camera angle is automatically captured as the orientation preview
- In Preview Mode, you can test the jump effect
Configuring a Portal (Properties Panel)
After selecting a portal, the properties panel shows the following options:
| Setting | Description |
|---|---|
| Target Scene | Select the target scene from the dropdown (includes the current scene and all other scenes) |
| Portal | After selecting a scene, the dropdown refreshes to list that scene's portals; select the landing target |
| Name | Portal name |
| Update Preview Image | Update the portal position, orientation, and re-capture a screenshot using the current camera angle |
Note: You must first place a portal in the target scene before you can link to it.
Persistent Name and Description Labels
In V2.4, a portal name or description can remain visible as a label, so users can identify the portal without repeatedly hovering over it.
- The label stays synchronized with the portal data and moves with the portal
- The label follows the portal's visibility and is hidden when the portal is hidden
- No orphaned label remains after the portal is hidden or deleted, or after portal navigation is complete
Two-Way Portal
When two portals each designate the other as their target (A→B and B→A), the system automatically detects the bidirectional link and displays a Bidirectional Link badge on both portals.
- Two-way portals must be configured manually on each end; the system does not create reverse links automatically
- When either end is modified or the link is removed, the Bidirectional Link badge is removed from both
Portal Interaction
- Trigger: Mouse click (click-to-trigger only; proximity auto-trigger is not supported)
- Supported mode: Free Mode (SelfMode); portals are hidden in other modes
- Same-scene jump: Instant teleport — camera arrives immediately
- Cross-scene jump: After loading completes, the camera lands at the target position with the orientation set by the landing point
This chapter is from the official XGRIDS user manual. Official source (opens in a new tab) · Updated:
