MC-WEB
Minecraft 1.8 reimplementado desde cero en C++20 (sala limpia): nativo en Linux y Windows y en el navegador con WebAssembly + WebGL2.
MC-WEB
Minecraft 1.8 reimplementado desde cero en C++20, open source (MIT). Se compila de forma nativa para Linux y Windows y el mismo código funciona en el navegador (WebAssembly + WebGL2).
Una aldea en un mundo de semilla 12345, con las texturas originales de tu 1.8.8.jar (ver Cómo ver las texturas originales). Sin jar, el juego usa un pack libre (CC0) propio.
Capturas
Todas son del propio juego, sacadas con tu 1.8.8.jar y con las reglas de generación de 1.8 (la misma semilla da los mismos
biomas que Minecraft). Debajo está el comando exacto de cada una.
Las texturas que se ven en las capturas son de Minecraft (© Mojang) y están ahí solo para ilustrar el juego: no forman parte del código del repositorio ni de su licencia MIT.
![]() Aldea de llanura · semilla 12345 |
![]() Desierto con templo, aldea y cactus · 12345 |
![]() Jungla junto a un río · 12345 |
![]() Colinas extremas · 12345 |
![]() Mesa (badlands) junto a una playa helada · semilla 47 |
![]() Pinchos de hielo y un cantil · 47 |
![]() Isla de setas en mitad del océano · 47 |
![]() Supervivencia con su interfaz · 47 |
![]() Nether: roca del Nether, lava, fuego y piedra luminosa |
![]() El End: la isla, los pilares de obsidiana y el cielo estrellado |
![]() Pantalla final, al volver del End tras vencer al dragón |
![]() Mapa de biomas de 12345 (4000 x 4000 bloques; la cruz es el origen) |
Qué es (y qué no es)
MC-WEB es una reimplementación en sala limpia: el juego, el motor y el servidor están escritos desde cero usando Minecraft 1.8 como especificación. Se basa en el comportamiento observable del juego, en la documentación pública de minecraft.wiki y en los formatos de datos públicos (modelos JSON, NBT, Anvil y el protocolo de red 1.8).
- No contiene código de Mojang. No se usa código descompilado ni mappings, y nada de Eaglercraft.
- La generación de biomas y del relieve base sigue el algoritmo de 1.8, portado a C++ desde Cubiomes (MIT, © Cubitect), una reimplementación independiente: con la misma semilla da los mismos biomas que el juego original. Detalles y licencia en docs/THIRD_PARTY.md. Las cuevas, las menas, los árboles y el contenido de las estructuras son propios.
- No contiene assets de Mojang. Las texturas, la fuente y los sonidos se cargan en tiempo de
ejecución desde tu propio
1.8.8.jar. Si no lo tienes, el juego usa un pack libre (CC0) generado por código.
Las reglas completas están en CONTRIBUTING.md.
Estado
| Fase | Contenido | Estado |
|---|---|---|
| F0 | CMake, SDL3 + OpenGL 3.3 / WebGL2, Linux + Windows + web, tests, CI | ✅ |
| F1 | Ver el mundo: packs, modelos JSON, texture array, mallado en hilos, AO y luz suave, cielo, nubes, niebla, biomas y relieve con el algoritmo de 1.8 | ✅ |
| F2 | Jugar: físicas, romper/colocar, día/noche, servidor integrado con protocolo 1.8, fluidos que corren | ✅ |
| F3 | Supervivencia: vida, hambre, inventario, crafteo, horno, criaturas (más de 30), cría, armaduras, encantamientos, pociones, comercio, sonido, partículas | ✅ |
| F4 | Guardado en formato Anvil (compatible con mundos 1.8) | ✅ |
| F5 | Multijugador: otros MC-WEB y clientes y servidores 1.8 en modo offline, y servidor dedicado propio | ✅ (sin online-mode: ver docs/online-mode.md) |
| F6 | Redstone, Nether/End con dragón y pantalla final, opciones, empaquetado | 🟡 (todo menos el empaquetado de la v1.0.0) |
El detalle de lo que se hizo en cada tanda, lo que falta y lo que no se ha podido comprobar a mano está en docs/ESTADO.md.
Lo que ya funciona:
-
Carga de assets de Minecraft:
- En nativo busca solo
.minecraft/versions/1.8.x; en web eliges el jar y se guarda en IndexedDB. - Lee blockstates y modelos JSON con herencia, rotaciones,
uvlocky variantes con peso. - Mete todas las texturas en un texture array con mipmaps y aplica las animaciones de los
.mcmeta(agua, lava…). - Tiñe hierba y hojas con los colormaps de bioma.
- En nativo busca solo
-
Mundo infinito con las reglas de generación de 1.8 (detalles):
- Biomas: la pila de capas de 1.8 (continentes, zoom, clima, colinas, variantes "M", ríos y orillas), con los 39 de la lista de exploración (salvo el océano helado, que 1.8 no genera): océanos, playas, ríos —también helados—, llanuras, bosques, bosque oscuro, abedules, taigas, taiga gigante, tundra y pinchos de hielo, desierto, mesa con sus franjas de arcilla, sabana, jungla, pantanos, islas de hongos y montañas, con sus variantes de colinas y mutadas, cada uno con sus árboles (jungla gigante, roble oscuro, picea gigante...), plantas y criaturas. Una prueba comprueba que el mundo normal los da todos.
- Relieve: la misma función de densidad de 1.8 (ruido de Perlin con sus octavas, alturas base y variación por bioma, mezcla de los 5x5 biomas vecinos), así que las llanuras, colinas, montañas, cantiles y océanos tienen su forma.
- Cuevas y cavernas con lava en el fondo, y vetas de menas.
- Árboles, flores, hierba, cactus, caña de azúcar y nenúfares.
-
Luz de cielo y de bloque con propagación entre chunks y actualizaciones incrementales.
-
Render:
- Mallado en varios hilos, con luz suave y oclusión ambiental por vértice.
- Pasadas sólido, cutout y translúcido; agua con alturas por esquina.
- Cielo con sol, luna con fases, estrellas y amanecer; nubes y niebla.
-
Modos supervivencia y creativo:
- Físicas del jugador con las constantes de 1.8: andar a 4,317 bloques/s, correr, saltar 1,25 bloques, agacharse sin caerse por los bordes, nadar, escalones de 0,6 y daño por caída.
- En creativo: volar (dos veces espacio), romper al instante y todos los bloques en el inventario.
- Cambio de modo en el menú de pausa (Esc).
-
Romper y colocar con los tiempos de 1.8 (dureza, herramienta, bajo el agua, en el aire), grietas, contorno del bloque apuntado, drops (semillas, pedernal, manzanas, brotes…) y objetos que caen, giran y se recogen.
-
Colocación como en 1.8: troncos según la cara, antorchas en paredes, hornos mirando al jugador, plantas de dos bloques; las flores y antorchas sin soporte caen y la arena y la grava caen al quitar lo de debajo.
-
Inventario completo: barra rápida, inventario con rejilla de 2x2, mesa de trabajo (3x3, recetas con forma y sin forma de 1.8), horno con combustible y progreso. Clic, clic derecho (partir montón), mayús+clic (mover rápido) y tirar objetos (Q).
Inventario creativo: la pestaña de Combate, con una fila por armadura (con el pack libre). -
Inventario creativo con pestañas (como en 1.8): Bloques de construcción, Decoración, Redstone, Transporte, Varios, Alimentos, Herramientas, Combate, Pociones y Materiales, más el inventario de supervivencia (armadura, jugador, inventario y papelera) y la búsqueda. Cada grupo empieza en una fila nueva (una fila por tipo de herramienta, una por armadura, una por tinte...) y los libros encantados van a Combate o Herramientas según lo que encantan. Se desplaza con la rueda, arrastrando la barra o, en el móvil, con el dedo (con inercia). La búsqueda encuentra por nombre en español o en inglés, sin mayúsculas ni tildes y con varias palabras ("pico diam", "filo", "golden apple"); mientras se escribe, la tecla E no cierra el inventario. Recuerda la última pestaña que usaste.
-
Vida, hambre, saturación y aire, regeneración, comer (mantener clic derecho), durabilidad de herramientas, pantalla de muerte y reaparecer (se sueltan los objetos).
-
Experiencia: orbes que se mueven hacia ti y suben el nivel (barra y número encima de la barra rápida; 2n+7, 5n-38 y 9n-158 puntos por nivel). Dan experiencia los monstruos (5), los animales (1 a 3, las crías no), los minerales (carbón, lapislázuli, redstone, diamante, esmeralda y cuarzo), sacar cosas del horno y criar animales; al morir sueltas 7 puntos por nivel (hasta 100).
/xp <puntos>y/xp <niveles>L. Se ve y se recoge también en multijugador. -
Mesa de encantamientos: hasta 15 estanterías a su alrededor (a dos bloques, con el hueco libre) dan las tres opciones de la ventana, que piden 1, 2 y 3 lapislázuli y niveles; el coste sale de las estanterías y de una semilla propia de cada jugador, como en 1.8, y cada opción da una pista del encantamiento (Filo . . . ?) escrita en runas. Vale para herramientas, armas, armadura y libros (el libro encantado guarda un solo encantamiento). Sobre la mesa flota un libro que se abre y mira hacia ti al acercarte (a menos de 3 bloques) y pasa páginas. Funciona también en multijugador.
-
Efectos de los 25 encantamientos de 1.8: Protección (con los puntos de 1.8, tope de 25 y recorte a 20), contra el fuego, explosiones y proyectiles, Caída de pluma, Espinas, Respiración, Afinidad y Agilidad acuáticas; Filo, Pesadez, Perdición de los artrópodos, Retroceso, Aspecto ígneo y Botín; Eficiencia, Toque de seda, Fortuna e Irrompibilidad; Poder, Golpe, Llama e Infinidad. Lo encantado brilla con un destello morado (iconos, objetos en el suelo y en la mano). La lava y el fuego queman al jugador (el agua apaga).
-
Yunque (reparar y nombrar): repara con material (un cuarto de la durabilidad por unidad), junta dos objetos iguales, pasa los encantamientos de un libro (con sus incompatibilidades y su precio por rareza) y cambia el nombre; cada uso duplica la "penitencia" del objeto y a partir de 40 niveles sale "Demasiado caro". Se desgasta (12 % por uso) y acaba rompiéndose. Funciona en multijugador (también con clientes de 1.8: mineflayer renombra espadas en las pruebas de interoperabilidad).
-
Vagonetas y raíles: raíl normal (rectas, curvas y cuestas, se une solo a los de al lado), propulsor (la potencia pasa a 8 raíles más en fila), detector (da señal mientras haya una vagoneta encima) y activador (baja al jinete y enciende la dinamita). Vagoneta normal (se monta, la empuja quien va dentro y agacharse la deja), con cofre, con horno (carbón: se empuja sola, 4 bloques por segundo) y con dinamita (explota a los 4 s en un raíl activador, con mechero o al chocar rápido). Cinco golpes con el puño (uno con espada) la rompen; a 1000 bloques de donde te subiste, el logro "Sobre raíles". Se guardan en el mundo y funcionan en multijugador, también con clientes de 1.8 (Spawn Object 10, Attach Entity y Steer Vehicle).
-
Cerdo con silla: la silla se pone con clic derecho a un cerdo adulto; con ella se monta (agacharse baja) y, con la caña con zanahoria en la mano, va hacia donde mira quien lo monta. Al morir suelta la silla; caer de más de 5 bloques montado da "Cuando los cerdos vuelen". Se guarda y va por red.
-
Armadura (cuero, malla, hierro, oro y diamante): cuatro casillas en el inventario, se pone con clic derecho o mayús+clic, quita un 4 % del daño por punto (barra sobre la vida) y se desgasta con cada golpe; se ve sobre el jugador (también en multijugador). Las caídas, el ahogo y el hambre la ignoran (los encantamientos de protección, no todos), y al morir se suelta.
-
Criaturas: cerdo, vaca, oveja, gallina, zombi, esqueleto, creeper y araña, y las demás de 1.8 que hay (ver más abajo: lobo, ocelote, caballo, aldeano, golems, bruja, murciélago, calamar, champiñaca, conejo, guardián, y en el Nether y el End cerdo zombi, ghast, blaze, cubo de magma, enderman, dragón, Wither...).
- IA: los animales pasean, huyen si les pegas y siguen a quien lleva su comida (zanahoria, trigo, semillas); las ovejas comen hierba y se esquilan; las gallinas ponen huevos. Los zombis persiguen, las arañas trepan y saltan, los esqueletos disparan flechas y el creeper se enciende y explota.
- Cría de animales: trigo a vacas y ovejas, zanahorias a cerdos y semillas a gallinas los ponen en modo amor (corazones, 30 s); dos iguales cerca se buscan y, tras 60 ticks juntos, tienen una cría que mide la mitad, sigue a los adultos y crece en 20 min (la comida le quita el 10 % de lo que le falta). Los padres esperan 5 min. Criar vacas da el logro Repoblación. También se ven en multijugador (cría con la edad de 1.8 y corazones).
- Aparecen como en 1.8: animales al generarse el mundo (con un 5 % de crías); monstruos de noche o en cuevas oscuras. Zombis y esqueletos arden al sol.
- Combate con el daño de cada arma de 1.8, críticos, retroceso y botín (chuletas, cuero, lana, plumas, huesos, pólvora, hilo...).
- Arco y flechas: mantén el clic derecho para tensarlo (1 s = a tope, con el zoom y el frenado de 1.8) y suelta para disparar; la potencia, el daño (y el crítico a plena potencia), la caída de la flecha y la dispersión son los de 1.8. Gasta una flecha y 1 de durabilidad (nada de eso en creativo), y las flechas clavadas se recogen. En táctil, mantén el dedo. Abatir a un esqueleto desde 50 bloques da el logro Francotirador.
- Modelos propios hechos a partir de la disposición estándar de las texturas: con tu jar se ven con sus texturas originales; sin él, con las del pack libre.
-
Sonido sintetizado: romper y pisar según el material, criaturas, explosiones, arco, comer... Se genera todo al arrancar (1.8 no trae los sonidos en el jar), con sonido posicional.
-
Partículas: trozos de bloque al romper, polvo al correr, humo, chispas de crítico, llamas.
-
Ajustes (Esc → Ajustes), con páginas y se guardan:
- Gráficos: calidad (baja/media/alta/ultra), distancia hasta 32 chunks, resolución 3D, FPS máximos, VSync, campo de visión, brillo, luz suave, hojas detalladas o rápidas, nubes, niebla, mipmaps, partículas, distancia de las criaturas y balanceo al andar.
- Música y sonidos: volumen general, música (piano generativo), bloques, criaturas, jugador, interfaz y subtítulos.
- Controles: sensibilidad, invertir ratón, correr/agacharse manteniendo o alternando, salto automático, y en táctil: puntería (mira central o tocar para apuntar), sensibilidad, suavizado de la cámara, joystick fijo (el de serie: no se mueve nunca) o flotante (nace donde pones el pulgar y ahí se queda), con zona muerta y curva, botones de atacar y usar, modo zurdo, vibración, tamaño y opacidad de los botones, y un editor para colocar los botones y el joystick donde quieras (arrastrar y soltar también en los inventarios). Teclas: todas se pueden cambiar.
- Partida: modo, dificultad (pacífica, fácil, normal, difícil, como en 1.8), ciclo de día y noche, hora, aparición de criaturas y conservar el inventario.
- Interfaz: escala, cámara en primera o tercera persona, mano, punto de mira, FPS, coordenadas y subtítulos.
-
Pantalla de depuración (F3) con la fuente del juego.
Más cosas del juego
Todo esto está hecho y probado (los detalles y lo que no se ha podido comprobar a mano, en docs/ESTADO.md):
- Nether y End: portales (obsidiana y mechero; el del End con ojos de ender), generador propio del Nether (fortín, lava, roca del Nether, arena de almas) y del End, ghast, blaze, cerdo zombi, cubo de magma, esqueleto atrofiado, enderman, endermita, el dragón del End con sus cristales y el Wither (montaje en T, carga, bola de calaveras, barra de jefe). Las camas explotan allí. Fortines (strongholds) con portal del End. Al volver del End tras vencer al dragón sale una pantalla final con los créditos (una sola vez por jugador).
- Estructuras: aldeas (con aldeanos y gólems), templo del desierto con su trampa, templo de la jungla, cabañas de brujas, pozos del desierto, minas abandonadas, mazmorras y el monumento oceánico (58x58, con tesoro de oro, esponjas húmedas, linternas marinas, tres guardianes ancianos y diez guardianes).
- Guardián y guardián anciano: rayo que tarda 4 s en cargarse, púas que devuelven el golpe y fatiga de minado.
- Comercio con aldeanos (oficios y ofertas por niveles), pesca (botín de 1.8, Cebo y Suerte marina).
- Pociones: atril de pociones, caldero, pociones arrojadizas, efectos de estado.
- Redstone: polvo, antorchas, palancas, botones, placas, repetidores, comparadores, pistones, lámparas, tolvas, dispensadores, soltadores, bloques musicales y tocadiscos.
- Fluidos y fuego: agua y lava que corren (fuentes infinitas, obsidiana), fuego que se propaga, hielo y nieve que se derriten, brotes y cultivos que crecen, setas, hierba y micelio que se extienden.
- Tiempo: lluvia, tormenta, nieve y rayos.
- Decoración: marcos (con objetos y mapas), cuadros, soportes para armadura, carteles, estandartes y cabezas.
- Faro (pirámide de hasta 4 niveles, poderes, rayo teñido), fuegos artificiales (estrellas con forma, colores, desvanecimiento, centelleo y estela; cohetes que hieren si llevan estrellas) y mapas (se pintan solos alrededor de quien los lleva, se copian y se alejan por receta).
- Logros de 1.8 (también para los invitados, con su aviso por el chat y "¡Diamantes para ti!") y estadísticas.
Rendimiento
- Tantos FPS como dé la pantalla: 60, 120, 144 Hz... El juego va por ticks (20 por segundo) e interpola, así que la animación es fluida a cualquier frecuencia.
- Todos los núcleos, también en el navegador: en web, la generación del mundo y el mallado van a varios Web Workers (sin necesidad de COOP/COEP); en nativo, a hilos.
- Pocas llamadas a la GPU: las mallas de todo el terreno viven en unos pocos buffers grandes y se
dibujan con una llamada por buffer (multi-draw; en el navegador, con
WEBGL_multi_draw), en vez de cientos de llamadas por frame. Cambiar un bloque solo vuelve a subir su sección. - Solo se dibuja lo que se ve: además del recorte por la pirámide de visión, una oclusión por grafo de visibilidad deja fuera lo que tapa la roca (en una cueva, un 90 % menos de geometría), y el pase de bloques sólidos no descarta fragmentos (en las GPU de móvil evita pintar dos veces lo que otro tapa).
- Rendimiento automático: en Ajustes > Gráficos eliges los fps que quieres mantener (30 a 144) y el
juego baja la resolución del mundo y la distancia de render cuando no llega, y las recupera cuando
sobra (activado a 60 en el navegador;
--auto-fps Nen nativo). - Hilo principal ligero: lo que llega de los workers se sube a la GPU con un presupuesto por frame (una cuarta parte del frame).
- La GPU potente: el
.exede Windows y la página web piden la tarjeta dedicada en portátiles con dos GPU (NvOptimusEnablement,AmdPowerXpressRequestHighPerformanceypowerPreference: 'high-performance'). En Linux, lanza el juego conDRI_PRIME=1(AMD e Intel) o con__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia(NVIDIA). - Optimización entre archivos (LTO) en las compilaciones Release del código propio (
-DMCWEB_LTO=OFFla desactiva). - Medir: F3 enseña los fps, la CPU por fase del frame (red, carga, tick, cielo, terreno, entidades...), el
tiempo de GPU donde el sistema lo permita, las llamadas de dibujo y los quads.
--log-perflo escribe cada segundo;--bench N [--bench-spin]mide con la cámara dando vueltas y sale;tools/bench/render-bench.shhace la tabla de dos escenas (superficie y cueva).mcweb-benchmide lo que cuesta generar y mallar. Los números y lo conseguido están endocs/rendimiento.md.
iPhone con pantalla de 120 Hz (ProMotion): Safari limita las páginas a 60 Hz. Para jugar a 120 Hz, desactiva Prefer Page Rendering Updates near 60fps en Ajustes → Apps → Safari → Avanzado → Feature Flags. La página te dice a cuántos Hz va tu pantalla.
Jugar
Linux / Windows
Descarga el ejecutable de los artefactos de la CI o compílalo (ver abajo). Si tienes Minecraft instalado y has abierto la 1.8.8 al menos una vez, el juego encuentra el jar solo. Si no, pásaselo:
./mcweb --jar /ruta/a/1.8.8.jar
Para entrar directamente en un mundo: ./mcweb --seed 12345 (un número, o un texto: da lo mismo que en el juego, el
String.hashCode() de Java), --mode creative, --pos X,Y,Z --yaw G --pitch G (grados; el pitch negativo mira hacia abajo y el
yaw 0 hacia el norte), --rd 12 (distancia de visión), --time 6000 --freeze-time, --debug, --help.
Cómo ver las texturas originales (con tu jar)
El repositorio no lleva ni una textura, sonido ni modelo de Mojang: el juego los lee en ejecución de tu 1.8.8.jar. Para que se
vea igual que en las capturas:
- Compila (más abajo, Compilar). En Linux:
El ejecutable queda encmake --preset linux-release cmake --build --preset linux-releasebuild/linux-release/apps/mcweb/mcweb. - Consigue el jar de la 1.8.8. Lo normal es abrir la 1.8.8 una vez desde el launcher oficial de Minecraft: deja
~/.minecraft/versions/1.8.8/1.8.8.jar(en Windows,%APPDATA%\.minecraft\versions\1.8.8\1.8.8.jar). Si no lo tienes, el juego puede bajarlo solo de los servidores de Mojang (para uso personal) cuando arrancas sin--sin-red. - Arranca. Si el jar está en esa ruta, el juego lo encuentra solo; si no, díselo con
--jar:
En la consola sale./build/linux-release/apps/mcweb/mcweb --seed 12345 ./build/linux-release/apps/mcweb/mcweb --jar /ruta/a/1.8.8.jar --seed 12345usando los assets de .../1.8.8.jar; si sale que usa el pack libre, no ha encontrado el jar.--cc0fuerza el pack libre y--sin-redimpide la descarga. - En el navegador (
python3 web/serve.py build/web/apps/mcweb), al abrir la página eliges tu1.8.8.jar; se guarda en el navegador para la próxima vez.
Para sacar las mismas capturas (ventana de 1600x900; --fixed-cam deja la cámara quieta, sin interfaz y sin criaturas, y
--mode creative evita caer y morir):
mcweb --seed 12345 --mode creative --time 6000 --freeze-time --fixed-cam --size 1600x900 --rd 14 \
--pos -744,95,-340 --yaw 0 --pitch -25 --screenshot aldea.png --screenshot-delay 13 --exit
| Captura | Cambia en el comando anterior |
|---|---|
| Desierto | --pos 1350,92,-1130 --pitch -22 |
| Jungla | --pos 848,100,-1690 --pitch -20 |
| Colinas extremas | --pos -4,118,150 --pitch -12 |
| Mesa | --seed 47 --pos 1240,120,130 --pitch -20 |
| Pinchos de hielo | --seed 47 --pos 784,100,330 --pitch -22 |
| Isla de setas | --seed 47 --pos 1008,112,1840 --pitch -18 |
| Supervivencia | --seed 47 --mode survival (sin --fixed-cam ni --pos) |
| Nether / End | --demo cmds:archivo.txt --fixed-cam --pos 20,68,20 (Nether) o --pos 100,52,0 --yaw 90 (End), con /dim nether o /dim end en el archivo |
| Créditos | --demo creditos --screenshot-delay 9 |
El mundo y su semilla
La generación de biomas y del relieve base sigue el algoritmo de 1.8: la pila de capas, el ruido de superficie, las alturas por
bioma y las reglas que fijan dónde caen las estructuras (una prueba por región de 32x32 chunks para aldeas, templos y cabañas de
bruja, 32x32 con reparto triangular para los monumentos, minas, los 3 fortines del primer anillo, los fortines del Nether por regiones
de 16x16 y el punto de aparición). Está portado a C++ desde Cubiomes (MIT; ver
docs/THIRD_PARTY.md) y se comprueba con su prueba de referencia: con la misma semilla salen los mismos biomas
(tests/test_legacy_gen.cpp, 4096 semillas en cada ejecución y un millón con --no-skip).
No es idéntico a Minecraft en lo que Cubiomes no cubre y es propio de este proyecto: las cuevas y barrancos, las menas, los árboles y plantas, la capa de hierba, tierra y arena del suelo, el contenido de cada estructura (casas de la aldea, templos, monumento...) y los voladizos del relieve (aquí el terreno es un mapa de alturas). Por eso una semilla da los mismos biomas y casi la misma forma del terreno que en el juego, pero no las mismas cuevas ni los mismos árboles.
Navegador
python3 web/serve.py build/web/apps/mcweb # abre http://localhost:8080
El servidor añade las cabeceras COOP/COEP que necesitan los hilos (SharedArrayBuffer).
Si la página se sirve sin esas cabeceras (GitHub Pages, cualquier hosting estático), carga sola
la variante sin hilos (mcweb-st.js): va igual, pero carga el mundo algo más despacio.
Al abrir la página eliges tu 1.8.8.jar (o juegas con el pack libre).
Móvil y tablet
En pantallas táctiles la página activa sola los controles táctiles, con una mira en el centro (al estilo de la edición de bolsillo, pero con la mira central de los juegos de móvil modernos):
- Joystick (a la izquierda; aparece donde pongas el pulgar y su base sigue al dedo): moverse. A tope hacia delante, corres, y sigues corriendo aunque aflojes un poco; al volver al centro, paras. Zona muerta y curva ajustables.
- ▲ (abajo a la derecha): saltar. Dos toques seguidos en creativo: volar; manteniéndolo, subir.
- ▼: agacharse (un toque lo deja puesto, mantenerlo agacha solo mientras se aprieta). Volando: bajar.
- Espada: golpear y romper (mantenida). Bloque: colocar, usar, comer o tensar el arco (mantenido).
- Arrastrar en el resto de la pantalla: mirar. El giro se aplica en cada frame, sin perder lo que recorre el dedo al empezar.
- Tocar: usar o colocar donde apunta la mira (abrir mesa de trabajo u horno); sobre una criatura, golpearla (con tijeras, esquilar ovejas).
- Mantener el dedo quieto: romper, sin soltarlo se puede seguir girando. Con comida en la mano: comer.
- Barra rápida: tocar o deslizar el dedo sobre ella elige casilla. El botón junto a la barra abre el inventario.
- Arriba a la derecha: soltar (un toque suelta uno, mantener suelta toda la pila), cámara (primera o tercera persona), chat y pausa.
- Otros modos: "tocar para apuntar" (el dedo apunta al bloque y no hay mira ni botones de atacar y usar), modo zurdo (todo se refleja), botones más grandes o más claros, y vibración en Android.
- En los inventarios: tocar = clic, mantener = clic derecho, arrastrar = desplazar la lista del creativo (sigue deslizándose al soltar; tocar la frena), tocar las pestañas o arrastrar su barra, ✕ para cerrar. En la pestaña de búsqueda, tocar el campo saca el teclado. La página pide pantalla completa y apaisado, y mantiene la pantalla encendida mientras juegas.
Funcionan también en portátiles táctiles con Windows o Linux (y se fuerzan con --touch).
Para usar tus texturas en el móvil, copia el 1.8.8.jar a iCloud Drive, Google Drive o la
carpeta de descargas y elígelo en la página.
Controles
| Tecla | Acción |
|---|---|
| Clic | Capturar el ratón |
| WASD / ratón | Moverse / mirar |
| Espacio | Saltar (dos veces seguidas: volar en creativo) |
| Mayús | Agacharse (volando: bajar) |
| W dos veces / Ctrl | Correr |
| Clic izquierdo | Romper (mantener) · golpear criaturas |
| Clic derecho | Colocar, usar, comer, esquilar (tijeras) |
| Clic central | Coger el bloque apuntado (creativo) |
| 1–9 / rueda | Casilla de la barra rápida |
| E | Inventario (en creativo: pestañas; el campo de búsqueda escribe, Esc cierra) |
| Q / Ctrl+Q | Tirar un objeto / el montón |
| Esc | Menú de pausa y Ajustes (también en el navegador) |
| F5 | Cámara: primera persona, detrás, delante |
| F1 | Ocultar la interfaz |
| F3 | Pantalla de depuración |
| RePág / AvPág | Distancia de render |
| F2 | Captura de pantalla |
| F11 | Pantalla completa |
Opciones de línea de comandos: mcweb --help (por ejemplo --mode creative). En web se pasan
como parámetros de la URL, por ejemplo index.html?seed=1234&rd=10&mode=creative; la página
también tiene un selector de modo.
Skins
En el menú principal, Skins: elige una de serie (Steve y Alex, que salen del paquete de texturas activo) o sube tu PNG de 64x64 o 64x32. El personaje se ve girando y la skin queda elegida al momento; Capas... enciende o apaga el sombrero, la chaqueta, las mangas y las perneras, como la pantalla de personalizar skin de 1.8.
- Las skins de 64x32 (las antiguas) se convierten solas, y los brazos finos (el modelo Alex) se detectan al subirlas; se pueden cambiar con el botón Brazos.
- Tus skins se guardan en la carpeta
skins/de los datos de usuario (en la web, en el navegador). También vale copiar ahí un PNG a mano. - En multijugador, los jugadores de MC-WEB ven tu skin: se manda por un canal propio
(
MCWEB|Skin) que solo se usa con servidores de MC-WEB. Un servidor de Minecraft 1.8 normal no recibe nada de eso (y no tiene cómo pasar skins que no estén en los servidores de Mojang). Quien no manda skin se ve con Steve o Alex según su UUID, como en 1.8.
Multijugador
MC-WEB habla el protocolo de Minecraft 1.8 (versión 47) en modo offline: se puede jugar con otros MC-WEB y con el Minecraft 1.8 oficial.
-
Abrir en LAN (menú de pausa, versión de escritorio): tu partida se convierte en servidor. Se anuncia en la red local, como en 1.8, y la pantalla te dice la dirección para compartir. Los invitados se guardan con el mundo (
playerdata/). -
Multijugador (menú principal): servidores guardados con su ping, partidas de la LAN, conexión directa y tu nombre de jugador.
-
Servidor dedicado (
mcweb-server, sin ventana): leeserver.properties(puerto, MOTD, modo, dificultad, semilla, tipo de mundo, distancia de visión, lista blanca). Tiene consola conhelp,list,say,kick,time,whitelist,save-allystop.mcweb-server --dir mi-servidor # crea mi-servidor/server.properties y el mundo -
Desde el navegador: la web no puede abrir conexiones TCP, así que usa el puente
mcweb-wsproxy. Arráncalo en tu equipo y, en Multijugador, ponws://localhost:25500como proxy (es el valor por defecto).mcweb-wsproxy # ws://127.0.0.1:25500, solo este equipo mcweb-wsproxy --listen 0.0.0.0:25500 --allow mi.servidor.org:25565 # para otros, limitado
También van por red los logros de cada invitado, los mapas, los proyectiles que lanzan (bolas de nieve, huevos, perlas de ender, pociones...), los cohetes y los guardianes.
Límites: los portales y las dimensiones no funcionan con la partida abierta a LAN ni en el servidor dedicado (todo
el mundo comparte la misma dimensión); las cuentas premium (servidores con online-mode=true) no están soportadas,
porque necesitan un client ID de Azure aprobado por Mojang que solo puede conseguir quien publica el juego
(ver docs/online-mode.md).
Límites conocidos
- Sin
online-modeni dimensiones en servidor (arriba). - Ni el monumento ni el templo de la jungla tienen sus trampas (falta el cable de trampa).
- El mundo tiene los biomas, el relieve base y las posiciones de estructuras de 1.8, pero no las cuevas, menas, árboles ni el interior de las estructuras (ver El mundo y su semilla). El océano helado no sale de las capas de 1.8, y el logro "Aventurero" lo sigue pidiendo.
- Los guardianes no tienen sonidos propios y los fuegos artificiales usan el de explosión.
- Mapas: sin marcadores de otros jugadores ni de marcos, y el mapa en la mano se ve en una esquina de la pantalla (no como en 1.8).
- En el navegador no se pueden abrir conexiones TCP (hace falta
mcweb-wsproxy) y los sonidos oficiales se descargan aparte.
Recursos oficiales de Minecraft (automático)
El proyecto no incluye nada de Mojang. En escritorio, al arrancar sin --jar ni --cc0, el juego usa por orden: el jar de
tu instalación de Minecraft (.minecraft/versions/1.8.*), el que ya descargó antes (<datos del juego>/assets/1.8.8.jar) y,
si hay red, descarga el cliente oficial 1.8.8 de los servidores de Mojang (por HTTPS con el certificado comprobado y su
huella SHA-1 verificada). Sin red o si falla, usa el pack libre (CC0). --sin-red evita la descarga. Esos recursos son de Mojang y
están sujetos a su EULA; los descarga quien juega, para uso personal. Los sonidos oficiales (.ogg) también se bajan,
en segundo plano, solo los que usa el juego (unos 1,5 MB, la primera vez tarda unos 20 s; mientras tanto suenan los sintetizados). En la web, el botón «Jugar en automático» hace lo mismo.
Compilar
Necesitas CMake ≥ 3.25, Ninja y un compilador de C++20. Las dependencias se descargan solas y quedan fijadas a una versión: SDL3, glm, miniz, nlohmann/json, stb y doctest.
# Linux (dependencias de sistema de SDL3: ver .github/workflows/ci.yml)
cmake --preset linux-release && cmake --build --preset linux-release
ctest --preset linux-release
# Windows (Visual Studio 2022)
cmake --preset windows-msvc && cmake --build --preset windows-msvc
# Windows desde Linux (MinGW-w64)
cmake --preset windows-mingw && cmake --build --preset windows-mingw
# Web (con emsdk activado: source emsdk/emsdk_env.sh)
cmake --preset web && cmake --build --preset web
Para validar las tablas contra tus assets reales, descomprime assets/ de tu jar fuera del
repo y ejecuta los tests con MCWEB_ASSETS_DIR=/esa/carpeta.
Arquitectura
src/core buffers/VarInt, zip, hilos, rutas, log
src/data bloques, ítems, recetas, herramientas, drops, formas de colisión, biomas y el mapa
estado→blockstate de 1.8 (tablas de minecraft-data, MIT)
src/world chunks, ruido, generador de terreno, motor de luz
src/assets packs (jar/zip/carpeta/CC0), modelos JSON de bloques e ítems, texturas, pack libre generado
src/game reglas del juego sin gráficos: jugador y físicas, criaturas e IA, combate, explosiones,
inventario, menús, crafteo, horno, romper/colocar, drops (probado con tests)
src/save NBT, regiones Anvil, level.dat, playerdata y estadísticas (formato de 1.8)
src/net protocolo 1.8 (47): tramas, chunks, cliente, servidor, sockets, LAN, WebSocket
src/client mallador, renderer (GL 3.3 / WebGL2), modelos de criaturas, partículas, sonido
sintetizado, cielo, HUD e inventarios, menús, opciones, controles táctiles, Web Workers
apps/worker módulo de los Web Workers del build web (genera y malla sin gráficos)
apps/bench medidor de rendimiento de la carga del mundo
apps/mcweb punto de entrada (SDL3 main callbacks)
apps/mcweb-server servidor dedicado sin ventana
apps/mcweb-wsproxy puente WebSocket <-> TCP para jugar en servidores desde la web
web/ página del build web y servidor local
Licencia
MIT. Minecraft es una marca de Mojang AB; este proyecto no está afiliado ni respaldado por Mojang ni por Microsoft.










