Giter VIP home page Giter VIP logo

mk2's Introduction

MT Engine MK2

MT Engine MK2 is a framework composed by a modular engine coded in C and a powerful toolchain to make games for the ZX Spectrum. MK2 is the sucessor to Churrera (MK1).

MK2 needs z88dk v1.10 to compile and uses a modified version of splib2 by Alvin Albrecht.

We "abandoned" MK2 in 2018, but continued support by some developers has resurrected the project, which will eventually get more enhancements and additions.

Installation

There's a couple of things you have to do to get this working.

  1. Download or clone this repository.
  2. Install the stripped-down, minimal version of z88dk in C:. Just decompress the file env/z88dk_mt.7z to C:/. You should get a C:\z88dk\ folder.
  3. Compile and install the modified splib2 library. To do that, open a command line console, navigate to lib/splib2/ then run Makefile.bat.

How to Build

The engine / framework resides in src. The code, as is, features a placeholder game you are supposed to replace with your own. You can compile it as-is, of course, to test the environment. To do so:

  1. Open a command line console.
  2. Navigate to the src/dev folder
  3. Execute setenv.bat to set up some environment variables.
  4. Run compile.bat.

If everything went OK, you'll get a tape image mk2.tap you can play in your favourite ZX Spectrum emulator.

Documentation

There isn't a proper tutorial yet, but you can check the one we wrote for MK1 here (Spanish) or here (English, thanks Andy Dansby).

Most of the features are documented in the ever growing but a bit confusing 'whats's new' document.

There's also a bunch of interesting docs in the docs folder.

Credits

  • Engine & toolchain by na_th_an copyleft 2013-2015, 2019. Like it? buy me a coffee
  • Placeholder game by Greenweb.
  • splib2 by Alvin Albrecth.
  • Sound FX and Phaser 1 music player by Shiru.
  • Appack decompresor by dwedit, adapted by Utopian and optimized by Metalbrain.
  • WYZ Player by WYZ.

Important

  • The included splib2 library is not the original. You can get the original splib2 here. There's a backup of the original Spritepack site with the docs here.
  • The z88dk 1.10 package in the env folder is not complete as it just includes the files needed to compile MK2 projects. You can get the full version here.

License

MT Engine MK2 ZX is copyleft The Mojon Twins and is distributed under a LGPL license.

You are required to add the Mojon Twins logo to the cover art and/or the loading screen of your games.

But if you make a game with the engine we understand you'll want to make it into a tape and sell it. In such case, just tell us! Write to [email protected] - just as a matter of courtesy. If you don't we'll get sad and rather disappointed.

The game assets included in the testers and examples (graphics, music, etc.) are donationware.

If you like this, you can buy me a coffee.

Have fun.

Logo for game arts

MK2 logo

Logo for ZX Spectrum

MK2 logo spectrum

mk2's People

Contributors

mojontwins avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.