Tutorial de Ren'Py: crea tu primer cuento interactivo desde cero
En este artículo vamos a recorrer paso a paso un cuento
interactivo corto protagonizado por Alicia y Tomás, donde el
lector decide si adentrarse en el bosque o regresar a casa.
1. Declarar los personajes
Antes de escribir los diálogos, conviene definir quién habla
y con qué estilo visual se identificará cada personaje. Con Character() creamos
un "alias" corto (a y t) para no tener que escribir el nombre
completo en cada línea y asignamos un color hexadecimal a su nombre.
# Declaración de personajes
define a = Character("Alicia", color="#ff69b4")
define t = Character("Tomás", color="#00aaff")
define a =
Character(...): asocia la letra a al personaje Alicia y le da un
tono rosado (#ff69b4).
define t =
Character(...): asocia la letra t al personaje Tomás y le da un tono
celeste (#00aaff).
Ventaja práctica:
al escribir a "¡Hola!", Ren'Py entiende de inmediato que habla Alicia
y aplica su color.
2. Registrar fondos y personajes (imágenes)
El siguiente paso es indicar qué archivos gráficos usará la
historia. En Ren'Py es fundamental respetar la identación (los espacios
al inicio de cada línea) y los nombres exactos de los archivos ubicados en la
carpeta de imágenes del proyecto.
image pueblo = "pueblo.jpg"
image bosque = "bosque.jpg"
Fondos (pueblo y
bosque): representan los escenarios donde transcurre la acción.
Personajes (Alicia
y Tomas): corresponden a las figuras que aparecerán sobre el escenario.
image Alicia = "Alicia.png"
3. Construir el inicio de la historia (label start)
Todo proyecto en Ren'Py comienza en la etiqueta start:. Aquí
cargamos el escenario inicial, aplicamos una transición suave, ubicamos a los
personajes en pantalla y desarrollamos el diálogo introductorio.
# Inicio de la historia
label start:
scene pueblo
with fade
show Alicia at Position(xpos=0.35, ypos=0.75)
show Tomas at Position(xpos=0.45, ypos=0.80)
a "¡Qué bonito día hace hoy!"
t "Sí. El pueblo está muy tranquilo."
a "He escuchado que en el bosque ocurren cosas extrañas."
t "Yo también lo escuché."
a "¿Qué te parece si vamos a investigar?"
t "Vamos a decidir qué hacer."
jump decision
Detalles clave de este bloque
- scene
pueblo + with fade: limpia la pantalla, muestra el fondo del pueblo y
aplica un fundido (fade).
- show
... at Position(xpos=..., ypos=...): posiciona a cada personaje en la
pantalla usando coordenadas proporcionales (xpos de izquierda a derecha,
ypos de arriba abajo). Fíjate en que Tomás queda un poco más abajo (0.80)
y más a la derecha (0.45) que Alicia (0.35, 0.75), generando sensación de
profundidad y cercanía.
- Diálogos:
las líneas que comienzan con a o t muestran los textos de cada personaje.
Cuando no hay un personaje antes de las comillas (como ocurrirá más
adelante con "Continuará..." o "Fin."), Ren'Py lo
muestra como narración general.
jump decision: envía el flujo de la historia hacia la etiqueta decision, donde se presenta la elección al jugador.
4. Crear el menú de decisiones (label decision)
La interactividad aparece cuando permitimos que la persona
elija el rumbo del relato. Con el bloque menu: mostramos opciones en pantalla y
redirigimos a distintas etiquetas según lo seleccionado.
# Menú de decisiones
label decision:
menu:
"Ir al bosque":
jump ir_bosque
"Regresar a casa":
jump volver_casa
·
Cada opción va entre comillas seguida de dos
puntos (:).
·
La línea siguiente, con mayor sangría, indica
qué ocurre al elegir esa opción (jump ir_bosque o jump volver_casa).
5. Desarrollar las rutas alternativas
Una vez que el jugador elige una opción, la historia continúa por el camino correspondiente. En este ejemplo tenemos dos finales o cierres distintos: explorar el bosque o posponer la aventura y volver a casa.
Ruta 1: Ir al bosque
# Ruta 1
label ir_bosque:
scene bosque
with dissolve
show Alicia at Position(xpos=0.35, ypos=0.75)
show Tomas at Position(xpos=0.45, ypos=0.80)
a "¡Qué lugar tan misterioso!"
t "Parece que alguien ha pasado por aquí."
a "Tal vez encontremos una aventura."
"Continuará..."
return
·
Cambia el escenario a bosque con una transición
dissolve.
·
Mantiene las mismas posiciones de Alicia y Tomás
y cierra con "Continuará..." y return (que finaliza la etiqueta
actual y devuelve el control al flujo principal/menú del juego).
Resumen visual de comandos
|
Comando |
Función principal |
Ejemplo en el código |
|
define |
Crea personajes y define atributos como el color del
nombre. |
define a = Character("Alicia",
color="#ff69b4") |
|
image |
Asocia un nombre de recurso a un archivo de imagen. |
image bosque = "bosque.jpg" |
|
label |
Marca un punto o sección de la historia al que se puede
saltar. |
label decision: |
|
scene / with |
Cambia el fondo y aplica una transición visual. |
scene pueblo / with fade |
|
show ... at Position(...) |
Muestra un personaje en coordenadas específicas. |
show Alicia at Position(xpos=0.35, ypos=0.75) |
|
menu: |
Presenta opciones interactivas al usuario. |
"Ir al bosque": |
|
jump |
Salta directamente a otra label. |
jump ir_bosque |
|
return |
Termina la ejecución de la etiqueta o historia actual. |
return |

Comentarios
Publicar un comentario