> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatares/locomotion.md).

# Configurações e Restrições de Locomoção

Altere a velocidade e a altura do salto do jogador, ou restrinja como ele pode se mover

Pode alterar a forma como o avatar do jogador se move enquanto está dentro da sua cena. Use o `AvatarLocomotionSettings` componente para ajustar velocidades e alturas de salto, e o `InputModifier` componente para imobilizar o jogador ou bloquear tipos específicos de movimento. Ambos os componentes são adicionados a `engine.PlayerEntity`, e só têm efeito enquanto o jogador estiver dentro dos limites da sua cena.

## Definições de locomoção

Pode afetar a locomoção do jogador, como a velocidade de corrida, a altura do salto e muito mais. Isto pode ser alterado dinamicamente, por exemplo, para permitir que um jogador obtenha temporariamente um aumento de velocidade ao interagir com um objeto, ou para desativar a capacidade de saltar do jogador durante um curto período.

{% hint style="info" %}
**💡 Sugestão**: Pode definir estes valores sem escrever código. Arraste o objeto inteligente **Definições de locomoção** para a sua cena no [Scene Editor no Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/about-editor.md) e ajuste os respetivos controlos deslizantes. Consulte [Definições de locomoção](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md#locomotion-settings).
{% endhint %}

Para o fazer, adicione um componente `AvatarLocomotionSettings` a `engine.PlayerEntity`.

```ts
import {AvatarLocomotionSettings, engine} from '@dcl/sdk/ecs'

AvatarLocomotionSettings.create(engine.PlayerEntity, {
	runSpeed: 10,
	jumpHeight: 2,
})
```

As seguintes propriedades estão disponíveis:

* `walkSpeed`: A velocidade a que o jogador caminha, em metros por segundo. No cliente para computador, os jogadores caminham ao premir a tecla Control.
* `jogSpeed`: A velocidade a que o jogador se desloca a passo acelerado, em metros por segundo. Esta é a forma de movimento predefinida do jogador.
* `runSpeed`: A velocidade a que o jogador corre, em metros por segundo. No cliente para computador, os jogadores correm ao premir a tecla Shift.
* `jumpHeight`: A altura a que o jogador salta, em metros.
* `runJumpHeight`: A altura a que o jogador salta depois de correr, em metros.
* `doubleJumpHeight`: A altura do segundo salto ao dar um salto duplo, em metros.
* `glidingSpeed`: A velocidade horizontal a que o jogador se move enquanto plana, em metros por segundo.
* `glidingFallingSpeed`: A velocidade máxima de queda do jogador enquanto plana, em metros por segundo. Este valor apenas limita a descida do jogador: o movimento ascendente, como o impulso de uma força contínua da cena, não é limitado.
* `hardLandingCooldown`: O tempo de espera após uma aterragem brusca, em segundos. É o tempo que o jogador tem de aguardar antes de poder voltar a mover-se depois de aterrar após uma queda de grande altura.

Para referência, eis os valores predefinidos destas propriedades:

* `walkSpeed`: 1,5 m/s
* `jogSpeed`: 8 m/s
* `runSpeed`: 10 m/s
* `glidingSpeed`: 6 m/s
* `glidingFallingSpeed`: 1 m/s
* `jumpHeight`: 1 m
* `runJumpHeight`: 1.5 m
* `doubleJumpHeight`: 2 m
* `hardLandingCooldown`: 0.75 s

{% hint style="info" %}
**💡 Dica**: Enquanto planas, as forças contínuas aplicadas pela cena são 1,5 vezes mais fortes, e as forças ascendentes podem levantar o jogador. Consulte [Forças ao planar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/player-physics.md#forces-while-gliding).
{% endhint %}

{% hint style="info" %}
**💡 Dica**: Nenhuma destas propriedades pode ser inferior a 0. Se definir uma delas com um valor negativo, este será limitado a 0. Definir estes valores como zero terá o mesmo efeito que usar o `InputModifier` para bloquear a utilização de determinadas teclas.

Só pode afetar a locomoção do jogador se este estiver dentro dos limites da cena. Para afetar os avatares de outros jogadores, tem de executar o código que afeta a locomoção nas respetivas instâncias.
{% endhint %}

Pode criar um [wearable inteligente](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md) que faz com que o jogador corra sempre mais depressa ou salte mais alto. Se a cena e um wearable inteligente definirem valores diferentes para estes parâmetros, são sempre utilizados os valores da cena.

Para garantir que ninguém tem vantagens injustas numa cena de parkour, pode impor os parâmetros predefinidos adicionando explicitamente os respetivos valores predefinidos à sua cena:

```ts
import {AvatarLocomotionSettings, engine} from '@dcl/sdk/ecs'

AvatarLocomotionSettings.create(engine.PlayerEntity, {
	runSpeed: 10,
	walkSpeed: 1.5,
	jogSpeed: 8 ,
	jumpHeight: 1,
	runJumpHeight: 1.5,
	hardLandingCooldown: 0.75
})
```

## Restringir a locomoção

Pode restringir as ações que o jogador pode realizar na sua cena. Utilize esta opção para imobilizar o jogador ou restringir formas específicas de locomoção, por exemplo, para impedir que salte ou corra.

### Imobilizar o jogador

Pode imobilizar o jogador para que nenhuma tecla de entrada mova o avatar. Isto pode ser útil para muitas mecânicas de jogo. Também é uma boa prática imobilizar o jogador durante uma animação importante que não deva ser interrompida pelo movimento, ou enquanto uma [Virtual Camera](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/camera.md) está apontada para longe do avatar e não quer que o jogador se mova às cegas.

Utilize o componente `InputModifier` na `engine.PlayerEntity` para impedir que as ações do jogador afetem a locomoção do avatar. O avatar permanecerá imóvel e o jogador só poderá rodar a câmara.

```ts
import {InputModifier, engine} from '@dcl/sdk/ecs'

InputModifier.create(engine.PlayerEntity, {
	mode: InputModifier.Mode.Standard({
		disableAll: true,
	}),
})
```

Tenha em conta as seguintes considerações:

* Enquanto as interações do jogador estiverem desativadas, o avatar continuará a ser afetado por forças externas, como a gravidade ou plataformas em movimento.
* O componente `InputModifier` só pode ser utilizado com `engine.PlayerEntity` entidade. Só pode afetar o jogador atual; não pode afetar outros jogadores.
* Este componente só afeta o jogador enquanto o Avatar estiver dentro dos limites da sua Scene. A locomoção deixa de ser restringida assim que o jogador sai da Scene.
* Enquanto as interações do jogador estiverem desativadas, o jogador não pode executar Emotes livremente, mas a Scene pode acionar animações no Avatar.
* Os inputs do jogador não afetam o Avatar, mas os [eventos de input globais](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/system-based-events.md#global-input-events) continuam a poder ser escutados pela Scene. Pode usá-los para controlar um veículo ou usar uma [Virtual Camera](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/camera.md) para seguir outra entidade enquanto se move, tratando-a como um Avatar alternativo.

### Restringir tipos específicos de locomoção

Em vez de congelar completamente o jogador, pode restringir formas específicas da sua locomoção. Isto pode ser usado por motivos de gameplay, por exemplo, para preservar a dificuldade de um jogo de plataformas, impedindo o salto duplo e o voo planado. Estas capacidades podem até ser ativadas ou desativadas dinamicamente como uma mecânica de jogo, por exemplo, dando ao jogador uma barra de resistência e impedindo-o de correr quando esta se esgota. Também pode ser usado para definir o ambiente de uma Scene, por exemplo, impedindo que se corra ou salte num local que pretende ser sereno. O `InputModifier` inclui as seguintes opções:

* `disableWalk`: O jogador não pode caminhar devagar (premindo control). Se tentar caminhar, irá trotar ou correr, se permitido.
* `disableRun`: O jogador não pode correr (premindo shift). Se tentar correr, irá trotar, se permitido.
* `disableJog`: O jogador não pode trotar (esta é a velocidade de movimento predefinida). Se tentar trotar, irá correr ou caminhar, se permitido.
* `disableJump`: O jogador não pode saltar.
* `disableEmote`: O jogador não pode executar Emotes voluntariamente. A Scene pode acionar animações no Avatar do jogador.
* `disableDoubleJump`: O jogador não pode executar um salto duplo.
* `disableGliding`: O jogador não pode planar.

```ts
import {InputModifier, engine} from '@dcl/sdk/ecs'

InputModifier.create(engine.PlayerEntity, {
	mode: InputModifier.Mode.Standard({
		disableAll: false,
		disableWalk: false,
		disableRun: true,
		disableJog: true,
		disableJump: true,
		disableEmote: true,
		disableDoubleJump: true,
		disableGliding: true
	}),
})
```

### Sintaxe avançada

Para usar o componente sem quaisquer helpers, pode usar a seguinte sintaxe:

```ts
import {InputModifier, engine} from '@dcl/sdk/ecs'

InputModifier.createOrReplace(engine.PlayerEntity, {
	mode: {
		$case: 'standard',
		standard: {
			disableAll: false,
			disableWalk: false,
			disableRun: true,
			disableJog: true,
			disableJump: true,
			disableEmote: true,
		},
	},
})
```

{% hint style="info" %}
**💡 Sugestão**: Para ver um exemplo funcional, consulte a [`0,1-input-modifier`](https://github.com/decentraland/sdk7-test-scenes/tree/main/scenes/0,1-input-modifier) Scene de teste, que ativa e desativa separadamente cada sinalizador de movimento do `InputModifier` e mostra um Avatar a ser transportado por uma plataforma em movimento enquanto o movimento está bloqueado.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatares/locomotion.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
