KoLmafia Guide: Preface - Revision history

NISEMONO: Whoops necro edit. Sorry

2023-08-08T18:33:04Z

Whoops necro edit. Sorry

← Older revision		Revision as of 18:33, 8 August 2023
Line 58:		Line 58:
	We are now officially starting your KoLmafia lessons!		We are now officially starting your KoLmafia lessons!

	# Download the latest build from [https://ci.kolmafia.us KoLmafia's Build Server] ~~Click the last successful build which looks something like #3258.~~		# Download the latest build from [https://ci.kolmafia.us KoLmafia's Build Server]
	# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the ~~~30 MB Java .~~Jar file.		# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the java Jar file.
	# Move the file somewhere handy. Note that KoLmafia can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run KoLmafia. No further setup is needed.		# Move the file somewhere handy. Note that KoLmafia can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run KoLmafia. No further setup is needed.
	# If the file doesn't run, you need the ~~right~~ Java Runtime Environment ~~& JDK (Java 17)~~. The KoLmafia website given above, has a 'Getting Started' section that you can refer to in case of such issues.		# If the file doesn't run, you need the 1.6 or better Java Runtime Environment. This is not particularly hard and many will likely already have it. The KoLmafia website given above, has a 'Getting Started' section that you can refer to in case of such issues.
	# When you first run it, '''two''' windows pop up. Ignore the complicated looking frame, and look at the one with the login fields. Type in your login info (make sure you don't have KoL running elsewhere obviously), then click the '''LOGIN''' button. Ignore the RELAY button for now. Keep the other options unchecked, including breakfast. We will discuss this stuff later.		# When you first run it, '''two''' windows pop up. Ignore the complicated looking frame, and look at the one with the login fields. Type in your login info (make sure you don't have KoL running elsewhere obviously), then click the '''LOGIN''' button. Ignore the RELAY button for now. Keep the other options unchecked, including breakfast. We will discuss this stuff later.
	# The Login frame goes away and now you have the main box, which I will call the KoLmafia Frame. I don't have a place to store an up to date picture, but the whole thing is kind-of intimidating. You are probably ready to quit, but ''stick in there!''' We will make this easy by doing things step-by-step. I'm a noob, remember? I got your back! ;-)		# The Login frame goes away and now you have the main box, which I will call the KoLmafia Frame. I don't have a place to store an up to date picture, but the whole thing is kind-of intimidating. You are probably ready to quit, but ''stick in there!''' We will make this easy by doing things step-by-step. I'm a noob, remember? I got your back! ;-)

NISEMONO: Touch up some minor incorrect steps for 2023 mafia

2023-08-08T18:28:00Z

Touch up some minor incorrect steps for 2023 mafia

← Older revision		Revision as of 18:28, 8 August 2023
Line 58:		Line 58:
	We are now officially starting your KoLmafia lessons!		We are now officially starting your KoLmafia lessons!

	# Download the latest build from [https://ci.kolmafia.us KoLmafia's Build Server]		# Download the latest build from [https://ci.kolmafia.us KoLmafia's Build Server] Click the last successful build which looks something like #3258.
	# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the ~~java~~ Jar file.		# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the ~30 MB Java .Jar file.
	# Move the file somewhere handy. Note that KoLmafia can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run KoLmafia. No further setup is needed.		# Move the file somewhere handy. Note that KoLmafia can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run KoLmafia. No further setup is needed.
	# If the file doesn't run, you need the ~~1.6 or better~~ Java Runtime Environment~~. This is not particularly hard and many will likely already have it~~. The KoLmafia website given above, has a 'Getting Started' section that you can refer to in case of such issues.		# If the file doesn't run, you need the right Java Runtime Environment & JDK (Java 17). The KoLmafia website given above, has a 'Getting Started' section that you can refer to in case of such issues.
	# When you first run it, '''two''' windows pop up. Ignore the complicated looking frame, and look at the one with the login fields. Type in your login info (make sure you don't have KoL running elsewhere obviously), then click the '''LOGIN''' button. Ignore the RELAY button for now. Keep the other options unchecked, including breakfast. We will discuss this stuff later.		# When you first run it, '''two''' windows pop up. Ignore the complicated looking frame, and look at the one with the login fields. Type in your login info (make sure you don't have KoL running elsewhere obviously), then click the '''LOGIN''' button. Ignore the RELAY button for now. Keep the other options unchecked, including breakfast. We will discuss this stuff later.
	# The Login frame goes away and now you have the main box, which I will call the KoLmafia Frame. I don't have a place to store an up to date picture, but the whole thing is kind-of intimidating. You are probably ready to quit, but ''stick in there!''' We will make this easy by doing things step-by-step. I'm a noob, remember? I got your back! ;-)		# The Login frame goes away and now you have the main box, which I will call the KoLmafia Frame. I don't have a place to store an up to date picture, but the whole thing is kind-of intimidating. You are probably ready to quit, but ''stick in there!''' We will make this easy by doing things step-by-step. I'm a noob, remember? I got your back! ;-)

Mcroft: remove SourceForge

2021-12-28T18:23:17Z

remove SourceForge

← Older revision		Revision as of 18:23, 28 December 2021
Line 36:		Line 36:
	* Easier to Customize - Not much of an issue at first, but writing a new Greasemonkey script is relatively hard. Modifying KoLmafia behavior can be a lot easier for certain aspects.		* Easier to Customize - Not much of an issue at first, but writing a new Greasemonkey script is relatively hard. Modifying KoLmafia behavior can be a lot easier for certain aspects.

	* Consolidated Updates - All KoLmafia work occurs at its ~~sourceforge~~ website. Versions are numbered and under version-control. This means you can easily find the most up-to-date version and no intermediate fixes were skipped.		* Consolidated Updates - All KoLmafia work occurs at its GitHub website. Versions are numbered and under version-control. This means you can easily find the most up-to-date version and no intermediate fixes were skipped.

	* Easier to Figure Out - While the documentation for KoLmafia is not amazing, you will have a lot more luck finding help documents (like this one!) for Mafia, as opposed to documentation for random Greasemonkey scripts.		* Easier to Figure Out - While the documentation for KoLmafia is not amazing, you will have a lot more luck finding help documents (like this one!) for Mafia, as opposed to documentation for random Greasemonkey scripts.

Mcroft: /* Links */ i don't want to change this, but I don't want anyone finding SourceForge...

2021-12-28T18:20:32Z

Links: i don't want to change this, but I don't want anyone finding SourceForge...

← Older revision		Revision as of 18:20, 28 December 2021
Line 46:		Line 46:
	First, here's a list of various websites that I may refer to during the guide. You do not need to worry about them now!		First, here's a list of various websites that I may refer to during the guide. You do not need to worry about them now!

	*KoLmafia~~'s website~~: ~~http~~://kolmafia~~.sourceforge.net~~/<br />		*KoLmafia on GitHub: https://github.com/kolmafia/kolmafia<br />
	*KoLmafia forum: http://kolmafia.us/<br />		*KoLmafia forum: http://kolmafia.us/<br />
	*KolMafia Wiki: http://wiki.kolmafia.us/index.php?title=Main_Page<br />		*KolMafia Wiki: http://wiki.kolmafia.us/index.php?title=Main_Page<br />
Line 58:		Line 58:
	We are now officially starting your KoLmafia lessons!		We are now officially starting your KoLmafia lessons!

	# ~~Go to KoLmafia's website (listed above). The download link is not really obvious; it's a small link at~~ the ~~top left somewhere. Click it to go here:~~ https://~~sourceforge~~.~~net/project/showfiles~~.~~php?group_id=126572~~		# Download the latest build from [https://ci.kolmafia.us KoLmafia's Build Server]
	# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the java Jar file.		# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the java Jar file.
	# Move the file somewhere handy. Note that KoLmafia can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run KoLmafia. No further setup is needed.		# Move the file somewhere handy. Note that KoLmafia can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run KoLmafia. No further setup is needed.

Mcroft: rooting out all "sourceforge" references...

2021-12-28T18:17:06Z

rooting out all "sourceforge" references...

← Older revision		Revision as of 18:17, 28 December 2021
Line 30:		Line 30:
	I decided to try KoLmafia which has these advantages:		I decided to try KoLmafia which has these advantages:

	* More Secure - It comes from ONE ~~sourceforge~~ open-source website and its base version includes plenty of functionality. This makes it much safer to use out of the box.		* More Secure - It comes from ONE open-source website and its base version includes plenty of functionality. This makes it much safer to use out of the box.

	* Easier to Install - No digging around and searching forums for hours to find the right script. (At least not until you have mastered Mafia and go looking for Mafia-specific scripts...)		* Easier to Install - No digging around and searching forums for hours to find the right script. (At least not until you have mastered Mafia and go looking for Mafia-specific scripts...)
Line 39:		Line 39:

	* Easier to Figure Out - While the documentation for KoLmafia is not amazing, you will have a lot more luck finding help documents (like this one!) for Mafia, as opposed to documentation for random Greasemonkey scripts.		* Easier to Figure Out - While the documentation for KoLmafia is not amazing, you will have a lot more luck finding help documents (like this one!) for Mafia, as opposed to documentation for random Greasemonkey scripts.


	== Links ==		== Links ==

Bale at 19:50, 12 July 2010

2010-07-12T19:50:35Z

← Older revision		Revision as of 19:50, 12 July 2010
Line 71:		Line 71:
	'''Continue''' to [[KoLmafia Guide: Basics (Relay Browser)\|Lesson 1: Basics (Relay Browser)]]		'''Continue''' to [[KoLmafia Guide: Basics (Relay Browser)\|Lesson 1: Basics (Relay Browser)]]

	[[Category:KoLmafia Guide]]		[[Category:KoLmafia Guide]][[Category:New User Help]]

Heeheehee: consistency

2010-07-05T17:48:01Z

consistency

SinginSally: /* How I Teach & Requirements */

2010-05-04T14:08:42Z

How I Teach & Requirements

← Older revision		Revision as of 14:08, 4 May 2010
Line 1:		Line 1:
	== How I Teach & Requirements ==		== How I Teach & Requirements ==

	I have only played KoL for 3 months. I am hoping this means that I will not take stuff for-granted like year-long players. ~~It also means~~ I ~~will not~~ address ~~details~~ that I ~~simply don't~~ know ~~about or haven't explored much yet (Clan Dungeons~~, ~~Basement Dive~~, ~~etc~~.).		I have only played KoL for 3 months. (well, more like 7 now!) I am hoping this means that I will not take stuff for-granted like year-long players. I can actually address more advanced stuff now that I know how clan dungeons work, the Sea, and so forth. ;-)

	I assume that you have played KoL for at least a few weeks before reading this guide. This is simply so I can reference examples while teaching. This is not a strict requirement though... it just means that you might not catch some of my examples.		I assume that you have played KoL for at least a few weeks before reading this guide. This is simply so I can reference examples while teaching. This is not a strict requirement though... it just means that you might not catch some of my examples.

	Finally, you need to be able to ~~PLAY~~ while reading this guide! Learning while trying to break a speed ascension record or something is probably not the best way to go. 50 turns should be enough to get through most of the lessons.		Finally, you need to be able to '''play''' while reading this guide! Learning while trying to break a speed ascension record or something is probably not the best way to go. 50 turns should be enough to get through most of the lessons.


Line 11:		Line 11:

	Continue working through the guide by doing 'Lessons' until you have learned as much as you want. The lessons are roughly in the order of importance, or more honestly, the order in which I figured the stuff out. :-) There is tons of stuff that I probably won't cover, but by the time you are done with the lessons, you will have the hang of it.		Continue working through the guide by doing 'Lessons' until you have learned as much as you want. The lessons are roughly in the order of importance, or more honestly, the order in which I figured the stuff out. :-) There is tons of stuff that I probably won't cover, but by the time you are done with the lessons, you will have the hang of it.


	== What About Greasemonkey? ==		== What About Greasemonkey? ==

Bale at 08:53, 2 May 2010

2010-05-02T08:53:28Z

← Older revision		Revision as of 08:53, 2 May 2010
Line 13:		Line 13:


	== What About Greasemonkey ==		== What About Greasemonkey? ==

	Greasemonkey is another scripting tool that can be used for Kingdom of Loathing. Please skip this section if you don't know or care about Greasemonkey.		Greasemonkey is another scripting tool that can be used for Kingdom of Loathing. Please skip this section if you don't know or care about Greasemonkey.

Bale: moved KoLmafia Guide: Introduction to KoLmafia Guide: Preface: Weirdness resolved.

2010-05-02T08:52:11Z

moved KoLmafia Guide: Introduction to KoLmafia Guide: Preface: Weirdness resolved.

← Older revision	Revision as of 08:52, 2 May 2010
(No difference)

← Older revision		Revision as of 17:48, 5 July 2010
Line 8:		Line 8:


	My main goal is to start out playing KoL using ~~KoLMafia~~'s 'Relay Browser', which is basically identical to normal browser play. Then, each short lesson will progressively give you a new 'trick' that you can use. This lets you learn at your own pace.		My main goal is to start out playing KoL using KoLmafia's 'Relay Browser', which is basically identical to normal browser play. Then, each short lesson will progressively give you a new 'trick' that you can use. This lets you learn at your own pace.

	Continue working through the guide by doing 'Lessons' until you have learned as much as you want. The lessons are roughly in the order of importance, or more honestly, the order in which I figured the stuff out. :-) There is tons of stuff that I probably won't cover, but by the time you are done with the lessons, you will have the hang of it.		Continue working through the guide by doing 'Lessons' until you have learned as much as you want. The lessons are roughly in the order of importance, or more honestly, the order in which I figured the stuff out. :-) There is tons of stuff that I probably won't cover, but by the time you are done with the lessons, you will have the hang of it.
Line 28:		Line 28:


	I decided to try ~~KoLMafia~~ which has these advantages:		I decided to try KoLmafia which has these advantages:

	* More Secure - It comes from ONE sourceforge open-source website and its base version includes plenty of functionality. This makes it much safer to use out of the box.		* More Secure - It comes from ONE sourceforge open-source website and its base version includes plenty of functionality. This makes it much safer to use out of the box.
Line 34:		Line 34:
	* Easier to Install - No digging around and searching forums for hours to find the right script. (At least not until you have mastered Mafia and go looking for Mafia-specific scripts...)		* Easier to Install - No digging around and searching forums for hours to find the right script. (At least not until you have mastered Mafia and go looking for Mafia-specific scripts...)

	* Easier to Customize - Not much of an issue at first, but writing a new Greasemonkey script is relatively hard. Modifying ~~KoLMafia~~ behavior can be a lot easier for certain aspects.		* Easier to Customize - Not much of an issue at first, but writing a new Greasemonkey script is relatively hard. Modifying KoLmafia behavior can be a lot easier for certain aspects.

	* Consolidated Updates - All ~~KoLMafia~~ work occurs at its sourceforge website. Versions are numbered and under version-control. This means you can easily find the most up-to-date version and no intermediate fixes were skipped.		* Consolidated Updates - All KoLmafia work occurs at its sourceforge website. Versions are numbered and under version-control. This means you can easily find the most up-to-date version and no intermediate fixes were skipped.

	* Easier to Figure Out - While the documentation for ~~KoLMafia~~ is not amazing, you will have a lot more luck finding help documents (like this one!) for Mafia, as opposed to documentation for random Greasemonkey scripts.		* Easier to Figure Out - While the documentation for KoLmafia is not amazing, you will have a lot more luck finding help documents (like this one!) for Mafia, as opposed to documentation for random Greasemonkey scripts.


	== Links ==		== Links ==

	You need to have this post handy, '''while playing''' I will guide you through each lesson, but you have to be reading it while using ~~KoLMafia~~ for it to really make any sense. Printing it or having it on a second monitor is helpful.		You need to have this post handy, '''while playing''' I will guide you through each lesson, but you have to be reading it while using KoLmafia for it to really make any sense. Printing it or having it on a second monitor is helpful.

	First, here's a list of various websites that I may refer to during the guide. You do not need to worry about them now!		First, here's a list of various websites that I may refer to during the guide. You do not need to worry about them now!

	*~~KolMafia~~'s website: http://kolmafia.sourceforge.net/<br />		*KoLmafia's website: http://kolmafia.sourceforge.net/<br />
	*~~KolMafia~~ forum: http://kolmafia.us/<br />		*KoLmafia forum: http://kolmafia.us/<br />
	*KolMafia Wiki: http://wiki.kolmafia.us/index.php?title=Main_Page<br />		*KolMafia Wiki: http://wiki.kolmafia.us/index.php?title=Main_Page<br />
	*A Previously Existing Guide: http://forums.kingdomofloathing.com/vb/showthread.php?t=140340<br />		*A Previously Existing Guide: http://forums.kingdomofloathing.com/vb/showthread.php?t=140340<br />
	*List of CLI Commands http://kolmafia.sourceforge.net/scripting.html<br />		*List of CLI Commands http://kolmafia.sourceforge.net/scripting.html<br />
	*List of all ~~KolMafia~~ global variables (more for scripting): http://wiki.kolmafia.us/index.php?title=List_of_KoLmafia_Properties<br />		*List of all KoLmafia global variables (more for scripting): http://wiki.kolmafia.us/index.php?title=List_of_KoLmafia_Properties<br />


	== Getting Started ==		== Getting Started ==

	We are now officially starting your ~~KolMafia~~ lessons!		We are now officially starting your KoLmafia lessons!

	# Go to ~~KolMafia~~'s website (listed above). The download link is not really obvious; it's a small link at the top left somewhere. Click it to go here: https://sourceforge.net/project/showfiles.php?group_id=126572		# Go to KoLmafia's website (listed above). The download link is not really obvious; it's a small link at the top left somewhere. Click it to go here: https://sourceforge.net/project/showfiles.php?group_id=126572
	# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the java Jar file.		# By default it picks the appropriate package for you. All you need is '''your''' system's file. As a windows user, I download the 3 Meg executable. Mac users download theirs. Linux, etc. If all else fails, use the java Jar file.
	# Move the file somewhere handy. Note that ~~KolMafia~~ can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run ~~KoLMafia~~. No further setup is needed.		# Move the file somewhere handy. Note that KoLmafia can be downloaded as an executable. However, it does '''not install''' per se. Instead, I like to say that it 'roots'. When executed, '''will create quite a few subfolders''' to store its settings. Therefore, I extremely highly recommend placing it in its own folder. Once moved, make a link to it on your desktop so you can easily execute it. . You just run the file to run KoLmafia. No further setup is needed.
	# If the file doesn't run, you need the 1.6 or better Java Runtime Environment. This is not particularly hard and many will likely already have it. The ~~KolMafia~~ website given above, has a 'Getting Started' section that you can refer to in case of such issues.		# If the file doesn't run, you need the 1.6 or better Java Runtime Environment. This is not particularly hard and many will likely already have it. The KoLmafia website given above, has a 'Getting Started' section that you can refer to in case of such issues.
	# When you first run it, '''two''' windows pop up. Ignore the complicated looking frame, and look at the one with the login fields. Type in your login info (make sure you don't have KoL running elsewhere obviously), then click the '''LOGIN''' button. Ignore the RELAY button for now. Keep the other options unchecked, including breakfast. We will discuss this stuff later.		# When you first run it, '''two''' windows pop up. Ignore the complicated looking frame, and look at the one with the login fields. Type in your login info (make sure you don't have KoL running elsewhere obviously), then click the '''LOGIN''' button. Ignore the RELAY button for now. Keep the other options unchecked, including breakfast. We will discuss this stuff later.
	# The Login frame goes away and now you have the main box, which I will call the ~~KolMafia~~ Frame. I don't have a place to store an up to date picture, but the whole thing is kind-of intimidating. You are probably ready to quit, but ''stick in there!''' We will make this easy by doing things step-by-step. I'm a noob, remember? I got your back! ;-)		# The Login frame goes away and now you have the main box, which I will call the KoLmafia Frame. I don't have a place to store an up to date picture, but the whole thing is kind-of intimidating. You are probably ready to quit, but ''stick in there!''' We will make this easy by doing things step-by-step. I'm a noob, remember? I got your back! ;-)
	# Note that is possible that ~~KolMafia~~ '''may pop up an events logger window'''. This occurrs if you were attacked, received a message, or whatever other event type stuff might happen. Just close that small window if you encounter it.		# Note that is possible that KoLmafia '''may pop up an events logger window'''. This occurrs if you were attacked, received a message, or whatever other event type stuff might happen. Just close that small window if you encounter it.