ToolsMININIM
MININIM: the Free Prince of Persia Engine, Its Features and Setup
MININIM is a from-scratch free software engine for the first Prince of Persia, written by one programmer over many years. This page covers what it adds, what it loads and where the project lives.
What MININIM is
MININIM describes itself as the Advanced Prince of Persia Engine. It is a free software replacement for the 1989 game by Jordan Mechner, written by Bruno Félix Rezende Ribeiro, who publishes under the name oitofelix and describes himself as a programmer and free software activist. The project page and community listings agree on the key point: this is new code, written from scratch, and not a conversion of the original program. According to the page, Mechner’s 30th anniversary edition of The Making of Prince of Persia mentions the project.
The code is written in C and Lua. Graphics, sound and input go through the Allegro game library, and dialogs use the IUP widget toolkit. The author also set out to document the original game itself, its world and design ideas as well as the engine’s use and development, so the project is partly a reference text.
Licence
The software is released under the GNU General Public License, version 3 or later. The documentation carries the GNU Free Documentation License, version 1.3 or later, with no invariant sections. The repository’s own licence badge says GPL-3.0. Anyone may read the source, build it and change it, which is the same freedom that SDLPoP offers under its own GPL terms.
Features beyond the original
A program that only copied the DOS game would be a preservation exercise. MININIM goes further, and the project page lists a good deal of what it adds:
- Video, environment, hue and guard modes that can be switched while the game runs.
- Mirroring of the screen and of whole levels.
- A revised battle system and smarter opponents.
- Multi-room support, so the view is not limited to a single screen.
- A level editor with undo and redo.
- Recording, playback and validation of replays.
- A Lua console, screenshots and configurable joystick mapping.
A community listing adds sound that gets quieter with distance from its source, new movements for the prince and a configuration system with more than one back end. The project page describes the engine as in “constant and fast development”: legacy semantics, meaning exact behaviour of the original, are described as work in progress, and save states, network play and Guile scripting are listed as planned.
How MININIM relates to SDLPoP and the 1989 game
The two projects solve the same problem from opposite ends. SDLPoP starts from a disassembly of the DOS program, so its game logic follows the 1989 release closely, and it layers fixes and extras on top. MININIM starts from a blank page and rebuilds the game according to its author’s reading of the design, which gives it more freedom to change things and more work to reproduce the original’s quirks. Players who want the DOS behaviour as it was shipped will find more on the 1989 game page, including how the other versions differ.
The engine is aimed at the first game. Nothing on the project page or the listings that were checked mentions the sequel, and this page does not claim any support for it.
Level files and data formats
The project page says the engine loads levels in several formats: its own native format, a legacy format, PLV files and DAT files. The page does not spell out what each of those contains, and this page will not guess at it. DAT is the container family used by the DOS game for its images, sounds and levels, and the DAT files page explains how those containers are organised in general.
Whether a package includes ready-made levels is not stated on the project page. It does mention a walkthrough of the standard legacy level set that uses recorded replays, which suggests that the replay system is meant to be used on that set. For the exact contents of a given download, the project’s own documentation is the authority.
Platforms and setup
On Windows the project page offers a MinGW build as a zip archive. It is extracted and started by running mininim.exe, with no installation step. On GNU/Linux the route is to build from source. The repository’s instructions ask for the usual toolchain (Autoconf, Automake, GCC, Make, gnulib, CMake), Lua and Readline, and a fork of Allegro 5 that the author maintains. The sequence is to build and install that fork, run the bootstrap script, run configure and then make. Mac OS X, Android and iOS ports appear on the page as plans.
The manual that ships with the engine lags behind the code, according to the project page, and a full manual is promised for when the feature set settles. A MININIM 0.10 manual is also listed on the community site popuw.com.
Versions and project status
Version numbers follow the release date. The release linked from the project page is numbered 201701122309, which reads as a timestamp from January 2017, and a Linux distribution packaging project carries that same string. A community listing calls 0.10 the latest release instead. The GitHub repository shows more than a thousand commits and an empty releases section, so the page and the repository do not give one clean answer on which build is newest, and no claim is made here about how actively the project is maintained today.
That uncertainty is a reason to start from the source. The project page is at oitofelix.github.io/mininim, and it is where the current download, the build notes and the documentation are kept. As with every tool in the tools overview, the page does not host game files, and the play page explains the legitimate ways to obtain and run the original game.
Frequently asked questions
Is MININIM the same thing as SDLPoP?
No. Both are free, GPL-licensed programs that run the first game on current systems, but they have different origins. SDLPoP is based on a disassembly of the DOS program, while MININIM was written from scratch by Bruno Félix Rezende Ribeiro. Each has its own feature set, settings and community.
What language is MININIM written in?
The project page says C and Lua, built on the Allegro game library and the IUP widget toolkit. Lua is the language of its scripting console. The same page lists further scripting support as a planned feature, so what exists today is the Lua side.
Does it run on macOS, Android or iOS?
The project page names Windows and GNU/Linux as the practical routes: a ready-made zip for Windows and a source build for Linux. Mac OS X, Android and iOS ports are listed there as planned, not as finished. Check the page before assuming a build exists for those systems.
Which version is the newest?
Sources differ. The project page says versions follow the release date and links a release numbered 201701122309, while a community listing calls 0.10 the latest and offers a manual for it. The project page and its repository are the place to check what is current.