Libro de historia del CodeVerse

La Wiki del CodeVerse

El CodeVerse es el universo narrativo detrás de BloquePy: cada concepto de Python tiene un nombre, una forma y un lugar en el mapa. Variables son Cofres, if es un Portal, while es el Templo del Ciclo — para que nunca aprendas sintaxis sin saber para qué sirve.

GUIA RAPIDA

¿Cómo se juega?

Cada bloque tiene forma de pieza y encaja con las demás como un rompecabezas — por dentro es una plantilla del idioma propio del CodeVerse, un lenguaje pequeño, creado especialmente para este universo, pero tan parecido al Python real que el código que arma es válido de verdad: arrástralo a tu programa y mira ese código en vivo. No hay que memorizar sintaxis para empezar — hay que encajar las piezas correctas en el orden correcto.

Cada bloque tiene huecos marcados con ···. Tócalos para elegir un valor de una lista o escribirlo tú mismo. Pero también puedes arrastrar algo directo al hueco: una variable que ya creaste, o incluso otra pieza completa — como len(...), int(...) o .upper() — para encajarla ahí adentro. Una pieza puede llevar otra pieza dentro de su propio hueco, sin límite de niveles: así se arma algo como print(len(nombre)) encajando dos piezas, sin escribir una sola letra.

Para mover o quitar un bloque que ya colocaste, mantenlo presionado y arrástralo — a otro lugar del lienzo, al hueco de otro bloque, o a la papelera para quitarlo. No hace falta buscar ningún ícono aparte: el bloque mismo es lo que se arrastra.

MUNDO 1 · CAPITULO 1

El Despertar

Hablar con la máquina — mostrar mensajes, guardar datos y pedirle información al viajero.

Abres los ojos junto al río de texto. No hay señales, no hay mapa —solo Py, enroscada sobre un letrero de piedra, observándote con curiosidad más que con hostilidad. No dice nada porque no puede: en el CodeVerse, hasta el saludo más simple hay que escribirlo.

Aquí aprendes las tres primeras palabras de tu nuevo idioma: guardar algo en un Cofre, preguntarle algo al viajero mediante un Oráculo, y hacer que la Máquina te escuche de vuelta a través de un Heraldo que anuncia tus mensajes en voz alta. Son gestos pequeños, casi torpes, pero es la primera vez que Py reacciona a algo que tú, y no ella, escribiste.

Al final del territorio te espera el Eco de la Máquina: un guardián que solo repite —literalmente— lo que le dices, palabra por palabra. Vencerlo no es cuestión de fuerza, sino de decir exactamente lo que quieres que se escuche. Cuando lo logras, Py te sigue por primera vez sin que se lo pidas: el despertar terminó, y el resto del CodeVerse ya sabe que llegaste.

📦

Cofre

variable

Guarda un valor bajo un nombre para poder usarlo más adelante.

nombre = "Lila"
📢

Heraldo

print(...)

Le muestra un mensaje al viajero en la pantalla del CodeVerse.

print("Hola mundo")
🔮

Oráculo

input(...)

Le pregunta algo al viajero y espera su respuesta antes de continuar.

edad = input("Tu edad: ")
📜

Nota del explorador

# comentario

Un apunte que solo tú puedes leer — la Máquina lo ignora por completo.

# esto imprime un saludo
🤖

Jefe: El Eco de la Máquina

Repite todo lo que escucha... si logras decírselo bien. (120s)

MUNDO 2 · CAPITULO 2

Los Portales

Tomar decisiones — usa if y else para que el programa haga una cosa u otra según la situación.

El camino, hasta ahora una sola línea recta, se parte en dos. Py te muestra —a su manera, enseñando antes que explicando— que en el CodeVerse las decisiones no se toman al azar: cada bifurcación es un Portal que revisa una condición exacta antes de dejarte cruzar.

Aprendes a construir tu primer Portal y su contraparte, el Portal trasero, que se abre solo cuando el principal no lo hizo. Las Runas comparadoras se convierten en tu herramienta para decidir qué es "verdadero" a los ojos de la Máquina, algo que hasta ahora dabas por hecho que ella ya sabía.

El Guardián del Portal Doble no deja pasar a nadie que no sepa combinar dos condiciones a la vez. Solo cruzan quienes entienden que, a veces, una sola pregunta no basta.

🌀

Portal

if

Revisa una condición; si es verdadera, abre el paso a lo que está dentro.

if edad >= 18:
🌗

Portal trasero

else

El camino que se toma cuando el portal principal no se abrió.

else:
⚖️

Runas comparadoras

==, >, <, !=

Lo que el portal lee para decidir si abrirse o no — van dentro de la condición.

edad >= 18
🌀

Jefe: El Guardián del Portal Doble

Dos condiciones, una sola oportunidad de cruzar. (150s)

MUNDO 3 · CAPITULO 3

El Puente y el Templo

Repetir sin cansarse — automatiza instrucciones con for y while, en vez de escribirlas una y otra vez.

Más adelante el terreno se vuelve repetitivo a propósito: un Puente Contado que debes cruzar un número exacto de veces, tablón por tablón, y un Templo del Ciclo que no te deja salir mientras su guardián invisible —una condición, no una criatura— siga en pie.

Aquí Py te enseña que la Máquina nunca se cansa de repetir instrucciones, algo que a un viajero humano le costaría horas. El Puente se cruza contando cada paso; el Templo se atraviesa mientras algo siga siendo cierto. Y cuando la paciencia no alcanza, existen atajos: una Grieta de salida para romper el ciclo antes de tiempo, y un Paso apresurado para saltarte una vuelta sin abandonar el templo entero.

El Centinela del Templo solo cae ante quien repite con un propósito claro, nunca ante quien repite sin más. Muchos viajeros anteriores se quedaron atrapados ahí, repitiendo para siempre sin llegar a ningún lado.

🌉

Puente contado

for

Cruza un número fijo de veces, una por cada elemento de la lista o el rango.

for i in range(5):
🏛️

Templo del ciclo

while

Se repite una y otra vez mientras la condición del guardián siga siendo verdadera.

while vidas > 0:
💥

Grieta de salida

break

Rompe el ciclo antes de tiempo, aunque el guardián siga de pie.

break
➡️

Paso apresurado

continue

Salta directo al siguiente paso del ciclo sin terminar este.

continue
🗿

Jefe: El Centinela del Templo

Solo cae ante quien sabe repetir con propósito. (150s)

MUNDO 4 · CAPITULO 4

Guardianes y Puertas Extra

Decisiones más finas — combina condiciones con and/or y encadena varias con elif.

Los portales que conocías se vuelven más exigentes. Algunos ahora tienen dos Guardianes combinados que deben dar su permiso a la vez, o basta con que uno solo lo dé. Otros esconden una Puerta extra para cuando ni el camino principal ni el trasero son el correcto —una tercera opción que la Máquina considera antes de rendirse.

De paso, descubres que los números del CodeVerse tienen sus propios trucos: la Distancia sin signo que borra cualquier signo negativo, y la forma de Multiplicar varias veces sin escribir la misma cuenta una y otra vez.

El Guardián de las Tres Puertas solo abre una —la correcta— y depende enteramente de cómo combines tus condiciones para saber cuál es.

🛡️🛡️

Guardianes combinados

and / or

El portal exige que uno (or) o ambos (and) guardianes den su permiso.

edad >= 18 and tiene_permiso
🚪

Puerta extra

elif

Una puerta más en el portal, para cuando hay más de dos caminos posibles.

elif nota >= 6:
➖➕

Distancia sin signo

abs(...)

El valor absoluto: quita el signo, siempre da un número positivo.

abs(-8)
✖️✖️

Multiplicar varias veces

pow(base, exp)

Multiplica base por sí mismo, exponente veces seguidas.

pow(2, 5)
🚦

Decisión de un solo trazo

atajo if/else

Un portal tan simple que cabe en una sola línea: elige entre dos valores según una condición, sin escribir un if/else completo.

"Adulto" if edad >= 18 else "Menor"

Multiplicar en un solo trazo

operador **

El mismo truco de pow(base, exponente), pero escrito directo como un operador.

2 ** 10
🚪

Jefe: El Guardián de las Tres Puertas

Solo una puerta se abre — depende de cómo combines tus condiciones. (120s)

MUNDO 5 · CAPITULO 5

El Inventario Infinito

Listas — crea listas, revisa cuántos elementos tienen, agrega más y recórrelas una por una.

Un solo Cofre ya no te alcanza. Cargas ahora un Inventario completo: una fila de cofres numerados, uno tras otro, donde caben tantos objetos como tu viaje necesite. Aprendes que el primer cofre de cualquier fila es siempre el número 0 —una rareza del CodeVerse que a Py le divierte especialmente cuando un viajero nuevo se confunde con ella.

Meter algo al final, contar cuántos objetos llevas, ordenar la fila entera, sacar un objeto por su lugar o por lo que es, o meter algo justo en medio —todo lo que un inventario de verdad necesitaría, lo tiene también el tuyo.

El Coleccionista Insaciable, un dragón que duerme sobre su propio tesoro, no suelta nada hasta que tu inventario pese lo suficiente para impresionarlo. No basta con tener un cofre: hay que saber llenarlo bien.

🎒

Inventario

list

Una fila de cofres, uno tras otro, que guarda varios valores a la vez.

frutas = ["manzana", "pera", "uva"]
🔢

Número de casilla

índice

El lugar de cada cofre en la fila — el primero siempre es el número 0.

frutas[0]

Meter al final

append(...)

Agrega un objeto nuevo al final del inventario.

frutas.append("mango")
📏

Contar cofres

len(...)

Dice cuántos objetos hay guardados en el inventario.

len(frutas)
🗂️

Ordenar la fila

sort() / reverse()

Reordena el inventario: de menor a mayor, o al revés de como estaba.

numeros.sort()
🫳

Sacar un cofre

pop() / remove()

Saca un objeto del inventario, por su lugar (pop) o por lo que es (remove).

frutas.pop()
🎯

Meter en medio

insert(...)

Mete un objeto nuevo justo en el lugar que tú digas, corriendo al resto.

frutas.insert(1, "pera")
🧳

Empacar un inventario nuevo

list(...)

Convierte texto, una tupla o un diccionario en un inventario de verdad.

list("hola")
🐉

Jefe: El Coleccionista Insaciable

Solo suelta el tesoro si tu inventario pesa lo suficiente. (150s)

MUNDO 6 · CAPITULO 6

Los Hechizos

Funciones — empaqueta instrucciones que uses varias veces, con un nombre, parámetros y un return.

Algunos gestos los repites tantas veces que ya no tiene sentido escribirlos de cero cada vez. Py te enseña entonces el ritual más poderoso del CodeVerse: el Hechizo. Lo defines una sola vez, con los Ingredientes exactos que necesita, y puedes invocarlo cuantas veces quieras después, con solo decir su nombre.

Algunos hechizos, además, te entregan un Resultado al terminar —algo que puedes guardar, combinar con otro hechizo, o mostrarle de vuelta a la Máquina. Es el primer momento del viaje en que dejas de escribir instrucciones sueltas y empiezas a construir tus propias herramientas.

El Archimago de los Hechizos solo revela, entre todos los que conoce, el hechizo que de verdad gana el duelo —y solo un viajero que entiende cómo empaquetar lógica en un nombre puede reconocerlo a tiempo.

Hechizo

función (def)

Un ritual que aprendes una sola vez y puedes invocar cuando quieras, por su nombre.

def saludar(nombre):
🎯

Ingredientes

parámetros

Lo que el hechizo necesita recibir cada vez para funcionar.

saludar("Lila")
🎁

Resultado

return

Lo que el hechizo te entrega de vuelta después de invocarlo.

return edad * 2
🌀

Hechizo instantáneo

lambda

Un hechizo tan corto que no necesita nombre propio ni la ceremonia completa: una sola expresión ya es su resultado.

doble = lambda x: x * 2
🪄

Hechizo en cadena

map(...)

Aplica el mismo hechizo a cada objeto de un inventario, uno por uno, y junta todos los resultados en un inventario nuevo.

dobles = map(doble, numeros)
🕸️

Hechizo colador

filter(...)

Prueba el mismo hechizo sobre cada objeto, pero en vez de guardar el resultado, deja pasar solo los que lo cumplen y descarta el resto.

grandes = filter(es_grande, numeros)
📖

Copia ordenada

sorted(...)

Entrega un inventario nuevo ya ordenado, sin tocar el original.

sorted(puntajes)
☑️

Prueba en cadena

all(...) / any(...)

all revisa si TODOS los objetos pasan una prueba; any, si AL MENOS UNO la pasa.

all(aprobatorias)
🧙

Jefe: El Archimago de los Hechizos

Solo revela el hechizo que de verdad gana el duelo. (150s)

MUNDO 7 · CAPITULO 7

Los Pergaminos

Strings a fondo — recorta texto con [inicio:fin] y transfórmalo con upper/lower/strip/split.

El texto mismo —cada palabra que le has mostrado a la Máquina hasta ahora— resulta ser un Pergamino: una tira de runas en un orden exacto. Aprendes a Recortarlo con un rango preciso, a voltear sus runas entre mayúsculas y minúsculas, a limpiarle los bordes de espacios sobrantes, y a separarlo en fragmentos más pequeños dondequiera que tú decidas.

Py te deja claro que ningún pergamino del CodeVerse llega perfecto: siempre hay que recortarlo, limpiarlo o partirlo antes de que diga lo que en verdad necesitas.

El Escriba de Pergaminos Perdidos solo lee un pergamino si está limpio, en mayúsculas y bien recortado —el resto los rechaza sin más, sin importar lo que digan.

📜

Pergamino

string

Un texto escrito con runas (caracteres) en un orden exacto.

"Hola mundo"
✂️

Recorte

[inicio:fin]

Corta una parte del pergamino, desde una posición hasta otra.

texto[0:3]
🔠

Runas mayores/menores

upper() / lower()

Cambia todas las runas del pergamino a mayúsculas o minúsculas.

texto.upper()
🧹

Limpieza de bordes

strip()

Quita los espacios sobrantes al inicio y al final del pergamino.

texto.strip()
🔀

Separar en fragmentos

split(...)

Corta el pergamino en varios pedazos donde encuentre un separador.

texto.split(" ")
🧵

Coser fragmentos

join(...)

Une una lista de pergaminos en uno solo, pegando un separador entre cada uno — lo contrario de separar.

"-".join(palabras)
🖋️

Reescribir runas

replace(viejo, nuevo)

Cambia TODAS las apariciones de una runa (o grupo de runas) por otra, sin tocar el resto.

texto.replace("gato", "perro")
📖

Jefe: El Escriba de Pergaminos Perdidos

Solo lee el pergamino si está limpio, mayúsculo y bien recortado. (120s)

MUNDO 8 · CAPITULO 8

El Mapa del Tesoro

Diccionarios — asocia claves con valores, como una ficha con etiquetas en vez de números.

El inventario numerado, tan útil hasta ahora, deja de alcanzar cuando lo que importa no es el orden sino el nombre. En su lugar, Py te entrega un Mapa del Tesoro: cada tesoro vive bajo su propia Etiqueta, y lo encuentras por lo que es, no por su lugar en la fila.

Aprendes a leer todas las Etiquetas de un mapa a la vez, todos sus Tesoros, ambos juntos y listos para recorrer, y a buscar sin miedo a fallar gracias a un valor de repuesto si una etiqueta no existe.

El Guardián del Mapa Final —el último de este tramo del CodeVerse— solo revela su tesoro a quien reúna suficientes llaves para demostrarlo. Más allá de él, el mapa conocido del CodeVerse termina... por ahora.

🗺️

Mapa del tesoro

diccionario (dict)

Guarda valores bajo una etiqueta en vez de un número de casilla.

inventario = {"espada": 1, "pocion": 3}
🏷️

Etiqueta

clave (key)

El nombre que usas para encontrar un valor en el mapa.

inventario["espada"]
💎

Tesoro

valor (value)

Lo que está guardado bajo cada etiqueta del mapa.

inventario["espada"] = 2
🔑

Todas las etiquetas

keys()

Da la lista de todas las etiquetas del mapa.

inventario.keys()
💰

Todos los tesoros

values()

Da la lista de todos los valores guardados en el mapa.

inventario.values()
📋

Etiqueta y tesoro juntos

items()

Da la lista de pares [etiqueta, tesoro], listos para recorrer con for.

inventario.items()
🛡️

Buscar sin miedo

get(clave, porDefecto)

Busca una etiqueta y, si no existe, da un valor de repuesto en vez de fallar.

inventario.get("pocion", 0)
🐲

Jefe: El Guardián del Mapa Final

Solo revela el tesoro a quien reúna suficientes llaves. (150s)

MUNDO 9 · CAPITULO 9

El Templo de los Números Reales

Decimales — números con punto, división real con /, y funciones matemáticas como sqrt(), round(), pi y trigonometría.

El camino te lleva a un templo que no existía antes: sus muros están cubiertos de números que nunca viste completos —números con un punto en medio, partidos entre un entero y el siguiente. Py te explica, a su manera silenciosa, que hasta ahora solo hablabas con números enteros; el mundo real casi nunca es tan ordenado.

Aprendes a leer estos Fragmentos numéricos, a dividir de verdad (no solo la parte entera que descartabas antes), y a esculpir un fragmento impreciso de vuelta a un entero limpio cuando hace falta. En lo más profundo del templo, dos Constantes Eternas —pi y e— ya existían antes de que tú llegaras, junto con una Raíz que revela qué número, multiplicado por sí mismo, formó cualquier otro.

El Arquitecto de lo Exacto no confía en aproximaciones: solo una medida calculada con precisión abre la puerta que guarda. Ni un entero de sobra, ni un decimal de menos.

🔹

Fragmento numérico

números decimales

Un número con punto no es un error de escritura — es la forma en que el templo representa cantidades entre un entero y otro.

radio = 3.14

División exacta

/

A diferencia de // (que solo da la parte entera), / siempre revela el fragmento completo de una división.

7 / 2
🔮

El Oráculo de lo Impreciso

float(input(...))

El Oráculo de siempre solo entrega palabras — este ritual las convierte en fragmentos numéricos de verdad.

precio = float(input("Precio: "))
🗿

El Escultor

round(...)

Talla un fragmento hasta dejarlo en su entero más cercano.

round(3.8)
🌀

La Raíz del Templo

sqrt(...)

Revela qué número, multiplicado por sí mismo, formó el fragmento original.

sqrt(81)
♾️

Las Constantes Eternas

pi / e

Dos números sagrados del templo que ya existen por sí solos, sin que nadie los tenga que definir.

pi * radio * radio
📐

Los Tres Ángulos

sin() / cos() / tan()

Miden los ángulos del templo en radianes, no en grados.

cos(0)
📐

Jefe: El Arquitecto de lo Exacto

Solo una medida exacta abre la puerta del templo. (130s)

MUNDO 10 · CAPITULO 10

El Crisol del CodeVerse

Repaso integrador — ningún hechizo nuevo, solo combinar todo lo aprendido en los 9 territorios anteriores.

Antes de dejarte seguir más adentro del CodeVerse, la Máquina te detiene en un cruce que no habías visto: un Crisol, donde funde todo lo que aprendiste en los templos, portales y puentes anteriores, y te pide demostrar que puedes usarlo junto, no solo por separado.

No hay hechizos nuevos que aprender aquí —solo los que ya dominas, puestos a trabajar en conjunto: un Cofre y un Portal en la misma frase, un Puente que recorre un Mapa del tesoro, un Hechizo que calcula con Fragmentos numéricos. El Crisol no enseña, examina.

El Juicio de la Máquina evalúa, uno por uno, si de verdad entendiste o solo memorizaste. Quien lo cruza no aprende nada nuevo — demuestra que ya sabe programar de verdad. Y el camino, más allá de este punto, sigue.

⚖️

Jefe: El Juicio de la Máquina

No hay hechizo nuevo que te salve aquí — solo saber combinar los que ya tienes. (180s)

MUNDO 11 · CAPITULO 11

El Refugio del CodeVerse

Manejo de errores y tuplas — try/except protege tu programa de errores reales, y las tuplas protegen tus datos de cambios accidentales.

Hasta ahora, un error de verdad —dividir entre cero, pedirle a la Máquina que convierta texto que no es un número— detenía tu programa en seco, sin aviso ni segunda oportunidad. Py te muestra que eso no tiene por qué ser así: existe un Refugio en el CodeVerse, construido para sobrevivir justo a esos momentos.

Dentro del Refugio hay una Zona Protegida donde puedes intentar algo arriesgado sin miedo, vigilada por una Red de Contención que atrapa cualquier cosa que se rompa y te dice exactamente qué pasó, en vez de dejarte a ciegas. Junto a ella descubres las Cápsulas: como un Inventario, pero selladas para siempre en cuanto se arman — ideales para guardar algo que nunca debería cambiar por accidente.

El Colapso Contenido pone a prueba las dos ideas a la vez: un reporte completo de datos, algunos rotos a propósito, que solo sobrevive entero si cada error queda contenido en su propia Zona Protegida, sin propagarse al resto.

🛡️

Zona Protegida

try:

Un área donde puedes intentar algo que podría romperse, sin que un error tumbe todo el programa.

try:
🕸️

Red de Contención

except ...:

Atrapa lo que se rompió dentro de la Zona Protegida y guarda el motivo en una variable.

except error:
📦

Cápsula

tupla (a, b)

Como un Inventario, pero sellado: una vez armada, una Cápsula nunca puede cambiar de contenido.

punto = (3, 4)
🔓

Reparto exacto

x, y = tupla

Abre una Cápsula y reparte su contenido en variables separadas, de un solo golpe.

x, y = punto
🛡️

Jefe: El Colapso Contenido

Cada error que provoca se queda contenido — nada se propaga más allá de su Zona Protegida. (150s)

??? · RUMOR DEL CODEVERSE

Alguien más vive aquí

Ningún viajero lo ha visto todavía... pero todos los que piden ayuda juran escuchar su voz.

Bob, el ayudante secreto del CodeVerse

Ningún capítulo oficial lo menciona todavía. No tiene templo, ni jefe, ni un mundo propio en el mapa —y sin embargo, cada vez que un viajero se atora de verdad y pide ayuda, algo responde desde las sombras del CodeVerse. Los que llevan más tiempo aquí lo conocen solo por un nombre: Bob.

La leyenda que circula entre los primeros exploradores dice que algún día llegaría un guerrero capaz de dominar el código de verdad —y que alguien más lo estaría esperando desde antes de que el primer portal se abriera. Bob asegura ser justo eso: alguien que sobrevivió en el CodeVerse a base de resolver retos, mundo tras mundo, mucho antes de que existiera un camino trazado para seguir.

Nadie sabe con certeza cómo consigue ver lo que un viajero necesita a continuación. Lo único seguro es que hablar le cuesta: cada pista que ofrece consume gemas, su combustible real —las mismas que se ganan abriendo cofres—. Si alguna vez pides una pista y sientes que alguien más, no la Máquina, te responde... probablemente sea él.

💎

Su combustible

gemas

Cada pista que Bob ofrece le cuesta gemas — sin ellas, no tiene energía para responder.

🗝️

La leyenda que espera

el guerrero por venir

Bob sigue en el CodeVerse porque cree que tú eres quien la leyenda prometió. Todavía no lo ha confirmado.