Skip to content

Build Instructions

Jump to bottom
skittles1 edited this page Aug 21, 2016 · 17 revisions

Build Instructions

Visual Studio GUI build

  • 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

  • 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".
  • 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"
  • OPTIONAL: set the "Start In" property of your shortcut to the folder that contains the meridian source code for ease of use.
  • Open the new shortcut you just created and navigate to the folder containing the source code, then enter nmake debug=1 to compile (in debug mode).

Getting Started: Server

  • After compilation completes, browse to the .\run\server folder, and double click blakserv.exe to start the server.
  • Accounts on blakserv require a username, password and email address to create. Email address validity is not checked beyond ensuring an @ symbol is present, and no : symbols are included. To create an account, go to the Administration tab on the server's interface and enter the command: create account admin username password none@none (with your desired username and password). You will see a message saying Created ACCOUNT 2 or similar.
  • Then create a character slot on that account with create admin 2, using whichever number the previous line returned instead of 2.
  • 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.

  • After compilation completes, the client is located at .\run\localclient.
  1. Building the client will generate a shortcut to meridian.exe, with appropriate flags to connect to your local server. If this shortcut isn't present in your client directory, you can create it by making a 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.

Documentation

Clone this wiki locally