Code and bugfixes for Instant Kingdom's Notrium, a topdown survival game
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
runtime_files
.gitattributes
.gitignore
.travis.yml
CMakeLists.txt
COPYING
FindSDL2.cmake Add SDL2 libs to CMake in a more cross-platform way Oct 26, 2014
FindSDL2_image.cmake
FindSDL2_mixer.cmake
Notrium.ico
README.md
blendstate.h
credits.h
editor.cpp
editor.h
engine.cpp
engine.h
entities.cpp
entities.h
func.cpp
func.h
keys.h
main.cpp
main.h
memleaks.cpp
memleaks.h
mod_loader.cpp
mod_loader.h Fixed header files from using deprecated headers or 'using namespace' Oct 18, 2014
musicmanager.h
puzzle.cpp
puzzle.h
resource.h
resource_handler.cpp
resource_handler.h
sinecosine.cpp
sinecosine.h
soundmanager.cpp
soundmanager.h
text_output.cpp
text_output.h

README.md

OpenNotrium

Build Status

Open source version of Notrium.

Notrium is a top-down survival game originally developed by Ville Mönkkönen.

Join the chat at https://gitter.im/verhoevenv/OpenNotrium

Dependencies

  • SDL 2.0
  • SDL_mixer 2.0
  • SDL_image 2.0
  • PhysFS
  • CMake for building

How to build - Linux

Underneath, Ubuntu is assumed. This probably only affects the package manager, apt-get. Please refer to the documentation of your own distro if you are not sure how to execute the following steps. We will also assume you have the OpenNotrium source files checked out in ~/OpenNotrium

  1. Install CMake

     sudo apt-get install cmake
    
  2. Install dependencies

     sudo apt-get install build-essential libsdl2-dev libsdl2-mixer-dev libsdl2-image-dev libphysfs-dev
    
  3. Go to the OpenNotrium source directory and create a new directory for build output

     cd ~/OpenNotrium
     mkdir build
     cd build
    
  4. From this new directory, let cmake generate the Makefile. CMake should end with a message about build files being written. Fix any errors before continuing!

     cmake ..
    
  5. Build OpenNotrium. This also shouldn't produce any errors. A few warnings is fine.

     make
    
  6. You should have the executable OpenNotrium in your build directory. We will create a seperate directory from which to run the program. We also need the runtime files there.

     cd ..
     mkdir out
     cp build/OpenNotrium out
     cp -r runtime_files/* out
    
  7. Run OpenNotrium!

     cd out
     ./OpenNotrium
    

How to build - Mac

We highly suggest using a package manager for Mac, either fink, MacPorts or Homebrew. Underneath Homebrew is used.

  1. Get XCode command line tools running

    You should search online for this. It involves registering an Apple developer account, downloading XCode, and installing the command line tools from there.

  2. Install CMake

     brew install cmake
    
  3. Install dependencies

     brew install sdl2 sdl2_mixer physfs
    
  4. Follow Linux guidelines from step 3 onwards.

How to build - Windows - Visual Studio

These instructions have been tested on Visual Studio Community 2013 and 2015, which are both free to download. Other versions of Visual Studio might or might not work, but the instructions below should still apply. Alternatively, it might be possible to use MinGW to build OpenNotrium, if you manage to do so, please let us know!

  1. Install CMake

    Find it from the website.

  2. Build physfs

    Physfs doesn't provide binaries on Windows. Google, download and unpack. Then, follow the instructions they provide in INSTALL.txt, which is mainly to use CMake.

  3. Place the created libraries in the physfs directory, under a lib subdirectory. That is where CMake expects to find them

  4. Download and unpack SDL 2.0, SDL_image 2.0 and SDL_mixer 2.0.

    Make sure to get the VS-development archives. It is highly recommended to unpack the libraries to the same directory, this helps with the next steps.

  5. Create environment variables for the libraries so CMake can find them. You can do this by typing the below in a command prompt. Alternatively, use the control panel. Set the paths to where you unpacked.

     setx SDL2DIR c:\SDL2
     setx PHYSFSDIR c:\physfs
    
  6. Create a project file using CMake

     Similar to steps 3 and 4 under the Linux howto:
     
     mkdir build
     cd build
     :: to build with VS2013:
     cmake .. -G "Visual Studio 12"
     :: to build with VS2015:
     cmake .. -G "Visual Studio 14"
     
     Alternatively, use cmake-gui:
    
    1. Where is the source code: browse to where you placed the OpenNotrium sources
    2. Where to build the binaries: copy-paste the above, add /build to it to build in a subdirectory
    3. Click Configure. Select your preferred option for any dialog the pops up.
    4. The messages at the bottom should end with Configuring done, and the configuration options above should be filled out with proper paths. If not, fix errors. Probably your environment variables aren't set up properly, or the physfs libs aren't in a /libs directory.
    5. Click Generate.
  7. Build OpenNotrium by opening the Visual Studio solution file (under the /build subdirectory) and doing a build. If you want an optimized executable, make sure the "Release" target is set. For development purposes, the "Debug" target is ok.

  8. Create a new directory named out under the OpenNotrium source directory. Copy both the executable (should be under build\Debug\OpenNotrium.exe) and the contents of runtime_files to it.

  9. Search the library directories for any necessary .dll files, and copy these to the new out directory. This may depend on your system, but you might want the x86 versions of:

    • for physfs

      • physfs.dll
    • for SDL

      • SDL2.dll
    • for SDL_image

      • SDL2_image.dll
      • libjpeg-9.dll
      • libpng16-16.dll
      • libtiff-5.dll
      • libwebp-4.dll
      • zlib1.dll
    • for SDL_mixer

      • SDL2_mixer.dll
      • libFLAC-8.dll
      • libmikmod-2.dll
      • libogg-0.dll
      • libvorbis-0.dll
      • libvorbisfile-3.dll
      • smpeg2.dll