Eldritch Source
This is a build of the Eldritch source code released by David Pittman that has been modified to support modding more easily. Thanks, David, for releasing the source code to your game, and for being very helpful with this project! You need the original game to use this, which you can get from
The original source code is available from the bottom of this page:
http://eldritchgame.com/about.html
This build has been created by Gunnar Zötl (gz@tset.de). Everything I made is covered by the same license as the original Eldritch source code.
This version of Eldritch’s source code has been modified to be built using Makefiles with the standard development toolchain on Linux, with XCode command line tools on Mac OS X and with the 64-bit toolchain of mingw-w64 on windows. It has been tested with the humble version of Eldritch on Windows 7, Linux (XUbuntu 16.04 and 17.10) and MacOSX Yosemite. It has also been tested with the windows steam version of Eldritch on Windows 7.
Note that on all 3 platforms, a 64 bit executable is being built. Support for 32 bit executables has been dropped.
For all platforms, you can set paths to external libraries in Code/make_config.mk.
Those are SDL2 and fmodex. For info on how to obtain fmodex, please check the file
Dependencies/[PLATFORM]/FMOD/readme.txt for your platform.
After a successfull build, a call
make install BUILD=...
will copy the compiled files for BUILD (debug, release, final) into the
directory Eldritch-Source/Install/[PLATFORM]/[BUILD], and after that
make binpack
will build one zip archive for each platform/build pair found in Eldritch-Source/Install/
make pack
will build an archive of the source code. Do this last as is cleans the source directory and thus removes all compiled files.
Building on Linux
You can link against the system wide SDL2 libraries, or build your own. A simple make in the directory Code should suffice.
Installing on Linux
You may want to install mEldritch into a copy of the original Eldritch game folder. Even though mEldritch uses its own save files, it also adds to Eldritch’s prefs.cfg file, which might conflict with what Eldritch writes.
Copy the mEldritch binary, libfmodex64.so and the Mods folder from the
folder Eldritch-Source/Install/[PLATFORM]/[BUILD] into your Eldritch game
folder. The Examples Folder contains a few sample mods. You can install any
of those, if you like. They all have a readme inside that explains what each
mod does. In order to install a mod, just copy it into the Mods folder and
add it to Mods/mods.cfg.
The contents of the Extras folder is for modding. You don’t need it to play mods.
Start mEldritch(.exe) instead of Eldritch(.exe). Press Control+Shift+T or
resurrect to generate a new, mEldritch compatible world.
Building on MacOSX
As there are no system wide SDL2 libraries, you will probably need to build your own or use the ones from homebrew. A simple make in the directory Code should suffice.
Installing on MacOSX
You may want to install mEldritch into a copy of the original Eldritch.app
folder, as you can start only one executable within an application directory.
First, open (not run, but “show contents” or whatever that is called in
non-german) the Eldritch.app (or better yet, a copy of it). From the Folder
Eldritch-Source/Install/MacOSX/[BUILD], copy the folders MacOS and
Frameworks into Eldritch.app/Contents, but be sure to merge them with
the existing folders!
If you want to open mEldritch on starting Eldritch.app, do this: open Eldritch.app/Contents/Info.plist in a text editor and replace the string for the key CFBundleExecutable with mEldritch (should be Eldritch before replacing). Otherwise you can just navigate to Eldritch.app/Contents/MacOS and start mEldritch from there.
The Mods folder must be copied from the archive to
~/Library/Application Support/Eldritch. The Examples Folder contains a few
sample mods. You can install any of those, if you like. They all have a readme
inside that explains what each mod does. In order to install a mod, just copy
it into the Mods folder and add it to Mods/mods.cfg.
Start mEldritch. Press Control+Shift+T or resurrect to generate a new,
mEldritch compatible world.
The contents of the Extras folder is for modding. You don’t need it to play mods.
Building on Windows
First install msys2 64 bit from http://www.msys2.org/, inclusing all updates, as detailed on the page. Then install the mingw-w64 Toolchain like this:
pacman -S mingw-w64-x86_64-toolchain
Open the “MSYS2 MinGW 64-bit” shell from the start menu, and then a simple make in the directory Code should suffice.
Installing on Windows
Installing on Windows is just like installing on Linux, please read that
section above. The only difference is tthat instead of libfmodex64.so
you need to copy fmodex64.dll.
A Note for the steam version
mEldritch works with the steam version of Eldritch, and provides support for the steam exclusive content (Halloween and Asylum). However, there is no support for steam itself.
More information about mEldritch
Find readme_meldritch.txt either in Eldritch-Source/Install/[PLATFORM]/[BUILD]
(after a call to make install) or in Eldritch-Source/Projects/Eldritch. Also a
file names readme_lua.txt is available from either locations, that explains a bit
about the lua integration of meldritch.