---
type: how-to
title: Personalize os jogos que seus visitantes jogam
summary: Registre um jogo do marketplace, ajuste seu idioma, skin e configuração, e gerencie atualizações e remoção, tudo pelo painel.
---

Um jogo do marketplace roda com os presets que seu autor publicou. Pelo painel você pode sobrescrever esses, o idioma do jogo, seu skin e sua configuração de jogabilidade, para que o desafio combine com seu produto e seu público. Você cria as substituições uma vez; o Caputchin as resolve no servidor e as aplica ao jogo renderizado.

Esta página cobre registrar um jogo e gerenciar seu ciclo de vida. Os guias por eixo se ramificam a partir daqui.

## Onde fica a personalização

Abra uma equipe, abra uma chave de site e vá para a página **Jogos** dela. Cada jogo que você registra aparece em **Jogos registrados**; abrir um leva você ao seu editor, que tem quatro abas:

| Aba | O que você define |
|---|---|
| **Configuração** | Opções de jogabilidade que o jogo expõe, como a dificuldade. Veja [configurações](/docs/game-customization/configurations). |
| **Idioma** | As strings traduzidas do jogo. Veja [personalizar o idioma](/docs/game-customization/locale). |
| **Skin** | As cores e os ativos visuais do jogo. Veja [personalizar o skin](/docs/game-customization/skin). |
| **Configurações** | Atualizações, atualização automática e remoção (abaixo). |

Você também pode registrar e personalizar jogos uma vez no nível da **equipe** (a própria página **Jogos** da equipe), e toda chave de site da equipe os herda. Uma chave de site vê seus próprios jogos registrados mais os da equipe, e pode sobrescrever qualquer valor sem sair da sua página. Veja [escopos](#troop-and-site-key-scope).

## Registre um jogo

No painel **Adicionar um jogo** na página Jogos:

- **Jogo do marketplace**: pesquise na caixa, escolha um jogo, e o editor abre. Este é o caminho comum; veja [adicionar um jogo do marketplace](/docs/getting-started/add-a-game) para o passo a passo completo.
- **Jogo personalizado**: insira seu próprio id e clique em **Definir** para criar um jogo que você mesmo hospeda. Veja [jogos personalizados](/docs/game-customization/custom-games).

Registrar um jogo do marketplace fixa um instantâneo dele, então a versão que seus visitantes jogam fica fixa até você escolher atualizá-la.

## Configurações do jogo: atualizações e remoção

A aba **Configurações** gerencia um jogo registrado ao longo do tempo.

### Atualização automática

Um jogo do marketplace tem um botão **Atualização automática**. Com ele ligado (o padrão para um jogo do marketplace recém-registrado), o jogo acompanha a versão publicada mais nova que passa na sua checagem de replay, então você recebe as correções e melhorias do autor automaticamente. Desligue-o para ficar fixado na versão exata que você registrou.

### Atualizar agora

Quando a atualização automática está desligada e o autor publicou uma versão mais nova, a aba Configurações mostra que uma atualização está disponível e oferece **Atualizar agora**. Aplicá-la refixa o jogo na versão atual e mantém os presets de configuração, idioma e skin que você já criou. A fixação anterior é substituída, então isto não é reversível.

### Excluir um jogo

A aba Configurações tem uma ação **Excluir jogo**. Ela remove os presets e o esquema do jogo para o escopo atual (esta chave de site, ou a equipe) após uma confirmação. Uma vez excluído, os visitantes recaem nos presets empacotados do jogo no próximo carregamento. Excluir a personalização não remove o jogo do marketplace; só limpa o que você criou aqui.

## Escopo de equipe e de chave de site [#troop-and-site-key-scope]

A personalização resolve o mais específico vence, nesta ordem:

1. **Chave de site**: uma substituição para esta única chave.
2. **Equipe**: uma base compartilhada por todas as chaves da equipe.
3. **Empacotado**: os presets que o autor do jogo publicou.

Um valor de chave de site vence o valor da equipe, que vence o padrão empacotado, calculado por valor. Então uma chave de site pode mudar uma cor enquanto herda todo o resto da equipe, que por sua vez herda do jogo. Defina uma base uma vez na equipe, depois substitua só as exceções em chaves individuais.

## O que se aplica, e em qual plano [#what-applies-and-on-which-plan]

Cada eixo se desbloqueia em um plano diferente. A substituição é resolvida no servidor e aplicada ao jogo renderizado em tempo de execução.

| Eixo | Plano |
|---|---|
| Configuração | Todo plano, inclusive o Solo |
| Idioma (locale) | Alpha em diante |
| Skin | Alpha em diante |

Personalizar o **shell do widget** ao redor do jogo (sua faixa de marca, cores e links) é um recurso separado, de nível Apex; veja [white-label do widget](/docs/widget-customization/white-label).

Jogos personalizados (auto-hospedados, fora do marketplace) resolvem seus presets do mesmo jeito: você cria o esquema de campos no painel em vez de herdá-lo de um manifesto do marketplace, depois cria presets de configuração, idioma e skin contra ele, e o Caputchin os resolve e aplica em tempo de execução nos mesmos níveis de plano acima. Veja [jogos personalizados](/docs/game-customization/custom-games).

## Veja também

- [Configurações](/docs/game-customization/configurations), [idioma](/docs/game-customization/locale) e [skin](/docs/game-customization/skin): os guias por eixo.
- [Referência de esquema](/docs/references/customization-schema): cada tipo de campo que um preset pode ter.
- [Adicionar um jogo do marketplace](/docs/getting-started/add-a-game): o passo a passo de primeiros passos.
- [Jogos e o portão de jogo](/docs/site-keys/games): exigir um jogo para verificar.
- [Nossa filosofia](/docs/understanding-caputchin/philosophy): por que cada eixo fica no plano em que fica, e o que continua grátis.
