mojontwins / MK1

MT Engine MK1 para ZX Spectrum (La Churrera)
GNU General Public License v2.0
65 stars 11 forks source link

MTE MK1 (la Churrera)

MTE MK1 (más conocido como la Churrera) es un framework compuesto por un motor modular programado en C y ensamble, y un conjunto de herramientas para hacer juegos para ZX Spectrum. MTE MK1 compila con z88dk 1.10 (incluido) y emplea una versión modificada de la biblioteca splib2 de Alvin Albrecht.

El motor ha ido evolucionando desde 2010 y fue abandonado a principios de 2014 cuando evolucionó para convertirse en MTE MK2. Con motivo del décimo aniversario en 2020, se retomó el proyecto, actualizando, corrigiendo o reescribiendo distintas partes del motor y del toolchain.

How to Build

Descarga la última release estable de la v5 de la carpeta "releases".

El motor/framework reside en /src. El código, tal y como está, genera un juego mínimo por defecto que debes reemplazar con el tuyo. Para compilarlo, sigue los siguientes pasos:

Instalación de z88dk

Nightly Build

  1. Obtén la última versión de z88dk (nightly build) desde https://github.com/z88dk/z88dk e instálala.
  2. Descomprime la versión de splib2 que encontrarás en env/ en una ubicación temporal, y posteriormente mueve spritepack.h al subdirectorio include de z88dk (por ejemplo, c:/z88dk/include) y splib2_mk2.lib al subdirectorio lib/clibs de z88dk (por ejemplo, c:/z88dk/lib/clibs/).

Versión incluida

Si lo prefieres, puedes usar el z88dk incluid en env/, que ya viene con splib2 instalada. Para ello, descomprime el contenido de env/z88dk_mt.7z en C:\.

Construyendo el proyecto por defecto

  1. Si has instalado z88dk en una ubicación diferente de c:/z88dk/ tendrás que modificar src/dev/setenv.bat.
  2. Desde una ventana de línea de comandos, entra en src/dev y ejecuta los siguientes comandos:
    $ setenv.bat
    $ compile.bat

El primer comando establece las variables de entorno necesarias. El segundo construye y compila el juego de ejemplo.

Documentación

Puedes encontrar documentación y un tutorial en el directorio docs.

Evolución

Por nuestra parte es posible que el motor sólo reciba correcciones, pero los pull request son muy bienvenidos.

Créditos

MTE MK1 ha sido diseñado y desarrollado por los Mojon Twins y utiliza:

Licencia

La Churrera es copyleft The Mojon Twins y se distribuye bajo una licencia LGPL. Puedes hacer juegos como quieras, pero acuérdate de añadir el logo en un lugar visible, que así salimos beneficiados todos:

Logo MTE MK1

Pero si quieres hacer un juego con el motor entenderemos que quieras hacer copias físicas en cinta o en cualquier otro medio. En ese caso sólo tienes que avisarnos, que nos gusta saber estas cosas.

Los juegos de ejemplo contenidos en /examples son propiedad de Mojon Twins y no pueden ser reproducidos en formato físico sin llegar a un acuerdo con nosotros.

Los juegos realizados por otros desarrolladores contenidos en /contrib son propiedad de sus respectivos desarrolladores y los derechos quedan reservados a los mismos.

Los recursos gráficos y sonoros de nuestros juegos son donationware.

Si te gusta esto y aprecias la cantidad de horas que le hemos echado, invita a un café.

Y lo más importante: pásalo guay.