Editarla ciudad

Abrir la escena

1. Abra la carpeta nuevacondor/ con Godot 4.7.1, la misma versión de siempre.
2. Abra main.tscn con doble clic en el panel FileSystem, o con el botón Abrir la escena principal del panel Nueva Cóndor.
3. Espere un segundo mientras la Ciudad carga las casas guardadas. En la consola (Output) aparece [Ciudad] listo: 170 fuentes (170 de lo guardado).

El árbol de la escena

Todo el nivel vive en main.tscn, y lo que importa para esta guía está dentro de Mundo.

Las casas no aparecen en el árbol, porque cuelgan de un nodo oculto que no se guarda en la escena. Siempre se cambian por medio de su curva, su estilo o su kit.

Cómo se guardan las casas

Godot arma cada casa con las piezas del kit. Cuando usted cambia algo, la Ciudad vuelve a armar solo lo que se afectó, o sea la fila que tocó o las filas que están encima de la parte del terreno que movió. Cada fila tarda menos de un segundo.

Al guardar la escena con Ctrl+S también se guardan las casas, en la carpeta world/city/casas/ (un archivo por curva). El juego las carga de ahí al empezar, así que no tiene que armar nada mientras se juega.

Tres reglas

• Se cambian las curvas, no las casas. Una casa no se mueve ni se borra a mano, lo que se mueve o se borra es su curva.
• Todo se puede deshacer. Ctrl+Z deshace en el editor, y lo que está en git se puede recuperar. Si va a probar algo grande, mejor hágalo en una rama.
• Revise antes de guardar algo grande. El botón Revisar el mapa del panel Nueva Cóndor avisa si algo quedó mal, por ejemplo un enemigo dentro de una casa, una casa sin material o un desnivel sin escalera.

Una fila de casas

Una RoofLine es una curva que marca el centro de una fila de casas. La Ciudad la divide en casas de largo al azar (entre los dos números de House Length), le da a cada una su color, sus ventanas y su techo, y las apoya en el terreno.

Estos son los ajustes que se cambian en el Inspector de una fila.

Crear una fila nueva

1. Elija la carpeta. En el árbol, haga clic derecho sobre la carpeta del barrio y del sector (por ejemplo Borde › 0 Cerro) y elija Add Child Node. Busque RoofLine y créela. También puede seleccionar una fila parecida y duplicarla con Ctrl+D, que es más rápido.
2. Dibuje la curva. Con la fila seleccionada aparecen las herramientas de curva en la barra de arriba de la vista 3D. Elija Add Point y haga clic en el suelo donde empieza la fila, y después donde sigue. Con tres o cuatro puntos es suficiente, la curva se suaviza sola.
3. Ponga los ajustes. Style, Width y Floors (2 o 3 pisos para casas comunes).
4. Suelte y espere un segundo. Las casas aparecen solas. Después guarde con Ctrl+S.

Alargar o acortar una fila (o un techo)

Una fila mide lo mismo que su curva, así que para alargarla hay que alargar la curva.

• Mover la punta. Con Select Points, arrastre el último cuadro (el naranja) o el primero (el verde) más lejos.
• Agregar un punto. Con Add Point, haga clic más allá de la punta y la fila sigue hasta ahí.
• Acortar. Arrastre la punta hacia adentro, o borre un punto con Delete Point.

Un techo flotante o una rampa se alargan igual, porque también son filas.

Más pisos (o menos)

Cambie Floors en el Inspector. Cada casa sube o baja esa cantidad de pisos desde su suelo, y el estilo decide la altura de cada piso (3.6 m en las casas limpias y 3.2 m en las gastadas). En el estilo limpio algunas casas salen con un piso de más, para que la fila no se vea toda igual.

Con Floors en 0, la altura sale de la curva. Si sube o baja los puntos, el techo los sigue, y cada casa toma la altura promedio de su tramo. Esto sirve para techos flotantes o para filas que tienen que quedar a una altura exacta.

Un edificio suelto (villa, torre o casona)

Una RoofFootprint es una planta cerrada. Sus puntos, en orden, son el borde del edificio, y se cierra sola. Puede ser un rectángulo, una L (6 puntos) o una U (8 puntos), y las L y las U se techan por partes.

1. Haga clic derecho en la carpeta, elija Add Child Node y cree una RoofFootprint. También puede duplicar una villa.
2. Con Add Point, marque las esquinas en orden, dando la vuelta al edificio. Para que los ángulos queden rectos, ayuda verlo desde arriba con la tecla 7 del teclado numérico.
3. Ponga los ajustes. Floors son los pisos (o Wall Height, la altura de pared, si Floors es 0). Roof es el techo (Gable, Hip o Flat). Facades apagado deja las paredes sin ventanas ni puertas. Door Edge dice en qué lado va la puerta, con el número del punto donde empieza ese lado, y con −1 la puerta va en el lado más largo.

Techos

• Techos inclinados (Gable, Hip y Shed), con la inclinación que diga Pitch.
• Azoteas (Flat, o House Flat Chance en una fila), que se pueden caminar. Llevan un muro bajo alrededor (Parapet, de 0.2 a 1.5 m) y adornos del estilo, como tanques de agua, antenas y casetas.
• Techos flotantes, que son una fila con Buildings apagado y Floors en 0. La curva marca la altura. Son losas gruesas para subir con las cadenas de enemigos.
• El desgaste (láminas de zinc, tejas rotas y techos hundidos) sale del estilo y no de la fila. Vea Tipos de casa.

Rampa curva de azotea

Para unir la calle con un techo, o dos techos de diferente altura, con una losa que se camina y sigue una curva, use una fila con Roof en Ramp. No lleva casas, es una sola losa que sube y baja con la curva.

1. Cree una RoofLine (o duplique una) y cambie Roof a Ramp.
2. En Width ponga el ancho de la rampa. Entre 3 y 4 m se camina cómodo.
3. Marque los puntos por donde pasa. La altura de cada punto es la altura de la rampa en ese lugar, así que el primero va a nivel de la calle y el último a la altura del techo al que llega. Para subirlos o bajarlos, use las flechas de mover.
4. Para entrar a una azotea, termine la rampa a la altura del muro de la azotea y un par de metros hacia adentro, encima de la losa.

Casas sobre el terreno

Si Floors es mayor que 0, cada casa se apoya sola en el terreno, sin que usted tenga que hacer nada.

• La planta baja queda a la altura del punto más alto del suelo debajo de la casa, para que ningún piso quede enterrado.
• Las paredes bajan hasta el punto más bajo. Donde el suelo baja, la franja de abajo de la pared se estira hasta tocarlo, así ninguna casa queda flotando.
• Si la calle de enfrente está un piso o más abajo, ese lado de la casa crece hacia abajo con pisos completos (con ventanas) hasta llegar a la calle, y la puerta queda abajo, al nivel de la calle.
• Si mueve el terreno, las casas lo siguen. Cuando sube una parte del terreno, las casas de encima se vuelven a armar a la nueva altura (vea Terreno).

Si Floors es 0, la altura es la de la curva. Si mueve el terreno debajo de una fila así, apriete Ajustar al terreno para poner la curva otra vez a la altura correcta.

Escalones bajo la puerta

Algunas casas tienen escalones debajo de la puerta y otras no. Es automático y depende solo del suelo que está frente a cada puerta.

1. Cada lado de la casa que da a la calle lleva una puerta, en el espacio más cercano al centro donde el suelo está al nivel de la planta baja (con 30 cm de margen). Si la casa está en suelo plano, la puerta queda a nivel y sin escalones. Es lo más común, 422 de las 526 puertas del mapa.
2. Si la calle está un piso o más abajo, ese lado de la casa crece pisos hacia abajo hasta la calle (lo que se explica arriba) y la puerta va en el piso de abajo.
3. Lo que falta, que es menos de un piso, se cubre con escalones. Se usa la pieza escalon del kit, estirada a la altura exacta. Pasa en casas que quedan sobre un desnivel del terreno o en una pendiente.
4. Nunca hay más de 3 m de escalones. Si una puerta necesitara más, ese lado de la casa se queda sin puerta.

Esto es lo que se puede cambiar.

Colores a mano

Cada casa toma colores al azar de la lista de su estilo, sin repetir el color de la casa de al lado. Para ponerlos a mano, use el grupo Colores de la fila o del edificio. Wall Color es el color de la pared, Trim Color el de los marcos y las cornisas, y Zocalo Color el de la franja de abajo. Si la transparencia (alfa) está en 0, se vuelve a usar la lista del estilo.

Cómo está hecho

El Terreno se parece a un gráfico de pastel. Tiene anillos alrededor del centro, divididos en tajadas, y cada pedazo (un anillo por una tajada) es una celda plana. Las alturas van de 1.5 m en 1.5 m. Donde una celda queda más alta que la de al lado, se forma una pared.

• Los anillos CALLE son por donde se corre. Cada cambio de altura en una calle necesita una escalera o una rampa.
• Los anillos MANZANA son donde van las filas de casas. Las casas tapan sus paredes.
• Los huecos son celdas a −10 m o más abajo, como la quebrada. Su borde es un barranco a propósito.
• El centro (los primeros 74 m) no se pisa, porque lo tapan las torres.

Subir o bajar una celda

1. Seleccione Mundo › Terreno.
2. Arrastre el punto de la celda hacia arriba o hacia abajo. Se mueve de 1.5 m en 1.5 m y el suelo se actualiza mientras lo arrastra.
3. Cuando lo suelta, las casas de encima se vuelven a armar a la nueva altura, y las escaleras de alrededor se acomodan solas.
4. Ctrl+Z lo deshace. Para guardar, use Ctrl+S.

Las líneas de colores

Crear una escalera

Las escaleras van dentro de Terreno › Escaleras y se acomodan solas. Toman las alturas de las dos celdas que unen, calculan cuántos escalones necesitan, y si se ponen al revés, se dan vuelta.

1. La forma rápida es seleccionar el Terreno y apretar Poner escaleras donde faltan. Eso pone una escalera en el medio de cada borde rojo de calle.
2. Para ponerla a mano, seleccione una escalera de Terreno › Escaleras y duplíquela con Ctrl+D. También puede hacer clic derecho en Escaleras, elegir Add Child Node y crear una TerrainStairs.
3. Arrástrela cerca del borde entre las dos alturas. Si Snap está encendido, se pega sola al desnivel más cercano y se gira para bajar.
4. Ajuste el ancho en Width. Si la línea se pone roja, está chocando con otra escalera y hay que moverla.

Una rampa

Una rampa es una escalera con Kind en Ramp. Es lisa y más larga para el mismo desnivel (con Ramp Slope en 0.2, necesita 15 m para subir 3 m). Para cambiar una escalera a rampa, selecciónela y cambie Kind, y se acomoda sola.

Esta rampa es parte del terreno y es recta. Para una rampa curva que suba a un techo, use una fila con Roof en Ramp.

Anillos y tajadas

Estos son los números del Terreno en su Inspector.

Si cambia los anillos o las tajadas, apriete Rehacer el terreno. El mapa completo se diseña visto desde arriba en design/ y se pasa a la escena con tools/make_map.gd (la guía del proyecto lo explica). Hacer eso reemplaza los cambios hechos a mano en el Terreno y la Ciudad.

Qué es un estilo

Hay dos estilos, world/houses/estilos/limpio.tres para el barrio rico y gastado.tres para el barrio pobre. Con doble clic en el panel FileSystem se abren en el Inspector, y lo que cambie ahí cambia todas las casas de ese estilo.

Qué decide cada campo

Crear un tipo de casa nuevo

Por ejemplo, casas de pescadores, bajas, de colores fuertes y con azoteas.

1. En FileSystem, haga clic derecho en limpio.tres (o en gastado.tres), elija Duplicate y póngale de nombre pescadores.tres.
2. Ábralo y cambie lo que lo hace diferente. Por ejemplo, en Colores Muro ponga azules y verdes fuertes, en Techos ponga flat: 3, gable: 1, Storey en 3.0 y Mugre en 0.3.
3. En cada fila o edificio que quiera de ese tipo, arrastre pescadores.tres desde FileSystem hasta el campo Custom Style del Inspector.
4. Esas casas se vuelven a armar solas con el estilo nuevo. Después guarde la escena.

Si el tipo nuevo necesita piezas que el kit colonial no tiene (otra ventana u otro techo), hay que hacerlas en el kit (vea la parte siguiente), o hacer un kit propio y poner su ruta en Kit Path.

Qué es un kit

Cómo se arma una fachada

Cada fachada es una cuadrícula. Las esquinas mantienen su tamaño, las piezas del medio se repiten y se estiran un poco hasta llenar el largo, y las franjas corren a lo ancho. El estilo elige el tipo de cada pieza (ventana, balcón o pared sin ventana), y el kit pone la variante (A, B o C) al azar, según cuánto deba salir cada una.

ciega es una pared sin ventana.

Cómo debe estar una pieza

• El nombre tiene la forma zona-tipo-variante, con guiones, como piso-ventana-C, esquina-der-A o prop-tinaco-A.
• La orientación. X va a lo largo de la fachada, −Y apunta hacia la calle (el frente) y Z hacia arriba. El origen va abajo a la izquierda, sobre la pared (en y = 0).
• Cada pieza trae su pedazo de pared alrededor de la ventana o la puerta, y ocupa todo el rectángulo de su ancho por su alto.
• Solo hace falta la cara de afuera. Revísela con Overlays › Face Orientation, el frente se tiene que ver azul.
• No use espejo con escala −1, y aplique la escala con Ctrl+A › Scale.
• La posición del objeto en la escena no importa, solo sirve para ordenar las piezas a la vista.

Cada pieza lleva estas propiedades en Object › Custom Properties.

Puntos especiales. Son empties dentro de la pieza que marcan dónde va a pasar algo en el juego, con los nombres slot-puerta, slot-tienda, slot-balcon y slot-azotea. Se ponen en el piso, frente a la puerta, mirando hacia la calle. Más adelante la gente y las tiendas del juego van a salir de ahí.

Materiales

Cada material se llama como su función, y el juego lo pinta con los colores de cada casa. Los nombres son Muro (déjelo gris claro), Marco, Zocalo, Teja, Vidrio, Madera, Hierro y Chapa. Si un material es otra cosa (un toldo o un ladrillo), márquelo como decorativo con Custom Properties › decorativo = 1, y se queda con su color original.

Exportar

1. En Blender, abra el editor de texto (pestaña Scripting), elija export_kit.py y use Run Script (Alt+P).
2. El script escribe colonial.glb y colonial.json junto al .blend. Si hay errores no escribe nada, y los muestra en la consola (Window › Toggle System Console).
3. Vuelva a Godot. El kit se carga de nuevo y las casas se vuelven a armar solas. Después guarde la escena.

Una variante nueva

1. Duplique una pieza parecida con Shift+D y póngala al lado para verla.
2. Cámbiele el nombre a la letra siguiente, por ejemplo piso-ventana-E, y quítele el .001 que pone Blender.
3. Edítela, cuidando que la pared siga ocupando todo el rectángulo.
4. Ajuste peso, pisos y estilos, y exporte. La variante sale sola, al azar entre las demás del mismo tipo.

Un tipo nuevo (por ejemplo piso-mirador-A) también se carga, pero no aparece hasta que un estilo lo pida. Para eso, en el estilo agregue mirador: 1 en Pisos.

Un kit nuevo

Copie art/kits/plantilla.blend a art/kits/<nombre>.blend. Es un kit pequeño (puerta, ventana, pared sin ventana, esquina, franja de abajo y remate de techo) con todas las propiedades puestas y un texto LEEME con las reglas. Modele, exporte y ponga la ruta de su .glb en el Kit Path de un estilo (vea Crear un tipo nuevo). Cada estilo necesita por lo menos una planta_baja-puerta y una piso-ventana.

Si el exportador da un error

Todas las reglas, con ejemplos, están en nuevacondor/docs/kits.md.

De curva a casa

La Ciudad divide cada curva en casas, decide los pisos, las puertas y los techos con las reglas del estilo, y arma cada casa con las piezas del kit, varias a la vez. Cada casa trae su colisión, que funciona por los dos lados para que el jugador no la atraviese ni a 30 m/s, y marca dónde están sus puertas, tiendas y balcones. La ciudad completa, de unas 300 casas, se arma en unos 5 segundos.

Sin abrir el editor

Para volver a armar y guardar toda la ciudad desde una terminal, abra la carpeta nuevacondor/ y corra este comando.

gd script res://tools/build_city.gd

Al terminar muestra cuántas casas, triángulos y segundos tomó. Si usa git, agregue también los cambios de world/city/casas/.

Si algo se ve raro