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

http://eldritchgame.com/

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.