C C++ HTML PHP Makefile TeX Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 849 commits ahead, 145 commits behind OpenMeridian:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bbgun Upgrade Meridian59.sln to VS 2015. Jul 14, 2016
bin Compile jansson library statically. Apr 6, 2016
blakcomp Add compiler check for duplicate settings args in calls. Feb 3, 2017
blakdeco Add new goto opcodes for $ checks. Jan 25, 2017
blakdiff Upgrade Meridian59.sln to VS 2015. Jul 14, 2016
blakserv Add new goto opcodes for $ checks. Jan 25, 2017
clientd3d Update splash screen handling. Feb 3, 2017
club Add target platform version to VS projects. Aug 29, 2016
design Add stories from renratpiz Feb 13, 2016
dlg Add variable NPC response quest prizetype. Jul 14, 2015
doc Handle real time using time.h calls. Jan 4, 2017
gelmaker Initial upload of Meridian 59 Sep 15, 2012
include Update splash screen handling. Feb 3, 2017
install Add NSIS installer based on original repo installer. Apr 16, 2016
keybind Copy German resources for keybind to localclient dir during build. Mar 2, 2016
kod Translation for Museum Items Feb 11, 2017
lib Add d3dx9 Direct 3D includes/libs. Jun 26, 2016
libarchive Add target platform version to VS projects. Aug 29, 2016
libjansson Add target platform version to VS projects. Aug 29, 2016
libpng Add target platform version to VS projects. Aug 29, 2016
libzlib Add target platform version to VS projects. Aug 29, 2016
makebgf Upgrade Meridian59.sln to VS 2015. Jul 14, 2016
manual Initial upload of Meridian 59 Sep 15, 2012
module Update splash screen handling. Feb 3, 2017
mysqltest fix mysqltest Sep 28, 2014
qbscripts Update 105 build script. Feb 13, 2016
resource Adding miniature to museum Feb 11, 2017
roomedit Save roomedit solution file in VS2015. Jul 15, 2016
run New Tos East Version Jan 19, 2017
sql Updated MySQL tables that didn't have a timestamp to include one. Jan 9, 2014
tools Remove all uses of decryption, since files are no longer encrypted Jul 5, 2013
util Add target platform version to VS projects. Aug 29, 2016
www Initial MySQL Statistics Pull Oct 3, 2015
.gitattributes Add documentation on kod resource strings. May 7, 2016
.gitignore Update gitignore with new VS files. Jul 14, 2016
CONTRIBUTING.md Update forum locations. Aug 21, 2016
LICENSE Initial upload of Meridian 59 Sep 15, 2012
Meridian59.sln Save solution file in VS2015. Jul 15, 2016
MeridianPalette.BMP Initial upload of Meridian 59 Sep 15, 2012
README.md Update forum locations. Aug 21, 2016
README.old Rewrite README.md with updated info. Rename README to README.old Apr 28, 2015
blakston.pal Initial upload of Meridian 59 Sep 15, 2012
common.mak Compile jansson library statically. Apr 6, 2016
common.mak.linux More work on the kod tree build Feb 13, 2016
makefile Compile jansson library statically. Apr 6, 2016
makefile.linux More work on the kod tree build Feb 13, 2016
postbuild.bat Update build script with new install location. May 26, 2016
rules.mak Generate pdb for blakserv release build. May 31, 2016
rules.mak.linux More work on the kod tree build Feb 13, 2016

README.md

Meridian 59 v2.0, February 2016 Andrew Kirmse and Chris Kirmse

Copyright 1994-2012 Andrew Kirmse and Chris Kirmse All rights reserved. Meridian is a registered trademark.

Play Meridian 59

This repository is for the "Server 105" version of Meridian 59. You can create an account for this server and download the client on the [server 105 website] (https://www.meridiannext.com/play/). Note that this repository is for the "classic" version of the client, the Ogre client repository is at https://github.com/cyberjunk/meridian59-dotnet. A list of known servers is kept on the 105 website.

Contribute to Meridian 59 development

This is a volunteer project under active development. New contributors are always welcome, and you can read about how to get started contributing to the game on the OpenMeridian105 GitHub wiki page. No experience is required or assumed, and there are many different ways to contribute (coding, art, 3D model creation, room building, documentation).

License

This project is distributed under a license that is described in the LICENSE file. The license does not cover the game content (artwork, audio), which are not included.

Note that "Meridian" is a registered trademark and you may not use it without the written permission of the owners.

The license requires that if you redistribute this code in any form, you must make the source code available, including any changes you make. We would love it if you would contribute your changes back to the original source so that everyone can benefit.

What's included and not included

The source to the client, server, game code, Blakod compiler, room editor, and all associated tools are included. The source code to the irrKlang audio library is not included, and the graphics and music for Meridian 59 must be downloaded with the game client.

Build Instructions

These build instructions can also be found on the Server 105 GitHub wiki.

  1. Install Microsoft Visual Studio 2015 Community Edition. During installation you will need to choose "Custom" installation and add the C++ components to the installation, as these are not installed by default (see https://msdn.microsoft.com/en-au/library/60k1461a.aspx).
  2. Download this source code, either with a git client or with the "Download ZIP" option from your chosen repository.

Visual Studio GUI build

  1. If you prefer the Visual Studio graphical interface, open Meridian59.sln from the root folder of the codebase. Click on the BUILD menu and select Build Solution (or press CTRL+SHIFT+B) to build.

Makefile build

  1. Locate your Visual Studio install folder, usually something like "C:\Program Files (x86)\Microsoft Visual Studio 14.0". Navigate to the Common folder, and then the Tools folder. Example: "C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools".
  2. Create a shortcut (by right-clicking on vsvars32.bat and selecting Create shortcut) called "Meridian Development Shell" on your desktop or in your start menu with the following property: Target: %windir%\system32\cmd.exe /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools\vsvars32.bat"
  3. OPTIONAL: set the "Start In" property of your shortcut to the folder that contains the meridian source code for ease of use.
  4. Open the Meridian Development Shell and navigate to the folder containing the source code, then enter nmake debug=1 to compile.

Getting Started: Server

  1. After compilation completes, browse to the .\run\server folder, and double click blakserv.exe to start the server.
  2. Go to the Administration tab on the server's interface and enter the command: create account admin username password email (with your desired username, password and email (email can be "none@none"). You will see a message saying Created ACCOUNT 4 or similar.
  3. Then create a character slot on that account with create admin 4, using whichever number the previous line returned instead of 4.
  4. You'll now be able to log in with this account name and password. Be sure to "save game" from the server interface to save this new account.

Getting Started: Client

You will need to obtain the client graphics before you can run the client locally, which can be done by installing the server 105 classic client from the [105 website] (https://www.meridiannext.com/play/). When this is installed, building the client (via makefile or VS solution) will automatically copy the needed resources to the appropriate directory. If for some reason this isn't done, copy the files manually from the 105 client's resource directory to your repo's .\run\localclient\resource directory. Running postbuild.bat from the root directory of the repo will also perform the copy function. Resources may differ between versions of Meridian 59 - if using this repository for a different version of the game, make sure you have that client downloaded and edit postbuild.bat to copy the appropriate resources.

  1. After compilation completes, the client is located at .\run\localclient.
  2. You can point your local client at your local server by running the client meridian.exe with command line flags, like this: meridian.exe /U:username /W:password /H:localhost /P:5959.
  3. Building the client will generate a shortcut to meridian.exe, with these flags, however if this shortcut isn't present in your client directory, you can create it by making the shortcut, right-clicking it and selecting Properties, and adding /H:localhost /P:5959 after the existing link in the Target: box.

Note that any time you recompile KOD code, changes need to be loaded into your local blakserv server by clicking the 'reload system' arrow icon, next to the 'save game' disk icon.

Third-Party Code

Meridian uses the third party libraries zlib, libarchive, libpng and jansson. Each of these is built from source which is included in the appropriately-named directories (libzlib, libarchive, libpng and libjansson).

Contact Information

For further information please join the #Meridian59de channel on irc.esper.net. You can also join us on the forums where you can ask any questions about the game or the codebase.

Forked from the OpenMeridian codebase, which was forked from the [original Meridian 59 codebase] (https://github.com/Meridian59/Meridian59). Original codebase README file included as README.old.