# Teleportation

This module allows you to configure everything that is linked to the teleport commands.

## Configurations

### Config.yml

```yaml
########################################################################################################################
#
# ████████╗███████╗██╗░░░░░███████╗██████╗░░█████╗░██████╗░████████╗░█████╗░████████╗██╗░█████╗░███╗░░██╗
# ╚══██╔══╝██╔════╝██║░░░░░██╔════╝██╔══██╗██╔══██╗██╔══██╗╚══██╔══╝██╔══██╗╚══██╔══╝██║██╔══██╗████╗░██║
# ░░░██║░░░█████╗░░██║░░░░░█████╗░░██████╔╝██║░░██║██████╔╝░░░██║░░░███████║░░░██║░░░██║██║░░██║██╔██╗██║
# ░░░██║░░░██╔══╝░░██║░░░░░██╔══╝░░██╔═══╝░██║░░██║██╔══██╗░░░██║░░░██╔══██║░░░██║░░░██║██║░░██║██║╚████║
# ░░░██║░░░███████╗███████╗███████╗██║░░░░░╚█████╔╝██║░░██║░░░██║░░░██║░░██║░░░██║░░░██║╚█████╔╝██║░╚███║
# ░░░╚═╝░░░╚══════╝╚══════╝╚══════╝╚═╝░░░░░░╚════╝░╚═╝░░╚═╝░░░╚═╝░░░╚═╝░░╚═╝░░░╚═╝░░░╚═╝░╚════╝░╚═╝░░╚══╝
#
# Documentation: https://zessentials.groupez.dev/modules/teleportation
#
########################################################################################################################

enable: true

# If the teleport destination is unsafe, should players be teleported to the nearest safe location?
# If this is set to true, zEssentials will attempt to teleport players close to the intended destination. The destination will be on the same x and z, only the y will change.
# If this is set to false, attempted teleports to unsafe locations will be cancelled with a warning.
teleport-safety: true

# Whether to make all teleportations go to the center of the block; where the x and z coordinates decimal become .5
teleport-to-center: true

# The delay, in seconds, before a user actually teleports. If the user moves or gets attacked in this timeframe, the teleport is cancelled.
teleport-delay: 5

# The delay, in seconds, before a user actually teleports. If the user has one or more permissions, the minimum delay will be taken.
teleport-delay-permissions:
  - permission: "essentials.teleport.delay.vip"
    delay: 4
  - permission: "essentials.teleport.delay.staff"
    delay: 2

# Enable bypass of teleport delay on player to essentials.teleport.bypass permission
teleport-delay-bypass: false

# The delay, in seconds, for the teleport request to expire.
teleport-tpa-expire: 60

# Opens a confirmation inventory for the /tpa command.
open-confirm-inventory-for-tpa: false

rtp-center-x: 0
rtp-center-z: 0

rtp-radius-x: 5000
rtp-radius-z: 5000

rtp-world: "world"

max-rtp-attempts: 10

blacklist-biomes:
  - cold_ocean
  - deep_cold_ocean
  - deep_frozen_ocean
  - deep_lukewarm_ocean
  - deep_ocean
  - deep_warm_ocean
  - frozen_ocean
  - frozen_river
  - lukewarm_ocean
  - ocean
  - river
  - warm_ocean
```

### Confirm\_Request\_Inventory.yml

```yaml
name: '#3f3f3fᴄᴏɴꜰɪʀᴍ ʀᴇǫᴜᴇѕᴛ'
size: 27
items:
  cancel:
    slot: 10
    closeInventory: true
    item:
      material: RED_STAINED_GLASS_PANE
      name: '#ff0000ᴄᴀɴᴄᴇʟ'
      lore:
        - '&7Click to cancel the teleport request'

  head:
    slot: 13
    item:
      playerHead: '%zessentials_user_target_player_name%'
      name: '#99E0FF%zessentials_user_target_player_name%'

  confirm:
    type: ZESSENTIALS_TELEPORTATION_CONFIRM
    slot: 16
    closeInventory: true
    item:
      material: GREEN_STAINED_GLASS_PANE
      name: '#00ff00ᴄᴏɴғɪʀᴍ'
      lore:
        - '&7Click to send &n%zessentials_user_target_player_name%&r &7a tpa request'
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zessentials.groupez.dev/modules/teleportation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.