> 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/tipos-de-projetos/scene-files.md).

# Arquivos da Scene

Arquivos padrão criados em uma nova scene.

Depois de [criar uma nova cena](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/sdk-101.md), a pasta da cena incluirá uma série de ficheiros com conteúdo predefinido.

## Ficheiros predefinidos numa cena

As cenas incluem os seguintes ficheiros:

* **src/index.ts**: O ponto de entrada da cena.
* **scene.json**: O manifesto que contém metadados da cena.
* **package.json** e **package-lock.json**: Especificam as versões de todas as dependências da cena.
* **tsconfig.json**: Ficheiro de configuração do TypeScript.
* **.dclignore**: Lista os ficheiros do projeto que não serão carregados quando publicar a cena.
* **assets/scene/main.composite**: Ficheiro gerado automaticamente que inclui tudo o que adicionou e configurou visualmente no Scene Editor do Creator Hub. Não se destina a ser legível por pessoas. É um exemplo de um [composite](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/composites.md), um ficheiro que descreve uma árvore de Entities e Components. As cenas criadas através da CLI incluem, em vez disso, um ficheiro `main.crdt` no diretório raiz.

### index.ts

Este é o ponto de entrada para o código personalizado da sua cena. Pode incluir toda a lógica da cena neste ficheiro, embora, para maior clareza, na maioria dos casos recomendemos distribuir o código por vários outros ficheiros *.ts* .

Se utilizar apenas o Scene Editor e os [Smart Items](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md), não precisará de modificar este ficheiro.

Se pretender escrever código personalizado, provavelmente só precisará de editar este e outros ficheiros .ts para criar a sua cena. Este ficheiro contém o código que gera as [Entities, Components](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/entities-components.md) e [Systems](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/systems.md) da sua cena.

Ao executar a cena, o conteúdo dos seus ficheiros `.ts` é compilado num único ficheiro `.js` , `bin/index.js`. Ao criar uma versão de produção, este ficheiro também é minificado.

{% hint style="warning" %}
**📔 Nota**: Pode utilizar outra ferramenta ou linguagem em vez de TypeScript, desde que os seus scripts estejam contidos num único ficheiro JavaScript (bin/index.js). Todas as declarações de tipos fornecidas são escritas em TypeScript; outras linguagens e transpiladores não são oficialmente suportados.
{% endhint %}

### scene.json

O ficheiro *scene.json* é um manifesto em formato JSON para uma cena no World. Uma cena pode abranger uma ou várias parcelas de LAND. O *scene.json* manifesto descreve os objetos existentes na cena, uma lista dos assets necessários para a renderizar, os dados de contacto do proprietário da parcela e as definições de segurança.

A maioria dos campos do *scene.json* o ficheiro pode ser editado diretamente na UI do Scene Editor. Consulte [Definições da Scene](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/scene-editor-essentials.md#scene-settings).

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-89beaa271602570a5f8e55d01517680b656d7135%2Fthumbnail-image.webp?alt=media)

Para obter mais informações, consulte [os metadados da scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md#metadata).

Todos estes metadados são opcionais para pré-visualizar a scene localmente, mas alguns são necessários para a implementação. Pode alterar estas informações manualmente a qualquer momento.

### package.json

Este ficheiro fornece informações ao NPM que lhe permitem identificar o projeto e gerir as respetivas dependências. As scenes do Decentraland requerem um pacote principal:

* **@dcl/sdk**: A dependência fundamental do SDK do Decentraland, que inclui definições e tipos para o engine, os Components, os Systems, etc.
* **@dcl/js-runtime**: Um conjunto de declarações de tipos que facilita a integração do @dcl/sdk.

A sua scene pode incluir qualquer número de outros pacotes, por exemplo, para incluir [bibliotecas](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) que podem facilitar a escrita de código ou ativar funcionalidades especiais.

### package-lock.json

Este ficheiro apresenta as versões de todas as outras dependências do projeto. Estas versões são fixas, o que significa que o compilador usará exatamente a mesma versão secundária aqui indicada.

Pode alterar manualmente a versão de qualquer pacote editando este ficheiro.

### tsconfig.json

Os diretórios que contêm um *tsconfig.json* são diretórios raiz de projetos TypeScript. O ficheiro *tsconfig.json* especifica os ficheiros raiz e as opções necessárias para compilar o seu projeto de TypeScript para JavaScript.

Ao instalar bibliotecas adicionais na sua scene, deverá ser adicionada automaticamente uma entrada a este ficheiro. Para instalar bibliotecas de utilitários do Decentraland, não deverá ser necessário alterar manualmente este ficheiro.

## Localizações de ficheiros recomendadas

Tenha em atenção que, ao implementar a sua scene no Decentraland, todos os assets ou bibliotecas externas necessários para a utilizar têm de estar incluídos na pasta da scene ou disponíveis num servidor remoto.

Tudo o que se destina a ser executado no cliente do jogador tem de estar dentro da pasta da scene. Não deve referenciar ficheiros ou bibliotecas instalados noutro local da sua máquina, pois não estarão disponíveis na scene implementada.

Sugerimos que utilize estes nomes de pastas de forma consistente para armazenar os diferentes tipos de assets de que a sua scene possa precisar:

* Modelos 3D: `assets/scene/models`
* Vídeos: `assets/scene/videos`
* Ficheiros de som: `assets/scene/sounds`
* Ficheiros de imagem para texturas (exceto para modelos glTF): `assets/scene/materials`
* *.ts* definições de Components `/src/components`
* *.ts* definições de Systems `/src/systems`

{% hint style="warning" %}
**📔 Nota**: Os ficheiros de suporte dos modelos glTF, como as respetivas imagens de textura ou ficheiros *.bin* devem estar sempre na mesma pasta que o modelo *.gltf* ou *.glb* .
{% endhint %}

{% hint style="warning" %}
**📔 Nota**: recomendamos usar sempre nomes em minúsculas para todas as pastas e ficheiros, para evitar possíveis problemas.
{% endhint %}

Ao importar quaisquer recursos através do Scene Editor, estes são adicionados automaticamente à pasta `assets/scene` . Ao usar qualquer um dos recursos predefinidos dos Asset Packs do Scene Editor, os respetivos ficheiros são adicionados à pasta `assets/builder` .

## O ficheiro dclignore

Todas as cenas incluem um ficheiro *.dclignore* , que especifica que ficheiros da pasta da cena devem ser ignorados ao publicar uma cena na Decentraland.

Por exemplo, pode querer manter os ficheiros do Blender dos modelos 3D da sua cena dentro da pasta da cena, mas impedir que sejam publicados na Decentraland. Nesse caso, pode adicionar `*.blend` a *.dclignore* para ignorar todos os ficheiros com essa extensão.

{% hint style="warning" %}
**📔 Nota**: *.dclignore* também se aplica à pré-visualização local, não apenas às publicações. Um ficheiro ignorado não é listado no conteúdo disponibilizado pela pré-visualização, pelo que a sua cena também não o pode carregar aí. Não se trata de um erro 404 que possa detetar nos registos: o ficheiro simplesmente nunca é solicitado. Se um recurso funcionar no seu editor, mas não na pré-visualização, verifique primeiro *.dclignore* .
{% endhint %}

| O que ignorar         | Exemplo     | Descrição                                                                                            |
| --------------------- | ----------- | ---------------------------------------------------------------------------------------------------- |
| Ficheiros específicos | `BACKUP.ts` | Ignora um ficheiro específico                                                                        |
| Pastas                | `drafts/`   | Ignora todo o conteúdo de uma pasta e das respetivas subpastas                                       |
| Extensões             | `*.blend`   | Ignora todos os ficheiros com uma determinada extensão                                               |
| Secções do nome       | `test*`     | Ignora todos os ficheiros cujos nomes correspondam à consulta. Neste caso, os que começam por *test* |


---

# 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/tipos-de-projetos/scene-files.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.
