OpenNefia

OpenNefia

OpenNefia is an open-source engine reimplementation of the Japanese roguelike RPG Elona using Lua and the LÖVE game engine.

It is not a variant of Elona, but a ground-up rewrite intended to vastly expand the support for modding in the game, allowing for game features that would have been impractical or impossible with the vanilla codebase.

It is also an experiment to see if a game can be written in an extensible manner, using a mod system and an extensive API.

Note that it is currently alpha-quality and massive breakage will occur when attempting to play through the game normally. Nearly everything is still a work-in-progress. If you would like a stable experience, then please play vanilla Elona or a variant like oomSEST instead.

See the wiki for more information and a work-in-progress modding tutorial.

Features

• Intended goal of being feature-compatible with Elona 1.22 (though still a work in progress).
• Ability to modify the flow of game logic using event hooks.
• Architecture based on APIs - mods can reuse pieces of functionality exposed by other mods.
• Quality-of-life features for developers like code hotloading and an in-game Lua REPL. Build things like new game UIs or features in an interactive manner.
• Supports Windows, macOS, and Linux.

Running

If you’re using Windows, install LÖVE from the official website.

If you’re using a Unix-like platform, ensure the love binary, wget and unzip are on your PATH.

Then, run OpenNefia.bat (Windows) or OpenNefia (Unix).

Contributing

Any feedback or contributions to the project are appreciated. See CONTRIBUTING.md for details.

Credits

See CREDITS.md for third-party code information.