---
title: "Astra.Components.PathFollow"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-pathfollow/
---

# Astra.Components.PathFollow

Path Follow: Percorre curva em distância mundial e orienta +Z. Família Lógica · Caminhos.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.Components.PathFollow
```

Path Follow: Percorre curva em distância mundial e orienta +Z. Família Lógica · Caminhos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_pathfollow3d.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.PathFollow>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Caminhos** → **Path Follow**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<PathFollow>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new PathFollow(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Path Follow](/pt-br/snapshot-2026-10-06/componentes/astra-path-follow/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-ae9458b9ae180acd) | Method |
| [Playing](#member-fe3c8533c74943fe) | Method |
| [Progress](#member-3af8de9116392837) | Method |
| [Remove](#member-cb53ba4c826d7d79) | Method |
| [Restart](#member-2f9b4339e5b60d52) | Method |
| [Stop](#member-b0c40885286e185f) | Method |
| [Wrap](#member-b5cf2f79409af26a) | Method |
| [Autoplay](#member-1d5e7bcf8e7f0e0c) | Property |
| [Backwards](#member-00b0567aeb8ec040) | Property |
| [Component](#member-ec9f43d48fc10de7) | Property |
| [Duration](#member-cf393963de83455e) | Property |
| [Enabled](#member-7381c1f5a15f2afa) | Property |
| [InstanceId](#member-0db619919d72009a) | Property |
| [IsAlive](#member-25649cfffcec48a8) | Property |
| [Loop](#member-267b9c29b4e4a24c) | Property |
| [Mode](#member-3c70a5ff8d752ba7) | Property |
| [Object](#member-cb6c1bc3c45cea63) | Property |
| [OffsetX](#member-600cdb32863c8e6d) | Property |
| [OffsetY](#member-a0685c056b249ebd) | Property |
| [OffsetZ](#member-4d476a0455d4ff6a) | Property |
| [Orient](#member-152a49196aebc18a) | Property |
| [ProgressDistance](#member-5dc757f0ea9006a0) | Property |
| [Speed](#member-2ff1e7928fef3aef) | Property |
| [Target](#member-a5f373225eee0cbb) | Property |
| [TypeId](#member-f8a70f74f7c1c078) | Property |

<h3 id="member-ae9458b9ae180acd" class="astra-member">.ctor</h3>

```csharp
public PathFollow(Astra.Component component)
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-fe3c8533c74943fe" class="astra-member">Playing</h3>

```csharp
public bool Playing()
```

Em movimento. Verdadeiro enquanto avança

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Em movimento. Verdadeiro enquanto avança

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3af8de9116392837" class="astra-member">Progress</h3>

```csharp
public double Progress()
```

Progresso. Distância percorrida no mundo

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Progresso. Distância percorrida no mundo

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb53ba4c826d7d79" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2f9b4339e5b60d52" class="astra-member">Restart</h3>

```csharp
public void Restart()
```

Reiniciar. Volta à distância inicial e avança

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Reiniciar. Volta à distância inicial e avança

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b0c40885286e185f" class="astra-member">Stop</h3>

```csharp
public void Stop()
```

Parar. Congela pose e progresso

Executado no mundo de Play; fora dele lança WorldException NotRunning.

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Parar. Congela pose e progresso

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b5cf2f79409af26a" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.PathFollow Wrap(Astra.Component component)
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-1d5e7bcf8e7f0e0c" class="astra-member">Autoplay</h3>

```csharp
public bool Autoplay { get; set; }
```

Iniciar no Play

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Iniciar no Play:** Inicia a reprodução automaticamente ao ativar a execução; não é o mesmo que repetição.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-00b0567aeb8ec040" class="astra-member">Backwards</h3>

```csharp
public bool Backwards { get; set; }
```

Sentido inverso

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Sentido inverso:** Percorre a curva na direção reversa.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ec9f43d48fc10de7" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cf393963de83455e" class="astra-member">Duration</h3>

```csharp
public float Duration { get; set; }
```

Duração (s)

Faixa válida: 0.001 a 100000.

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Duração:** Tempo para completar o percurso no modo por duração; modo velocidade usa Speed.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7381c1f5a15f2afa" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; set; }
```

Ativo

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Ativo:** Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0db619919d72009a" class="astra-member">InstanceId</h3>

```csharp
public ulong InstanceId { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-25649cfffcec48a8" class="astra-member">IsAlive</h3>

```csharp
public bool IsAlive { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-267b9c29b4e4a24c" class="astra-member">Loop</h3>

```csharp
public bool Loop { get; set; }
```

Repetir percurso

**Caminho:** Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

**Uso:** **Repetir percurso:** Repete a reprodução/percurso no fim.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3c70a5ff8d752ba7" class="astra-member">Mode</h3>

```csharp
public Astra.Components.PathFollow.ModeOption Mode { get; set; }
```

Avanço

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Avanço:** Seleciona o modo do componente no domínio indicado; revise os campos que aparecem após trocar.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-cb6c1bc3c45cea63" class="astra-member">Object</h3>

```csharp
public Astra.GameObject Object { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-600cdb32863c8e6d" class="astra-member">OffsetX</h3>

```csharp
public float OffsetX { get; set; }
```

Deslocamento lateral (u)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Deslocamento lateral:** Deslocamento do resultado/volume em relação à origem configurada, eixo X.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a0685c056b249ebd" class="astra-member">OffsetY</h3>

```csharp
public float OffsetY { get; set; }
```

Deslocamento vertical (u)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Deslocamento vertical:** Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4d476a0455d4ff6a" class="astra-member">OffsetZ</h3>

```csharp
public float OffsetZ { get; set; }
```

Deslocamento tangente (u)

Faixa válida: -10000 a 10000.

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Deslocamento tangente:** Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-152a49196aebc18a" class="astra-member">Orient</h3>

```csharp
public bool Orient { get; set; }
```

Orientar +Z

**Caminho:** Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

**Uso:** **Orientar +Z:** Alinha orientação ao frame do caminho.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-5dc757f0ea9006a0" class="astra-member">ProgressDistance</h3>

```csharp
public float ProgressDistance { get; set; }
```

Distância inicial (u)

Faixa válida: 0 a 1000000.

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Distância inicial:** Distância inicial mundial ao longo da curva.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2ff1e7928fef3aef" class="astra-member">Speed</h3>

```csharp
public float Speed { get; set; }
```

Velocidade (u/s)

Faixa válida: 0 a 100000.

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Velocidade:** Velocidade de reprodução/percurso/motor na unidade do componente.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a5f373225eee0cbb" class="astra-member">Target</h3>

```csharp
public Astra.ObjectReference Target { get; set; }
```

Caminho

**Caminho:** Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

**Uso:** **Caminho:** Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f8a70f74f7c1c078" class="astra-member">TypeId</h3>

```csharp
public static string TypeId { get; }
```

**Caminho:** Inspector → Path Follow; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.