<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Installing, compiling, running</title><link rel="stylesheet" href="manual.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.64.1"><link rel="home" href="index.html" title="The Grendel Manual"><link rel="up" href="index.html" title="The Grendel Manual"><link rel="previous" href="index.html" title="The Grendel Manual"><link rel="next" href="ar01s03.html" title="Command Reference"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Installing, compiling, running</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ar01s03.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="install"></a>Installing, compiling, running</h2></div></div><div></div></div><p> This section outlines the steps required to install, optionally compile, and run the Grendel software. </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="install_installation"></a>Installation</h3></div></div><div></div></div><p> The archive you have downloaded contains prebuilt binaries for the target operating system. The target operating system can be identified by the extension of the archive; .zip => Windows, .tar.gz => Linux. </p><p> You can install the software in any location you deem useful. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="install_compilation"></a>Compilation</h3></div></div><div></div></div><p> If you want to recompile the binaries, you need the following ingredients: </p><div class="itemizedlist"><ul type="disc"><li><p>Linux</p><p> </p><div class="itemizedlist"><ul type="circle"><li><p>Borland Kylix 3</p></li><li><p>GNU make (usually pre-installed on your system)</p></li></ul></div><p> </p></li><li><p>Windows</p><p> </p><div class="itemizedlist"><ul type="circle"><li><p>Borland Delphi 6 or higher</p></li><li><p>GNU make (available at <a href="http://www.grendelproject.nl/dls/gnumake-win32.zip" target="_top">the Grendel website</a>)</p></li></ul></div><p> </p></li></ul></div><p> </p><p> If these ingredients are present, you can run 'make' in the directory where you've installed Grendel. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="install_running"></a>Running</h3></div></div><div></div></div><p> Starting Grendel is simple. Windows users can click on the <tt class="literal">grendel.exe</tt> icon, or open a console window and start the <tt class="literal">grendel.exe</tt> file manually. </p><p> Linux users can either start the executable <tt class="literal">grendel</tt> from an automated script or manually from a terminal. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Under Linux Grendel forks to the background by default, to override this and let Grendel write to stdout use <tt class="literal">grendel -f</tt> instead.</p></div><p> </p><p> If all is well, you should be able to connect to Grendel by using a telnet client to connect to localhost, port 4444. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="install_immortals"></a>Creating immortals</h3></div></div><div></div></div><p> Grendel comes shipped without any users (characters), so you'll have to create your own. </p><p> After connecting to Grendel, you should see a brief introductory message, and a prompt. Here you can create a new user and explore the example world. </p><p> Once you've created a new user, navigate to the <tt class="literal">players</tt> directory, and edit the file <tt class="literal">YourUserName.usr</tt>. To 'immortalize' this user, change the number on the line with <tt class="literal">Level:</tt> to a number in the range 990-1000, where 990 is the lowest ranking Immortal, and 1000 the highest. </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ar01s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The Grendel Manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Command Reference</td></tr></table></div></body></html>