Adicione um editor de fases para jogadores sem comprometer a sincronia do jogo de ritmo

Planeje um editor para jogadores que preserve a sincronia das batidas, a reprodução, as pontuações e os mapas de notas antigos. Inclua criação local, prévia, validação e reversão de mudanças.

Seele Editorial TeamAtualizado 16 de novembro de 2026

Um editor de fases para jogadores pode prolongar a vida útil de um jogo de ritmo, mas afeta o formato dos mapas de notas, o relógio de áudio, a pontuação, os comandos, os dados salvos e, às vezes, os recursos da comunidade. Mantenha o sistema de reprodução atual como referência. Comece com um conjunto básico de funções de criação local: posicione eventos em uma grade musical, visualize e valide um mapa de notas e salve um rascunho com controle de versão, sem alterar a forma como as fases já lançadas funcionam.

Um editor fictício de jogo de ritmo mostra uma grade de batidas, faixas de notas e uma prévia compacta da reprodução.
Pulse Harbor e a interface deste editor são fictícios; nenhum jogo de ritmo foi testado.

Este guia ensina a adicionar um editor a um projeto existente sem substituir seu motor de ritmo. O jogo, a trilha sonora, a interface, os dados dos mapas de notas e os resultados do exemplo são fictícios. Não havia arquivos de projeto, músicas, parser ou build disponíveis. As listas de verificação descrevem validações propostas, sem apresentar resultados de testes.

Delimite o escopo do editor

Parta de um commit limpo e documente um mapa de notas que você já sabe que é reproduzido corretamente. Registre o relógio de áudio, o carregador de mapas, o mapa de andamento, o mapeamento dos comandos, as faixas de notas, as regras de pontuação, o deslocamento temporal da música, o caminho de salvamento e os indicadores de progresso. Se não houver uma build disponível, examine apenas os arquivos fornecidos e deixe claro que o comportamento durante a execução continua desconhecido.

Mantenha a primeira versão local e com escopo limitado. O jogador deve poder escolher uma música disponível, posicionar e mover eventos, desfazer uma alteração, visualizar um trecho, salvar um rascunho, reabri-lo e ver mensagens de validação. Compartilhamento online, avaliações, moderação, assinaturas e sincronização entre dispositivos podem ser planejados à parte. Adicionar tudo ao mesmo tempo dificulta isolar uma regressão de sincronia.

Sistema existenteO que registrar antes de começarProteção padrão
Áudio e sincroniaFonte do relógio, compensação de latência e mudanças de andamentoNão substituir o relógio de reprodução
Execução dos mapas de notasCampos do arquivo, ordem dos eventos e comportamento do carregadorPreservar a compatibilidade com os mapas já lançados
Pontuação e comandosJanelas de acerto, nomes das ações e mapeamento das faixasManter as mesmas regras na prévia
ProgressãoDesbloqueios, conclusão de fases e pontuações salvasSeparar os rascunhos dos resultados oficiais

Peça à IA que examine os arquivos reais e proponha um plano de alterações antes de editar. Exija uma lista de arquivos que podem ser alterados e outra com os sistemas que devem permanecer intactos. Um pedido como “adicione um editor de fases” é amplo demais: pode levar à criação de um novo modelo de sincronia ou à substituição do carregador de mapas que já funciona. Um pedido mais seguro especifica um formato de mapa de notas, um caminho de salvamento local e uma tela simples que aciona o código de reprodução existente.

Crie eventos em tempo musical

Represente cada evento pela posição que ocupa na música, sem usar o horário real registrado enquanto alguém arrasta um bloco. Se o jogo já usa posições em batidas durante a execução, preserve essa coordenada. Se usa segundos, adicione um adaptador explícito e confira a conversão com o mapa de andamento existente. A régua do editor e o mapa jogável devem coincidir em todos os trechos de andamento.

Em um modelo conceitual, um evento pode conter um ID estável, faixa, compasso, batida, subdivisão, tipo de evento e duração opcional. Use apenas os campos necessários e siga o formato aceito pelo carregador do projeto. Armazene mudanças de andamento no formato somente se o jogo já der suporte a elas durante a execução ou se o plano do recurso previr esse suporte explicitamente. Nunca deduza um esquema completo a partir de uma captura de tela ou de um mapa de exemplo que não foi fornecido.

A linha do tempo de um mapa de notas fictício alinha os eventos de nota às divisões das batidas, acima de uma faixa separada com a forma de onda.
As posições das batidas e a forma de onda do áudio têm funções diferentes; o relógio de reprodução existente continua sendo a referência.

A documentação da versão estável do Godot descreve como ler e gravar arquivos durante a execução com FileAccess e APIs relacionadas, com exemplos que incluem conteúdo fornecido pelo usuário. O guia de caminhos de dados documenta o uso de user:// para armazenar dados persistentes do usuário. Essas referências apresentam as opções de leitura e gravação de arquivos do motor. Elas não definem um formato obrigatório para mapas de notas, não oferecem garantia de segurança e não descrevem uma implementação testada de Pulse Harbor.

Use identificadores estáveis para que mover ou excluir um evento não renumere todos os outros. Defina uma ordem determinística para a reprodução e o que acontece com notas simultâneas. Diferencie um campo opcional ausente de um campo obrigatório inválido. Se o projeto já armazena mapas de notas como recursos, crie um adaptador para que o editor trabalhe com esse formato, sem contorná-lo com uma estrutura paralela.

Torne a edição previsível e reversível

Use uma grade de batidas com controles de zoom que não alterem a posição temporal armazenada. Um clique adiciona um evento; arrastar move o evento; uma indicação clara de seleção facilita a exclusão; e o comando de desfazer reverte a última edição. Os atalhos de teclado não devem entrar em conflito com as ações existentes no jogo. Mostre o compasso atual, a subdivisão da batida, a faixa selecionada e o cursor de reprodução para que os criadores entendam o efeito de seus comandos.

Mantenha as operações com rascunhos separadas do registro oficial de conclusão. A prévia não deve contar para a progressão, sobrescrever um mapa já lançado nem enviar pontuações a um ranking. Salve em uma pasta exclusiva para rascunhos e preserve uma cópia do original quando o jogador abrir um mapa personalizado existente. Se o jogo só aceita músicas incluídas no próprio pacote, ofereça essas músicas no editor, sem dar a entender que é possível importar qualquer áudio.

No exemplo fictício de Pulse Harbor, o editor grava localmente um rascunho de mapa de notas com um número de versão e reutiliza a cena de prévia existente. Essa proposta não descreve arquivos reais nem uma integração feita de fato. Seu projeto pode exigir outro limite entre o editor e o restante do jogo, especialmente se o carregamento de mapas estiver ligado ao fluxo de importação de recursos.

Valide os arquivos locais dos mapas de notas antes da prévia

Trate o arquivo criado por um jogador como dados a validar, sem executar seu conteúdo como instruções. Verifique a versão do arquivo, as propriedades obrigatórias, os identificadores das faixas de notas, os tipos de evento, os intervalos numéricos, os IDs duplicados e a música indicada. Rejeite mapas que ultrapassem os limites do projeto ou apontem para um recurso indisponível. Exiba mensagens de erro claras: indique o evento ou campo e explique como o criador pode corrigir o problema.

Separe os avisos dos erros que impedem a reprodução. Uma densidade incomum, mas válida, pode merecer um aviso. Já uma faixa ausente ou uma posição de batida inválida deve bloquear a prévia se o jogo não conseguir processá-la. Use valores adequados ao projeto para limitar o tamanho dos arquivos e a quantidade de eventos. Teste o comportamento do parser com arquivos vazios, truncados, de versões antigas e malformados. Os limites devem seguir o design do jogo em questão, sem recorrer a números arbitrários apresentados como universais.

Área de validaçãoPergunta a responderO que fazer em caso de falha
VersãoO editor consegue ler esta versão do esquema?Explique como atualizar o arquivo ou por que ele foi rejeitado
Referência à músicaEsta música existe no catálogo permitido?Não substitua o áudio sem avisar
Coordenadas do eventoOs valores de faixa e batida são aceitos?Indique o evento inválido
Identificação dos eventosOs IDs são únicos e estáveis?Ofereça uma correção segura ou bloqueie o salvamento
Limites do arquivoO conteúdo está dentro dos limites do projeto?Interrompa a operação de forma previsível antes de carregar o arquivo

Planeje a menor mudança possível no projeto

Antes de aceitar um patch, compare as alterações com o plano de arquivos. Uma primeira entrega de escopo limitado pode envolver uma cena do editor, um controlador do editor, um adaptador para os dados dos mapas de notas, um serviço local de rascunhos e alguns testes. Ela não deve reescrever todas as músicas sem aviso, alterar as janelas de acerto, modificar o driver de áudio nem incluir mapas em rascunho na progressão oficial.

Peça à IA que mostre o diff completo, explicite as premissas de compatibilidade e descreva como remover o recurso. Trabalhe em uma branch ou em uma cópia do projeto. Preserve um mapa que você já conhece e uma gravação de referência. Se precisar de uma nova versão do formato de dados, escreva um plano de migração e teste em cópias dos mapas antes de alterar os dados dos jogadores. Se o resultado alterar a reprodução, volte à versão de referência e isole a causa.

Teste a sincronia e verifique regressões em uma cópia do projeto

Vá além de verificar se a tela do editor abre. Compare o mesmo mapa de notas conhecido antes e depois da mudança. Confira uma nota perto do início, um trecho no meio, uma transição de andamento e o final. Confirme que o cursor de reprodução do editor, o som da prévia, a animação das notas, o registro de acertos e a pontuação usam a mesma referência de tempo. O alinhamento visual da grade não comprova que a latência do áudio ou a sincronia do jogo estejam corretas.

Uma prévia fictícia de um mapa de notas local mostra uma fase de jogo de ritmo ao lado de uma lista para verificar o alinhamento das batidas, a versão do arquivo e o intervalo dos eventos.
Painel de validação apenas conceitual; a sincronia do aplicativo e o parser não foram testados.
Verificação propostaAçãoO que registrar
Mapa de referênciaExecute um mapa conhecido na build anteriorBuild, música e marcas de tempo esperadas
Ciclo de ediçãoPosicione eventos, salve o rascunho, reabra-o e visualize a préviaEventos serializados e eventuais diferenças
Transição de andamentoPosicione eventos antes e depois de uma mudança de andamentoBatida, posição do áudio e posição do cursor de reprodução
Arquivo malformadoTeste campos ausentes, inválidos e sem suporteIndicação clara da falha, sem travamento
RegressãoReproduza novamente o mapa de referência sem alteraçõesSincronia, pontuação, comandos e progressão
ReversãoRemova a branch do recurso ou restaure uma cópiaConfirmação de que o mapa original continua jogável

Essa matriz é uma proposta e não comprova que a sincronia foi preservada. Ao executar testes reais, registre a versão do projeto, o dispositivo de áudio, o mapa de notas, os deslocamentos temporais, a ação exata, o comportamento esperado, o comportamento observado e quaisquer regressões. Uma maquete de interface gerada não deve servir de base para afirmar que existe um editor ou um painel de validação.

Trate a publicação e o compartilhamento com a comunidade à parte

Se o objetivo de longo prazo inclui o compartilhamento, defina primeiro as regras de moderação, denúncias, exclusão, titularidade, licenciamento de músicas, limites de armazenamento e compatibilidade entre versões do jogo. Um editor local não oferece automaticamente uma biblioteca online segura. Só afirme que mapas criados por usuários podem ser publicados ou baixados depois de implementar e testar esses serviços e políticas.

Para explorar um conceito separado de jogo de ritmo, experimente o SEELE AI Game Maker. A ferramenta serve para explorar conceitos e não funciona como editor de projetos existentes.

Perguntas frequentes

O que um editor de fases de um jogo de ritmo deve permitir que os jogadores façam?

Comece pelas ações necessárias para criar um mapa de notas e ver sua prévia: escolher uma música, posicionar eventos em uma grade de batidas, editar os eventos ou desfazer alterações, salvar um rascunho e validá-lo. Mantenha a publicação, o compartilhamento e a moderação como recursos separados até que a criação local funcione de forma confiável.

Os eventos de um mapa de notas devem ser salvos em segundos ou em batidas?

Quando o jogo já tiver um mapa de andamento, prefira coordenadas musicais estáveis, como compasso, batida e subdivisão. Converta essas coordenadas em tempo de reprodução pelo sistema de sincronia existente. Preserve o relógio de áudio atual e as regras de deslocamento temporal. Depois, teste as mudanças de andamento e as notas próximas às transições entre trechos.

Como adicionar um editor sem alterar a reprodução do jogo de ritmo?

Mantenha como referência o carregador de mapas de notas, o relógio de áudio, a pontuação, os comandos e as faixas de notas atuais. Faça o editor gerar dados no formato que o jogo já usa durante a execução ou use um adaptador com controle de versão. Compare um mapa conhecido antes e depois da mudança e reverta a alteração se o momento em que os eventos ocorrem mudar.

Como validar mapas de notas criados pelos jogadores?

Antes da prévia, verifique a versão do arquivo, os campos obrigatórios, a referência à música, os tipos de evento, os intervalos de batidas, os IDs duplicados e os valores sem suporte. Mostre no editor os problemas que podem ser corrigidos e rejeite o conteúdo malformado com segurança. Uma lista de verificações do esquema não garante que um parser real consiga lidar com todos os arquivos maliciosos.

A IA pode criar um editor de fases no meu jogo de ritmo existente?

A IA pode ajudar a examinar os arquivos fornecidos, propor um patch de escopo limitado e elaborar casos de validação. Sem o projeto real e sem testes, ela não consegue verificar a sincronia nem a compatibilidade. Forneça uma lista de arquivos que podem ser alterados, um mapa de referência intacto, o comportamento esperado das batidas e um commit ao qual seja possível voltar. Revise o diff completo.

Adicione recursos de criação sem reescrever a reprodução

Mantenha o motor de ritmo atual no controle da sincronia. Adicione um editor local de escopo limitado que grave eventos em tempo musical em um formato com controle de versão, valide esses eventos antes da prévia e mantenha os rascunhos separados dos mapas já lançados e das pontuações oficiais. Revise o diff, teste mapas conhecidos em uma cópia do projeto e mantenha um ponto de reversão. Considere todos os resultados como não verificados até testar o jogo real.

Fontes

SEELE AI

Transforme este guia em um projeto jogável.

Comece com um briefing claro e evolua sua ideia no Workspace da Seele AI.

Começar a criar