Empieza a programar en Bloxd.io: prueba primero la lógica del juego

16 nov 2026 6 min

Aprende por dónde empezar con el código de Bloxd.io y crea una pequeña lógica de rondas en JavaScript antes de conectarla a las API del juego.

En Bloxd.io puedes escribir JavaScript que se ejecuta dentro del juego: desde hacer que un bloque lance a un jugador por los aires hasta crear una tienda o un juego con rondas y equipos. Para empezar, la documentación recomienda visitar Getting started, que explica los bloques de código, los boards y World Code, además de dónde se ejecuta cada uno.

Para practicar las reglas de un juego, construiremos una lógica de rondas en JavaScript estándar, ejecutable por sí sola. Después, podrás consultar Getting started y la referencia de la API para aprender a conectarla a jugadores y eventos de Bloxd.

Preparar el primer experimento

Abre la documentación de Bloxd.io y empieza por Getting started. Después, revisa Snippets: la página recomienda copiar un ejemplo en un bloque de código y cambiarlo para observar el resultado. La referencia de la API permite buscar métodos, y el buscador se abre con Ctrl K o ⌘ K en Mac.

Para los ejemplos de este artículo, guarda el código en un archivo llamado rondas.js y ejecútalo con un entorno JavaScript que tengas disponible. Estos bloques no llaman a la API de Bloxd: son ejercicios autocontenidos para definir y comprobar reglas. No los pegues en World Code esperando que controlen el mundo; para eso hay que adaptar la lógica a las funciones documentadas.

1. Definir participantes y equipos

Empezaremos con dos equipos representados por arrays de nombres. La función devuelve una lista sencilla de participantes; luego podremos reutilizarla para calcular puntuaciones y decidir un ganador.

// Guarda como rondas.js y ejecuta con un entorno JavaScript.
function crearEquipos() {
  return {
    Sol: ["Ari", "Noa"],
    Luna: ["Kai", "Uma"]
  };
}

const equipos = crearEquipos();
console.log(equipos);

Las etiquetas y los nombres son datos de ejemplo, no jugadores de Bloxd. En un juego real, la documentación de Bloxd debe indicar cómo obtener la lista de jugadores y asignarlos a equipos. Mantener esa diferencia clara evita confundir un prototipo de reglas con una integración ya funcional.

Empieza a programar en Bloxd.io: prueba primero la lógica del juego
Imagen generada con IA

2. Llevar la puntuación

A continuación, creamos una tabla de puntos y una función que suma una cantidad a un equipo. La comprobación impide escribir accidentalmente una puntuación para un nombre que no exista en la tabla.

const puntuacion = {
  Sol: 0,
  Luna: 0
};

function sumarPunto(equipo, cantidad = 1) {
  if (!Object.hasOwn(puntuacion, equipo)) {
    throw new Error(`Equipo desconocido: ${equipo}`);
  }
  if (!Number.isInteger(cantidad) || cantidad < 0) {
    throw new Error("La cantidad debe ser un entero no negativo");
  }
  puntuacion[equipo] += cantidad;
  return puntuacion[equipo];
}

sumarPunto("Sol");
sumarPunto("Luna", 2);
console.log(puntuacion);

La función acepta puntos enteros y no negativos. Si la regla de tu juego permite penalizaciones, habría que cambiar esa condición de forma deliberada, no retirar la validación sin más. En Bloxd, el evento que concede puntos —por ejemplo, una acción de jugador— tendría que proceder de un callback documentado.

3. Resolver el final de una ronda

El siguiente paso compara los resultados y devuelve un estado para la ronda. Si hay empate, no elige un ganador por orden ni por azar: informa del empate para que el diseño del juego decida qué hacer después.

function resolverRonda(puntos) {
  const equipos = Object.keys(puntos);
  if (equipos.length === 0) {
    throw new Error("Hace falta al menos un equipo");
  }

  const mejorPuntuacion = Math.max(...Object.values(puntos));
  const lideres = equipos.filter(
    equipo => puntos[equipo] === mejorPuntuacion
  );

  if (lideres.length > 1) {
    return { estado: "empate", equipos: lideres, puntos: mejorPuntuacion };
  }

  return { estado: "ganador", equipo: lideres[0], puntos: mejorPuntuacion };
}

console.log(resolverRonda(puntuacion));

Con los valores del paso anterior, Luna queda por delante. Si ambos equipos terminan igualados, la función devuelve un resultado de empate explícito. Esa salida facilita añadir después una regla propia, como iniciar otra ronda; no presupone cómo Bloxd gestiona el final de una partida.

4. Simular una ronda completa

Ahora juntamos los pasos en una función que crea una partida, suma puntos y devuelve el resultado. La simulación utiliza valores fijos, así que siempre produce la misma salida: es útil para comprobar la lógica sin depender de eventos ni de una partida en línea.

function simularRonda() {
  const puntos = { Sol: 0, Luna: 0 };

  puntos.Sol += 1;
  puntos.Luna += 2;
  puntos.Sol += 1;

  return {
    puntuacion: puntos,
    resultado: resolverRonda(puntos)
  };
}

console.log(simularRonda());

La secuencia de la prueba queda fijada en el código: Sol suma dos puntos y Luna suma dos. Por tanto, el resultado debe ser un empate. Una prueba repetible ayuda a localizar errores antes de sustituir esos incrementos manuales por acciones reales del juego.

5. Probar los casos límite

Antes de conectar nada al mundo, prueba tanto una victoria como un empate y verifica que un equipo inexistente provoca un error. Este último bloque ejecuta comprobaciones con JavaScript estándar; si alguna condición falla, detiene el programa con una explicación.

function comprobar(condicion, mensaje) {
  if (!condicion) {
    throw new Error(`Fallo: ${mensaje}`);
  }
}

const victoria = resolverRonda({ Sol: 3, Luna: 1 });
comprobar(victoria.estado === "ganador", "debe haber un ganador");
comprobar(victoria.equipo === "Sol", "Sol debe ganar la prueba");

const empate = resolverRonda({ Sol: 2, Luna: 2 });
comprobar(empate.estado === "empate", "debe detectar el empate");

let rechazoEquipo = false;
try {
  sumarPunto("Estrellas");
} catch (error) {
  rechazoEquipo = error instanceof Error;
}
comprobar(rechazoEquipo, "debe rechazar equipos desconocidos");

console.log("Todas las comprobaciones han pasado.");
Empieza a programar en Bloxd.io: prueba primero la lógica del juego
Imagen generada con IA

Errores habituales al llevarlo a Bloxd

El fallo más fácil de cometer es tratar este prototipo como código de World Code. No contiene llamadas a la API de Bloxd ni callbacks; solo define y prueba reglas en JavaScript. La documentación indica que los callbacks permiten reaccionar a acciones como entrar, chatear o romper bloques, pero hay que consultar la referencia para conocer sus nombres y cómo se usan.

También conviene no asumir que cualquier nombre escrito en el código representa un jugador real, o que un método estándar de JavaScript es un método de Bloxd. Consulta Getting started para distinguir dónde se ejecuta cada herramienta y busca en la API los métodos que necesites. Los Snippets ofrecen ejemplos que puedes copiar y modificar; el Changelog recoge cambios del Code API.

La documentación también dirige a Discord para hacer preguntas, informar de problemas y sugerir funciones. Con la lógica de puntuación ya separada, el siguiente paso es encontrar en la API cómo leer a los jugadores y responder a los eventos de la partida, sin inventar nombres de métodos.

Fuente: Bloxd.io