Developing your game with Backstitch.Desarrolla tu juego con Backstitch.

Good news, this part is not new! You save your project normally in Godot with Ctrl+S or Scene → Save Scene. Backstitch will automatically save your work as well. Always look for the green checkmark in Backstitch that indicates it has saved your work online, too.Buenas noticias, ¡esta parte no es nueva! Guardas tu proyecto normalmente en Godot con Ctrl+S o Scene → Save Scene. Backstitch también guardará tu trabajo automáticamente. Busca siempre la marca verde en Backstitch que indica que también guardó tu trabajo en línea.

Backstitch automatically keeps a permanent history of those saves, so you can look back at your changes over time. Each save appears in the History with a timestamp. Godot will not do this for you, so this is the first really nice feature!Backstitch mantiene automáticamente un historial permanente de esos guardados, para que puedas repasar tus cambios a lo largo del tiempo. Cada guardado aparece en el Historial con su hora. Godot no hace esto por ti, ¡así que esta es la primera función realmente útil!

Backstitch keeps a History of your saved changes, with the newest at the top.Backstitch mantiene un Historial de tus cambios guardados, con lo más nuevo arriba.

Click any save point in the History to see what changes were recorded. A list below the History, at the bottom right of the screen, shows what specific changes were made in that save.Haz clic en cualquier punto de guardado del Historial para ver qué cambios se registraron. Una lista debajo del Historial, abajo a la derecha de la pantalla, muestra qué cambios específicos se hicieron en ese guardado.

Backstitch also gives you a way to return to an earlier version of your work.Backstitch también te da una forma de volver a una versión anterior de tu trabajo.

If you make a change you no longer want, find the earlier save you want to return to, click the three dots (…), and choose Reset to here.Si haces un cambio que ya no quieres, busca el guardado anterior al que quieres volver, haz clic en los tres puntos (…) y elige Reset to here.

Resetting does not delete any of your save points. It brings the version you selected back as a new save at the top of your History.Restablecer no borra ninguno de tus puntos de guardado. Trae la versión que elegiste de vuelta como un guardado nuevo en la parte de arriba de tu Historial.

That means you can try a reset without losing the versions that came after it. If you realize you chose the wrong save point, all of the other saves are still in the list — just find the version you actually wanted and use Reset to here again.Eso significa que puedes probar un reset sin perder las versiones que vinieron después. Si te das cuenta de que elegiste el punto equivocado, todos los demás guardados siguen en la lista — solo busca la versión que de verdad querías y usa Reset to here otra vez.

Every project starts with a branch called main. Think of main as the starting version of the project. While you're learning Backstitch, it's useful to leave main unchanged so you always have a clean version of the StoryQuest Kit to start from in case things get messy as you work. And they will very likely get messy!Cada proyecto empieza con una rama llamada main. Piensa en main como la versión inicial del proyecto. Mientras aprendes Backstitch, es útil dejar main sin cambios para tener siempre una versión limpia del StoryQuest Kit desde la cual empezar por si las cosas se complican mientras trabajas. ¡Y muy probablemente se complicarán!

Instead of working on main, when you want to build or experiment, you can create a branch. A branch gives you a separate version of the whole project where you can make changes without changing main or any of your other branches. If you make every change on a single branch then you may end up with changes you want and some you do not, with no easy way to separate the work — the "reset" option does not let you pick and choose which things to keep and which to throw away from any one save point; it isn't that specific. This is where branches can help.En lugar de trabajar en main, cuando quieras construir o experimentar, puedes crear una rama. Una rama te da una versión aparte de todo el proyecto donde puedes hacer cambios sin cambiar main ni ninguna de tus otras ramas. Si haces todos los cambios en una sola rama, puedes terminar con cambios que quieres y otros que no, sin una forma fácil de separar el trabajo — la opción de "reset" no te deja elegir qué conservar y qué descartar de un punto de guardado; no es tan específica. Aquí es donde las ramas ayudan.

You might create a branch for a prototype, a new playable area, a gameplay mechanic, or even your entire StoryQuest.Podrías crear una rama para un prototipo, una nueva zona jugable, una mecánica de juego, o incluso todo tu StoryQuest.

Steps 1–3Pasos 1–3

Solo tip: If you're working alone, you can simply create a branch for the work you want to do and keep saving there. You only need to merge branches when you actually want to combine work from separate branches.Consejo en solitario: Si trabajas solo, puedes simplemente crear una rama para el trabajo que quieras hacer y seguir guardando ahí. Solo necesitas fusionar ramas cuando de verdad quieras combinar el trabajo de ramas separadas.

Branches let you separate your work while you're developing. When you want the changes from one branch to become part of the parent branch, you can merge them back into whatever branch you originally split from in order to do your work.Las ramas te permiten separar tu trabajo mientras desarrollas. Cuando quieras que los cambios de una rama pasen a formar parte de la rama madre, puedes fusionarlos de vuelta en la rama de la que originalmente te separaste para hacer tu trabajo.

Select the branch containing the work you want to merge and choose the Merge button. And don't worry, Backstitch shows you where the changes will go and gives you a preview before anything is changed.Selecciona la rama que contiene el trabajo que quieres fusionar y elige el botón Merge. Y no te preocupes, Backstitch te muestra a dónde irán los cambios y te da una vista previa antes de que algo cambie.

Steps 4–5Pasos 4–5

When several people are building the same project, branches give each person a separate place to work. Your team can start from a shared branch, create smaller branches for different parts of the StoryQuest, and merge that work back together when it's ready.Cuando varias personas construyen el mismo proyecto, las ramas le dan a cada una un lugar separado para trabajar. Tu equipo puede empezar desde una rama compartida, crear ramas más pequeñas para diferentes partes del StoryQuest, y volver a unir ese trabajo cuando esté listo.

Branches help keep your work separate, but your team still needs to coordinate what each person is working on. If two people change the same part of the game at the same time, their changes can still conflict when those branches are brought back together.Las ramas ayudan a mantener tu trabajo separado, pero tu equipo aún necesita coordinar en qué trabaja cada persona. Si dos personas cambian la misma parte del juego al mismo tiempo, sus cambios todavía pueden entrar en conflicto cuando esas ramas se vuelven a unir.

For example, putting one teammate on a tilemap branch and another on an environment branch may sound separate, but if both people are painting the same TileMap in the same scene, they may still be changing the same files of the project. When those branches are merged, one person's changes may replace some of the other's.Por ejemplo, poner a un compañero en una rama tilemap y a otro en una rama environment puede sonar separado, pero si ambos están pintando el mismo TileMap en la misma escena, puede que aún estén cambiando los mismos archivos del proyecto. Cuando esas ramas se fusionan, los cambios de una persona pueden reemplazar algunos de los de la otra.

A better plan is to divide the work so teammates are working on different parts of the StoryQuest whenever possible. One person might work on character art while another builds a playable area, or teammates might work in different scenes entirely.Un mejor plan es dividir el trabajo para que los compañeros trabajen en diferentes partes del StoryQuest siempre que sea posible. Una persona puede trabajar en el arte de personajes mientras otra construye una zona jugable, o los compañeros pueden trabajar en escenas completamente diferentes.

The important part is to use branches along with a communicated plan for dividing the work. Separate branches help, but they work best when teammates are also changing separate parts of the project. A final suggestion is to keep your work small and focused on a branch. Try not to work for days and days on multiple files and parts of your StoryQuest all on one branch if you can avoid it.Lo importante es usar las ramas junto con un plan comunicado para dividir el trabajo. Las ramas separadas ayudan, pero funcionan mejor cuando los compañeros también cambian partes separadas del proyecto. Una última sugerencia es mantener tu trabajo pequeño y enfocado en una rama. Intenta no trabajar días y días en múltiples archivos y partes de tu StoryQuest todo en una sola rama si puedes evitarlo.

Backstitch gives you a few ways to catch problems when work comes back together:Backstitch te da algunas formas de detectar problemas cuando el trabajo se vuelve a unir:

• Check the merge preview. Before you confirm a merge, look at which changes will be brought into the other branch.Revisa la vista previa de la fusión. Antes de confirmar una fusión, mira qué cambios se llevarán a la otra rama.
• Watch for a warning that the branch you're merging into has changed. This doesn't mean anyone did something wrong. It means someone else has added work since your branch was created, so take an extra look at the merge preview.Fíjate si aparece un aviso de que la rama a la que fusionas ha cambiado. Esto no significa que alguien haya hecho algo mal. Significa que otra persona ha añadido trabajo desde que se creó tu rama, así que mira de nuevo la vista previa.
• Use History if something goes wrong. Because your earlier saves are still there, you can reset to a version from before the merge if you need to.Usa el Historial si algo sale mal. Como tus guardados anteriores siguen ahí, puedes restablecer a una versión de antes de la fusión si lo necesitas.
• Make a fresh branch when needed. If some of your work conflicts with newer work on the shared branch, it may be easier to create a new branch from the updated version and redo only the changes you still need.Crea una rama nueva cuando haga falta. Si parte de tu trabajo entra en conflicto con trabajo más nuevo en la rama compartida, puede ser más fácil crear una rama nueva desde la versión actualizada y rehacer solo los cambios que aún necesitas.