| Ambos lados, revisión anteriorRevisión previaPróxima revisión | Revisión previa |
| tutorial_de_renpy [2025/01/18 18:49] – peron | tutorial_de_renpy [2026/04/21 16:09] (actual) – editor externo 127.0.0.1 |
|---|
| ======Tutorial de Ren'Py====== | ======Tutorial de Ren'Py====== |
| |
| Bienvenid@ al Tutorial de Ren'Py. El propósito de este tutorial es demostrar como hacer un juego en Ren'py en unos pocos pasos. | Bienvenid@ al Tutorial de Ren'Py. |
| | ** |
| | Ren'Py** (Renobe Python) es un lenguaje de programación muy parecido a [[tutorial de python|Python]], especialmente concebido para la creación de //novelas visuales//. Estas son historias computarizadas con diálogos, imágenes y sonidos, que pueden contar con interactividad por parte del lector, constituyendo en aventuras con múltiples hilos argumentales. |
| |
| ====El lanzador de Ren'Py==== | El propósito de este tutorial es demostrar como hacer un juego en Ren'py en unos pocos pasos. |
| |
| Antes de empezar a hacer un juego, primero hay que tomarse el tiempo de aprender como funciona el lanzador de Ren'Py. El lanzador te deja crear, gestionar, editar y ejecutar los proyectos de Ren'Py. | ====Preparar Ren'Py==== |
| |
| ===Empezar=== | ===Instalar=== |
| Para empezar tendrás que [[instalar renpy|instalar Ren'Py]]. | |
| |
| | Para empezar tendrás que [[instalar renpy|instalar el ambiente Ren'Py en tu sistema]]. |
| |
| | ====Lanzador Ren'py==== |
| |
| ====Lanzador Renpy==== | El ambiente de programación gira alrededor de un programa llamado //Lanzador de Ren'Py// ("Ren'Py Laucher"). Este te permitirá crear, gestionar, editar, ejecutar y depurar distintos proyectos de Ren'Py. |
| El lanzador está traducido a varios idiomas. Para elegir uno, elegí preferencias en la esquina inferior derecha, y elegí Español. | |
| | Puesto que el lanzador está traducido a varios idiomas, lo primero que deberás hacer es elegir un idioma. También puedes escoger un idioma haciendo clic en //Preferencias// en la esquina inferior derecha, y eligiendo //Español//. |
| |
| ===Elegir y lanzar un Proyecto=== | ===Elegir y lanzar un Proyecto=== |
| |
| Primero deberías ver que apariencia tiene el juego The Question. Para hacer esto, empezá con el lanzador renpy, y elegí The Question desde la primer pantalla. Elegí Lanzar Proyecto para ejecutar The Question. | {{ :renpy_launcher.png?200 |}} |
| |
| Podés volver a la demo de Ren'Py haciendo lo mismo, pero eligiendo "Tutorial" en lugar de "The Question". | Primero revisemos qué apariencia tiene la novela visual "The Question". Para reproducirla, en el panel izquierdo seleccioná "The Question", y después apretá **Lanzar Proyecto** para reproducir //The Question//. |
| |
| ====Iniciar un Proyecto Nuevo==== | Podés volver a la demo de Ren'Py de la misma forma, pero eligiendo "Tutorial" en lugar de "The Question". |
| | |
| | ====Programar en Ren'Py==== |
| | |
| | Vamos a crear un nuevo nuevo proyecto de Ren'Py. |
| | |
| | Para ello tendremos siguiendo la sintaxis de Ren'Py. Esta funciona mayormente con palabras en inglés, y utilizan una sintaxis sencilla. |
| |
| ===Crea un nuevo proyecto=== | ===Crea un nuevo proyecto=== |
| Podés crear un nuevo proyecto eligiendo "Crear Nuevo Proyecto" en el lanzador de RenPy. | En el Lanzador de Ren'Py elegí "Crear Nuevo Proyecto". |
| |
| Si esta esa tu primera vez creando un proyecto, Ren'Py puede pedirte que elijas el directorio de proyectos. Este será el directorio (también llamado carpeta) donde se crean los nuevos proyectos, y se lo revisará para buscar proyectos ya existentes. El Selector de directorios puede apracer debajo de RenPy, de modo que asegurate de revisarlo por si está allí. | Si esta esa tu primera vez creando un proyecto, Ren'Py te pedirá que elijas un //Directorio de proyectos//; este consiste en un //directorio// (también llamado //carpeta//) donde se almacenarán los nuevos proyectos que vayas creando. En la parte inferior del Lanzador de Ren'Py puede aparecer el //Selector de Directorios//; asegurate de revisarlo por si está allí. |
| |
| El lanzador pedirá un nombre de proyecto. Elegiremos algo como "Mi Opción", y apretamos Enter. | Se te solicitará que indiques un //nombre de proyecto//. Como nuestra novela visual estará en castellano, por ahora pongámosle algo como "Mi pregunta", y apretamos la **tecla Intro** para confirmar. |
| |
| Acto seguido el lanzador preguntará la resolución del proyecto. 1280x720 es un buen compromiso entre tamaño de juego y calidad de imagen. Para el proósito de este tutorial, le elegimos 1280x720 para que coincida con el arte del juego "The Question", y apretamos Continuar. | El Lanzador Ren'Py te solicitará que indiques la //resolución de pantalla// del proyecto. 1280x720 es un buen compromiso entre tamaño de juego y calidad de imagen. Para el propósito de este tutorial, elegí 1280x720 (ya que coincidirá con el arte gráfico de la novela visual de demostración "The Question"), y apretá **Continuar**. |
| |
| El lanzador pedirpa que elijamos un esquema cromático (un color de fondo y de acentos para la interfaz de usuario). No importa en este momento, así que elegí algún color lindo, y dale "Continuar". | El Lanzador Ren'Py te pedirá luego que escojas un esquema cromático (un color de fondo y de acentos para la interfaz de usuario). En este momento no importa demasiado, elegí algún color lindo, y dale "Continuar". |
| |
| En este momento RenPy procesará lo indicado, y te dará una plantilla simple de juego. La plantilla usa arte y texto "de quita y pon", pero funcionará, y soporta las funcionalidades esperadas como retroceder, cargar, y guardar jugadas. Elegí "lanzar proyecto" para ejecutarlo. | Llegado este momento, el Lanzador Ren'Py procesará lo escogido, y creará por tí una plantilla simple para tu juego. Por ahora la plantilla usa arte y texto "genérico", pero funcionará. Además, te creará automáticamente los botones típicos de retroceder, cargar y guardar jugadas, etcétera. |
| |
| ====Un juego simple==== | Para ejecutar la plantilla de tu prototipo de novela visual, apretá "Lanzar proyecto". |
| |
| <code python> | ====Un juego simple para aprender==== |
| label start: | |
| |
| "Sylvie" "Hi there! How was class?" | Para empezar a crear nuestra novela visual, haremos una versión traducida al castellano de The Question (puesto que esto facilitará aún más el aprendizaje). |
| |
| "Me" "Good..." | ¡Manos a la obra! |
| |
| "I can't bring myself to admit that it all went in one ear and out the other." | Para empezar, desde la parte superior del panel izquierdo del Lanzador Ren'Py seleccioná "My Question", y luego desde el sector //Editar Archivo//, elegí el fichero que contiene el guión de la obra: "''script.rpy''". |
| |
| "Me" "Are you going home now? Wanna walk back with me?" | Si es tu primera vez, Ren'Py pedirá que elijas un Editor para trabajar - para los creativos novatos recomendamos Editra, pero podés usar tu [[editores de texto|editor de texto favorito]]. El Lanzador Ren'Py recurrirá el editor que elijas, y abrirá el fichero de guion de la obra con el editor que pediste. |
| |
| "Sylvie" "Sure!" | Ahora bien, una vez que se abra el editor, borrá todo el contenido de ''script.rpy'': como empezaremos desde cero, no necesitaremos nada del guion anterior. Pegá el siguiente contenido en ''script.rpy'', y guardalo. |
| </code> | |
| | <file python script.rpy> |
| | label start: |
| | |
| | "Silvana" "¡Como va! ¿Qué tal estuvo la clase?" |
| | |
| | "Yo" "Buena..." |
| |
| Este es un juego de renpy muy simple. No incluye ninguna imagen ni música, pero muestra una conversación entre dos personajes, y una línea de narración. | "No puedo admitir que me entró por un oído y me salió por el otro." |
| |
| Para probarlo, desde la parte superior de la pantalla selcciona "My Question", y lueego elegí "script.rpy" desde Editar Archivo. Si es tu primera vez, RenPy pedirá que selecciones un Editor (recomendamos Editra para los creadores iniciales) y descargará el editor que elijas). Luego abrirá el archivo de gion en el editor. | "Yo" "¿Te vas a tu casa ahora? ¿Querés que volvamos juntos?" |
| |
| Una vez que se abra el editor, borra todo en script.rpy. Vamos a empezar de cero, de modo que no necesitamos nada de lo que tiene escrito. Copiá el ejemplo de arriba en script.rpy y grabalo. | "Silvana" "¡Dale!" |
| | </file> |
| |
| | Este primer guion de juego sigue la sintaxis de Ren'Py, y como ves, es sumamente simple. Aún no le pusimos ninguna imagen ni nada de música, pero al menos presenta una //conversación entre dos personajes//, y una de las líneas es una //narración en off//. |
| |
| Ahora estamos listos para correr este ejemplo. Volvemos al lanzador y elegimos "Lanzar Proyecto". RenPy comenzará. Fijate como - sin ningún trabajo extra - Renpy te da los menús que te dejan cargar y grabar la partida, y cambiar varias preferencias. Cuando estamos listos, apretamos "Lanzar Proyecto" y jugamos este juego de ejemplo. | Ya estamos listos para ejecutar este guion de ejemplo. Volvé al Lanzador Ren'Py y apretá "**Lanzar Proyecto**". Ren'Py lo ejecutará. Fijate como Ren'py pone directamente los menús que te dejan cargar y grabar una partida, así como los de modificar las preferencias del juego. |
| |
| Este ejemplo muestras algunas declaraciones comunes del lenguaje Ren'Py. | Como vemos, este guion mínimo ya incluye varias //declaraciones// muy comunes del lenguaje Ren'Py. Estudiémoslas. |
| |
| La primer línea es una declaración label. La declaración label se usa para dar etiquetar un lugar en el programa. En este caso, creamos una etiqueta llamada ''start''. La etiqueta start es especial, porque determina donde empiezan los guiones de RenPy al presionar Empezar Juego en el menú principal. | La primer línea es una declaración ''label''. La declaración ''label'' se usa para etiquetar un lugar en el programa. En este caso, creamos una etiqueta llamada ''start''; esta etiqueta ''start'' resulta especial, puesto determina el lugar desde donde comenzará a ejecutarse los guiones de RenPy cuando apretás **Empezar Juego** en el menú principal. |
| |
| Las otras líneas son declaraciones ''say''. Existen dos formas de declaración ''say'': | Las demás líneas constituyen lo que se llaman declaraciones ''say''. Existen dos formas de declaración ''say'': |
| * una //cadena// (comienza con comillas ''"'', contiene caracteres, y termina con comillas ''"'', todo en una sola línea. Esta se usa para **narración** o **énsamientos** del personaje principal. | * Una __forma usada para **narración en off** o **pensamientos** del personaje principal__: consiste en una //cadena// (comienza con comillas ''"'', contiene caracteres, y termina con comillas ''"'', toda en una sola línea. |
| * dos //cadenas//, usadas para **diálogos**, donde la primer cadena es un nombre de personaje y la segunda es lo que dice dicho personaje. | * Una __forma para **diálogos**__: consiste en dos //cadenas//; la primer cadena es un //nombre de personaje// y la segunda cadena es lo que dice tal personaje. |
| |
| Tené en cuenta que todas las declaraciones ''say'' están sangradas 4 espacios. Esto es porque hay un bloque debajo de la declaración label. En Ren'Py, los bloques __deben estar sangrados en relación a la declaración anterior__, y todas las declaraciones en un bloque deben estar indentadas por la misma cantidad. | >Tené en cuenta que todas las declaraciones ''say'' van sangradas a 4 //espacios//. Esto se debe a que existe un //bloque// debajo de la declaración ''label''. En Ren'Py, los //bloques// __necesariamente deben estar sangrados en relación a la declaración anterior__, y todas las declaraciones en un bloque deben estar sangradas por la misma cantidad de //espacios//. |
| |
| Cuando las cadenas contienen caracteres de ''"'' en sí, estos caracteres tienen que ser escapados con una barra invertida ''/''. Por ejemplo: | En el caso que las cadenas contengan en sí caracteres de //comillas// (''"''), estas deben ser escapadas con un caracter de //barra invertida// (''<nowiki>\</nowiki>''). Por ejemplo: |
| |
| |
| <code python> | <code python> |
| "Sylvie" "Did you ever hear Lincon's famous saying, \"The problem with Internet quotations is that many of them are not genuine.\"" | "Silvana" "¿Alguna vez oíste la famosa frase de Perón, \"El problema con las citas sacadas de Internet, es que muchas de ellas son truchas.\"?" |
| </code> | </code> |
| |
| Si bien este juego simple no tiene mucho para ver, es un ejemplo de cuán fácil es lograr algo funcional en Ren'Py. Agregaremos las imágenes en breve pero primero, veamos cómo definir los personajes. | Aunque parezca que nuestra novela visual provista de este guion simple no tiene mucho efectismo, resulta un ejemplo que demuestra lo simple que es escribir algo que resulte funcional usando Ren'Py. En breve le agregaremos las imágenes, pero primero veamos cómo definimos los personajes de nuestra historia. |
| |
| ====Personajes==== | ===Personajes=== |
| |
| Main article: Defining Character Objects | Un problema que tiene este primer ejemplo es que fue necesario ingresar repetidamente el nombre de un personaje toda vez que el mismo habla (tal como si fuese un guion de una obra teatral). Si quisiéramos escribir mucho diálogo en nuestra novela, hacer esto se volvería sumamente tedioso. Por suerte también podemos indicar los nombres de personaje al iniciar el guion. Para esto tenemos que **definir los personajes por adelantado** según la sintaxis de Ren'Py. Gracias a ello, podremos asociar un //nombre abreviado// al personaje, y cambiar el //color del nombre del personaje//. |
| |
| Un problema del primer ejemplo es que necesita que ingresemos repetidamente el nombre de un personaje cada vez que el tipo habla. En un juego con mucho diálogo, esto se hace muy pesado. También, se presentan ambos nombres del personaje de la misma manera, con el color de acento elegido al iniciar el juego. Para solucionarlo, Ren'Py te deja definir los personajes por adelantado. Esto permite asociar un nombre corto con el personaje, y cambiar el color del nombre del personaje. | Altera el guión para que quede así: |
| |
| <code python> | <code python> |
| define s = Character('Sylvie', color="#c8ffc8") | define s = Character('Silvana', color="#c8ffc8") |
| define m = Character('Me', color="#c8c8ff") | define m = Character('Yo', color="#c8c8ff") |
| |
| label start: | label start: |
| |
| s "Hi there! How was class?" | s "¡Como va! ¿Qué tal estuvo la clase?" |
| |
| m "Good..." | m "Buena..." |
| |
| "I can't bring myself to admit that it all went in one ear and out the other." | "No puedo admitir que me entró por un oído y me salió por el otro." |
| |
| s "Are you going home now? Wanna walk back with me?" | s "¿Te vas a tu casa ahora? ¿Querés que volvamos juntos?" |
| |
| m "Sure!" | m "¡Dale!" |
| </code> | </code> |
| |
| La primera y segunda línea definen personajes. La primer línea define un personaje con el nombre abreviado de "s", y su nombre largo "Sylvie", con un nombre de color verdoso (los colores son representados en triples hexadecimales rojo-verde-azul, como en las páginas web). | ¡Ahora será más fácil escribir el diálogo entre los dos personajes!. La primera y segunda línea definen al primero y el segundo personaje. Veamos: |
| |
| La segunda línea crea un personaje con el nombre corto "''m''" y el nombre largo "''Me''". con el nombre indicado en color rojizo. Podés crear otros personajes copiando una de las líneas del personaje, y cambiando su //nombre corto//, //nombre largo// y su //color//. | La primer línea define un personaje con el //nombre abreviado// de "s", y su //nombre largo// "''Silvana''", con un //color de nombre// verdoso (los colores se representan con tripletes hexadecimales rojo-verde-azul, como lo hacen en las páginas web). |
| |
| También cambiamos las declaraciones ''say'' para usar objetos //personaje// en lugar de una cadena de nombre de un personaje. Esto le dirá a Ren'Py usar los personajes que definimos. | La segunda línea crea un personaje con el nombre corto "''m''" y el nombre largo "''Yo''". con el color de nombre rojizo. Podés inventar otros personajes copiando una de las líneas de definición de personaje, y cambiándole su //nombre corto//, //nombre largo// y el //color//. |
| |
| | También modificamos las declaraciones ''say'' para hacer uso de los objetos ''Character'' en lugar de recurrir a la tediosa cadena de nombre para un personaje. |
| |
| ====Imagenes==== | >¡Este pequeño trabajo que nos tomamos, le permitirá ahora a Ren'Py usar los personajes que le hemos definido de una forma más abreviada y fácil de escribir! |
| |
| Main article: Displaying Images | Ver manual: [[https://renpy.org/doc/html/dialogue.html#defining-character-objects|Defining Character Objects]] |
| |
| No tendremos una novela visual si no recurrimos a presentar imágenes en la pantalla. Aquí hay otra escena de "The Question". Esta también incluye declaraciones que muestran imágenes al jugador. Esto puede reemplazar completamente la sección anterior del guion, si lo deseas probar. | ====Imágenes==== |
| | |
| | No obtendremos una novela visual si no recurrimos a presentar imágenes en la pantalla. Aquí hay otra escena de "The Question". Esta también incluye declaraciones que muestran imágenes al jugador. Esto puede reemplazar completamente la sección anterior del guion, si lo deseas probar. |
| |
| <code python> | <code python> |
| define s = Character('Sylvie', color="#c8ffc8") | define s = Character('Silvana', color="#c8ffc8") |
| define m = Character('Me', color="#c8c8ff") | define m = Character('Yo', color="#c8c8ff") |
| |
| label start: | label start: |
| scene bg meadow | scene bg meadow |
| |
| "After a short while, we reach the meadows just outside the neighborhood where we both live." | "A poco caminar, alcanzamos los prados justo al lado del vecindario donde vivimos." |
| |
| "It's a scenic view I've grown used to. Autumn is especially beautiful here." | "Es una vista muy linda a la que me fui acostumbrando. El otoño es especialmente hermoso por estos lares." |
| |
| "When we were children, we played in these meadows a lot, so they're full of memories." | "Cuando éramos chic@s, jugábamos mucho en estos campitos, están llenos de recuerdos." |
| |
| m "Hey... Umm..." | m "Ey... Umm..." |
| |
| show sylvie green smile | show sylvie green smile |
| |
| "She turns to me and smiles. She looks so welcoming that I feel my nervousness melt away." | "Gira hacia mi y sonríe. Parece tan a gusto que siento que mis nervios desaparecen." |
| |
| "I'll ask her...!" | "¡Le voy a preguntar...!" |
| |
| m "Ummm... Will you..." | m "Ummm... ¿Serías..." |
| |
| m "Will you be my artist for a visual novel?" | m "¿Serías mi artista para una novela visual?" |
| |
| show sylvie green surprised | show sylvie green surprised |
| |
| "Silence." | "Silencio." |
| </code> | </code> |
| |
| Este segmento de guion introduce dos nuevas declaraciones. La declaración ''scene'' en la línea 6 borra todas las imágenes y muestra solamente una imagen de fondo. Las declaraciones ''show'' de las líneas 16 y 26 hacen aparecer en pantalla un //sprite// (una gráfica activable) encima del fondo, y modifican este sprite, respectivamente. | Este segmento de guion introduce dos declaraciones nuevas. La declaración ''scene'' de la línea 6 __borra todas las imágenes y presenta solamente una //imagen de fondo//__. Las declaraciones ''show'' de las líneas 16 y 26 __hacen aparecer en pantalla un //sprite// (una gráfica activable) encima de la imagen de fondo__, y modifican este sprite, respectivamente. |
| | |
| En Ren'Py, cada imagen tiene un //nombre//. El nombre consiste de una //etiqueta//, y opcionalmente de uno o más //atributos//. Tanto la etiqueta como los atributos deben comenzar con una letra, y contener letras, números y guiones bajos. Por ejemplo. | |
| |
| | En Ren'Py, cada imagen consta de un //nombre//. El nombre consiste de una //etiqueta//, y opcionalmente de uno o más //atributos//. Tanto la etiqueta como los atributos deben empezar con una letra, y sólo pueden contener letras, números y guiones bajos. Por ejemplo: |
| |
| En la declaración ''scene'' de la línea 6, la etiqueta es "''bg''" y el atributo es "''meadow''". Por convención, las imágenes de fondo usan la etiqueta "''bg''" (por "background", o "fondo" en inglés). | |
| |
| En la primer declaración ''show'' en la línea 16, la etiqueta es "''sylvie''", y los atributos son "''green''" y "''smile''". | * En la declaración ''scene'' de la línea 6, la etiqueta es "''bg''" y el atributo es "''meadow''". Por convención, las imágenes de fondo usan la etiqueta "''bg''" (por "background", o "fondo" en inglés). |
| | * En la primer declaración ''show'' en la línea 16, la etiqueta es "''sylvie''", y los atributos son "''green''" y "''smile''". |
| | * En la segunda declaración ''show'' de la línea 26, la etiqueta es "''sylvie''" y los atributos son "''green''" y "''surprised''". |
| |
| En la segunda declaración ''show'' de la línea 26, la etiqueta es "''sylvie''" y los atributos son "''green''" y "''surprised''". | |
| |
| | En cada momento dado, sólo puede aparecer una imagen con una etiqueta dada. Si se presenta una segunda imagen del mismo //nombre//, esta reemplazará a la primera (tal como sucede en la línea 26 del guion). |
| |
| En cada momento dado, sólo puede aparecer una imagen con una etiqueta dada. Al presentarse una segunda imagen del mismo //nombre//, esta reemplaza a la primera (tal como sucede en la línea 26 del guión). | Ren'Py buscará el fichero de imagen en el directorio de imágenes, que puede localizarse seleccionando "Imagenes" en la sección "//Abrir Directorio//" del Lanzador de Ren'Py. Ren'Py puede usar arte de personajes que se encuentren en formato PNG, WEBP, o AVIF, mientras que el arte de fondo puede estar en formato JPG, JPEG, PNG, WEBP, o AVIF. También existe siporte para archivos SVG, aunque estos se utilizan fundamentalmente para personalizar la interfaz de usuario. Es muy importante el nombre de archivo - puesto que la extensión no se usa, el nombre de archivos se convierte forzadamente a minúsculas, y se emplea el resultado como nombre de la imagen. |
| | |
| Ren'Py buscará el fichero de imagen en el directorio de imágenes, que puede localizarse seleccionando "Imagenes" en la sección "Abrir Directorio" del lanzador. Ren'Py espera que el arte de personajes se encuentre en formato PNG, WEBP, o AVIF, mientras que el arte de fondo de estar en JPG, JPEG, PNG, WEBP, o AVIF. También están soportados los archivos SVG, pero fundamentalmente se los utiliza para personalizar la interfaz. Es muy importante el nombre de archivo - ya que la extensión no se usa, el nombre de archivos se convierte forzadamente a minúsculas, y eso se usa como nombre de la imagen. | |
| |
| Por ejemplo, los siguientes archivos - localizados en el directorio de imágenes - definen las siguientes imágenes: | Por ejemplo, los siguientes archivos - localizados en el directorio de imágenes - definen las siguientes imágenes: |
| "sylvie green surprised.png" -> sylvie green surprised | "sylvie green surprised.png" -> sylvie green surprised |
| |
| Ya que los nombres de archivo están en minúscula, también se mantiene lo siguiente: | Puesto que los nombres de archivo están en minúscula, también lo siguiente se mantiene: |
| |
| "Sylvie Green Surprised.png" -> sylvie green surprised | "Sylvie Green Surprised.png" -> sylvie green surprised |
| |
| Las imágenes también pueden ser puestas en subdirectorios (subcarpetas) contenidas en el directorio de imágenes. El nombre de directorio se ignorará y sólo el nombre de archivo se usa para definir el nombre de imágenes. | Las imágenes también pueden ser colocadas en subdirectorios (subcarpetas) contenidas en el directorio de imágenes. El nombre de directorio resultará ignorado y sólo se usará el nombre de archivo para definir el nombre de imágenes. |
| |
| | Ver manual: [[https://renpy.org/doc/html/displaying_images.html|Displaying Images]] |
| |
| ===Declaración Hide=== | ===Declaración Hide=== |
| | |
| Ren'Py también soporta una declaración ''hide'', que __oculta__ una imagen dada. | Ren'Py también soporta una declaración ''hide'', que __oculta__ una imagen dada. |
| |
| <code renpy> | <code python> |
| label leaving: | label irse: |
| |
| s "I'll get right on it!" | s "¡Me voy a encargar ahora mismo!" |
| |
| hide sylvie | hide sylvie |
| "..." | "..." |
| |
| m "That wasn't what I meant!" | m "¡No era eso a lo que me refería!" |
| </code> | </code> |
| |
| En realidad es bastante raro usar ''hide''. Se puede usar ''show'' cuando un personaje cambia de emociones, mientras que ''scene'' lo usás para el momento en que todos se van. Sólo necesitás usar ''hide'' cuando un personaje abandona la escena, pero el resto de la escena tiene que quedar igual. | En realidad ''hide'' se usa bastante poco. Podés usar ''show'' cuando un personaje cambia de emociones, mientras que a ''scene'' lo usás para el momento en que todos los personajes se van. Sólo es necesario usar ''hide'' cuando un personaje abandona la escena, pero el resto de la escena y los demás personajes tienen que quedar igual. |
| |
| ===Declaracion Image=== | ===Declaración Image=== |
| |
| A veces, puede que no quieras dejar que Ren'Py defina las imágenes automáticamente por sí mismo. Para esto se usa la declaración ''image''. Debería estar en el nivel superior del fichero (sin sangrado y antes de ''label start''), y puede usarse para mapear un nombre de imagen a un fichero de imagen específico. Por ejemplo | A veces, puede que no quieras dejar que Ren'Py defina las imágenes automáticamente por sí mismo. Para esto se usa la declaración ''image''. Debería estar en el nivel superior del fichero (sin sangrado y antes de ''label start''), y puede usarse para mapear un nombre de imagen a un fichero de imagen específico. Por ejemplo |
| La declaración ''image'' también puede ser utilizada para llevar a cabo tareas mas complejas, pero esto se tratará aparte. | La declaración ''image'' también puede ser utilizada para llevar a cabo tareas mas complejas, pero esto se tratará aparte. |
| |
| ====Transiciones==== | ===Transiciones=== |
| |
| En el guion anterior, las imágenes aparecen y desaparecen de forma instantánea. Ya que cambiar la locación y hacer que un personaje entre o salga de escena es importante, Ren'Py soporta //transiciones//, que permiten aplicarse cuando los personajes presentan modificaciones. | En el guion anterior, las imágenes aparecen y desaparecen de forma instantánea. Ya que cambiar la locación y hacer que un personaje entre o salga de escena es importante, Ren'Py soporta //transiciones//, que permiten aplicarse cuando los personajes presentan modificaciones. |
| |
| Las transiciones cambian lo que se muestra, desde lo que sucedía al final de la última interacción (diálogo, menú o transición - entre otras declaraciones) a la apariencia luego de que se han ejecutado las declaraciones ''scene'', ''show'' y ''hide''. | Las transiciones modifican lo que se muestra, desde el momento de lo que sucedía al final de la última interacción (diálogo, menú o transición - entre otras declaraciones) hasta la apariencia luego de que se han ejecutado las declaraciones ''scene'', ''show'' y ''hide''. |
| |
| <code python> | <code python> |
| with fade | with fade |
| |
| "After a short while, we reach the meadows just outside the neighborhood where we both live." | "A poco caminar, alcanzamos los prados justo al lado del vecindario donde vivimos." |
| |
| "It's a scenic view I've grown used to. Autumn is especially beautiful here." | "Es una vista muy linda a la que me fui acostumbrando. El otoño es especialmente hermoso por estos lares." |
| |
| "When we were children, we played in these meadows a lot, so they're full of memories." | "Cuando éramos chicos, jugábamos mucho en estos campitos, están llenos de recuerdos." |
| |
| m "Hey... Umm..." | m "Ey... Umm..." |
| |
| show sylvie green smile | show sylvie green smile |
| with dissolve | with dissolve |
| |
| "She turns to me and smiles. She looks so welcoming that I feel my nervousness melt away." | "Gira hacia mi y sonríe. Parece tan a gusto que siento que mis nervios desaparecen." |
| |
| "I'll ask her...!" | "¡Le voy a preguntar...!" |
| |
| m "Ummm... Will you..." | m "Ummm... ¿Serías..." |
| |
| m "Will you be my artist for a visual novel?" | m "¿Serías mi artista para una novela visual?" |
| </code> | </code> |
| |
| La declaración ''with'' recibe el nombre de la transición que empleará. La más común es ''dissolve'', que //disuelve// de una pantalla a la siguiente. Otra transición útil es ''fade'', que desvanece la pantalla a negro, y luego la desvanece a la siguiente pantalla. | La declaración ''with'' recibe el __nombre de la transición__ a emplear. La más común es ''dissolve'', que //disuelve// de una pantalla a la siguiente. Otra transición útil es ''fade'', que //desvanece la pantalla a negro//, y luego la transiciona a la siguiente pantalla. |
| |
| Cuando se coloca una transición después de múltiples declaraciones ''scene'', ''show'' o ''hide'', se aplicará a todas ellas a la vez. Si escribís: | Cuando colocás una transición tras múltiples declaraciones ''scene'', ''show'' o ''hide'', ésta se aplicará a todas ellas a la vez. Por lo tanto, si escribís: |
| |
| <code python> | <code python> |
| </code> | </code> |
| |
| Tanto las imagenes "''bg meadow''" y "''sylvie green smile''" se disolverán al mismo tiempo. Para disolver una por vez, tenés que programarlo usando dos declaraciones ''with'': | ...tanto las imágenes "''bg meadow''" y "''sylvie green smile''" se disolverán al mismo tiempo. Para disolver de a una por vez, es necesario programarlo de otra forma, usando dos declaraciones ''with'', de esta manera: |
| |
| <code python> | <code python> |
| </code> | </code> |
| |
| Esto primero disuelve el fondo del río, y luego disuelve a sylvie. Si quería mostrar el río instantáneamente, y luego presentar a sylvie, podías programarlo así: | De esta manera, primero se disuelve el fondo del prado, y luego disuelve a Silvana. Si querías mostrar el prado instantáneamente, y luego hacer que Silvana aparezca suavemente, podías programarlo así: |
| |
| |
| Aquí se usa ''None'' para indicar una transición especial que actualiza la idea de Ren'Py de que era la pantalla anterior, sin mostrarle nada al jugador. | Aquí se usa ''None'' para indicar una transición especial que actualiza la idea de Ren'Py de que era la pantalla anterior, sin mostrarle nada al jugador. |
| |
| ====Posiciones==== | Ver manual: [[https://renpy.org/doc/html/transitions.html|Transitions]] |
| |
| Main article: Transforms | ===Posiciones=== |
| |
| Por defecto, las imágenes se muestran centradas horizontalmente, y con su borde inferior tocando el borde inferior de la pantalla. Esto usualmente está bien para fondos y personajes únicos, pero cuando se muestra más de un personaje en la pantalla, probablemente tenga más sentido hacerlo en otra posición. También puede tener sentido reposicionar un personaje según como venga el relato. | Por defecto, las imágenes se muestran centradas horizontalmente, y con su borde inferior tocando el borde inferior de la pantalla. Esto usualmente está bien para fondos y personajes únicos, pero cuando se muestra más de un personaje en la pantalla, probablemente tenga más sentido hacerlo en otra posición. También puede tener sentido reposicionar un personaje según como venga el relato. |
| </code> | </code> |
| |
| Para hacer este reposicionamiento, agrega una clásula ''at'' a la declaración ''show''. La cláusula ''at'' recibe una posición, y presenta la imágen en dicha posición. Ren'Py incluye varias posiciones predefinidas: | Para hacer este reposicionamiento, agrega una clausula ''at'' a la declaración ''show''. La cláusula ''at'' recibe una posición, y presenta la imagen en dicha posición. Ren'Py incluye varias posiciones predefinidas: |
| ''left'' para el lado izquierdo de la pantalla, ''right'' para el lado derecho, ''center'' para centrarlo horizontalmente (el valor por defecto) y ''truecenter'' para que la centre horizontalmente y verticalmente. | ''left'' para el lado izquierdo de la pantalla, ''right'' para el lado derecho, ''center'' para centrarlo horizontalmente (el valor por defecto) y ''truecenter'' para que la centre horizontalmente y verticalmente. |
| |
| Los creadores puede incluso definir sus propias posiciones, y hacer eventos con movimientos complejos, pero esto cae por fuera de este tutorial rápido | Los creadores puede incluso definir sus propias posiciones, y hacer eventos con movimientos complejos, pero esto cae por fuera de este tutorial rápido |
| |
| ====Música y Sonido==== | Ver manual: [[https://renpy.org/doc/html/transforms.html|Transforms]] |
| |
| | ====Música y Sonido==== |
| |
| Main article: Audio | |
| |
| La mayoría de los juegos de Ren'Py tienen música de fondo. La música se reproduce con la declaración ''play music''. La declaración ''play music'' recibe un nombre de archvio que es interpretado como un fichero de audio que debe ejecutarse. Los ficheros de audio se interpretan en relación al directorio de juevo. Los ficheros de audio deben estar en formato opus, ogg vorbis, o mp3. | La mayoría de los juegos de Ren'Py tienen música de fondo. La música se reproduce con la declaración ''play music''. La declaración ''play music'' incluye un nombre de archivo que es interpretado como un fichero de audio que debe ejecutarse de manera sinfín (en bucle). Los ficheros de audio se interpretan en relación al directorio de juego. Los ficheros de audio que acepta Ren'Py son de formato ''opus'', ''ogg vorbis'', o ''mp3''. |
| |
| Por ejemplo: | Por ejemplo: |
| </code> | </code> |
| |
| Cuando se cambia la música, uno puede indicar una cláusula ''fadeout'' o ''fadein'', que se usan para desvanecer el volúmen de la antigua música y aumentar el volúmen de la música nueva (para hacer una transición suave de músicas). | Cuando se cambia la música, uno puede indicar una cláusula ''fadeout'' o ''fadein'', que se usan para desvanecer el volumen de la antigua música y aumentar el volumen de la música nueva (para hacer una transición suave de músicas). |
| |
| <code python> | <code python> |
| </code> | </code> |
| |
| La declaración ''queue music'' reproduce un fichero de audio después que el fichero de audio actual terminal | La declaración ''queue music'' permite hacer una //playlist//, o sea, reproduce un fichero de audio nuevo una vez que termina el fichero de audio actual. |
| |
| <code pywhon> | <code pywhon> |
| </code> | </code> |
| |
| Podés parar la música con la declaración ''stop music'', que también puede recibir una cláusula ''fadeout'' opcional. | Podés detener la reproducción de la música abruptamente con la declaración ''stop music'', o bien agragarle una cláusula ''fadeout'' opcional para detener la música suavemente. |
| |
| <code python> | <code python> |
| </code> | </code> |
| |
| Los efectos de sonido pueden reproducirse con la declaración ''play sound''. A diferencia de la música, los efectos de sonido no tienen bucle (no se repiten indefenidamente). | Los efectos de sonido se reproducen con la declaración ''play sound''. A diferencia de la música, los efectos de sonido no se reproducen en bucle sinfín (no se repiten indefinidamente). |
| |
| <code python> | <code python> |
| </code> | </code> |
| |
| Cuando ponés los archivo de audio en el directorio ''game/audio'', y podés usar el nombre sin extensión de archivo, al estilo de una variable de Python (o sea, comienza con una letra, y contiene sólo letras, números y guiones bajos). En tal caso, te será posible reproducir dicho fichero sin poner las comillas. | Si ponés los archivo de audio en el directorio ''game/audio'', podés usar el nombre sin extensión de archivo, al estilo de una variable de Python (o sea, comienza con una letra, y contiene sólo letras, números y guiones bajos). En tal caso, te será posible programar la reproducción de dicho fichero sin poner las comillas. |
| |
| Por ejemplo, si tenés el archivo de audio ''game/audio/illurock.ogg'', podés programar: | Por ejemplo, si tenés el archivo de audio ''game/audio/illurock.ogg'', podés programar: |
| </code> | </code> |
| |
| | Ver manual: [[https://renpy.org/doc/html/audio.html|Audio]] |
| |
| ====Declaración pause==== | ====Declaración pause==== |
| |
| La declaración ''pause'' hace que Ren'Py haga una pausa hasta hacer clic con el mouse. | La declaración ''pause'' hace que Ren'Py haga una pausa hasta que el jugador haga clic con el mouse. |
| |
| <code python> | <code python> |
| |
| |
| <code pywhon> | <code python> |
| ".:. Good Ending." | ".:. Final Feliz." |
| |
| return | return |
| </code> | </code> |
| |
| Esto es todo lo que tenés que hacer para hacer una novela cinética, un juego sin ningún tipo de opción que seguir en él. Ahora veremos lo que se necesita para hacer que un juego que presente menúes con opciones para que elija el usuario. | >Esto es todo lo que tenés que hacer para hacer una novela cinética, un juego sin ningún tipo de opción que seguir en él. |
| |
| |
| ====Menús, Etiquetas y Saltos==== | ====Menús, Etiquetas y Saltos==== |
| |
| Main articles: In-Game Menus and Labels & Control Flow | Ahora veremos lo que se necesita para hacer que un juego que presente **menúes con opciones para que el usuario elija interactivamente**. Estas permiten trazar diferentes //senderos// o //caminos//, si es que queremos permitir seguir distintos desarrollos arbolados. |
| |
| La declaración ''menu'' te permite presentar una opción al jugador: | La declaración ''menu'' te permite presentar una opción al jugador: |
| |
| <code python> | <code python> |
| s "Sure, but what's a \"visual novel?\"" | s "Seguro, pero ¿qué es una \"novela visual?\"" |
| |
| menu: | menu: |
| |
| "It's a videogame.": | "Es un videojuego.": |
| jump game | jump juego |
| |
| "It's an interactive book.": | "Es un libro interactivo.": |
| jump book | jump libro |
| |
| label game: | label juego: |
| |
| m "It's a kind of videogame you can play on your computer or a console." | m "Es como un videojuego que jugás en la computadora o en una consola." |
| |
| jump marry | jump casamiento |
| |
| label book: | label libro: |
| |
| m "It's like an interactive book that you can read on a computer or a console." | m "Es como un libro interactivo que leés en una computadora o una consola." |
| |
| jump marry | jump casamiento |
| |
| label marry: | label casamiento: |
| |
| "And so, we become a visual novel creating duo." | "Y de esta manera, nos volvimos un dúo creador de novelas visuales." |
| </code> | </code> |
| |
| Este ejemplo presenta un menú que puede usarse con Ren'Py. La declaración ''menu'' introduce una selección dentro del juego. Requiere un bloque de líneas sangradas, cada una consiste en una cadena seguida por dos puntos ('':''). Estas serán las opciones del menú, que se le presentarán al jugador. Cada opción del menú requiere su propio bloque de líneas sangradas, que se ejecutan cuando se eligen dicha opción del menú. | Este ejemplo presenta un menú que puede usarse con Ren'Py. La declaración ''menu'' introduce una selección dentro del juego. Requiere un bloque de líneas sangradas, cada una consiste en una cadena seguida por dos puntos ('':''). Estas serán las opciones del menú, que se le presentarán al jugador. Cada opción del menú requiere su propio bloque de líneas sangradas, que se ejecutan cuando se eligen dicha opción del menú. |
| |
| En este ejemplo, cada una de las dos opciones del menú ejecuta una única declaración ''jump''. La declaración ''jump'' transfiere el control a la etiqueda definida a través de la declaración ''label''. Luego del salto ''jump'', se ejecutan las declaraciones del guion que siguen a la etiqueta ''label'' determinada. | En este ejemplo, cada una de las dos opciones del menú ejecuta una única declaración ''jump''. La declaración ''jump'' transfiere el control a la etiqueta definida a través de la declaración ''label''. Luego del salto ''jump'', se ejecutan las declaraciones del guion que siguen a la etiqueta ''label'' determinada. |
| |
| | {{ :renpy_pregunta.jpg?200 |}} |
| |
| En el ejemplo anterior, luego de que Silvie realiza su pregunta, al jugador se le presentará un menú que contiene dos opciones. Si el jugador elige "Es un videojuego", se ejecuta la primer declaración ''jump'', y Ren'Py saltará a la etiqueta ''juego''. Esto provocará que el Punto de Vista del personaje diga "Es una historia con imágenes y música", tras lo cual Ren'Py saltará a la etiqueta ''marry''. | En el ejemplo anterior, luego de que Silvana realiza su pregunta, al jugador se le presentará un menú que contiene dos opciones. Si el jugador elige "Es un videojuego", se ejecuta la primer declaración ''jump'', y Ren'Py saltará a la etiqueta ''juego''. Esto provocará que el Punto de Vista del personaje diga "Es una historia con imágenes y música", tras lo cual Ren'Py saltará a la etiqueta ''casamiento''. |
| |
| Si no hay una declaración ''jump'' al final del bloque asociado con la etiqueta ''label'', Ren'Py continuará a la siguiente declaración. La última declaración jump aquí es técnicamente innecesaria, pero se la incluye para hacer más claro el flujo del juego. | Si no hay una declaración ''jump'' al final del bloque asociado con la etiqueta ''label'', Ren'Py continuará a la siguiente declaración. La última declaración ''jump'' aquí es técnicamente innecesaria, pero se la incluye para hacer más claro el flujo del juego. |
| |
| Pueden definirse las etiquetas label en cualquier archivo de juego que esté en el directorio ''game'', y termine con extensión .rpy. El nombre de archivo no importa en Ren'Py, solamente importan las etiquetas contenidas en el. Podés pensar todos los archivos .rpy como si fuese un único archivo .rpy enorme, en el cual se usan los saltos para transferir el control. Esto te da flexibilidad en la manera en la cual organizás el guión de un juego muy largo. | Pueden definirse las etiquetas ''label'' en cualquier archivo de juego que esté en el directorio ''game'', y termine con extensión ''.rpy''. El nombre de archivo no importa en Ren'Py, solamente importan las etiquetas contenidas en el. Podés pensar todos los archivos ''.rpy'' como si fuese un único archivo ''.rpy'' enorme, en el cual se usan los saltos para transferir el control. Esto te da flexibilidad en la manera en la cual organizás el guión de un juego muy largo. |
| |
| ====Flags de apoyo usando las declaraciones Default, Python e If==== | Ver manual: [[https://renpy.org/doc/html/menus.html|In-Game Menus]] y [[https://renpy.org/doc/html/label.html|Labels & Control Flow]] |
| |
| Main articles: Python Statements and Conditional Statements | ==== Integración de Python==== |
| |
| Si bien podés hacer algunos juegos simplemente usando las declaraciones ya indicadas, otros juegos requieren almacenar datos y recabarlos luego. Por ejemplo, puede tener sentido que el juego recuerde una opción escogida por el jugador, volver a una sección común del guión, y actuar en la opción más adelante. Esta es una de las razones por la cual Ren'Py tiene soporte de Python incorporado. | Si bien podés hacer algunos juegos simples usando las declaraciones ya indicadas, ciertos juegos requieren una programación más compleja en la cual se almacenan datos para recabarlos luego. Por ejemplo, puede tener sentido que el juego recuerde una opción escogida por el jugador, volver a una sección común del guion, y actuar más adelante según la opción escogida anteriormente. Esta es una de las razones por la cual Ren'Py cuenta con [[tutorial de python|soporte de Python]] incorporado. |
| |
| Aquí le mostraremos como almacenar un //flag// que contiene información sobre una opción que el jugador hizo. Para inicializar el flag, se usa la declaración ''default'', antes de la etiqueta ''label start'' | ===Flags de apoyo usando las declaraciones Default, Python e If=== |
| | |
| | Aprenderás aquí cómo almacenar un valor en un //flag//, que contendrá información sobre una elección escogida por el jugador a lo largo de la trama. Para inicializar el flag, se usa la declaración ''default'', antes de la etiqueta ''label start'', por ejemplo: |
| |
| <code python> | <code python> |
| # True if the player has decided to compare a VN to a book. | # True si el jugador ha decidido comparar las novelas visuales con un libro. |
| default book = False | default libro = False |
| |
| label start: | label start: |
| |
| s "Hi there! How was class?" | s "¡Como van! ¿Qué tal estuvo la clase?" |
| </code> | </code> |
| |
| El flag ''book'' comienza apagada inicializada al valor especial ''False'' (como con el resto de Ren'Py, es importante el uso de la mayúscula), lo que significa que no está activada. Si se elige la senda ''book'', podemos ponerla en ''True'' usando una declaración de asignación de Python. | De esta forma, el flag ''libro'' comienza inicializado de forma apagada (con al valor especial ''False'', recuerda que como con el resto de Ren'Py, es importante definirlo usando la primer letra en mayúscula). Esto significa que está desactivada. Si el jugador escoge la senda ''libro'', podemos poner el flag en ''True'' recurriendo una [[tutorial_de_python#variables|declaración de asignación de Python]], de la siguiente forma: |
| |
| <code python> | <code python> |
| label book: | label libro: |
| |
| $ book = True | $ libro = True |
| |
| m "It's like an interactive book that you can read on a computer or a console." | m "Es como un libro interactivo que leés en una computadora o un celular." |
| |
| jump marry | jump casamiento |
| </code> | </code> |
| |
| Las líneas que comienzan con ''$'' son interpretadas como declaraciones de Python. La declaración de asignación utilizada aquí asigna un valor a una variable. Ren'Py soporta otras formas de incluir Python, tales como las declaraciones multilíneas de Python, que se discuten en otras secciones del manual. Ren'Py soporta Python 2.7, aunque recomendamos escribir Python que corra en Python 2 y Phyton 3. | Fijate que __todas las líneas que comienzan con el caracter ''$'' son interpretadas como declaraciones de Python en lugar de declaraciones de Ren'Py__. La declaración de asignación de Python que utilizamos aquí asigna un valor a una variable. |
| | |
| | >Ren'Py soporta otras formas para incluir Python, tales como las [[tutorial_de_python#tuplas|declaraciones multilíneas (tuplas) de Python]], que se discuten en otras secciones del manual. Ren'Py soporta Python 2.7, aunque recomendamos escribir Python que corra en Python 2 y Phyton 3. |
| |
| Para revisar el flag, isamos la declaración ''if'': | Para revisar el valor que tiene almacenado el flag, recurrimos la [[tutorial_de_python#if|declaración ''if'']]: |
| |
| <code python> | <code python> |
| if book: | if libro: |
| |
| "Our first game is based on one of Sylvie's ideas, but afterwards I get to come up with stories of my own, too." | "Nuestro primer juego se basó en las ideas de Silvana, pero luego se me ocurrieron historias propias también." |
| </code> | </code> |
| |
| Si la condición es verdadera, se ejecutará el bloque del guión. Si no lo es, se lo salteará. La declaración ''if'' también puede recibir una cláusula ''else'' que introduce un bloque de guion que se ejecuta si la condición es falsa. | Si la condición es ''True'' (verdadera), se ejecuta el bloque del guión. Si no lo es, se la salteará. La declaración ''if'' puede recibir una cláusula ''else'' opcional, la cual introduce un bloque de guion alternativo que se ejecuta si la condición es ''False'' (falsa). |
| |
| <code python> | <code python> |
| if book: | if libro: |
| |
| "Our first game is based on one of Sylvie's ideas, but afterwards I get to come up with stories of my own, too." | "Nuestro primer juego se basó en las ideas de Silvana, pero luego se me ocurrieron historias propias también." |
| |
| else: | else: |
| |
| "Sylvie helped with the script on our first video game." | "Silvana ayudó con el guion de nuestro primer videojuego." |
| </code> | </code> |
| |
| Las variables de Python no necesitan ser valores simples ''True''/''False''. Podés usar variables para almacenar el nombre del jugador, los puntajes, o para cualquier otro propósito. Ya que Ren'Py incluye la habilidad de usar todo el lenguaje de programación Python, es posible hacer muchas cosas. | Las variables de Python no se limitan necesariamente a valores simples ''True''/''False''. También podés usar variables para almacenar el nombre del jugador, puntajes, estadísticas de vida, logros, o para cualquier otro propósito que se te ocurra. Ya que Ren'Py incluye la habilidad de usar todo el lenguaje de programación Python, es posible hacer muchas cosas más. |
| | |
| | >Un recurso típico es el subgénero "simdate" o "juego de conquistas", donde las elecciones del jugador suman o restan puntaje de una o varias variables; de acuerdo al puntaje que vas sumando o restando estadísticas, podés avanzar en determinadas //sendas// de la historia, o retroceder en otras. |
| | |
| | Ver Manual: [[https://renpy.org/doc/html/python.html|Python Statements]] y [[https://renpy.org/doc/html/conditional.html|Conditional Statements]] |
| | |
| | ====Guion de La Pregunta ==== |
| | |
| | //La Pregunta// es una versión traducida pero tiene los puntos básicos de este tutorial de Ren'Py. |
| | |
| | Si querés, podés ver el guion completo de ''[[script.rpy|La Pregunta]]'' aqui, pegarlo en el editor, y lanzarlo. |
| |
| ====Ficheros en Plantilla==== | ====Ficheros en Plantilla==== |
| |
| La carpeta ''game'' en el proyecto creado incluirá las siguientes carpetas y ficheros: | En la carpeta ''game'' del tus proyectos creados, se incluirá las siguientes carpetas y ficheros: |
| |
| | |''script.rpy'' |Este es el archivo pensado para incluir otros guiones que incluyen un escenario. También podeés agregar o borrar cualquier .rpy. | |
| | |''*.rpyc'' | Estos ficheros son resultados de la compilación de cada fichero .rpy para reducir el tiempo de carga. No necesitás editar estos archivos sin borrar el fichero .rpy correspondiente. | |
| | |''gui.rpy'' |Las variables de GUI se definen acá. | |
| | |''options.rpy'' |Variables Config y Build, una parte de preferencias y una parte de la GUI de definen acá. | |
| | |''screens.rpy'' |Las pantallas se definen en este fichero. Deberías editar esto para customizar la GUI en un sentido mas avanzado. | |
| | |''audio/'' |Este directorio está pensado para incluir los ficheros de audio. | |
| | |''cache/'' |Este directorio incluye los ficheros de caché. No necesitas editar estos ficheros. | |
| | |''gui/'' |Este directorio incluye imágenes usadas por la GUI. | |
| | |''images/'' |Esta carpeta está pensada para incluir ficheros de imágenes. | |
| | |''tl/'' |Este directorio incluye archivos de traducción. | |
| |
| | ''audio/'' | This folder is intended to include audio files. See Audio for more details. | | |
| | ''cache/'' | This folder includes cache files. You don't need to edit those files. | | |
| | ''gui/'' | This folder includes images which are used by the gui. See the GUI Customization Guide for more details. | | |
| | ''images/'' | This folder is intended to include images files. See Displaying Images for more details. | | |
| | ''tl/'' | This folder includes translation files. See Translation for more details. | | |
| | ''gui.rpy'' | The gui variables are defined in this file. See the GUI Customization Guide for more details. | | |
| | ''options.rpy'' | Config and Build variables, a part of preferences and a part of gui variables are defined in this file. See Configuration Variables, Preference Variables, Building Distributions and the GUI Customization Guide for more details. | | |
| | ''screens.rpy'' | Screens are defined in this file. You should edit this for more advanced gui customization. Also see Styles, Style Properties, Screens and Screen Language, Screen Actions, Values, and Functions, Special Screen Names and Screen Language Optimization for more details. | | |
| | ''script.rpy'' | This file is intended to include other scripts which include a scenario. You can also add or delete any .rpy. See Language Basics for more details. | | |
| | ''*.rpyc'' | Those files are result of compiling each .rpy files to reduce loading time. You don't need to edit those files without deleting the corresonding .rpy file. See Language Basics for more details. | | |
| |
| |
| ====Lanzando tu juego==== | ====Crear tu propio juego==== |
| |
| Una vez que hiciste un juego, existen varias cosas que podés hacer antes de publicarlo: | Como ves, el ambiente Ren'Py es lo suficientemente sencillo como para poder recurrir a hacer tus propios personajes, historias, senderos de aventura, retruécanos y relatos. |
| |
| | Dibujar y escanear/fotografiar tus propios personajes es una manera sencilla de comenzar. Existen recursos de música de licencias completamente libres para utilizar, o elementos generados por IA de libre uso. |
| |
| | Gracias a todas las herramientas de software libre, recursos audiovisuales liberados ¡Podrías convertirte en desarrollador@ de juegos amateur! |
| |
| Check for a new version of Ren'Py. | Una vez que hiciste un juego, existen varias cosas que podés hacer antes de publicarlo: |
| |
| New versions of Ren'Py are released on a regular basis to fix bugs and add new features. Before releasing, you'll want to click update in the launcher to update Ren'Py to the latest version. You can also download new versions and view a list of changes at https://www.renpy.org/latest.html. | ==Revisar tu guion== |
| |
| Rarely, changes to Ren'Py will require you to make a change to your game's script. Incompatible Changes has a list of these changes. | Desde la primer página del Lanzador, elegi "Revisar guion (Lint)". Esto depurará tu juego en busca de errores potenciales. Ya que algunos de estos errores sólo afectan a usuarios de otras plataformas, es importante entender y usaurlmente corregir todos estos errores, incluso si no te dan problemas en tu computadora. |
| Check the Script. | |
| |
| Desde la primer página del Lanzador, elegi "Revisar guion (Lint). Esto revisará tu juego en busca de errores potenciales. Ya que algunos de estos errores sólo afectan a usuarios de otras plataformas, es importante entender y usaurlmente corregir todos estos errores, incluso si no te dan problemas en tu computadora. | ==Revisar versiones nuevas de Ren'Py== |
| |
| ====Compilar distribuciones==== | Periódicamente se lanzan nuevas versiones de Ren'Py en base a correcciones de errores y nuevas funcionalidades. Antes de lanzarlas, querrías hacer clic en Actualizar en el lanzador de Ren'py para bajarte la última versión. También podés bajarte nuevas versiones y ver un listado de cambios en https://www.renpy.org/latest.html. |
| |
| Desde la primer página del lanzador, elegí "Compilar Distribuciones". Pasado en la información indicada en ''option.rpy'', el lanzador construirá uno o más ficheros de archivaje que contendrán a tu juego. | Raramente los cambios a Ren'Py requieren que hagas cambios en el guion de tu juego. Los cambios incompatibles se listan allí. |
| |
| ===Probarlo=== | ==Compilar distribuciones== |
| |
| Lint no es un substituto para evaluaciones completas. Es tu responsabilidad revisar tu juego antes de publicarlo. Considerá pedirle a tus amigos que te ayuden a testear la beta de tu juego ya que a menudo un probador podrá encontrar problemas que vos no. | Desde la primer página del lanzador, elegí "Compilar Distribuciones". Basado en la información indicada en ''option.rpy'', el Lanzador Ren'Py compilará uno o más ficheros de archivaje que contendrán a tu juego. |
| | |
| | ==Probar el juego compilado== |
| | |
| | Lint no es substituto para las pruebas completas del juego. Es tu responsabilidad revisar tu juego antes de publicarlo. Considerá pedirle a tus amig@s que te ayuden a testear la beta de tu juego compilado, puesto que a menudo un probador podrá encontrar problemas que vos no viste. |
| | |
| ===Lanzamiento=== | ===Lanzamiento=== |
| |
| Una vez que terminaste el juego y lo probaste, deberíaws postear el archivo generado en una web donde alguien pueda verlo (no tenés que tener tu propio website, https://itch.io hospeda un montón de novelas visuales) | Una vez que terminaste el juego y lo probaste, deberías postear el archivo compilado generado en una web donde alguien pueda verlo. Si ocupa poco espacio, ¡nuestra [[caja]] de texto-plano.xyz puede servirte! |
| | |
| | Tampoco necesitás tener tu propio website, https://itch.io hospeda un montón de novelas visuales) |
| |
| ¡Felicitaciones! ¡Publicaste tu primer novela visual! | ¡Felicitaciones! ¡Publicaste tu primer novela visual! |
| |
| ====Guion de The Question==== | |
| |
| |
| Podés ver el guion completo de ''[[script.rpy|The Question]]'' aqui. | |
| |
| ====Conclusión==== | ====Conclusión==== |
| Este Tutorial apenas cubre lo básico de lo que es capaz de hacer Ren'Py. Para hacerlo fácil y breve, omitimos muchas funcionalidades que soporta Ren'Py y simplificamos otras, enfocándonos en un conjunto mínimo de funcionalidades necesarias para emprender una novela visual. | Este Tutorial apenas cubre lo básico de lo que es capaz de hacer Ren'Py. Para hacerlo fácil y breve, omitimos muchas funcionalidades que soporta Ren'Py y simplificamos otras, enfocándonos en un conjunto mínimo de funcionalidades necesarias para emprender una novela visual. |
| |
| Si te interesa aprender mas, aprovechá para leer el [[|Manual de Ren'Py]] | Si te interesa aprender mas, aprovechá para leer el [[https://renpy.org/doc/html/language_basics.html|Manual de Ren'Py]]. |
| | |
| |
| ¡Gracias por escoger el motor de novelas visuales Ren'Py!. ¡Queremos ver lo que creás con él! | ¡Gracias por escoger el motor de novelas visuales Ren'Py!. ¡Queremos ver lo que creás con él! |
| |