> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# doglytdc.json

> Todos os campos do arquivo de dados do script.

`doglytdc.json` fica na raiz e guarda os dados do script. Ele é criado junto com o script.

## Exemplo

```json theme={null}
{
  "name": "Meu Script",
  "description": "Exemplo de script",
  "category": "tampermonkey",
  "platforms": [],
  "access": "free",
  "protection": true,
  "logo": null,
  "entry": "src/script.js",
  "version": "0.1.0"
}
```

## Campos

**name** `string` *required*

Nome do script (1 a 120 caracteres).

**description** `string`

Descrição curta. Vazio quando não informada.

**category** `string` *required*

Tipo do script. Um destes: `bookmark`, `tampermonkey`, `extension`, `terminal`, `app`, `discord_bot`.

**platforms** `string[]`

Só para `app`: `windows`, `linux`, `android`, `ios`. Nos outros tipos fica `[]`.

**access** `string` *required*

Quem pode usar: `free` (grátis), `paid` (pago) ou `private` (privado).

**protection** `boolean` *required*

Proteção da entrega. Ligada (padrão), o pacote é entregue só criptografado e só para quem tem acesso. Desligada, publicar pede confirmação (`confirm_unprotected`).

**logo** `string | null`

Endereço `https` da logo, ou `null`.

**entry** `string` *required*

Arquivo de entrada. Sempre `src/script.js`.

**version** `string` *required*

Versão inicial do modelo: `0.1.0`.

## Tipos de script

| `category` | Nome | Onde roda | Limites |
| - | - | - | - |
| `bookmark` | Bookmark/Console | Favorito do navegador ou colado no console (F12). | Sites com CSP rígida podem bloquear; não roda sozinho ao abrir a página. |
| `tampermonkey` | Tampermonkey | Userscript no Tampermonkey/Violentmonkey; roda sozinho nos sites do @match. | Precisa da extensão instalada; GM\_\* só com @grant. |
| `extension` | Extensão | Extensão Chrome/Edge (Manifest V3). | Sem código remoto nem eval; a instalação é descompactada ou pela loja. |
| `terminal` | Terminal | Comando de terminal (bash/PowerShell). | Roda com as permissões de quem executa; sem card na página. |
| `app` | App | Aplicativo para baixar: Windows, Linux, Android ou iOS. | Cada plataforma tem pacote próprio; iOS exige assinatura da Apple. |
| `discord_bot` | Bot Discord | Bot hospedado no DoglyTdc: comandos /, seletores, botões e formulários no seu servidor. | Responde a comandos, seletores e botões; não fica lendo todas as mensagens do chat. Precisa de um aplicativo no Discord Developer Portal. |

## Cabeçalho do Tampermonkey

No tipo `tampermonkey`, o `src/script.js` começa com o cabeçalho de userscript:

```js theme={null}
// ==UserScript==
// @name         Meu Script
// @version      0.1.0
// @match        *://*/*
// @grant        none
// ==/UserScript==
```

Troque `@match` para os sites onde o script deve rodar e use `@grant` se precisar de funções `GM_*`.

> [!NOTE]
>
> O número de versão que os usuários recebem é o da **versão publicada** (por exemplo `1.2.0`), não o campo `version` deste arquivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.