Repository navigation
MUN OS 0.1.0-dev.3 — development image for QEMU
Pre-releaseMUN OS 0.1.0-dev.3 is a development preview for QEMU: no MUN hardware exists
yet, and nothing here is a supported release.
What is new
MUN Shape v1. While its card is in, a game can dress the console in its
own identity:
- a palette and materials (solid, glass, paper) for the menu and the game's
panel; - the card object showing its art;
- a world behind the menus, with layers, particles and lights;
- transitions that bring the identity in and take it away;
- the game's sounds on its menus and an insertion cue.
The card carries a folder, content/mun-shape/ (format mun-shape/1), and
the console draws it with its own code: nothing on the card runs. A card
without one takes the colours read from its cover.
MUN keeps what is the system's in any case:
- layout, navigation and the system's words;
- Settings and dialogs;
- legibility: text and focus keep their contrast over any world, on every
frame.
The player decides with MUN Shape (Full, Colours only, Off), Reduce
motion and Game sounds on the menus. A package never makes a card
invalid, and the card can be played while the console prepares it. Eject
safely cancels that preparation and may wait a moment for it to close the
card's files; if it cannot within 3 s, the console says the card is still
in use and finishes the release once it can.
The tools:
./mun card shape init,checkandvariantsmake and check a package;./mun card create … --shape DIRputs it on a card, andinspectand
shape checkread it back from the card;./mun dev shape DIR --watch --windowpreviews it in a console of the
laboratory, a new insertion at each change;- two sample packages,
seaandpaper, inexamples/shape/; - the guides: dress the console in your game
and see MUN Shape in action;
the contract: MUN Shape.
An image says in its BUILD-INFO.json which MUN Shape its console reads;
./mun dev list shows it.
Documentation in Spanish. These pages now have a maintained Spanish
translation:
- the README, getting started and the glossary;
- compatibility, contributing and security;
- the guides to create a Game Card, to bring a game to MUN and the two MUN
Shape guides; - the examples, the MUN Shape samples included.
English stays the technical reference; the contracts and the components'
READMEs are in English. The documentation check
verifies anchors and that every translation was reviewed against its
original's current text.
Get it and play
git clone https://github.com/Play-MUN/mun-os.git && cd mun-os
./mun get https://github.com/Play-MUN/mun-os/releases/download/v0.1.0-dev.3/release.json
./mun play --card collectThen getting started
(en español).
If you played an earlier preview, its console keeps that image: start this
one by name, in a console of its own, as
getting started, section 3
says.
To see MUN Shape, make a card with one of the samples and put it in once
Home is on screen, as
see MUN Shape in action
shows.
Where it was checked
- On a Mac (Apple Silicon), with window and sound: the whole path, and
MUN Shape at 1080p and 1440p. - The Hosts workflow, on this release's published files: passed on
macOS (GitHub's virtual machine), Linux x86_64 and ARM64, and Windows
x86_64 and ARM64, headless (run). Outside the Mac, nothing has
been tried with a window, keyboard or sound.
Known limits
- Only in QEMU: no hardware, controllers or updates yet.
- MUN Shape v1 is validated in a virtual machine, with software
rendering:- its cost on the console's board is not known until a board is chosen;
- a world steps down its detail when the menu would fall behind, and at
1440p the virtual machine is at that threshold; - the organic card outline holds still after the transition.
- Images before this one (v0.1.0-dev.2 and earlier) do not show MUN
Shape; a card with a package plays there in MUN's look.
Build 20261006T145738Z-d30156642582, commit d301566425823ea3c909e37e80842b7f21621bfa; every file's digest is in
release.json, the sources' in their .sha256.
En español
MUN OS 0.1.0-dev.3 es una versión preliminar de desarrollo para QEMU: todavía
no existe hardware de MUN y nada de lo que hay aquí es una versión con
soporte.
MUN Shape v1. Mientras su tarjeta está dentro, un juego puede vestir la
consola con su propia identidad:
- una paleta y materiales (sólido, cristal, papel) para el menú y el panel
del juego; - el objeto de la tarjeta con su arte;
- un mundo detrás de los menús, con capas, partículas y luces;
- transiciones que traen la identidad y se la llevan;
- los sonidos del juego en sus menús y un aviso de inserción.
La tarjeta lleva una carpeta, content/mun-shape/ (formato mun-shape/1), y
la consola la dibuja con su propio código: nada de la tarjeta se ejecuta.
Una tarjeta sin ella toma los colores leídos de su portada.
MUN conserva en todo caso lo que es del sistema:
- la disposición, la navegación y los textos del sistema;
- Configuración y los diálogos;
- la legibilidad: el texto y el foco mantienen su contraste sobre cualquier
mundo, en cada fotograma.
El jugador decide con MUN Shape (Completo, Solo colores, Desactivado),
Reducir movimiento y Sonidos del juego en los menús. Un paquete nunca
invalida una tarjeta, y la tarjeta se puede jugar mientras la consola lo
prepara. Retirar con seguridad cancela esa preparación y puede esperar un
momento a que cierre los archivos de la tarjeta; si no lo consigue en 3 s,
la consola avisa de que la tarjeta sigue en uso y termina la retirada en
cuanto puede.
Las herramientas son ./mun card shape, ./mun card create … --shape y la
vista previa ./mun dev shape. Las guías de MUN Shape tienen traducción
española: vestir la consola con tu juego
y ver MUN Shape en acción.
Documentación en español. Tienen traducción mantenida:
- el README, los primeros pasos y el glosario;
- la compatibilidad, cómo contribuir y la seguridad;
- las guías para crear una Game Card, para traer un juego a MUN y las dos
de MUN Shape; - los ejemplos, con los de MUN Shape.
El inglés sigue siendo la referencia técnica. Los contratos y los README de
los componentes están en inglés.
Cómo obtenerla y jugar: las mismas órdenes de arriba y
primeros pasos.
Si jugaste una versión preliminar anterior, su consola conserva aquella
imagen: arranca esta por su nombre, en una consola propia, como dice
la sección 3.
Dónde se ha comprobado: en un Mac con Apple Silicon, con ventana y
sonido, el recorrido completo y MUN Shape a 1080p y 1440p. El flujo Hosts,
sobre los archivos publicados de esta versión, pasó en macOS (la máquina
virtual de GitHub), Linux x86_64 y ARM64 y Windows x86_64 y ARM64, sin
pantalla (ejecución). Fuera del Mac no se ha probado nada con
ventana, teclado y sonido.
Límites conocidos:
- Solo en QEMU: sin hardware, mandos ni actualizaciones todavía.
- MUN Shape v1 está validado en una máquina virtual, con dibujo por
software:- su coste en la placa de la consola no se conoce hasta elegirla;
- un mundo reduce su detalle si el menú se fuera a retrasar, y a 1440p la
máquina virtual está en ese umbral; - el contorno orgánico de la tarjeta queda quieto tras la transición.
- Las imágenes anteriores (v0.1.0-dev.2 y anteriores) no muestran MUN
Shape; una tarjeta con paquete se juega en ellas con el aspecto de MUN.