> For the complete documentation index, see [llms.txt](https://docs.mongenscave.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mongenscave.com/premium-products/homes/feature-help/safe-teleport.md).

# Safe Teleport

## What does the Safe Teleport feature do?

The **Safe Teleport** feature ensures that the destination is still safe **before teleporting the player to their home**. It checks the location for potential dangers (like lava, void, or unsafe blocks) to prevent unwanted damage or death.

How the plugin reacts in these situations depends on the configured **`safe-teleport.mode`**—allowing you to choose whether the teleport is canceled, requires confirmation, or proceeds anyway.

### Type of Mode's

```yaml
  safe-teleport:
    enabled: true
    # Options: cancel, confirm, auto
    mode: "auto"
    scan-radius: 5
    check:
      air-under-player: true
      dangerous-blocks: true
      end-crystal-nearby: true
      liquid: true
      suffocation-risk: true
```

#### Mode 'cancel'

* This mode immediately blocks the teleport if the location is deemed unsafe.

#### Mode 'confirm'

* This mode opens a confirmation menu if the location is potentially dangerous, leaving it up to the player to decide whether they still want to teleport at their own risk.

#### Mode 'auto' (recommended)

* In this mode, if the location is unsafe, the plugin will attempt to find a safe spot nearby within the specified radius. If a safe location is found, the player will be teleported there; otherwise, the teleport will fail.
