Home

Awesome

MegaZeux Gentoo Overlay

What is MegaZeux?

MegaZeux is a text-based game creation system (GCS) that was originally released in 1994 and is still under active development to this day.

This is an overlay designed to make MegaZeux easier to install on Gentoo Linux systems.

For more information, including a library of available games, please visit DigitalMZX.

Installing MegaZeux

The first step is to add this overlay to your system. There are two ways of doing this: by using layman or by creating a repos.conf file for the overlay yourself.

The layman Method

This method requires you to touch fewer files by hand and will probably work best for most users.

After installing layman, bring open your terminal of choice and run the following as root:

layman -o https://raw.githubusercontent.com/Spectere/megazeux-overlay/master/megazeux-layman.xml -f -a megazeux

Next, the package will need to be unmasked in order for you to emerge it. This will take care of that:

echo games-engines/megazeux > /etc/portage/package.keywords/megazeux

You should now be able to simply emerge megazeux! Be sure to run layman -S once in a while to sync all of your layman repositories (or layman -s megazeux to only sync this one).

repos.conf Method

This method works well but requires a little bit of manual effort to get set up. If you don't feel like messing around with your portage configuration files directly, give the layman method a try first.

First, you'll need to create a directory to house this overlay's ebuild files. Personally, I store this overlay in /usr/local/portage/megazeux.

Next, create a file in your /etc/portage/repos.conf/ directory called megazeux.conf. Copy and paste the following files into the new file:

[megazeux]
location = /usr/local/portage/megazeux
sync-type = git
sync-uri = https://github.com/Spectere/megazeux-overlay.git
priority = 10

Note: Be sure to change the location attribute if you are placing the overlay elsewhere.

The overlay is now set up to automatically sync when you run emerge --sync. Do so now and it will retrieve the overlay and place it in your chosen directory.

Next, the package will have to be unmasked before it can be emerged. This can be accomplished by executing this as root (note: you'll need to execute this from a root shell, via sudo -s or su, otherwise this won't function as expected):

echo games-engines/megazeux > /etc/portage/package.keywords/megazeux

From here, you can simply emerge megazeux and begin playing and creating.

USE Flags

This ebuild currently supports the following USE flags:

This ebuild is designed to mimick the default canonical MegaZeux distribution as closely as possible by default. This results in the following design choices: