File: README.html

package info (click to toggle)
crossfire 1.71.0%2Bdfsg1-1
links: PTS
area: main
in suites: jessie, jessie-kfreebsd, stretch
size: 28,080 kB
sloc: ansic: 85,126; sh: 11,969; perl: 2,659; lex: 2,044; makefile: 1,271
file content (1025 lines) | stat: -rw-r--r-- 27,647 bytes
parent folder | download | duplicates (2)
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.6.9" />
<title>Crossfire Server User Guide</title>
<style type="text/css">
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */

/* Default font. */
body {
  font-family: Georgia,serif;
}

/* Title font. */
h1, h2, h3, h4, h5, h6,
div.title, caption.title,
thead, p.table.header,
#toctitle,
#author, #revnumber, #revdate, #revremark,
#footer {
  font-family: Arial,Helvetica,sans-serif;
}

body {
  margin: 1em 5% 1em 5%;
}

a {
  color: blue;
  text-decoration: underline;
}
a:visited {
  color: fuchsia;
}

em {
  font-style: italic;
  color: navy;
}

strong {
  font-weight: bold;
  color: #083194;
}

h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
}

h1, h2, h3 {
  border-bottom: 2px solid silver;
}
h2 {
  padding-top: 0.5em;
}
h3 {
  float: left;
}
h3 + * {
  clear: left;
}
h5 {
  font-size: 1.0em;
}

div.sectionbody {
  margin-left: 0;
}

hr {
  border: 1px solid silver;
}

p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
}

ul, ol, li > p {
  margin-top: 0;
}
ul > li     { color: #aaa; }
ul > li > * { color: black; }

.monospaced, code, pre {
  font-family: "Courier New", Courier, monospace;
  font-size: inherit;
  color: navy;
  padding: 0;
  margin: 0;
}
pre {
  white-space: pre-wrap;
}

#author {
  color: #527bbd;
  font-weight: bold;
  font-size: 1.1em;
}
#email {
}
#revnumber, #revdate, #revremark {
}

#footer {
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
}
#footer-text {
  float: left;
  padding-bottom: 0.5em;
}
#footer-badges {
  float: right;
  padding-bottom: 0.5em;
}

#preamble {
  margin-top: 1.5em;
  margin-bottom: 1.5em;
}
div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
  margin-top: 1.0em;
  margin-bottom: 1.5em;
}
div.admonitionblock {
  margin-top: 2.0em;
  margin-bottom: 2.0em;
  margin-right: 10%;
  color: #606060;
}

div.content { /* Block element content. */
  padding: 0;
}

/* Block element titles. */
div.title, caption.title {
  color: #527bbd;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
}
div.title + * {
  margin-top: 0;
}

td div.title:first-child {
  margin-top: 0.0em;
}
div.content div.title:first-child {
  margin-top: 0.0em;
}
div.content + div.title {
  margin-top: 0.0em;
}

div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid #dddddd;
  border-left: 4px solid #f0f0f0;
  padding: 0.5em;
}

div.listingblock > div.content {
  border: 1px solid #dddddd;
  border-left: 5px solid #f0f0f0;
  background: #f8f8f8;
  padding: 0.5em;
}

div.quoteblock, div.verseblock {
  padding-left: 1.0em;
  margin-left: 1.0em;
  margin-right: 10%;
  border-left: 5px solid #f0f0f0;
  color: #888;
}

div.quoteblock > div.attribution {
  padding-top: 0.5em;
  text-align: right;
}

div.verseblock > pre.content {
  font-family: inherit;
  font-size: inherit;
}
div.verseblock > div.attribution {
  padding-top: 0.75em;
  text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
  text-align: left;
}

div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
}
div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 3px solid #dddddd;
}

div.exampleblock > div.content {
  border-left: 3px solid #dddddd;
  padding-left: 0.5em;
}

div.imageblock div.content { padding-left: 0; }
span.image img { border-style: none; vertical-align: text-bottom; }
a.image:visited { color: white; }

dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: normal;
  color: navy;
}
dd > *:first-child {
  margin-top: 0.1em;
}

ul, ol {
    list-style-position: outside;
}
ol.arabic {
  list-style-type: decimal;
}
ol.loweralpha {
  list-style-type: lower-alpha;
}
ol.upperalpha {
  list-style-type: upper-alpha;
}
ol.lowerroman {
  list-style-type: lower-roman;
}
ol.upperroman {
  list-style-type: upper-roman;
}

div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
  margin-top: 0.1em;
  margin-bottom: 0.1em;
}

tfoot {
  font-weight: bold;
}
td > div.verse {
  white-space: pre;
}

div.hdlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
div.hdlist tr {
  padding-bottom: 15px;
}
dt.hdlist1.strong, td.hdlist1.strong {
  font-weight: bold;
}
td.hdlist1 {
  vertical-align: top;
  font-style: normal;
  padding-right: 0.8em;
  color: navy;
}
td.hdlist2 {
  vertical-align: top;
}
div.hdlist.compact tr {
  margin: 0;
  padding-bottom: 0;
}

.comment {
  background: yellow;
}

.footnote, .footnoteref {
  font-size: 0.8em;
}

span.footnote, span.footnoteref {
  vertical-align: super;
}

#footnotes {
  margin: 20px 0 20px 0;
  padding: 7px 0 0 0;
}

#footnotes div.footnote {
  margin: 0 0 5px 0;
}

#footnotes hr {
  border: none;
  border-top: 1px solid silver;
  height: 1px;
  text-align: left;
  margin-left: 0;
  width: 20%;
  min-width: 100px;
}

div.colist td {
  padding-right: 0.5em;
  padding-bottom: 0.3em;
  vertical-align: top;
}
div.colist td img {
  margin-top: 0.3em;
}

@media print {
  #footer-badges { display: none; }
}

#toc {
  margin-bottom: 2.5em;
}

#toctitle {
  color: #527bbd;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
}

div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  margin-top: 0;
  margin-bottom: 0;
}
div.toclevel2 {
  margin-left: 2em;
  font-size: 0.9em;
}
div.toclevel3 {
  margin-left: 4em;
  font-size: 0.9em;
}
div.toclevel4 {
  margin-left: 6em;
  font-size: 0.9em;
}

span.aqua { color: aqua; }
span.black { color: black; }
span.blue { color: blue; }
span.fuchsia { color: fuchsia; }
span.gray { color: gray; }
span.green { color: green; }
span.lime { color: lime; }
span.maroon { color: maroon; }
span.navy { color: navy; }
span.olive { color: olive; }
span.purple { color: purple; }
span.red { color: red; }
span.silver { color: silver; }
span.teal { color: teal; }
span.white { color: white; }
span.yellow { color: yellow; }

span.aqua-background { background: aqua; }
span.black-background { background: black; }
span.blue-background { background: blue; }
span.fuchsia-background { background: fuchsia; }
span.gray-background { background: gray; }
span.green-background { background: green; }
span.lime-background { background: lime; }
span.maroon-background { background: maroon; }
span.navy-background { background: navy; }
span.olive-background { background: olive; }
span.purple-background { background: purple; }
span.red-background { background: red; }
span.silver-background { background: silver; }
span.teal-background { background: teal; }
span.white-background { background: white; }
span.yellow-background { background: yellow; }

span.big { font-size: 2em; }
span.small { font-size: 0.6em; }

span.underline { text-decoration: underline; }
span.overline { text-decoration: overline; }
span.line-through { text-decoration: line-through; }

div.unbreakable { page-break-inside: avoid; }


/*
 * xhtml11 specific
 *
 * */

div.tableblock {
  margin-top: 1.0em;
  margin-bottom: 1.5em;
}
div.tableblock > table {
  border: 3px solid #527bbd;
}
thead, p.table.header {
  font-weight: bold;
  color: #527bbd;
}
p.table {
  margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
  border-style: none;
}
div.tableblock > table[frame="hsides"] {
  border-left-style: none;
  border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
  border-top-style: none;
  border-bottom-style: none;
}


/*
 * html5 specific
 *
 * */

table.tableblock {
  margin-top: 1.0em;
  margin-bottom: 1.5em;
}
thead, p.tableblock.header {
  font-weight: bold;
  color: #527bbd;
}
p.tableblock {
  margin-top: 0;
}
table.tableblock {
  border-width: 3px;
  border-spacing: 0px;
  border-style: solid;
  border-color: #527bbd;
  border-collapse: collapse;
}
th.tableblock, td.tableblock {
  border-width: 1px;
  padding: 4px;
  border-style: solid;
  border-color: #527bbd;
}

table.tableblock.frame-topbot {
  border-left-style: hidden;
  border-right-style: hidden;
}
table.tableblock.frame-sides {
  border-top-style: hidden;
  border-bottom-style: hidden;
}
table.tableblock.frame-none {
  border-style: hidden;
}

th.tableblock.halign-left, td.tableblock.halign-left {
  text-align: left;
}
th.tableblock.halign-center, td.tableblock.halign-center {
  text-align: center;
}
th.tableblock.halign-right, td.tableblock.halign-right {
  text-align: right;
}

th.tableblock.valign-top, td.tableblock.valign-top {
  vertical-align: top;
}
th.tableblock.valign-middle, td.tableblock.valign-middle {
  vertical-align: middle;
}
th.tableblock.valign-bottom, td.tableblock.valign-bottom {
  vertical-align: bottom;
}


/*
 * manpage specific
 *
 * */

body.manpage h1 {
  padding-top: 0.5em;
  padding-bottom: 0.5em;
  border-top: 2px solid silver;
  border-bottom: 2px solid silver;
}
body.manpage h2 {
  border-style: none;
}
body.manpage div.sectionbody {
  margin-left: 3em;
}

@media print {
  body.manpage div#toc { display: none; }
}


</style>
<script type="text/javascript">
/*<![CDATA[*/
var asciidoc = {  // Namespace.

/////////////////////////////////////////////////////////////////////
// Table Of Contents generator
/////////////////////////////////////////////////////////////////////

/* Author: Mihai Bazon, September 2002
 * http://students.infoiasi.ro/~mishoo
 *
 * Table Of Content generator
 * Version: 0.4
 *
 * Feel free to use this script under the terms of the GNU General Public
 * License, as long as you do not remove or alter this notice.
 */

 /* modified by Troy D. Hanson, September 2006. License: GPL */
 /* modified by Stuart Rackham, 2006, 2009. License: GPL */

// toclevels = 1..4.
toc: function (toclevels) {

  function getText(el) {
    var text = "";
    for (var i = el.firstChild; i != null; i = i.nextSibling) {
      if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
        text += i.data;
      else if (i.firstChild != null)
        text += getText(i);
    }
    return text;
  }

  function TocEntry(el, text, toclevel) {
    this.element = el;
    this.text = text;
    this.toclevel = toclevel;
  }

  function tocEntries(el, toclevels) {
    var result = new Array;
    var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
    // Function that scans the DOM tree for header elements (the DOM2
    // nodeIterator API would be a better technique but not supported by all
    // browsers).
    var iterate = function (el) {
      for (var i = el.firstChild; i != null; i = i.nextSibling) {
        if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
          var mo = re.exec(i.tagName);
          if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
            result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
          }
          iterate(i);
        }
      }
    }
    iterate(el);
    return result;
  }

  var toc = document.getElementById("toc");
  if (!toc) {
    return;
  }

  // Delete existing TOC entries in case we're reloading the TOC.
  var tocEntriesToRemove = [];
  var i;
  for (i = 0; i < toc.childNodes.length; i++) {
    var entry = toc.childNodes[i];
    if (entry.nodeName.toLowerCase() == 'div'
     && entry.getAttribute("class")
     && entry.getAttribute("class").match(/^toclevel/))
      tocEntriesToRemove.push(entry);
  }
  for (i = 0; i < tocEntriesToRemove.length; i++) {
    toc.removeChild(tocEntriesToRemove[i]);
  }

  // Rebuild TOC entries.
  var entries = tocEntries(document.getElementById("content"), toclevels);
  for (var i = 0; i < entries.length; ++i) {
    var entry = entries[i];
    if (entry.element.id == "")
      entry.element.id = "_toc_" + i;
    var a = document.createElement("a");
    a.href = "#" + entry.element.id;
    a.appendChild(document.createTextNode(entry.text));
    var div = document.createElement("div");
    div.appendChild(a);
    div.className = "toclevel" + entry.toclevel;
    toc.appendChild(div);
  }
  if (entries.length == 0)
    toc.parentNode.removeChild(toc);
},


/////////////////////////////////////////////////////////////////////
// Footnotes generator
/////////////////////////////////////////////////////////////////////

/* Based on footnote generation code from:
 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
 */

footnotes: function () {
  // Delete existing footnote entries in case we're reloading the footnodes.
  var i;
  var noteholder = document.getElementById("footnotes");
  if (!noteholder) {
    return;
  }
  var entriesToRemove = [];
  for (i = 0; i < noteholder.childNodes.length; i++) {
    var entry = noteholder.childNodes[i];
    if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
      entriesToRemove.push(entry);
  }
  for (i = 0; i < entriesToRemove.length; i++) {
    noteholder.removeChild(entriesToRemove[i]);
  }

  // Rebuild footnote entries.
  var cont = document.getElementById("content");
  var spans = cont.getElementsByTagName("span");
  var refs = {};
  var n = 0;
  for (i=0; i<spans.length; i++) {
    if (spans[i].className == "footnote") {
      n++;
      var note = spans[i].getAttribute("data-note");
      if (!note) {
        // Use [\s\S] in place of . so multi-line matches work.
        // Because JavaScript has no s (dotall) regex flag.
        note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
        spans[i].innerHTML =
          "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
          "' title='View footnote' class='footnote'>" + n + "</a>]";
        spans[i].setAttribute("data-note", note);
      }
      noteholder.innerHTML +=
        "<div class='footnote' id='_footnote_" + n + "'>" +
        "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
        n + "</a>. " + note + "</div>";
      var id =spans[i].getAttribute("id");
      if (id != null) refs["#"+id] = n;
    }
  }
  if (n == 0)
    noteholder.parentNode.removeChild(noteholder);
  else {
    // Process footnoterefs.
    for (i=0; i<spans.length; i++) {
      if (spans[i].className == "footnoteref") {
        var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
        href = href.match(/#.*/)[0];  // Because IE return full URL.
        n = refs[href];
        spans[i].innerHTML =
          "[<a href='#_footnote_" + n +
          "' title='View footnote' class='footnote'>" + n + "</a>]";
      }
    }
  }
},

install: function(toclevels) {
  var timerId;

  function reinstall() {
    asciidoc.footnotes();
    if (toclevels) {
      asciidoc.toc(toclevels);
    }
  }

  function reinstallAndRemoveTimer() {
    clearInterval(timerId);
    reinstall();
  }

  timerId = setInterval(reinstall, 500);
  if (document.addEventListener)
    document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
  else
    window.onload = reinstallAndRemoveTimer;
}

}
asciidoc.install(2);
/*]]>*/
</script>
</head>
<body class="article">
<div id="header">
<h1>Crossfire Server User Guide</h1>
<span id="author">Crossfire Development Team</span><br />
<span id="email"><code>&lt;<a href="mailto:crossfire@metalforge.org">crossfire@metalforge.org</a>&gt;</code></span><br />
<span id="revnumber">version 1.71.0,</span>
<span id="revdate">April 2014</span>
<div id="toc">
  <div id="toctitle">Table of Contents</div>
  <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
</div>
</div>
<div id="content">
<div id="preamble">
<div class="sectionbody">
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">This README is written for those who wish to run their own server. It is
not necessary to install the server in order to play Crossfire.</td>
</tr></table>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_introduction">1. Introduction</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_what_is_crossfire">1.1. What is Crossfire?</h3>
<div class="paragraph"><p>Crossfire is a free, open-source, cooperative multi-player RPG and adventure
game. Since its initial release, Crossfire has grown to encompass over 150
monsters, 3000 areas to explore, an elaborate magic system, 13 races, 15
character classes, and many powerful artifacts scattered far and wide. Set
in a fantastical medieval world, it blends the style of Gauntlet, NetHack,
Moria, and Angband.</p></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_installation">2. Installation</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_system_requirements">2.1. System Requirements</h3>
<div class="paragraph"><p>Crossfire should run on any machine with an ANSI C compiler installed. To
date, it has been known to work on Linux, BSD, Windows, Solaris, and Mac.</p></div>
<div class="paragraph"><p>In order to build the server, a copy of the game archetypes must be unpacked
or linked in the "lib/arch" directory. This can be deleted once the build is
finished, but keeping a copy around won&#8217;t hurt. Perl is required to generate
the final archetype files, but is not needed after the build is complete.</p></div>
<div class="paragraph"><p>In order to run the server, a copy of the game maps is also required.</p></div>
<div class="paragraph"><p>In addition, there are a number of optional dependencies that make the game
even more fun. These include:</p></div>
<div class="ulist"><ul>
<li>
<p>
Support for dynamically loaded libraries. Most modern operating systems
should have it. This is needed for server plugins.
</p>
</li>
<li>
<p>
Python 2.4 or later - this is needed for the Crossfire Python plugin
(CFPython) and is <strong>highly</strong> recommended. Most maps, quests, and NPCs will
not work without it.
</p>
</li>
<li>
<p>
SQLite3 - for cflogger and cfnewspaper. These plugins are still under
development and aren&#8217;t very useful at the moment.
</p>
</li>
<li>
<p>
Check - for unit tests. This is required for plugin developers, but mostly
useless to normal users.
</p>
</li>
</ul></div>
</div>
<div class="sect2">
<h3 id="_compiling">2.2. Compiling</h3>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Important</div>
</td>
<td class="content">This section is out of date. Don&#8217;t rely on it.</td>
</tr></table>
</div>
<div class="paragraph"><p>Crossfire has been known to compile on a wide variety of systems.  It should
compile on most all ANSI C and POSIX compliant systems.</p></div>
<div class="paragraph"><p>To get directions on compilation under Unix/Linux, read the INSTALL file.
For Windows: Someone with Windows: please fill this in.</p></div>
<div class="paragraph"><p>Step-by-step compilation guide:
<a href="http://wiki.metalforge.net/doku.php/crossfire_compile_guide">http://wiki.metalforge.net/doku.php/crossfire_compile_guide</a></p></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_running_crossfire">3. Running Crossfire</h2>
<div class="sectionbody">
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Important</div>
</td>
<td class="content">This section is out of date. Don&#8217;t rely on it.</td>
</tr></table>
</div>
<div class="paragraph"><p>Crossfire runs on a client/server model.  You will also need the client to
play.  You can either connect to a server someone else has set up, or run
your own server and connect to that.  The client package has information for
connecting to servers.</p></div>
<div class="paragraph"><p>To run your own server, you need to make the crossfire binaries and install
them, and then run the crossfire-server program.  This creates a server
that you and other people can connect to.  The map files must be downloaded
and installed for the server to run properly.  They should be unpacked in
the <em>$(TARGET)/share/crossfire</em> directory - after unpacking, you should have a
<em>$(TARGET)/share/crossfire/maps</em> directory.  Alternatively, maps in that
location may be a sym-link that points to a different folder.</p></div>
<div class="sect2">
<h3 id="_hosting_a_public_server">3.1. Hosting a Public Server</h3>
<div class="paragraph"><p>If you plan to run a long term server, you should use one of the scripts
provided that will re-run crossfire if it dies for some reason.</p></div>
<div class="paragraph"><p>How to host a public server:
<a href="http://wiki.metalforge.net/doku.php/serverhosting:hosting_a_crossfire_server">http://wiki.metalforge.net/doku.php/serverhosting:hosting_a_crossfire_server</a></p></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_getting_help">4. Getting Help</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_website">4.1. Website</h3>
<div class="paragraph"><p>Official Website:
<a href="http://crossfire.real-time.com/">http://crossfire.real-time.com/</a></p></div>
<div class="paragraph"><p>Crossfire Wiki:
<a href="http://wiki.metalforge.net/doku.php">http://wiki.metalforge.net/doku.php</a></p></div>
<div class="paragraph"><p>SourceForge Downloads Page:
<a href="http://sourceforge.net/projects/crossfire/files/">http://sourceforge.net/projects/crossfire/files/</a></p></div>
</div>
<div class="sect2">
<h3 id="_irc">4.2. IRC</h3>
<div class="paragraph"><p>It&#8217;s possible to link up with a small community of Crossfire players and
developers on irc.freenode.net in the #crossfire channel. Though activity
waxes and wanes, it&#8217;s often possible to get live help there.</p></div>
</div>
<div class="sect2">
<h3 id="_mailing_lists">4.3. Mailing Lists</h3>
<div class="paragraph"><p>For the latest subscription for crossfire mailing lists, go to:
<a href="http://crossfire.real-time.com/mailinglists/index.html">http://crossfire.real-time.com/mailinglists/index.html</a></p></div>
<div class="paragraph"><p>There you can subscribe/unsubscribe any of the mailing lists.  Links to
archives of the mailing lists can be found there, as well as at:
<a href="http://gmane.org/find.php?list=crossfire">http://gmane.org/find.php?list=crossfire</a></p></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_contributing">5. Contributing</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_reporting_bugs">5.1. Reporting Bugs</h3>
<div class="paragraph"><p>First, check the INSTALL file for common problems, and see if yours is
mentioned.</p></div>
<div class="paragraph"><p>Bugs should be filed in the Crossfire bug tracker on SourceForge:
<a href="http://sourceforge.net/p/crossfire/bugs/">http://sourceforge.net/p/crossfire/bugs/</a></p></div>
<div class="paragraph"><p>When reporting bugs, make sure you include the following:</p></div>
<div class="ulist"><ul>
<li>
<p>
If you have a sourceforge login, make sure you are logged in.  This way,
    if there are questions about the bug, you will be notified about the
    request for more information.
</p>
</li>
<li>
<p>
What version of crossfire did you use?
</p>
</li>
<li>
<p>
What type of computer did you use (CPU type)
</p>
</li>
<li>
<p>
What is the version of the OS?
</p>
</li>
<li>
<p>
What compiler (and its version) did you use (ie, gcc, icc, etc)?
</p>
</li>
<li>
<p>
Which flags did you give it?
</p>
</li>
<li>
<p>
If the bug happens when compiling crossfire, send an EXACT copy of the
    compiler line, as well as the errors it puts out.  Sending bugs of the
    sort <em>it failed with a line like &#8230;</em> doesn&#8217;t help at all.
</p>
</li>
<li>
<p>
If you are using any of the plugins, what version(s) of Python and SQLite
    do you have installed?
</p>
</li>
<li>
<p>
If the bug happened while running crossfire:
</p>
<div class="ulist"><ul>
<li>
<p>
Include any output before to the bug.
</p>
</li>
<li>
<p>
Give a description of what you did before the bug occurred.  The better
      detailed the description, the better chance we have of figuring out
      where the bug happened, or how we can recreate the bug.
</p>
</li>
<li>
<p>
If possible, a stack trace from gdb (or other debugger) is very helpful.
</p>
</li>
</ul></div>
</li>
</ul></div>
<div class="paragraph"><p>The more information provided, the better chance of the bug being fixed in
a timely fashion.</p></div>
<div class="paragraph"><p>Further debugging information can be found at
<a href="http://crossfire.real-time.com/debugging_tips.html">http://crossfire.real-time.com/debugging_tips.html</a></p></div>
</div>
<div class="sect2">
<h3 id="_submitting_patches">5.2. Submitting Patches</h3>
<div class="paragraph"><p>See the doc/programming_guide file.</p></div>
<div class="paragraph"><p>Patches should be sent to the Crossfire patch tracker on SourceForge:
<a href="http://sourceforge.net/p/crossfire/patches/">http://sourceforge.net/p/crossfire/patches/</a></p></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_copyright">6. Copyright</h2>
<div class="sectionbody">
<div class="paragraph"><p>Don&#8217;t get scared by the below, it&#8217;s included just for "safety" reasons 8)
(Don&#8217;t want anyone to start selling the game)</p></div>
<div class="listingblock">
<div class="content">
<pre><code>Copyright (c) 2000, 2006 Mark Wedel
Copyright (c) 1992 Frank Tore Johansen

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.

The author can be reached via e-mail to crossfire-devel@real-time.com</code></pre>
</div></div>
</div>
</div>
</div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
Version 1.71.0<br />
Last updated 2014-04-03 22:18:52 CDT
</div>
</div>
</body>
</html>