Sobre el proyecto

## Visión general Godot Road Generator es un plugin para el motor de juegos Godot que permite a los desarrolladores crear carreteras, calles y sistemas de tráfico 3D flexibles que siguen los carriles directamente dentro del editor. Su objetivo es resolver problemas comunes de creación de carreteras, como huecos en las mallas, transiciones de carriles, intersecciones e integración con IA de tráfico. ## Características principales - **Geometría basada en secciones transversales**: los ajustes de RoadPoint se interpolan suavemente entre puntos, con un gizmo de control de carriles para ajustar el número de carriles por punto o por contenedor. - **Organización con RoadContainer**: agrupa RoadPoints hermanos y encaja varios contenedores entre sí. Guarda contenedores como escenas para reutilizarlos. - **Panel de inspector de RoadPoint**: define el ancho de carril, el arcén y otras propiedades. Mantén pulsado Shift para aplicar los cambios a todos los puntos de un contenedor. - **Dibujo por clic con ajuste por colisión**: dibuja carreteras haciendo clic en la vista 3D, con ajuste a la geometría. - **Intersecciones procedurales**: conecta RoadPoints dinámicamente para crear intersecciones, con compatibilidad con configuraciones no planares. - **Contenedores de intersecciones prefabricados**: cruces de cuatro vías, de tres vías y rampas de entrada y salida de autopista integrados que se encajan fácilmente. - **Integración con Terrain3D**: aplana el terreno para que coincida con los niveles de la carretera con márgenes y atenuación configurables. Es extensible a otros generadores de terreno. - **Soporte de múltiples materiales**: materiales de superficie y de parte inferior separados por contenedor, con una trim-sheet de origen para materiales personalizados. - **Rutas de IA generadas automáticamente**: activa la colocación automática de RoadLane o coloca los carriles manualmente. Usa RoadLaneAgent para ayudar a los agentes a seguir las carreteras y gestionar las transiciones de segmentos. - **Curvas de borde para decoración**: añade geometría de ruta CSG o scripts personalizados para instanciar activos a lo largo de las curvas izquierda, derecha y central. - **Funciones procedurales en tiempo de ejecución**: las operaciones se aplican en RoadSegments individuales para mejorar el rendimiento, lo que permite la generación procedural dentro del juego. - **Exportación a gLTF/glb**: exporta secciones de tu red de carreteras para editarlas posteriormente en software 3D. - **Soporte de mallas personalizadas**: desactiva la generación de geometría y coloca tus propias mallas y colliders manteniendo las rutas de IA conectadas. - **Solo GDScript**: no requiere compilación ni dependencias externas. ## Instalación y uso 1. Descarga la última versión desde la [página de versiones](https://github.com/TheDuckCow/godot-road-generator/releases) u obtén el plugin desde la [Godot Asset Store](https://store.godotengine.org/asset/theduckcow/road-generator/). 2. Copia la carpeta `addons/road-generator` en tu proyecto. Opcionalmente, copia la carpeta `demo_roads` para consultar ejemplos. 3. Sigue el [tutorial de introducción](https://github.com/TheDuckCow/godot-road-generator/wiki/A-getting-started-tutorial) o abre la escena `road_demos/demo_menu.tscn` para explorar las demostraciones. 4. Consulta la [wiki](https://github.com/TheDuckCow/godot-road-generator/wiki) para obtener documentación detallada. ## Compatibilidad de versiones | Rama | Versión del plugin | Compatibilidad con Godot | | ------ | -------------- | ------------- | | main | 0.9.1 | 4.4+ | | dev | Próxima versión | 4.4+ | | godot4.3 | 0.9.0 | 4.3+ | | godot3 | 0.6.0 | 3.5-3.6 | ## Créditos Desarrollado por Moo-Ack! Productions como parte del proyecto de juego "Wheel Steal". Distribuido bajo la licencia MIT. Las contribuciones de la comunidad son bienvenidas. ## Juegos creados con Road Generator - Wheel Steal Game - caso de uso procedural - Wheelie Big and Small - caso de uso procedural - Makin'Paper / Racin'Paper - pistas creadas en el editor ## Planes futuros Las ideas de desarrollo se rastrean como issues de mejora en GitHub. Los issues priorizados forman parte de los milestones. ## Contribución Las contribuciones son bienvenidas. Consulta la [guía de contribución](https://github.com/TheDuckCow/godot-road-generator/blob/main/CONTRIBUTING.md) para más detalles. Únete al Discord o inicia una conversación en un issue antes de empezar a programar.