Esta página ainda não foi traduzida: mostrando a versão em inglês.
Como criar um novo Project
Um Project é o backend de um jogo no PlayServ. Ele guarda os dados, as Functions, os Players e as keys do jogo, divididos em Environments isolados. Os Projects pertencem a um estúdio, e cada pessoa da equipe do estúdio vê aqueles a que tem acesso. Esta página mostra como colocar de pé um estúdio e o primeiro Project, e como cuidar dos Projects depois.
O seu primeiro login
No primeiro login, o PlayServ conduz você por duas etapas.
Dê um nome ao estúdio
O estúdio é o que a sua equipe vê nos cabeçalhos. O nome pode ter até 60 caracteres; o slug aparece logo abaixo e pode ser editado.
Crie o seu primeiro Project
Escolha Start with example para ganhar um jogo de demonstração completo em cerca de cinco segundos, ou Start blank para dar nome a um Project e escolher o ícone e a região. Skip for now leva você direto para dentro.
Start blank pede o mesmo nome, ícone e região de qualquer outro Project.
Em seguida, você chega a Projects com o novo Project selecionado. O painel API keys dele fica vazio até você criar uma key, que é a próxima coisa de que o jogo precisa.
Se alguém já convidou você para um estúdio, a primeira tela pergunta se você quer aceitar o convite ou criar a sua própria organização. Se você criar a sua, o convite continua valendo: dá para aceitá-lo depois em Organizations, no menu do perfil.
Criar um Project
Em Projects, clique em Create project ou use Create project no fim do seletor de Projects, no canto superior esquerdo.
| Campo | Regras |
|---|---|
| Name | Até 48 caracteres. Letras e dígitos, com espaços ou pontuação; não pode ter só dígitos e precisa ser único no estúdio, sem diferenciar maiúsculas de minúsculas. |
| Icon | As iniciais do Project sobre uma de seis cores. |
| Region | Onde rodam os dados e serviços do Project. Frankfurt (eu-west-1) já está disponível; Virgínia, Singapura e São Paulo chegam em breve. |
A região não pode ser alterada depois
O Project fica na região em que foi criado. Escolha a mais próxima da maioria dos seus Players.
O novo Project vira o ativo, já com os Environments dev e prod prontos.
O slug é o identificador do Project em endereços e no CLI. Ele é gerado a partir do nome, e o PlayServ acrescenta um sufixo aleatório de cinco caracteres para garantir que seja único: um Project chamado Sky Arena recebe um slug como sky-arena-a1b2c. A prévia no diálogo mostra a parte gerada a partir do nome.
O Project de exemplo
Try example cria um jogo de demonstração completo chamado Tank Wars, com itens de catálogo, lojas, três cloud functions, 30 dias de atividade simulada e mais de mil eventos. Leva cerca de cinco segundos e é o jeito mais rápido de ver cada parte do Backoffice com dados que parecem reais. Um estúdio pode ter mais de um exemplo, e um exemplo pode ser excluído como qualquer outro Project.
A página Projects
Cada Project do estúdio tem um cartão com o nome, a região, os usuários ativos mensais, a receita das últimas 24 horas (os Projects de exemplo mostram dados de amostra) e quando foi usado pela última vez.
| No cartão | O que faz |
|---|---|
| Clique no cartão | Torna o Project ativo. |
| Engrenagem | Abre as configurações do Project. |
| Gráfico | Abre o Analytics do Project. |
| API Keys | Mostra as keys do Project no painel abaixo dos cartões; veja Gerenciamento de API keys. |
| Lixeira | Exclui o Project. |
A aba History lista o que aconteceu com Projects e keys, do mais recente para o mais antigo: quem criou, renomeou, excluiu, restaurou ou abriu um Project, e quem criou, rotacionou ou revogou uma key. Os eventos de keys aparecem para o Project selecionado no Environment atual.
Configurações do Project
A engrenagem em um cartão, ou em um Project no seletor, abre as configurações do Project. As abas são General, Environments, Deployment, Notifications e Danger zone.
| Configuração em General | O que você pode fazer |
|---|---|
| Name | Renomear o Project, com até 48 caracteres. Renomear não muda o slug. |
| Slug | Somente leitura; o dono pode gerá-lo de novo. |
| Icon | Escolher outra cor. |
| Region | Aparece só para referência; não pode ser alterada. |
| Description | Até 280 caracteres. |
As alterações são salvas quando você clica em Save changes.
Gere um novo slug só quando for inevitável. Isso muda o endereço que todas as integrações usam. Regenerate slug mantém a parte gerada a partir do nome e troca o sufixo aleatório. O slug antigo pode continuar redirecionando por 0 a 180 dias (60 por padrão), para que links de loja, destinos de webhook e favoritos tenham tempo de migrar; com 0, ele para de funcionar na hora. Para confirmar, você digita o slug atual. Só o dono do estúdio pode fazer isso, uma vez a cada 30 dias e no máximo cinco vezes na vida de um Project.
Excluir e restaurar um Project
Exclua um Project pelo ícone de lixeira no cartão ou em Danger zone, nas configurações, e confirme digitando o nome dele. O catálogo, as lojas, as Functions, o analytics, os eventos e as keys vão junto.
Você tem dez segundos para voltar atrás
Depois de excluir, Undo aparece no cartão e na notificação por dez segundos. Passado esse tempo, o Project vai para Deleted projects.
Um Project excluído não atende mais nada, mas os dados dele são mantidos. Em Deleted projects:
| Ação | Quem | O que acontece |
|---|---|---|
| Restore | Dono ou admin da organização | O Project volta como estava. |
| Erase | Só o dono | Os dados são apagados de vez. Não há como voltar atrás. |
Um Project marcado como Held não pode ser apagado enquanto houver um bloqueio de um operador do PlayServ sobre ele.
Próximos passos
- Environments —
dev,prode outros, e como copiar um para outro - Gerenciamento de API keys — as keys que o jogo e os servidores usam
- Equipe e acesso — convide pessoas e decida quais Projects elas veem
Atualizado em 15 de out. de 2026