Añade un editor de niveles para jugadores sin alterar la sincronización con el ritmo

Planifica un editor para jugadores que conserve la sincronización con el pulso, la reproducción, las puntuaciones y los mapas de notas antiguos. Añade creación local, vista previa, validación y la posibilidad de revertir los cambios.

Seele Editorial TeamActualizado 16 de noviembre de 2026

Un editor de niveles para jugadores puede alargar la vida de un juego de ritmo, pero afecta al formato de los mapas de notas, al reloj de audio, a la puntuación, a los controles, a los datos guardados y, a veces, a las funciones de comunidad. Mantén el sistema de reproducción actual como referencia. Empieza con un conjunto básico de funciones de creación local: colocar eventos en una cuadrícula musical, previsualizar un mapa de notas, validarlo y guardar un borrador con número de versión sin cambiar cómo se reproducen los niveles ya publicados.

Un editor ficticio de un juego de ritmo muestra una cuadrícula de pulsos, carriles de notas y una vista previa compacta de la reproducción.
Pulse Harbor y la interfaz de este editor son ficticios; no se ha probado ningún juego de ritmo.

Esta guía explica cómo añadir un editor a un proyecto existente sin sustituir su motor de ritmo. El juego de ejemplo, la banda sonora, la interfaz, los datos de los mapas de notas y los resultados son inventados. No se dispuso de archivos del proyecto, música, un analizador de archivos ni una compilación. Las listas de comprobación describen pruebas propuestas, no resultados de pruebas.

Delimita el alcance del editor

Parte de un commit limpio y documenta un mapa de notas que ya se reproduzca correctamente. Anota el reloj de audio, el cargador de mapas de notas, el mapa de tempo, la asignación de controles, los carriles de notas, las reglas de puntuación, el desfase de la canción, la ruta de guardado y los indicadores de progreso. Si no hay una compilación disponible, revisa solo los archivos facilitados e indica que se desconoce el comportamiento en ejecución.

Limita la primera versión a unas pocas funciones locales. El jugador debe poder elegir una pista disponible, colocar y mover eventos, deshacer un cambio, previsualizar una sección, guardar un borrador, volver a abrirlo y consultar los mensajes de validación. Puedes planificar por separado las opciones para compartir en línea, las valoraciones, la moderación, las suscripciones y la sincronización entre dispositivos. Si las añades a la vez, será más difícil aislar la causa de un fallo de sincronización.

Sistema existenteQué documentar antes de empezarProtección por defecto
Audio y sincronizaciónFuente del reloj, compensación de latencia y cambios de tempoNo sustituir el reloj de reproducción
Ejecución de mapas de notasCampos del archivo, orden de los eventos y comportamiento del cargadorMantener la compatibilidad con los mapas ya publicados
Puntuación y controlesMárgenes de acierto, nombres de las acciones y asignación de carrilesAplicar las mismas reglas en la vista previa
ProgresoDesbloqueos, niveles completados y puntuaciones guardadasSeparar los borradores de los resultados oficiales

Pide a la IA que revise los archivos reales y proponga un plan de cambios antes de editar nada. Exige una lista de archivos que se pueden modificar y otra de los sistemas que deben quedar intactos. Una petición como «añade un editor de niveles» es demasiado amplia: puede llevar a introducir un modelo de sincronización nuevo o a sustituir el cargador de mapas de notas que ya funciona. Una instrucción más segura especifica un solo formato de mapa, una ruta de guardado local y una pantalla sencilla que llame al código de reproducción existente.

Coloca los eventos en el tiempo musical

Representa cada evento según su posición en la canción, en vez de usar una marca de tiempo del reloj del sistema tomada al arrastrar un bloque. Si el motor actual utiliza posiciones expresadas en pulsos, conserva esa coordenada. Si utiliza segundos, añade un adaptador explícito y comprueba la conversión con el mapa de tempo existente. La regla temporal del editor y el mapa de notas jugable deben coincidir en cada tramo de tempo.

En un modelo conceptual, un evento podría incluir un ID estable, el carril, el compás, el pulso, la subdivisión, el tipo de evento y una duración opcional. Usa solo los campos imprescindibles y ajústalos al cargador real del proyecto. Guarda los cambios de tempo en el formato solo si el motor ya los admite o si el plan de la función prevé añadirlos de forma explícita. Nunca deduzcas un esquema completo a partir de una captura de pantalla o de un mapa de ejemplo que no se haya facilitado.

La línea de tiempo de un mapa de notas ficticio alinea los eventos de nota con las divisiones del pulso, sobre una franja separada con la forma de onda.
Las posiciones de los pulsos y la forma de onda del audio cumplen funciones distintas; el reloj de reproducción existente sigue siendo la referencia.

La documentación de la versión estable de Godot explica cómo leer y escribir archivos durante la ejecución con FileAccess y otras API relacionadas, e incluye ejemplos con contenido proporcionado por los usuarios. Su guía de rutas de datos documenta user:// para guardar datos de usuario de forma persistente. Estas referencias describen las opciones de lectura y escritura de archivos del motor. No prescriben un formato para los mapas de notas, no ofrecen garantías de seguridad ni documentan una implementación probada de Pulse Harbor.

Usa identificadores estables para que mover o eliminar un evento no obligue a renumerar los demás. Ordena los eventos siempre con el mismo criterio para la reproducción, define qué ocurre con las notas simultáneas y distingue entre un campo opcional ausente y un campo obligatorio no válido. Si el proyecto ya guarda los mapas de notas como recursos, crea un adaptador para que el editor use ese formato en lugar de crear una estructura paralela.

Haz que la edición sea previsible y reversible

Usa una cuadrícula de pulsos con controles de zoom que no modifiquen las posiciones temporales guardadas. Un clic añade un evento; al arrastrarlo, se mueve; una selección claramente marcada permite eliminarlo; y la opción de deshacer revierte la última edición. Los atajos de teclado no deben interferir con las acciones que ya tiene asignadas el juego. Muestra el compás actual, la subdivisión del pulso, el carril seleccionado y el cursor de reproducción para que los creadores vean el efecto de sus acciones.

Mantén las operaciones con borradores separadas del registro oficial de niveles completados. La vista previa no debe otorgar avances en el juego, sobrescribir un mapa publicado ni enviar una puntuación a una clasificación. Guarda los borradores en una carpeta específica y conserva una copia del original cuando el jugador abra un mapa personalizado existente. Si el juego solo admite las canciones incluidas, el editor debe ofrecer esas pistas sin dar a entender que ya se puede importar cualquier archivo de audio.

En el ejemplo ficticio de Pulse Harbor, el editor guarda un borrador local del mapa de notas con un número de versión y reutiliza la escena de vista previa existente. Esta propuesta no describe archivos reales ni una integración ya realizada. Tu proyecto puede requerir una separación distinta, sobre todo si la carga de mapas de notas depende de un proceso de importación de recursos.

Valida los archivos locales de mapas de notas antes de previsualizarlos

Trata los archivos creados por los jugadores como datos que hay que validar, no como instrucciones que se puedan ejecutar. Comprueba la versión del archivo, las propiedades obligatorias, los identificadores de carril, los tipos de evento, los intervalos numéricos, los ID duplicados y la pista a la que hace referencia. Rechaza cualquier mapa que supere los límites del proyecto o apunte a un recurso no disponible. Redacta mensajes de error claros y útiles: indica qué evento o campo falla y explica cómo corregirlo.

Distingue los avisos de los errores que impiden continuar. Una densidad de notas poco habitual pero válida puede merecer un aviso. En cambio, si el motor no admite un carril ausente o una posición de pulso no válida, esos errores deben impedir la vista previa. Limita el tamaño de los archivos y el número de eventos con valores adecuados para el proyecto y comprueba cómo responde el analizador ante archivos vacíos, truncados, de versiones anteriores y mal formados. Esos límites deben basarse en el diseño del juego, no en cifras inventadas que se presenten como universales.

Aspecto que se validaPregunta que hay que responderQué hacer si falla
Versión¿Puede el editor leer esta versión del esquema?Explicar cómo actualizar el archivo o por qué se rechaza
Referencia a la pista¿Está esta canción en el catálogo permitido?No sustituir el audio sin avisar
Coordenadas de los eventos¿Se admiten los valores de carril y de pulso?Señalar el evento no válido
Identidad de los eventos¿Son los ID únicos y estables?Ofrecer una corrección segura o impedir el guardado
Límites del archivo¿Respeta el contenido los límites del proyecto?Rechazar el archivo de forma previsible antes de cargarlo

Planifica el menor cambio posible en el proyecto

Antes de aceptar un parche, compáralo con la lista de cambios previstos por archivo. Una primera versión de alcance limitado puede afectar a una escena del editor, un controlador del editor, un adaptador para los datos de los mapas de notas, un servicio local de borradores y unas pocas pruebas. No debe reescribir todas las canciones sin avisar, cambiar los márgenes de acierto, modificar el controlador de audio ni incorporar los borradores al sistema oficial de progreso.

Pide a la IA que muestre el diff completo, indique qué da por supuesto sobre la compatibilidad y describa cómo retirar la función. Trabaja en una rama o en una copia del proyecto. Conserva intactos un mapa de notas conocido y una grabación de referencia. Si hace falta una nueva versión de los datos, prepara un plan de migración y pruébalo con copias de los mapas de notas antes de modificar los datos de los jugadores. Si el resultado altera la reproducción, vuelve al estado de referencia y aísla la causa.

Comprueba la sincronización y busca regresiones en una copia del proyecto

No te limites a comprobar que se abre la pantalla del editor. Compara el mismo mapa de notas conocido antes y después del cambio. Comprueba una nota cerca del inicio, un tramo intermedio, un punto en el que cambie el tempo y el final. Confirma que el cursor de reproducción del editor, el sonido de la vista previa, la animación de las notas, el registro de aciertos y la puntuación usan la misma referencia temporal. Que la cuadrícula parezca bien alineada no demuestra que la latencia del audio o la sincronización durante la partida sean correctas.

Una vista previa local ficticia de un mapa de notas muestra una escena de un juego de ritmo junto a una lista para comprobar la alineación con el pulso, la versión del archivo y el intervalo de los eventos.
El panel de validación es conceptual; no se han probado la sincronización de la aplicación ni el analizador de archivos.
Comprobación propuestaAcciónQué registrar
Mapa de notas de referenciaEjecutar un mapa conocido con la compilación anteriorCompilación, pista y marcas de tiempo esperadas
Ciclo de edición y guardadoColocar eventos, guardar el borrador, volver a abrirlo y previsualizarloEventos serializados y cualquier diferencia
Cambio de tempoColocar eventos antes y después de un cambio de tempoPulso, posición del audio y posición del cursor de reproducción
Archivo mal formadoProbar con campos ausentes, no válidos y no admitidosError claro sin que se cierre la aplicación
RegresiónVolver a reproducir el mapa de referencia sin modificarloSincronización, puntuación, controles y progreso
ReversiónEliminar la rama de la función o restaurar una copiaEl mapa original sigue siendo jugable

Esta tabla es una propuesta. No demuestra que se haya mantenido la precisión de la sincronización. Cuando hagas pruebas reales, registra la versión del proyecto, el dispositivo de audio, el mapa de notas, los desfases, la acción exacta, el comportamiento esperado, el observado y cualquier regresión. Una maqueta generada de la interfaz no permite afirmar que exista un editor o un panel de validación.

Trata la publicación y la puesta en común con la comunidad como funciones aparte

Si el objetivo a largo plazo incluye compartir mapas de notas, define primero cómo se gestionarán la moderación, las denuncias, la eliminación de contenido, la titularidad, las licencias de las canciones, los límites de almacenamiento y la compatibilidad entre versiones del juego. Un editor local no proporciona por sí solo una biblioteca en línea segura. No afirmes que los mapas creados por los usuarios se pueden publicar o descargar hasta que esos servicios y políticas se hayan implantado y probado.

Si quieres explorar una idea para otro juego de ritmo, prueba SEELE AI Game Maker. Es una herramienta para explorar conceptos, no un editor de proyectos existentes.

Preguntas frecuentes

¿Qué debe permitir hacer a los jugadores un editor de niveles para un juego de ritmo?

Empieza por las acciones necesarias para crear y previsualizar un mapa de notas: elegir una pista, colocar eventos en una cuadrícula de pulsos, editarlos o deshacer los cambios, guardar un borrador y validarlo. Mantén la publicación, las opciones para compartir y la moderación como funciones aparte hasta que la creación local funcione de forma fiable.

¿Conviene guardar los eventos de un mapa de notas en segundos o en pulsos?

Si el juego ya tiene un mapa de tempo, da prioridad a una coordenada musical estable que indique el compás, el pulso y la subdivisión. Usa el sistema de sincronización existente para convertirla a tiempo de reproducción. Conserva el reloj de audio actual y las reglas de desfase. Después, prueba los cambios de tempo y las notas cercanas a los límites entre secciones.

¿Cómo puedo añadir un editor sin alterar la sincronización de la reproducción?

Toma como referencia el cargador de mapas de notas, el reloj de audio, la puntuación, los controles y los carriles de notas actuales. Haz que el editor cree datos en el formato que ya usa el motor o mediante un adaptador con control de versiones. Compara un mapa conocido antes y después del cambio y reviértelo si se desplazan sus eventos en el tiempo.

¿Cómo se deben validar los mapas de notas creados por los jugadores?

Antes de abrir la vista previa, comprueba la versión del archivo, los campos obligatorios, la referencia a la pista, los tipos de evento, los intervalos de pulsos, los ID duplicados y los valores no admitidos. Informa en el editor de los problemas que se puedan corregir y rechaza de forma segura el contenido mal formado. Una lista de comprobación del esquema no demuestra que un analizador real pueda manejar cualquier archivo malicioso.

¿Puede la IA crear un editor de niveles dentro de mi juego de ritmo existente?

La IA puede ayudar a revisar los archivos facilitados, proponer un parche de alcance limitado y redactar casos de validación. No puede verificar la sincronización ni la compatibilidad sin el proyecto real y las pruebas. Dale una lista de archivos que pueda modificar, un mapa de notas de referencia que deba quedar intacto, el comportamiento esperado de los pulsos y un commit al que volver. Revisa el diff completo.

Añade funciones de creación sin reescribir la reproducción

Deja que el motor de ritmo actual siga controlando la sincronización. Añade un editor local de alcance limitado que guarde los eventos musicales en un formato con versión, los valide antes de abrir la vista previa y mantenga los borradores separados de los mapas publicados y las puntuaciones oficiales. Revisa el diff, prueba mapas conocidos en una copia del proyecto y conserva un punto al que volver. Considera que ningún resultado está verificado hasta que se pruebe el juego real.

Fuentes

SEELE AI

Convierte esta guía en un proyecto jugable.

Empieza con una idea concreta y desarróllala en el espacio de trabajo de Seele AI.

Empezar a crear