> For the complete documentation index, see [llms.txt](https://docs.easy.gg/scripting/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.easy.gg/scripting/bedwars-scripting/events/telepearled.md).

# Telepearled

```lua
-- When a player uses a telepearl, give them the Decay status effect
Events.Telepearled(function(event)
    local entity = event.player:getEntity()
    if (entity == nil) then
        return
    end
    StatusEffectService.giveEffect(entity, StatusEffectType.DECAY)
end)
```

### Parameters

#### player: [Player](/scripting/bedwars-scripting/objects/player.md)

The player that threw the telepearl

#### startPos: [Vector3](https://create.roblox.com/docs/reference/engine/datatypes/Vector3)

The position where the player threw the telepearl

#### endPos: [Vector3](https://create.roblox.com/docs/reference/engine/datatypes/Vector3)

The position where the telepearl landed (where the player will teleport to)