Editarla ciudad

Abrir la escena

1. Abrí la carpeta nuevacondor/ con Godot 4.7.1 (el mismo de siempre; no hace falta otra versión).
2. Abrí main.tscn con doble clic en el panel FileSystem, o con el botón Abrir la escena principal del panel Nueva Cóndor.
3. Esperá un segundo: 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. Lo que importa para esta guía está bajo Mundo:

Las casas en sí no aparecen en el árbol: cuelgan de un nodo oculto de la Ciudad que no se guarda en la escena. Se cambian siempre a través de su curva, su estilo o su kit.

Cómo se guardan las casas

Godot arma cada casa con piezas del kit. Cuando cambiás algo, la Ciudad rearma solo lo afectado: la fila que tocaste, o las filas que están encima de la celda de terreno que moviste. Tarda menos de un segundo por fila.

Al guardar la escena (Ctrl+S) las casas rearmadas se guardan también, en world/city/casas/ (un archivo por curva). El juego las carga de ahí al empezar, así que no se arma nada mientras jugás.

Tres reglas

• Se cambian las curvas, no las casas. Una casa no se mueve ni se borra a mano: se mueve o se borra su curva.
• Todo se deshace. Ctrl+Z deshace en el editor, y lo que está en git se puede recuperar. Para probar algo grande, hacé una rama.
• Antes de guardar algo grande, revisá. El botón Revisar el mapa del panel Nueva Cóndor avisa en castellano si algo quedó roto (un enemigo dentro de una casa, una casa sin material, un escalón sin escalera).

Una fila de casas

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

Lo que se cambia en el Inspector de una fila:

Crear una fila nueva

1. Elegí la carpeta. En el árbol, clic derecho sobre la carpeta del barrio y sector (por ejemplo Borde › 0 Cerro) › Add Child Node. Buscá RoofLine y creala. (Más rápido: seleccioná una fila parecida y Ctrl+D para duplicarla.)
2. Dibujá la curva. Con la fila seleccionada aparecen las herramientas de curva en la barra de arriba de la vista 3D. Elegí Add Point y hacé clic en el suelo donde empieza la fila, y después donde sigue. Tres o cuatro puntos alcanzan; la curva se suaviza sola.
3. Poné los ajustes. Style, Width, Floors (2 o 3 para casas comunes).
4. Soltá y esperá un segundo. Las casas aparecen solas. Guardá con Ctrl+S.

Alargar o acortar una fila (o un techo)

Una fila mide lo que mide su curva. Para alargarla:

• Mover la punta. Con Select Points, arrastrá el último cuadradito (naranja) o el primero (verde) más lejos.
• Agregar un punto. Con Add Point, clic más allá de la punta: la fila sigue hasta ahí.
• Acortar. Arrastrá la punta hacia adentro, o borrá un punto con Delete Point.

Es lo mismo para un techo flotante o una rampa: un techo es una fila con Buildings apagado, y se alarga igual.

Más pisos (o menos)

Cambiá Floors en el Inspector. Cada casa sube o baja esos pisos desde su suelo; el estilo decide el alto de cada piso (3.6 m las limpias, 3.2 m las gastadas). En el estilo limpio, algunas casas salen con un piso de más para que la silueta no sea pareja.

Con Floors en 0 la altura sale de la curva: subí o bajá los puntos y el techo sigue (cada casa toma la altura media de su tramo). Sirve para techos flotantes o filas que tienen que coincidir con algo exacto.

Un edificio suelto (villa, torre, casona)

Una RoofFootprint es una planta cerrada: los puntos, en orden, son el contorno del edificio, y se cierra solo. Puede ser un rectángulo, una L (6 puntos) o una U (8 puntos); las L y U se techan por alas.

1. Clic derecho en la carpeta › Add Child Node › RoofFootprint (o duplicá una villa).
2. Con Add Point, marcá las esquinas en orden, dando la vuelta. Para ángulos rectos, ayuda mirar desde arriba (7 del teclado numérico).
3. Ajustes: Floors (o Wall Height si Floors es 0), Roof (Gable, Hip o Flat), Style, Facades (apagado = muros ciegos) y Door Edge: en qué lado va la puerta (el número del punto donde empieza ese lado; −1 = el lado más largo).

Techos

• Inclinados (Gable, Hip, Shed), con la pendiente de Pitch.
• Azoteas (Flat, o House Flat Chance en una fila): se caminan. Llevan pretil (Parapet, 0.2 a 1.5 m) y adornos del estilo: tinacos, antenas, casetas.
• Techos flotantes: una fila con Buildings apagado y Floors en 0. La curva marca la altura. Son losas gruesas, para subir con cadenas de enemigos.
• Desgaste: chapas, tejas rotas y cumbreras hundidas salen del estilo (ver Tipos de casa), no de la fila.

Rampa curva de azotea

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

1. Creá una RoofLine (o duplicá una) y poné Roof › Ramp.
2. Width: el ancho de la rampa (3 a 4 m se camina cómodo).
3. Marcá los puntos por donde pasa. La altura de cada punto es la altura de la rampa ahí: el primero a nivel de la calle, el último a la altura del techo al que llega. Movelos con el gizmo para subirlos o bajarlos.
4. Para entrar a una azotea, terminá la rampa a la altura del pretil y un par de metros adentro, sobre la losa.

Que la casa abrace el terreno

Con Floors mayor que 0, cada casa se apoya sola en el terreno, sin que hagas nada:

• La planta baja va a la altura del punto más alto del suelo bajo la casa: ningún piso queda enterrado.
• Los muros bajan hasta el punto más bajo. Donde el suelo baja a lo largo de la casa, el zócalo (la franja de abajo) se estira hasta tocarlo: nunca queda una casa flotando.
• Si la calle de enfrente queda un piso o más abajo, la fachada crece hacia abajo con pisos de verdad (ventanas, impostas) hasta esa calle, y la puerta va abajo, a nivel de la calle.
• Si movés el terreno, las casas lo siguen: subí una celda y las casas de encima se rearman a la nueva altura (ver Terreno).

Con Floors en 0, la altura es la de la curva: si movés el terreno abajo de una fila así, apretá Ajustar al terreno para volver a poner la curva a la altura justa.

Escalones bajo la puerta

Algunas casas tienen unos escalones bajo la puerta y otras no. Es automático y depende solo del suelo frente a cada puerta:

1. Cada fachada a la calle lleva una puerta, en la bahía más cerca del medio donde el suelo está a nivel de la planta baja (con 30 cm de margen). Casa en suelo plano: puerta a nivel, sin escalones. Es lo más común: 422 de las 526 puertas del mapa.
2. Si la calle queda un piso o más abajo, la fachada crece pisos hacia abajo hasta ella (el punto anterior) y la puerta va en el piso de abajo.
3. Lo que sobra, menos de un piso, lo cubren escalones: la pieza escalon del kit, estirada al alto justo. Pasa en casas que quedan sobre un escalón del terreno, o en pendiente.
4. Nunca hay más de 3 m de escalones. Si una puerta necesitaría más, esa fachada va sin puerta.

Lo que se puede cambiar:

Colores a mano

Cada casa toma colores al azar de la paleta de su estilo, sin repetir el de la vecina. Para forzarlos, en el grupo Colores de la fila o el edificio: Wall Color (revoque), Trim Color (marcos y cornisas), Zocalo Color. Con alfa en 0 vuelve a la paleta.

Cómo está hecho

El Terreno es como un gráfico de torta: anillos alrededor del centro, cortados en tajadas. Cada pedazo (anillo × tajada) es una celda plana, a una altura en escalones de 1.5 m. Donde una celda queda más alta que la vecina, baja un muro de contención.

• Anillos CALLE: por donde se corre. Los cambios de altura tienen que tener escalera o rampa.
• Anillos MANZANA: donde van las filas de casas. Sus muros los tapan las casas.
• Hoyos: una celda a −10 m o más abajo es un hoyo (la quebrada). Su borde es un barranco a propósito.
• El centro (radio 74 m) no se pisa: lo tapan las torres.

Subir o bajar una celda

1. Seleccioná Mundo › Terreno.
2. Arrastrá el punto de la celda hacia arriba o hacia abajo. Sube o baja de a 1.5 m, y el suelo se rehace en vivo.
3. Las casas de encima se rearman solas a la nueva altura (cuando soltás y pasa un instante). Las escaleras de alrededor también se reacomodan.
4. Ctrl+Z deshace. Guardá con Ctrl+S.

Las líneas de colores

Crear una escalera

Las escaleras son hijas de Terreno › Escaleras. Se acomodan solas: arriba y abajo salen de las alturas de las dos celdas que unen, calculan cuántos escalones hacen falta y, si la ponés al revés, se dan vuelta.

1. La forma rápida: seleccioná el Terreno y apretá Poner escaleras donde faltan. Pone una en el medio de cada borde rojo de calle.
2. A mano: seleccioná una escalera de Terreno › Escaleras y duplicala (Ctrl+D). O clic derecho en Escaleras › Add Child Node › TerrainStairs.
3. Arrastrala cerca del borde entre las dos alturas. Con Snap prendido se pega sola al borde con desnivel más cercano y gira para bajar.
4. Ajustá el Width (ancho). Si la línea queda roja, choca con otra escalera: correla.

Una rampa

Una rampa es una escalera con Kind › Ramp: lisa, y más larga para el mismo desnivel (con Ramp Slope 0.2, 15 m para 3 m de alto). Para pasar una escalera a rampa, seleccionala y cambiá Kind; se reacomoda sola.

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

Anillos y tajadas

Los números del Terreno, en su Inspector:

Si cambiás anillos o tajadas, apretá Rehacer el terreno. El mapa entero se diseña en planta en design/ y se pasa a la escena con tools/make_map.gd (ver la guía del proyecto); eso pisa los cambios hechos a mano en Terreno y Ciudad.

Qué es un estilo

Hay dos: world/houses/estilos/limpio.tres (barrio rico) y gastado.tres (barrio pobre). Doble clic en el panel FileSystem y se abre en el Inspector. Lo que cambies 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, con azoteas.

1. En FileSystem, clic derecho en limpio.tres (o gastado.tres) › Duplicate, y nombralo pescadores.tres.
2. Abrilo y cambiá lo que lo hace distinto: Colores Muro (azules y verdes fuertes), Techos (flat: 3, gable: 1), Storey 3.0, Mugre 0.3.
3. En cada fila o edificio que quieras de ese tipo, arrastrá pescadores.tres desde FileSystem al campo Custom Style del Inspector.
4. Esas casas se rearman solas con el estilo nuevo. Guardá la escena.

Si el tipo nuevo necesita piezas que el kit colonial no tiene (otra ventana, otro techo), hacelas en el kit (parte siguiente) o hacé un kit propio y poné su ruta en Kit Path.

Qué es un kit

Cómo arma una fachada

Cada fachada es una grilla, como un nine-slice: las esquinas no se estiran, las bahías (celdas) se repiten y se estiran un poco para llenar el largo, y las bandas corren a lo ancho. El estilo elige el tipo de cada celda (ventana, balcón, ciega); el kit pone la variante (A, B, C), al azar según su peso.

Cómo tiene que estar una pieza

• Nombre zona-tipo-variante, con guiones: piso-ventana-C, esquina-der-A, prop-tinaco-A.
• Ejes: X a lo largo de la fachada, −Y es la calle (el frente), Z arriba. Origen abajo a la izquierda, sobre el plano del muro (y = 0).
• Cada celda trae su pedazo de muro alrededor de la ventana o la puerta, ocupando todo el rectángulo ancho × alto.
• Una sola cara, hacia afuera. Revisá con Overlays › Face Orientation: el frente se ve azul.
• Nunca espejar con escala −1, y escala aplicada (Ctrl+A › Scale).
• La posición del objeto en la escena no importa: solo sirve para ordenar las piezas a la vista.

Propiedades en Object › Custom Properties:

Lugares: empties hijos de la pieza que marcan dónde va a pasar algo en el juego: slot-puerta, slot-tienda, slot-balcon, slot-azotea. Se ponen en el piso, frente a la puerta, mirando a la calle. Más adelante, la gente y las tiendas van a salir de ahí.

Materiales

Los materiales se llaman como un rol, y el juego los tiñe con los colores de cada casa: Muro (dejalo gris claro neutro), Marco, Zocalo, Teja, Vidrio, Madera, Hierro, Chapa. Otro material (un toldo, un ladrillo) se marca como decorativo: Custom Properties › decorativo = 1, y queda tal cual.

Exportar

1. En Blender, abrí el editor de texto (pestaña Scripting), elegí export_kit.py y Run Script (Alt+P).
2. Escribe colonial.glb y colonial.json al lado del .blend. Si hay errores no escribe nada y los lista en la consola (Window › Toggle System Console).
3. Volvé a Godot: recarga el kit y las casas se rearman solas. Guardá la escena.

Una variante nueva

1. Duplicá una pieza parecida (Shift+D) y movela al lado para verla.
2. Renombrala con la letra siguiente, piso-ventana-E (sacale el .001).
3. Editala: que el muro siga ocupando todo el rectángulo.
4. Ajustá peso, pisos y estilos, y exportá. Sale sola, al azar entre sus hermanas.

Un tipo nuevo (por ejemplo piso-mirador-A) también se carga, pero no sale hasta que un estilo le dé peso: en el estilo, Pisos › mirador: 1.

Un kit nuevo

Copiá art/kits/plantilla.blend a art/kits/<nombre>.blend: es un kit mínimo (puerta, ventana, ciega, esquina, zócalo, cumbrera) con todas las propiedades puestas y un texto LEEME. Modelá, exportá, y en un estilo (uno nuevo, ver Crear un tipo nuevo) poné Kit Path en tu .glb. Cada estilo tiene que tener al menos una planta_baja-puerta y una piso-ventana.

Si el exportador se queja

Todas las reglas, con ejemplos: nuevacondor/docs/kits.md.

El camino de una casa

La Ciudad corta cada curva en casas, decide pisos, puertas y techos con las reglas del estilo, y arma cada casa con las piezas del kit, todas a la vez en varios núcleos del procesador. Cada casa trae su colisión (por las dos caras: a 30 m/s no se atraviesa) y marca sus puertas, tiendas y balcones. Toda la ciudad, unas 300 casas, se arma en unos 5 segundos.

Sin abrir el editor

Para rearmar y guardar toda la ciudad desde una terminal, en nuevacondor/:

gd script res://tools/build_city.gd

Imprime casas, triángulos y segundos. Después del comando, si usás git, sumá los cambios de world/city/casas/.

Si algo se ve raro