<?
require "mgeneric.inc.php";

$pageCSS = "/docs.css";
$pageTitle = "Alloy combo information submission instructions";
cmPrintPageHeader($pageTitle);

echo "<h1>".$pageTitle."</h1>\n";
?>
<h3>Preamble</h3>
<p>
Okay. First of all, the <a href="/mat/">Pupunen alloy and material info database</a>
was originally SUPPOSED to be a joint/open project. Of course,
that didn't really happen - almost nobody was interested.
People are generally just lazy bastards.
During the years there have been some other contributors, those
are listed on the alloy information page, but mostly the work was
done by me (Ggr) as a mortal.
<b>And I've since moved to the wizardly realms, I am
not going to add into the data myself anymore.</b>
</p>

<p>
<b>BUT! I am still willing to run the site and update the data IF new
data is provided by mortal players who are ready to follow the
instructions provided here.
</b>
</p>

<h3>Notice!</h3>
<p>
Do note that I am NOT going to accept any "research" in some
random format or as CSV or Excel tables or whatever. The system
I made is based on raw BatMUD log file data and that is the
ONLY format I'm going to accept contributions in.
</p>

<h3>How to gather data</h3>

<ol>
<li>To gather data, you need to have <b>logfiles</b> and do alloying.
</li>

<li>The logfiles do not need to be "complete", the ONLY relevant
   lines of interest to my system are the:
<pre>
You mix X and Y and create a quantity of Z.
</pre>
AND the 1-2 lines preceeding it.
</li>
</ol>

<p>
The easiest way to get this result is to use GNU "grep" utility,
available in most UNIX/Linux systems as follows:
</p>

<pre style="background: black;">
cat your_log_files | grep -a -B2 "^You mix .* and create a quantity of " > alloylog.txt
</pre>

<p>
The resulting alloylog.txt contents should look something like this:
</p>
<pre>
An ethereal blue hammer appears in your right hand. 
You mix copper and aluminium and create a quantity of bronze.
--
An ethereal blue hammer appears in your right hand. 
You mix iron and hematite and create a quantity of brass.
--
You slip up and fumble your attempt.
You mix obsidian and crystal and create a quantity of glass.
--
An ethereal blue hammer appears in your right hand. 
You mix nullium and illumium and create a quantity of dukonium.
</pre>

<h3>How to submit</h3>
<p>
When and if you have the log data in the desired format, 
provide me with the "alloylog.txt" file via e-mail or as a
downloadable link.
</p>

<p style="background: black; color: red;">If you can't use GNU grep or other method of providing similar results, but
are willing to send your logfiles verbatim, that is also possible.
</p>

<p>
In either case, please compress your logfile(s)/result file(s) with RAR, 7-Zip or other
generally used archiver especially if the files are larger than few hundred kilobytes.
</p>

<p>
If you have something to submit, or have questions, contact me via
tells in BatMUD or by e-mail <b>ccr@tnsp.org</b>
</p>

<p>
<b>-- Ggr</b>
</p>

<?
cmPrintPageFooter();
?>