KoLmafia Guide: Running ASH Scripts - Revision history

StDoodle at 19:44, 23 November 2010

2010-11-23T19:44:07Z

← Older revision		Revision as of 19:44, 23 November 2010
Line 12:		Line 12:
	# Open the script using Notepad or similar text browser. Take a look. This is just so you can see what a script looks like, and also for your own peace of mind.		# Open the script using Notepad or similar text browser. Take a look. This is just so you can see what a script looks like, and also for your own peace of mind.
	# Do a Find, and look for "buy", "sell", "notify", and "send" text. This is a quick security check. Notify is a one-time mailing to the developer of a script which just lets them know you use their script. It makes the script writers happy, I guess. Send/csend can actually mail people Meat or Items so ensure that nothing funny is going on there. Buy/Sell deals with item manipulation. You want to make sure a script is not gonna go sell all your stuff or buy expensive things. Even the best intended script can bankrupt you.		# Do a Find, and look for "buy", "sell", "notify", and "send" text. This is a quick security check. Notify is a one-time mailing to the developer of a script which just lets them know you use their script. It makes the script writers happy, I guess. Send/csend can actually mail people Meat or Items so ensure that nothing funny is going on there. Buy/Sell deals with item manipulation. You want to make sure a script is not gonna go sell all your stuff or buy expensive things. Even the best intended script can bankrupt you.
	# Move the Tattoos.ash script to where your KoL executable lives. Remember in our first lesson we put KoLmafia in a folder. Since then, Mafia created several sub-folders where it stores its settings and stuff. In particular, a sub-directory called 'Scripts' should be present. Move Tattoos.ash into the scripts subdirectory.		# Move the Tattoos.ash script to where your KoL executable lives. Remember in our first lesson we put KoLmafia in a folder. Since then, Mafia created several sub-folders where it stores its settings and stuff. In particular, a sub-directory called 'Scripts' should be present. Move Tattoos.ash into the scripts subdirectory. (For users on non-Windows, refer to [[Mafia directories]] for OS-specific directory locations.)
	# At the top, click Scripts and 'Refresh Menu'. Go to Scripts again and you will see 'Tattoo.ash' in the list. You could click it to execute. Do not do this right now though.		# At the top, click Scripts and 'Refresh Menu'. Go to Scripts again and you will see 'Tattoo.ash' in the list. You could click it to execute. Do not do this right now though.
	# Back in Mafia, click the Graphical CLI tab.		# Back in Mafia, click the Graphical CLI tab.

Bale: urg

2010-08-23T21:19:35Z

urg

← Older revision		Revision as of 21:19, 23 August 2010
Line 22:		Line 22:

	===Tattoo script===		===Tattoo script===
	<div style="margin-bottom: 1em; padding: 1em; margin:0px 20px;">{{CodeSample\|code=<syntaxhighlight>		<div style="margin-bottom: 1em; font-size: 12px; padding: 1em; margin:0px 20px;">{{CodeSample\|code=<syntaxhighlight>
	## Original script from: http://kolmafia.us/index.php/topic,527.msg2569.html#msg2569 [19 October 2006]		## Original script from: http://kolmafia.us/index.php/topic,527.msg2569.html#msg2569 [19 October 2006]
	## Updated by Hippymon 13 November 2007		## Updated by Hippymon 13 November 2007

Bale: formatting fiddly

2010-08-23T21:16:47Z

formatting fiddly

← Older revision		Revision as of 21:16, 23 August 2010
Line 22:		Line 22:

	===Tattoo script===		===Tattoo script===
	<div style="margin-bottom: 1em~~; font-size: 12px; border: dashed 1px green~~; padding: 1em; margin:0px 20px;"><syntaxhighlight>		<div style="margin-bottom: 1em; padding: 1em; margin:0px 20px;">{{CodeSample\|code=<syntaxhighlight>
	## Original script from: http://kolmafia.us/index.php/topic,527.msg2569.html#msg2569 [19 October 2006]		## Original script from: http://kolmafia.us/index.php/topic,527.msg2569.html#msg2569 [19 October 2006]
	## Updated by Hippymon 13 November 2007		## Updated by Hippymon 13 November 2007
Line 112:		Line 112:
	print("* Check your Display Case and / or your Colossal Closet for possible missing outfit pieces. *");		print("* Check your Display Case and / or your Colossal Closet for possible missing outfit pieces. *");
	print("__________________________________________________________________________");		print("__________________________________________________________________________");
	</syntaxhighlight></div>		</syntaxhighlight>}}</div>


	===Bonus Lessons===		===Bonus Lessons===

Bale at 19:54, 12 July 2010

2010-07-12T19:54:07Z

← Older revision		Revision as of 19:54, 12 July 2010
Line 128:		Line 128:
	Continue to [[KoLmafia Guide: Useful Commands\|Lesson 14: Useful Commands]]		Continue to [[KoLmafia Guide: Useful Commands\|Lesson 14: Useful Commands]]

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

Heeheehee: Missed one. =P

2010-07-05T17:57:52Z

Missed one. =P

← Older revision		Revision as of 17:57, 5 July 2010
Line 1:		Line 1:
	{{TOCright}}		{{TOCright}}
	~~KolMafia~~ has the capability to execute scripts which can perform just about any KoL action. Mafia scripting uses an .ash extension and is simply a text file that contains a bunch of Mafia commands with some programming language constructs as needed. You can browse, download, and execute scripts that other people have written to help automate specific functions or expand Mafia capabilities.		KoLmafia has the capability to execute scripts which can perform just about any KoL action. Mafia scripting uses an .ash extension and is simply a text file that contains a bunch of Mafia commands with some programming language constructs as needed. You can browse, download, and execute scripts that other people have written to help automate specific functions or expand Mafia capabilities.

	This poses a bit of a security risk, obviously. Mafia is all open-source and examined by many people and is relatively trustworthy. Some random dude's script.... not so much. Feel free to skip this lesson if this makes you nervous. Note that scripts can be extremely helpful though, so it is worth learning about them.		This poses a bit of a security risk, obviously. Mafia is all open-source and examined by many people and is relatively trustworthy. Some random dude's script.... not so much. Feel free to skip this lesson if this makes you nervous. Note that scripts can be extremely helpful though, so it is worth learning about them.

Heeheehee: consistency

2010-07-05T17:53:56Z

consistency

← Older revision		Revision as of 17:53, 5 July 2010
Line 7:		Line 7:


	# First, we need to find a script we want to execute. For this lesson, point your browser to the [http://kolmafia.us/forum.php ~~KolMafia~~ forum]. This mafia forum has a compendium of various scripts that you can look through in the future. For now, in <span class="plainlinks">[http://kolmafia.us/showthread.php?t=1736&highlight=tattoo this forum thread]</span>, scroll to the last entry and find the most updated Tattoo.ash attachment.		# First, we need to find a script we want to execute. For this lesson, point your browser to the [http://kolmafia.us/forum.php KoLmafia forum]. This mafia forum has a compendium of various scripts that you can look through in the future. For now, in <span class="plainlinks">[http://kolmafia.us/showthread.php?t=1736&highlight=tattoo this forum thread]</span>, scroll to the last entry and find the most updated Tattoo.ash attachment.
	# Click and download the Tattoos.ash attachment. You might have to join the ~~KolMafia~~ forum to do the download. It is not a bad idea to do so anyways, so go ahead and do it. Or you can cut&paste from the bottom of this page into a Tattoos.ash text file.		# Click and download the Tattoos.ash attachment. You might have to join the KoLmafia forum to do the download. It is not a bad idea to do so anyways, so go ahead and do it. Or you can cut&paste from the bottom of this page into a Tattoos.ash text file.
	# Go find the downloaded Tattoos.ash on your computer.		# Go find the downloaded Tattoos.ash on your computer.
	# Open the script using Notepad or similar text browser. Take a look. This is just so you can see what a script looks like, and also for your own peace of mind.		# Open the script using Notepad or similar text browser. Take a look. This is just so you can see what a script looks like, and also for your own peace of mind.
	# Do a Find, and look for "buy", "sell", "notify", and "send" text. This is a quick security check. Notify is a one-time mailing to the developer of a script which just lets them know you use their script. It makes the script writers happy, I guess. Send/csend can actually mail people Meat or Items so ensure that nothing funny is going on there. Buy/Sell deals with item manipulation. You want to make sure a script is not gonna go sell all your stuff or buy expensive things. Even the best intended script can bankrupt you.		# Do a Find, and look for "buy", "sell", "notify", and "send" text. This is a quick security check. Notify is a one-time mailing to the developer of a script which just lets them know you use their script. It makes the script writers happy, I guess. Send/csend can actually mail people Meat or Items so ensure that nothing funny is going on there. Buy/Sell deals with item manipulation. You want to make sure a script is not gonna go sell all your stuff or buy expensive things. Even the best intended script can bankrupt you.
	# Move the Tattoos.ash script to where your KoL executable lives. Remember in our first lesson we put ~~KolMafia~~ in a folder. Since then, Mafia created several sub-folders where it stores its settings and stuff. In particular, a sub-directory called 'Scripts' should be present. Move Tattoos.ash into the scripts subdirectory.		# Move the Tattoos.ash script to where your KoL executable lives. Remember in our first lesson we put KoLmafia in a folder. Since then, Mafia created several sub-folders where it stores its settings and stuff. In particular, a sub-directory called 'Scripts' should be present. Move Tattoos.ash into the scripts subdirectory.
	# At the top, click Scripts and 'Refresh Menu'. Go to Scripts again and you will see 'Tattoo.ash' in the list. You could click it to execute. Do not do this right now though.		# At the top, click Scripts and 'Refresh Menu'. Go to Scripts again and you will see 'Tattoo.ash' in the list. You could click it to execute. Do not do this right now though.
	# Back in Mafia, click the Graphical CLI tab.		# Back in Mafia, click the Graphical CLI tab.
Line 116:		Line 116:

	===Bonus Lessons===		===Bonus Lessons===
	Bonus 1) Browse the <span class="plainlinks">[http://kolmafia.us/forumdisplay.php?3-Repository ~~KolMafia~~ scripts forum]</span> briefly. You can see that there are some pretty cool scripts available, such as ones that automate several annoying aspects of quests for you. You might note that some scripts have prerequisites. One script in particular, ZLib, was created solely as a programming library for other script-writers and is widely used.		Bonus 1) Browse the <span class="plainlinks">[http://kolmafia.us/forumdisplay.php?3-Repository KoLmafia scripts forum]</span> briefly. You can see that there are some pretty cool scripts available, such as ones that automate several annoying aspects of quests for you. You might note that some scripts have prerequisites. One script in particular, ZLib, was created solely as a programming library for other script-writers and is widely used.

	Bonus 2) I just started doing the Slime Tube and it sure is a pain. I found a cool slime.ash program which would outfit you, fight the slime, then rinse off when the Covered In Slime effect would kill you. However, it would make me take up to 99% of my HPs in Slime, then waste tons of healing aids to get me back to max. I modified it to auto-rinse after taking 500 damage from a single Covered in Slime effect. This let me kill slime without needing any healing effects at all.		Bonus 2) I just started doing the Slime Tube and it sure is a pain. I found a cool slime.ash program which would outfit you, fight the slime, then rinse off when the Covered In Slime effect would kill you. However, it would make me take up to 99% of my HPs in Slime, then waste tons of healing aids to get me back to max. I modified it to auto-rinse after taking 500 damage from a single Covered in Slime effect. This let me kill slime without needing any healing effects at all.

Bale: formatting

2010-05-18T04:19:03Z

formatting

Show changes

Bale at 20:43, 17 May 2010

2010-05-17T20:43:13Z

← Older revision		Revision as of 20:43, 17 May 2010
Line 6:		Line 6:


	# First, we need to find a script we want to execute. For this lesson, point your browser to the KolMafia forum~~. (link at the top of the guide)~~. This mafia forum has a compendium of various scripts that you can look through in the future. For now, in <span class="plainlinks">[http://kolmafia.us/showthread.php?t=1736&highlight=tattoo this forum thread]</span>, scroll to the last entry and find the most updated Tattoo.ash attachment.		# First, we need to find a script we want to execute. For this lesson, point your browser to the [http://kolmafia.us/forum.php KolMafia forum]. This mafia forum has a compendium of various scripts that you can look through in the future. For now, in <span class="plainlinks">[http://kolmafia.us/showthread.php?t=1736&highlight=tattoo this forum thread]</span>, scroll to the last entry and find the most updated Tattoo.ash attachment.
	# Click and download the Tattoos.ash attachment. You might have to join the KolMafia forum to do the download. It is not a bad idea to do so anyways, so go ahead and do it.		# Click and download the Tattoos.ash attachment. You might have to join the KolMafia forum to do the download. It is not a bad idea to do so anyways, so go ahead and do it.
	Or, you can cut&paste from the bottom of this page into a Tattoos.ash text file.		Or, you can cut&paste from the bottom of this page into a Tattoos.ash text file.

SinginSally at 17:03, 17 May 2010

2010-05-17T17:03:44Z

← Older revision		Revision as of 17:03, 17 May 2010
Line 177:		Line 177:


	BOTTOM LINE: ~~There are a lot of really useful~~ scripts ~~people have already written which~~ can ~~help~~ you ~~out~~.		'''BOTTOM LINE:''' Learning how to safely execute other people's scripts can be extremely helpful. Just about anything you want to do, someone else has wanted to do it also, and probably has a script for it.


	Continue to [[KoLmafia Guide: Useful Commands\|Lesson 14: Useful Commands]]		Continue to [[KoLmafia Guide: Useful Commands\|Lesson 14: Useful Commands]]

	[[Category:KoLmafia Guide]]		[[Category:KoLmafia Guide]]

SinginSally at 16:07, 11 May 2010

2010-05-11T16:07:12Z

Show changes