> 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/conceber-a-experiencia/design-games.md).

# Desenvolver Jogos

O que você precisa ter em mente ao projetar um jogo para o Decentraland.

Este documento aborda alguns pontos importantes a considerar ao conceber um jogo para Decentraland. Aspetos como a proximidade de outras Scenes e a propriedade distribuída do LAND fazem de Decentraland um lugar único, que exige que reconsidere pressupostos que possa ter adquirido com jogos anteriores.

Por exemplo, tem de compreender que, ao contrário do que acontece noutras plataformas de jogos, os jogos de Decentraland não existem isolados. Não controla o que existe nas Scenes adjacentes, nem controla certos detalhes, como os Avatars dos jogadores ou os itens que estes possam trazer de outros jogos. Isto abre portas a possibilidades entusiasmantes e exige que pense de forma diferente sobre as mecânicas de jogo.

Atualmente, o exemplo mais próximo nos jogos convencionais é o Roblox, onde os conteúdos criados pelos utilizadores da comunidade podem tornar-se locais de encontro para outras pessoas explorarem, jogarem e interagirem. Ao contrário do Roblox, em Decentraland navega pelas Scenes não percorrendo um menu de experiências sem relação entre si, mas explorando fisicamente um terreno onde todas as Scenes são adjacentes umas às outras. Decentraland também utiliza a blockchain para gerir a propriedade de terrenos, Avatars, Assets, etc.

Estamos a melhorar continuamente o SDK, pelo que algumas das limitações abaixo poderão ser removidas em futuras atualizações.

## Limites das Scenes

**O seu jogo tem de caber totalmente no \_LAND**\_\*\* sobre o qual a sua Scene é construída.\*\* Para Scenes pequenas, pense em jogos como o futebol, cujas regras mantêm as interações relevantes dentro de um espaço delimitado, embora os jogadores possam sair do campo. Os jogadores podem caminhar para fora dos limites de uma Scene, mas quaisquer Assets ou Entities que pertençam à Scene têm de permanecer dentro dela.

Os jogadores que saírem da sua Scene continuam a renderizá-la enquanto esta estiver dentro do alcance visível. Se se afastarem demasiado, deixarão de a renderizar por completo.

Também poderia criar um jogo que se estenda por vários terrenos separados, desconhecidos dos jogadores, em que a exploração do resto do mundo faça parte da jogabilidade. Um jogo desse tipo seria composto por várias *Scenes*, que poderiam partilhar dados entre si através de um Server.

Se publicar o seu jogo num [Decentraland World](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds), terá mais controlo sobre o que os jogadores veem para além dos limites da sua Scene. Normalmente, os Worlds são rodeados por uma paisagem gerada automaticamente, composta por prados, árvores e mar, mas pode [desativar esta paisagem](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md#landscape-terrain) se esta não se adequar ao cenário do seu jogo, como no caso de um jogo que decorra em mar aberto ou no espaço.

### Inventário do utilizador

**Atualmente, não existe um inventário onde os jogadores possam guardar itens do jogo enquanto se deslocam entre Scenes.** Atualmente, estão disponíveis as seguintes alternativas:

* Pode guardar informações do inventário na própria Scene e associá-las ao endereço Ethereum de cada jogador (que pode ser usado como um ID persistente). Estas informações só poderão ser lidas a partir da sua Scene.
* Pode usar um sistema de armazenamento externo personalizado e sincronizar todas as suas Scenes com ele. Esta é uma solução mais robusta, capaz de lidar com um maior número de jogadores. Também pode alargar o acesso a este inventário a várias Scenes independentes que sejam suas ou de outras pessoas.
* Use Tokens na blockchain para gerir a propriedade dos itens.

Quando um jogador ganhar um item do jogo, este poderá ser guardado como um Token especial na Wallet Ethereum do jogador. Quando um jogador que possui o Token entrar na sua Scene, esta poderá atribuir-lhe determinadas características dentro do jogo.

Outras Scenes também poderão reagir ao mesmo Token de formas diferentes, o que pode criar interações interessantes entre jogos.

A desvantagem de usar a blockchain para guardar itens do inventário é que todas as transações têm um custo para o jogador e não são imediatas. Mais abaixo, consulte a secção especializada para saber mais sobre a blockchain.

Em futuras versões, os jogadores terão um inventário que poderão levar para todo o lado, com Assets on-chain e off-chain.

### Experiências portáteis

{% hint style="info" %}
**💡 Sugestão**: consulte [Experiências portáteis](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/portable-experiences.md) e [Smart wearables](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md) para saber como as criar.
{% endhint %}

As experiências portáteis são partes da jogabilidade que os jogadores levam consigo enquanto se deslocam pelo metaverso. Não estão associadas a parcelas de terreno; por vezes, estão associadas a Tokens ou são iniciadas pelo Explorer. Por exemplo, um jogador pode levar uma bola de neve da sua Scene, deslocar-se para outra Scene e atirá-la a outro jogador que também esteja a jogar o mesmo jogo.

Os Smart wearables são um tipo de experiência portátil associado a um Token de wearable e ativado quando o jogador veste a peça de roupa. Os Smart wearables podem conceder novas capacidades aos jogadores, como um jetpack que lhes permite voar, ou acrescentar uma nova camada de conteúdo ao resto do mundo, como colocar moedas aleatoriamente para serem recolhidas por toda a Genesis City.

Tenha em conta que os jogadores poderão estar a usar a experiência portátil de outra pessoa enquanto estão na sua Scene. Consulte [Dados do utilizador](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/user-data.md#get-portable-experiences) para saber como verificar que experiências portáteis um jogador tem atualmente ativadas.

## Persistência do jogo

**Decentraland é um mundo persistente: os jogadores podem visitar a sua Scene a qualquer momento.** A sua Scene não tem uma fase inicial nem um fim, por isso deve conceber as mecânicas de jogo de modo a permitir que os jogadores que entram ou saem a qualquer momento também possam participar.

A sua Scene pode ter um mecanismo de reinicialização que a repõe num estado inicial, mas deve ter cuidado para não interromper o jogo dos jogadores que já estão a jogar.

### Sincronizar o estado da Scene

**Por predefinição, os estados das Scenes não são partilhados entre jogadores.** Cada jogador executa a sua própria cópia local da Scene. Esta é a forma mais simples de criar uma Scene, mas não é ideal para experiências sociais.

A forma mais fácil de partilhar o estado entre jogadores é marcar as Entities como sincronizadas, usando a função `syncEntity` Consulte [Multijogador sem servidor](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/serverless-multiplayer.md). Com esta abordagem, as alterações de estado não são guardadas em lado nenhum: se não houver jogadores nas proximidades da Scene a carregá-la, esta será reposta no estado predefinido da próxima vez que for carregada.

**Também pode usar um servidor para armazenar informações sobre a sua Scene e manter todos os jogadores sincronizados.** Isto mantém o estado da Scene consistente e persistente, mesmo quando não há jogadores por perto, e permite validar alterações para impedir que os jogadores façam batota. A opção recomendada é usar um [Multiplayer Server](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/authoritative-servers.md), alojado e implementado pela Decentraland por si, como parte da publicação da sua Scene. Também pode alojar [o seu próprio servidor](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/rede/third-party-servers.md), o que permite manter determinadas informações, como tokens de segurança, apenas no servidor, sem nunca as expor externamente.

### Temporização do jogo

**Os jogos que usam a arquitetura de comunicações predefinida devem ter em conta que pode haver latência entre os jogadores** e não devem depender de reações rápidas entre as ações de diferentes jogadores. Recomendamos jogos por turnos ou baseados sobretudo em interações entre jogadores e o ambiente.

Nos jogos em que a temporização das ações entre jogadores é essencial, como num jogo de tiro na primeira pessoa, deve implementar o seu próprio servidor como fonte de verdade autoritativa em tempo real para todos os jogadores na sua Scene.

## Jogadores na Scene

**Na Decentraland, os jogadores são identificados pelo endereço da respetiva carteira Ethereum.** Esta carteira é usada como um ID persistente, já associado a todos os tokens que o jogador possui.

**Atualmente, não há forma de limitar o número de jogadores que podem estar presentes na Decentraland ao mesmo tempo.** Ao contrário de muitos outros jogos, que podem ter diferentes sessões de jogo alojadas em servidores separados, por enquanto existe apenas uma instância da Decentraland, partilhada por todos os jogadores.

Tenha em conta que pode haver vários jogadores a passear pela sua Scene a qualquer momento. Alguns podem estar só de passagem e não participar no jogo. Certifique-se de que as mecânicas do jogo não podem ser facilmente perturbadas por isso.

**O ciclo do jogo da sua Scene não pode afetar os jogadores diretamente**, a Scene reage às ações do jogador. Se um jogador estiver sobre uma Entity e esta se mover ou rodar, o jogador acompanhará o movimento. Isto é especialmente útil para elevadores, plataformas flutuantes e elementos semelhantes.

Enquanto proprietário de uma Scene, não pode expulsar à força um jogador que esteja a causar problemas nem teleportá-lo para fora da sua Scene. No entanto, poderá adicionar jogadores a uma lista negra no servidor de sinalização. Também pode implementar uma lista negra no código da sua Scene e negar determinados serviços aos jogadores nela incluídos.

## Construa interiores maiores do que na vida real

A maioria dos jogadores explora a Decentraland com a câmara predefinida na terceira pessoa, posicionada atrás e acima do Avatar. Essa câmara precisa de espaço. Um interior construído à escala real parece um corredor apertado no ecrã: a câmara fica encostada ao teto, o Avatar ocupa todo o enquadramento e o jogador não consegue ver para onde vai.

Construa a estrutura de uma divisão com cerca de **1,5 a 2 vezes** a altura livre real:

| Elemento                                            | Dimensões reais                                               | Dimensões de construção                                                |
| --------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Altura do teto                                      | 2,5 a 3 m                                                     | **5 a 6 m**                                                            |
| Porta ou abertura num percurso principal            | cerca de 2,1 m x 0,9 m                                        | **cerca de 4 m de altura e 3 m ou mais de largura**                    |
| Largura do corredor                                 | 1,2 a 1,8 m                                                   | **4 m ou mais**                                                        |
| Qualquer passagem por onde o Avatar tenha de passar |                                                               | **pelo menos 1,2 m de espaço livre**                                   |
| Escadas                                             | cerca de 0,18 m de altura e 0,28 m de profundidade por degrau | **até 0,25 m de altura e pelo menos 0,3 m de profundidade por degrau** |
| Rampas                                              |                                                               | **30 graus ou menos**                                                  |

A câmara na terceira pessoa orbita a cerca de 4,5 m do Avatar, com um campo de visão de 60 graus. Quando uma parede ou um teto se interpõe entre a câmara e o Avatar, a câmara avança para o manter visível. Esse salto repentino é o que faz a divisão parecer apertada. Por isso, as divisões onde os jogadores dão a volta parecem mais espaçosas quando têm cerca de **9 m de largura ou mais**, o dobro da distância da câmara. Para conhecer os limites do Engine relativos a degraus, inclinações e altura livre, consulte [Restrições espaciais dos jogadores](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/colliders.md#player-spatial-constraints).

Alguns aspetos a ter em conta:

* **Aumente a divisão, não o tamanho do seu conteúdo.** Mantenha as cadeiras, secretárias, balcões, corrimões e sinalização perto do tamanho real. Se aumentar a escala do mobiliário juntamente com as paredes, recriará a mesma sensação de aperto, só que numa escala maior, e o Avatar deixará de parecer uma pessoa dentro da divisão.
* **Aplique isto ao planear a área do piso**, não depois de colocar tudo. Salas maiores precisam de mais parcelas, por isso estes números alteram o seu [orçamento de parcelas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md).
* **Avalie o resultado a partir da câmara normal em terceira pessoa.** Uma câmara livre ou a janela de visualização do Creator Hub favorece os interiores, pois pode ficar fora da geometria e olhar para dentro. Percorra o trajeto como um jogador faria. Se a câmara atravessar o teto, ou se a cabeça do avatar ficar demasiado perto do topo do enquadramento, a sala é demasiado baixa.

{% hint style="info" %}
**💡 Dica**: Estas são recomendações de design baseadas na experiência, não um limite do engine. Use os números como ponto de partida e ajuste a olho.
{% endhint %}

## Limitações do conteúdo da cena

**Crie a sua cena tendo especial cuidado com a eficiência do código.** A Decentraland tem de funcionar em navegadores Web e dispositivos móveis, e os jogadores irão renderizar várias cenas ao mesmo tempo enquanto percorrem o metaverso.

**Também deve tentar manter a cena leve.** Ao contrário de outros jogos online, em que as mesmas texturas e os mesmos assets são repetidos de forma conveniente por todo um grande mundo aberto, na Decentraland cada cena pode ter um conjunto de assets completamente diferente. À medida que os jogadores percorrem várias cenas, devem conseguir transferir todo o conteúdo da cena, incluindo texturas, ficheiros de som, etc., a uma velocidade razoável.

Por este motivo, impusemos alguns limites para evitar o uso excessivo de recursos computacionais. Consulte [limitações das cenas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/scene-limitations.md) para saber mais sobre estes limites.

## Acesso às cenas

**O mapa da Decentraland foi concebido com estradas e praças públicas,** que garantem um acesso fácil a várias partes do mapa, independentemente do que outras pessoas construam. Os terrenos que não sejam adjacentes a uma estrada ou praça correm o risco de ficar bloqueados por cenas vizinhas, embora esperemos que a maioria das cenas permita a circulação e não bloqueie as outras.

Os novos jogadores começam a sua experiência na Genesis Plaza, no centro do mapa, onde serão incentivados a realizar algumas atividades tutoriais e, em seguida, a explorar o mundo.

Os jogadores também podem introduzir manualmente um URL com coordenadas específicas do mapa da Decentraland para aparecer nesse local. Também pode partilhar links para URLs com coordenadas iniciais predefinidas.

Tenha em conta que começar num local bloqueado ou abaixo do nível do terreno não será uma experiência agradável para o jogador. Para evitar isso, pode definir um conjunto de locais específicos na sua cena onde seja seguro aparecer. Consulte [metadados da cena](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md) para saber mais.

Os jogadores também podem percorrer o mundo rapidamente usando o mapa e as listas de locais e eventos populares. A sua cena pode incluir teletransportes que levam os jogadores a outras partes do mundo. Consulte [Teletransportes](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/external-links.md#teleports).

## UI do utilizador

**A UI sobreposta predefinida que os jogadores veem ao entrar na Decentraland inclui apenas os elementos essenciais.** Pode adicionar elementos à UI enquanto um jogador estiver na sua cena. Tenha em conta que a UI predefinida da Decentraland aparece por cima de tudo o que estiver na sua cena, por isso conceba a sua UI de modo a não se sobrepor a ela.

Quando um jogador sai da cena, todos os elementos da UI são removidos para não interferirem com outras cenas. Os jogadores também têm um botão no ecrã para desativar todos os elementos da UI da cena. Esta opção é útil sobretudo para evitar comportamentos abusivos de cenas que possam tentar cobrir todo o campo de visão do jogador.

## Física

Tenha em conta que o SDK não disponibiliza um engine de física completo para Entities. Pode aplicar forças e impulsos ao avatar do jogador. Consulte [Física do jogador](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/player-physics.md). Para a física entre Entities, como colisões ou gravidade, pode importar uma biblioteca ou programar o comportamento por conta própria.

## Controlos

**Os controlos do seu jogo devem limitar-se ao conjunto de ações de entrada suportadas pelo SDK**: as teclas de movimento, o salto, apontar e clicar, os botões principal (E) e secundário (F) e os botões de ação numerados (1 a 4). Estas entradas são abstraídas das teclas físicas, para que também possam ser associadas aos controlos no ecrã da aplicação móvel ou a outros dispositivos. Não presuma que toda a gente tem um teclado. Consulte [Botões do ponteiro](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/click-events.md#pointer-buttons) para ver a lista completa e [Entrada em dispositivos móveis](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/input-on-mobile.md) para saber o que deve preferir ao direcionar-se a jogadores em dispositivos móveis.

Todas estas entradas suportam eventos globais de *botão premido* e *botão libertado* e eventos de acerto, que permitem identificar se uma Entity estava na mira do jogador.

## Avatares

**Os jogadores podem criar os seus avatares a partir de um vasto catálogo de artigos vestíveis**, incluindo artigos criados e vendidos por criadores da comunidade no Marketplace da Decentraland. A sua cena pode ler o que um jogador está a usar e reagir a isso. Consulte [Dados do utilizador](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/user-data.md#get-player-data).

## Comunicação entre jogadores

**Os jogadores podem conversar entre si, falar por chat de voz e comunicar através da linguagem corporal, fazendo emotes** como dançar, bater palmas ou acenar, incluindo emotes vendidos por criadores da comunidade.

A sua scene pode detetar quando um jogador faz um emote e também pode fazer com que o avatar de um jogador reproduza uma animação. Consulte [O jogador reproduz uma animação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/event-listeners.md#player-plays-animation) e [Animações de Avatar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatares/avatar-animations.md).

## Notificações do jogo

**Atualmente, não existe um sistema de notificações entre scenes.** Qualquer jogo que necessite de apresentar notificações fora da scene atual terá de as implementar através de um serviço externo.

## Utilizar a blockchain

**Em Decentraland, a blockchain é utilizada para armazenar informações sobre a propriedade.** Atualmente, isto refere-se sobretudo à propriedade de LAND, mas também pode ser utilizado para a propriedade de itens de jogo, wearables, avatares especiais, emotes e tokens que garantam determinados privilégios no jogo ou acesso a jogos.

A blockchain não é utilizada para armazenar o estado do jogo, a posição dos jogadores ou qualquer informação que tenha de mudar em tempo real.

### LAND e MANA

**Os jogadores não precisam de possuir parcelas de terreno para participar no metaverso.** Na verdade, a grande maioria dos jogadores não possuirá nenhuma. Os avatares dos jogadores e os tokens LAND que possuem não estão diretamente ligados de forma alguma.

**Os jogadores não precisam de possuir previamente uma carteira Ethereum nem tokens MANA para entrar em Decentraland.** Se a sua jogabilidade depender muito da posse de tokens, estará a excluir a maioria dos jogadores. Um modelo de jogo freemium pode ser ideal para se adaptar a ambos os públicos.

### Outros NFTs

**Pode utilizar tokens não fungíveis (NFTs) especiais para representar itens de jogo, avatares personalizados ou wearables.** Se um jogador possuir um destes tokens, a sua scene poderá reagir a isso de diferentes formas.

Saiba o que são NFTs em [esta publicação no blogue](https://decentraland.org/blog/technology/what-are-nfts/).

### Transações no jogo

**A sua scene pode permitir transações na blockchain para que os jogadores comprem ou ganhem tokens.**

As transações na blockchain não são imediatas: requerem tempo para verificação e têm um custo em Ether. Tanto o tempo como o custo variam consoante a utilização atual da rede.

Decentraland utiliza a sidechain Polygon para processar transações de forma mais rápida e económica do que na rede Ethereum. Esta sidechain é ideal para transações no jogo, uma vez que as alterações podem ocorrer quase em tempo real e a um custo muito baixo. A cadeia principal Ethereum continua a ser recomendada para transações que exigem maior segurança e cujo custo e duração não sejam um problema. Consulte [Segunda camada](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/blockchain/second-layer.md).

O jogador tem sempre de aprovar explicitamente estas transações no seu cliente Ethereum. Por exemplo, ao utilizar o Metamask, o Metamask pede ao jogador que aceite cada transação antes de esta ser processada.

Os jogadores também podem assinar um contrato que aprove automaticamente todas as transações solicitadas por um endereço específico ou dentro de determinados limites, para evitar interrupções para aprovar transações.

Também pode utilizar smart contracts para condicionar transações a condições personalizadas. Por exemplo, os jogadores podem apostar no resultado de um jogo, e os pagamentos correspondentes são efetuados automaticamente assim que o resultado for conhecido.

Para implementar interações com a blockchain no código da sua scene, tem de utilizar bibliotecas externas que comuniquem com a rede Ethereum. As versões futuras do SDK disponibilizarão uma API personalizada para expor estas funcionalidades de forma mais simples.


---

# 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/conceber-a-experiencia/design-games.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.
