This repository has been archived by the owner on Sep 15, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmanual.html
95 lines (71 loc) · 5.08 KB
/
manual.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//Tigris//DTD XHTML 1.0 Transitional//EN"
"http://style.tigris.org/tigris_transitional.dtd">
<html>
<head>
<style type="text/css">/* <![CDATA[ */ @import "css/tigris.css"; @import "css/inst.css"; /* ]]> */ </style>
<link rel="stylesheet" type="text/css" href="css/print.css" media="print" />
<title>KoLmafia: User Manual</title>
</head>
<body>
<a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=126.82&type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
<h2>KoLmafia: User Manual</h2>
<div class="app">
<h3>Project Information</h3>
<div class="axial">
<table>
<tr>
<th>Project:</th>
<td>KoLmafia</td>
</tr>
<tr>
<th>Intended Product License:</th>
<td>Berkeley Software Development (BSD) License</td>
</tr>
<th>Related Documents:</th>
<td>
<div><a href="index.html">Project overview</a></div>
<div><a href="proposal.html">Project proposal</a></div>
</td>
</tr>
</table>
</div>
<p class="readonly"><strong>Process impact:</strong> This document serves to provide a basic overview of features which are available to the user, which functions to increase usability and thereby increase the size of the project's target audience. Please note that this documentation is outdated. For more up-to-date documentation, please visit the <a href="http://wiki.kolmafia.us">KoLmafia Wiki</a>.</p>
<h3>Table of Contents</h3>
<dl>
<dd><a href="#intro">Getting Started</a></dd>
<dd><a href="#trouble">Troubleshooting</a></dd>
<dd><a href="overriding.html">Overriding Data Files</a></dd>
<dd><a href="combat.html">Custom Combat Settings</a></dd>
<dd><a href="scripting.html">Basic Scripting</a></dd>
<dd><a href="advanced.html">Advanced Scripting</a></dd>
<dd><a href="http://forums.kingdomofloathing.com/viewtopic.php?t=84232">Unofficial Guide</a></dd>
<a name="intro"></a>
<h3>Getting Started</h3>
<dl>
<dt>Which file should I download?</dt>
<dd>If this is the first time you've ever used KoLmafia, and you don't intend to run it from a command line, you should download the release most specific to your operating system: Windows users should download the EXE, OS X users should download the DMG. If you plan on running KoLmafia from your command line or you're a Linux user or an OS X user and the DMG is not available, you should download the JAR. People who would like to see the source code that went into the release without trying to configure SVN should download TAR.GZ.</dd>
<dt>Where should I put the file I downloaded?</dt>
<dd>KoLmafia will run no matter where you put it, provided you have a JRE installed (unless you put it in a network folder where you do not have write privileges, but then that might be getting too technical), but a lot of people get confused when they see "data", "scripts", "images", "buffs" and "clan" directories suddenly appear on their desktop after running KoLmafia for the first time. Therefore, in order to minimize confusion, it is recommended that you create a new folder for KoLmafia on your desktop and put KoLmafia inside of it.</dd>
<dt>Okay, done! ... Where's the rest of the manual?</dt>
<dd><font color=gray>-cough-</font> Actually, there is a community project that's working on compiling a KoLmafia FAQ. It's mostly inactive, but activity does happen in bursts, and it's available <a href="http://wiki.kolmafia.us">here</a></dd>
</dl>
<a name="trouble"></a>
<h3>Troubleshooting</h3>
<dl>
<dt>Problems With Ubuntu Linux</dt>
<blockquote><pre>
Exception in thread "main" java.lang.ExceptionInInitializerError
at java.lang.Class.initializeClass(libgcj.so.7)
at java.lang.Class.forName(libgcj.so.7)
at gnu.java.lang.MainThread.run(libgcj.so.7)
Caused by: java.lang.NullPointerException
at javax.swing.JEditorPane.registerEditorKitForContentType(libgcj.so.7)
at net.sourceforge.kolmafia.KoLmafia.<clinit>(Unknown Source)
at java.lang.Class.initializeClass(libgcj.so.7)
...2 more</pre></blockquote>
<dd>Look familiar? This problem is extremely common and it's due to Ubuntu running the <a href="http://gcc.gnu.org/java/">GNU Compiler for Java</a> (more popularly, GCJ). As documented by GCJ, it's only a 99% implementation of Java, which is sufficient for most purposes, but KoLmafia makes use of part of the last 1% that GCJ did not implement, which results in the error you see above. How to fix this problem? It's not easy, but <a href="http://ubuntuforums.org/showthread.php?t=196841">this page</a> suggests you use <code>update-java-alternatives</code> to fix it on a global level. Alternatively, if the only Java program you use is KoLmafia, you can create a shell script that invokes the SUN Microsystems JRE directly, as described <a href="http://forums.kingdomofloathing.com/viewtopic.php?p=1873716#1873716">here</a>.</dd>
</dl>
</div><div class="footnote">Copyright © 2003 Jason Robbins. All rights reserved. <a href="readyset-license.html">License terms</code></a>. Retain this copyright statement whenever this file is used as a template.</div>
</body>
</html>