Kolmafia - User contributions [en]

Main Page

2020-11-09T23:18:50Z

Fewyn: Reverted edits by MediaWiki default (talk) to last revision by imported>Mcroft

<center>
<div align="center" style="margin: 0 0 20px 0; text-align: center; border: none;">
Welcome to the KoLmafia Wiki! 
Progress level: [[Special:Statistics|{{NUMBEROFARTICLES}}]]
</div>

<div style="width: 50%; float: left;">

<table style="width: 90%; border: 2px solid black; margin: 5px 5px 15px 5px;" cellpadding="0" cellspacing="0">
<tr><td colspan=2 style="background-color: #ffac62; padding: 4px; border-bottom: 1px solid black">Quick Links for ASH Scripters</td></tr>
<tr>
<td style="background-color: #ffc48e; padding: 4px; vertical-align: top;">
FUNCTION CATEGORIES 
* [[Your Character]]
* [[Item Management]]
* [[Equipment]]
* [[Skills and Effects]]
* [[Adventuring]]
* [[In-combat Consulting]]
* [[Math and Numbers]]
* [[String Handling Routines]]
* [[Money Making Game]]
* [[Datatype Conversions]]
* [[Modifier Functions]]
* [[Relay Browser Functions]]
* [[Miscellaneous Functions|Miscellaneous]]
</td>
<td style="background-color: #ffc48e; padding: 4px; vertical-align: top;">
LANGUAGE CONVENTIONS 
* [[Operators]]
* [[Data Types]]
* [[Control Structures]]
* [[Data Structures]]
* [[Proxy Records]]
* [[Miscellaneous ASH Features|Misc. ASH Features]]
HELPFUL RESOURCES 
* [[ASH For Beginners]]
* [[KoLmafia Properties]]
* [[Ash Functions|Master Function List]]
* [[CLI Reference|CLI Commands]]
* [[Helpful Scripts]]
</td>
</tr>
</table>

<table style="width: 90%; border: 2px solid black; margin: 5px 5px 15px 5px;" cellpadding="0" cellspacing="0">
<tr><td style="background-color: #b0ddb0; padding: 4px; border-bottom: 1px solid black">How Does KoLmafia Help?</td></tr>
<tr>
<td style="background-color: #c0ffc0; padding: 4px;">
* [[Automation]]
* [[Quests|Helping with Quests]]
* [[Basement|Basement Diving]]
</td>
</tr>
</table>

</div>

</center>
<div style="width: 50%; float: right;">

<table style="width: 90%; border: 2px solid black; margin: 5px 5px 15px 5px;" cellpadding="0" cellspacing="0">
<tr><td style="background-color: #aeaeee; padding: 4px; border-bottom: 1px solid black">New User Help</td></tr>
<tr>
<td style="background-color: #bfbfff; padding: 4px;">
* [[Installation]]
{{
Hidelist
|title=[[KoLmafia Guide]] by SinginSally
|1=[[KoLmafia Guide: Preface|Preface]]
|2=[[KoLmafia Guide: Basics (Relay Browser)|Lesson 1: Basics (Relay Browser)]]
|3=[[KoLmafia Guide: Java Interface|Lesson 2: Java Interface]]
|4=[[KoLmafia Guide: Stats-Checking|Lesson 3: Stats-Checking]]
|5=[[KoLmafia Guide: Attack Script|Lesson 4: Attack Script]]
|6=[[KoLmafia Guide: Custom Combat Script|Lesson 5: Custom Combat Script]]
|7=[[KoLmafia Guide: Auto-Adventuring|Lesson 6: Auto-Adventuring]]
|8=[[KoLmafia Guide: Automatic HP/MP Recovery|Lesson 7: Automatic HP/MP Recovery]]
|9=[[KoLmafia Guide: Goal-Oriented Adventuring|Lesson 8: Goal-Oriented Adventuring]]
|10=[[KoLmafia Guide: Setting Preferences|Lesson 9: Setting Preferences]]
|11=[[KoLmafia Guide: Setting Up Breakfast|Lesson 10: Setting Up Breakfast]]
|12=[[KoLmafia Guide: Eating & Drinking|Lesson 11: Eating & Drinking]]
|13=[[KoLmafia Guide: PvP (Beating Up People)|Lesson 12: PvP (Beating Up People)]]
|14=[[KoLmafia Guide: Running ASH Scripts|Lesson 13: Running ASH Scripts]]
|15=[[KoLmafia Guide: Useful Commands|Lesson 14: Useful Commands]]
|16=[[KoLmafia Guide: Closing Thoughts|Lesson 15: Closing Thoughts]]
}}
* [[SVN Primer]]
* [[Helpful Links]]
* [[Help:Frequently Asked Questions|KoLmafia FAQ]]
</td>
</tr>
</table>

<table style="width: 90%; border: 2px solid black; margin: 5px 5px 15px 5px;" cellpadding="0" cellspacing="0">
<tr><td style="background-color: #aeaeee; padding: 4px; border-bottom: 1px solid black">Advanced Features</td></tr>
<tr>
<td style="background-color: #bfbfff; padding: 4px;">
* [[Modifier Maximizer]]
* [[Daily Deeds]]
* [[Hidden Features]]
</td>
</tr>
</table>

<table style="width: 90%; border: 2px solid black; margin: 5px 5px 15px 5px;" cellpadding="0" cellspacing="0">
<tr><td style="background-color: #aeaeee; padding: 4px; border-bottom: 1px solid black">Contributing to the KoLmafia Project</td></tr>
<tr>
<td style="background-color: #bfbfff; padding: 4px;">
* [[Compiling from Source]]
* [[Development Environment Setup]]
* [[Mafia's Code]]
* [[Making a Patch]]
* [[Reporting a Bug/Requesting a Feature]]
* [[Help:Editing|Editing the Wiki Documentation]]
* [[Help:To Do List|Wiki "To Do" List]]
</td>
</tr>
</table>

</div>

File:SohWhy9.png

2020-11-08T22:00:58Z

Fewyn:

MediaWiki:Sidebar

2020-10-27T13:03:23Z

Fewyn:

MediaWiki:Sidebar

2018-10-17T18:46:16Z

Fewyn:

MediaWiki:Common.js

2014-03-08T02:35:33Z

Fewyn:

/* Any JavaScript here will be loaded for all users on every page load. */
//<source lang="javascript">

/*
* Description: Redirects from /User:UserName/skin.js or .css to the user's actual skin page
* Maintainer: Cacycle
*/
if (wgArticleId == 0 && wgUserName) {
var slash = wgPageName.indexOf('/');
var norm = wgPageName.substr(0, slash) + wgPageName.substr(slash).toLowerCase();
var test = 'User:' + wgUserName.replace(/ /g, '_') + '/skin.';
var ext = null;
if (norm == test + 'js') ext = 'js';
else if (norm == test + 'css') ext = 'css';
if (ext != null) window.location.href = window.location.href.replace(/\/skin.(css|js)/i, '/' + skin + '.' + ext);
}

/** extract a URL parameter from the current URL **********
* From [[en:User:Lupin/autoedit.js]]
*
* paramName : the name of the parameter to extract
*/
function getURLParamValue( paramName, url)
{
if (typeof (url) == 'undefined' || url === null) url = document.location.href;
var cmdRe=RegExp( '[&?]' + paramName + '=([^&#]*)' ); // Stop at hash
var m=cmdRe.exec(url);
if (m && m.length > 1) return decodeURIComponent(m[1]);
return null;
}

/** &withJS= URL parameter *******
* Allow to try custom scripts from MediaWiki space
* without editing [[Special:Mypage/monobook.js]]
*/
var extraJS = getURLParamValue("withJS");
if ( extraJS && extraJS.match("^MediaWiki:[^&<>=%]*\.js$") ) {
importScript(extraJS);
}

/* Import more specific scripts if necessary */

if (wgAction == "edit" || wgAction == "submit" || wgPageName == "Special:Upload") //scripts specific to editing pages
{
importScript("MediaWiki:Common.js/edit.js")
}
else if (wgPageName == "Special:Watchlist") //watchlist scripts
{
importScript("MediaWiki:Common.js/watchlist.js")
}
if( wgNamespaceNumber == 6 ) {
importScript('MediaWiki:Common.js/file.js');
}

/** For sysops and accountcreators *****************************************
*
* Description: Allows for sysop-specific Javascript at [[MediaWiki:Sysop.js]],
* and accountcreator-specific CSS at [[MediaWiki:Accountcreator.css]].
*/
if ( wgUserGroups ) {
for ( var g = 0; g < wgUserGroups.length; ++g ) {
if ( wgUserGroups[g] == "sysop" ) {
importStylesheet("MediaWiki:Sysop.css");
addOnloadHook( function() {
if ( !window.disableSysopJS ) {
importScript("MediaWiki:Sysop.js");
}
} );
}
else if ( wgUserGroups[g] == "accountcreator" ) {
importStylesheet("MediaWiki:Accountcreator.css");
}
}
}

/** WikiMiniAtlas *******************************************************
*
* Description: WikiMiniAtlas is a popup click and drag world map.
* This script causes all of our coordinate links to display the WikiMiniAtlas popup button.
* The script itself is located on meta because it is used by many projects.
* See [[Meta:WikiMiniAtlas]] for more information.
* Maintainers: [[User:Dschwen]]
*/

if (wgServer == "https://secure.wikimedia.org") {
var metaBase = "https://secure.wikimedia.org/wikipedia/meta";
} else {
var metaBase = "http://meta.wikimedia.org";
}
importScriptURI(metaBase+"/w/index.php?title=MediaWiki:Wikiminiatlas.js&action=raw&ctype=text/javascript&smaxage=21600&maxage=86400")

/* Scripts specific to Internet Explorer */

if (navigator.appName == "Microsoft Internet Explorer")
{
/** Internet Explorer bug fix **************************************************
*
* Description: Fixes IE horizontal scrollbar bug
* Maintainers: [[User:Tom-]]?
*/

var oldWidth;
var docEl = document.documentElement;

function fixIEScroll()
{
if (!oldWidth || docEl.clientWidth > oldWidth)
doFixIEScroll();
else
setTimeout(doFixIEScroll, 1);

oldWidth = docEl.clientWidth;
}

function doFixIEScroll() {
docEl.style.overflowX = (docEl.scrollWidth - docEl.clientWidth < 4) ? "hidden" : "";
}

document.attachEvent("onreadystatechange", fixIEScroll);
document.attachEvent("onresize", fixIEScroll);

/**
* Remove need for CSS hacks regarding MSIE and IPA.
*/
if (document.createStyleSheet) {
document.createStyleSheet().addRule('.IPA', 'font-family: "Doulos SIL", "Charis SIL", Gentium, "DejaVu Sans", Code2000, "TITUS Cyberbit Basic", "Arial Unicode MS", "Lucida Sans Unicode", "Chrysanthi Unicode";');
}

// In print IE (7?) does not like line-height
appendCSS( '@media print { sup, sub, p, .documentDescription { line-height: normal; }}');

// IE overflow bug
appendCSS('div.overflowbugx { overflow-x: scroll !important; overflow-y: hidden !important; } div.overflowbugy { overflow-y: scroll !important; overflow-x: hidden !important; }');

// IE zoomfix
//Use to fix right floating div/table inside tables.
appendCSS('.iezoomfix div, .iezoomfix table { zoom: 1;}' );

//Import scripts specific to Internet Explorer 6
if (navigator.appVersion.substr(22, 1) == "6") {
importScript("MediaWiki:Common.js/IE60Fixes.js")
}
}

/* Test if an element has a certain class **************************************
*
* Description: Uses regular expressions and caching for better performance.
* Maintainers: [[User:Mike Dillon]], [[User:R. Koot]], [[User:SG]]
*/

var hasClass = (function () {
var reCache = {};
return function (element, className) {
return (reCache[className] ? reCache[className] : (reCache[className] = new RegExp("(?:\\s|^)" + className + "(?:\\s|$)"))).test(element.className);
};
})();

/** Interwiki links to featured articles ***************************************
*
* Description: Highlights interwiki links to featured articles (or
* equivalents) by changing the bullet before the interwiki link
* into a star.
* Maintainers: [[User:R. Koot]]
*/

function LinkFA()
{
if ( document.getElementById( "p-lang" ) ) {
var InterwikiLinks = document.getElementById( "p-lang" ).getElementsByTagName( "li" );

for ( var i = 0; i < InterwikiLinks.length; i++ ) {
if ( document.getElementById( InterwikiLinks[i].className + "-fa" ) ) {
InterwikiLinks[i].className += " FA"
InterwikiLinks[i].title = "This is a featured article in another language.";
}
}
}
}

addOnloadHook( LinkFA );

/** Collapsible tables *********************************************************
*
* Description: Allows tables to be collapsed, showing only the header. See
* [[Wikipedia:NavFrame]].
* Maintainers: [[User:R. Koot]]
*/

var autoCollapse = 2;
var collapseCaption = "-";
var expandCaption = "+";

function collapseTable( tableIndex )
{
var Button = document.getElementById( "collapseButton" + tableIndex );
var Table = document.getElementById( "collapsibleTable" + tableIndex );

if ( !Table || !Button ) {
return false;
}

var Rows = Table.rows;

if ( Button.firstChild.data == collapseCaption ) {
for ( var i = 1; i < Rows.length; i++ ) {
Rows[i].style.display = "none";
}
Button.firstChild.data = expandCaption;
} else {
for ( var i = 1; i < Rows.length; i++ ) {
Rows[i].style.display = Rows[0].style.display;
}
Button.firstChild.data = collapseCaption;
}
}

function createCollapseButtons()
{
var tableIndex = 0;
var NavigationBoxes = new Object();
var Tables = document.getElementsByTagName( "table" );

for ( var i = 0; i < Tables.length; i++ ) {
if ( hasClass( Tables[i], "collapsible" ) ) {

/* only add button and increment count if there is a header row to work with */
var HeaderRow = Tables[i].getElementsByTagName( "tr" )[0];
if (!HeaderRow) continue;
var Header = HeaderRow.getElementsByTagName( "th" )[0];
if (!Header) continue;

NavigationBoxes[ tableIndex ] = Tables[i];
Tables[i].setAttribute( "id", "collapsibleTable" + tableIndex );

var Button = document.createElement( "span" );
var ButtonLink = document.createElement( "a" );
var ButtonText = document.createTextNode( collapseCaption );

Button.className = "collapseButton"; //Styles are declared in Common.css

ButtonLink.style.color = Header.style.color;
ButtonLink.setAttribute( "id", "collapseButton" + tableIndex );
ButtonLink.setAttribute( "href", "javascript:collapseTable(" + tableIndex + ");" );
ButtonLink.appendChild( ButtonText );

Button.appendChild( document.createTextNode( "[" ) );
Button.appendChild( ButtonLink );
Button.appendChild( document.createTextNode( "]" ) );

Header.insertBefore( Button, Header.childNodes[0] );
tableIndex++;
}
}

for ( var i = 0; i < tableIndex; i++ ) {
if ( hasClass( NavigationBoxes[i], "collapsed" ) || ( tableIndex >= autoCollapse && hasClass( NavigationBoxes[i], "autocollapse" ) ) ) {
collapseTable( i );
}
else if ( hasClass( NavigationBoxes[i], "innercollapse" ) ) {
var element = NavigationBoxes[i];
while (element = element.parentNode) {
if ( hasClass( element, "outercollapse" ) ) {
collapseTable ( i );
break;
}
}
}
}
}

addOnloadHook( createCollapseButtons );

/** Dynamic Navigation Bars (experimental) *************************************
*
* Description: See [[Wikipedia:NavFrame]].
* Maintainers: UNMAINTAINED
*/

// set up the words in your language
var NavigationBarHide = '[' + collapseCaption + ']';
var NavigationBarShow = '[' + expandCaption + ']';

// shows and hides content and picture (if available) of navigation bars
// Parameters:
// indexNavigationBar: the index of navigation bar to be toggled
function toggleNavigationBar(indexNavigationBar)
{
var NavToggle = document.getElementById("NavToggle" + indexNavigationBar);
var NavFrame = document.getElementById("NavFrame" + indexNavigationBar);

if (!NavFrame || !NavToggle) {
return false;
}

// if shown now
if (NavToggle.firstChild.data == NavigationBarHide) {
for (var NavChild = NavFrame.firstChild; NavChild != null; NavChild = NavChild.nextSibling) {
if (hasClass(NavChild, 'NavContent') || hasClass(NavChild, 'NavPic')) {
NavChild.style.display = 'none';
}
}
NavToggle.firstChild.data = NavigationBarShow;

// if hidden now
} else if (NavToggle.firstChild.data == NavigationBarShow) {
for (var NavChild = NavFrame.firstChild; NavChild != null; NavChild = NavChild.nextSibling) {
if (hasClass(NavChild, 'NavContent') || hasClass(NavChild, 'NavPic')) {
NavChild.style.display = 'block';
}
}
NavToggle.firstChild.data = NavigationBarHide;
}
}

// adds show/hide-button to navigation bars
function createNavigationBarToggleButton()
{
var indexNavigationBar = 0;
// iterate over all < div >-elements
var divs = document.getElementsByTagName("div");
for (var i = 0; NavFrame = divs[i]; i++) {
// if found a navigation bar
if (hasClass(NavFrame, "NavFrame")) {

indexNavigationBar++;
var NavToggle = document.createElement("a");
NavToggle.className = 'NavToggle';
NavToggle.setAttribute('id', 'NavToggle' + indexNavigationBar);
NavToggle.setAttribute('href', 'javascript:toggleNavigationBar(' + indexNavigationBar + ');');

var isCollapsed = hasClass( NavFrame, "collapsed" );
/*
* Check if any children are already hidden. This loop is here for backwards compatibility:
* the old way of making NavFrames start out collapsed was to manually add style="display:none"
* to all the NavPic/NavContent elements. Since this was bad for accessibility (no way to make
* the content visible without JavaScript support), the new recommended way is to add the class
* "collapsed" to the NavFrame itself, just like with collapsible tables.
*/
for (var NavChild = NavFrame.firstChild; NavChild != null && !isCollapsed; NavChild = NavChild.nextSibling) {
if ( hasClass( NavChild, 'NavPic' ) || hasClass( NavChild, 'NavContent' ) ) {
if ( NavChild.style.display == 'none' ) {
isCollapsed = true;
}
}
}
if (isCollapsed) {
for (var NavChild = NavFrame.firstChild; NavChild != null; NavChild = NavChild.nextSibling) {
if ( hasClass( NavChild, 'NavPic' ) || hasClass( NavChild, 'NavContent' ) ) {
NavChild.style.display = 'none';
}
}
}
var NavToggleText = document.createTextNode(isCollapsed ? NavigationBarShow : NavigationBarHide);
NavToggle.appendChild(NavToggleText);

// Find the NavHead and attach the toggle link (Must be this complicated because Moz's firstChild handling is borked)
for(var j=0; j < NavFrame.childNodes.length; j++) {
if (hasClass(NavFrame.childNodes[j], "NavHead")) {
NavFrame.childNodes[j].appendChild(NavToggle);
}
}
NavFrame.setAttribute('id', 'NavFrame' + indexNavigationBar);
}
}
}

addOnloadHook( createNavigationBarToggleButton );

/** Main Page layout fixes *********************************************************
*
* Description: Adds an additional link to the complete list of languages available.
* Maintainers: [[User:AzaToth]], [[User:R. Koot]], [[User:Alex Smotrov]]
*/

if (wgPageName == 'Main_Page' || wgPageName == 'Talk:Main_Page')
addOnloadHook(function () {
addPortletLink('p-lang', 'http://meta.wikimedia.org/wiki/List_of_Wikipedias',
'Complete list', 'interwiki-completelist', 'Complete list of Wikipedias')
var nstab = document.getElementById('ca-nstab-main')
if (nstab && wgUserLanguage=='en') {
while (nstab.firstChild) nstab = nstab.firstChild
nstab.nodeValue = 'Main Page'
}
}
)

/** Table sorting fixes ************************************************
*
* Description: Disables code in table sorting routine to set classes on even/odd rows
* Maintainers: [[User:Random832]]
*/

ts_alternate_row_colors = false;

/***** uploadwizard_newusers ********
* Switches in a message for non-autoconfirmed users at [[Wikipedia:Upload]]
*
* Maintainers: [[User:Krimpet]]
****/
function uploadwizard_newusers() {
if (wgNamespaceNumber == 4 && wgTitle == "Upload" && wgAction == "view") {
var oldDiv = document.getElementById("autoconfirmedusers"),
newDiv = document.getElementById("newusers");
if (oldDiv && newDiv) {
if (typeof wgUserGroups == "object" && wgUserGroups) {
for (i = 0; i < wgUserGroups.length; i++) {
if (wgUserGroups[i] == "autoconfirmed") {
oldDiv.style.display = "block";
newDiv.style.display = "none";
return;
}
}
}
oldDiv.style.display = "none";
newDiv.style.display = "block";
return;
}
}
}
addOnloadHook(uploadwizard_newusers);

/** IPv6 AAAA connectivity testing **/

var __ipv6wwwtest_factor = 100;
var __ipv6wwwtest_done = 0;
if ((wgServer != "https://secure.wikimedia.org") && (Math.floor(Math.random()*__ipv6wwwtest_factor)==42)) {
importScript("MediaWiki:Common.js/IPv6.js");
}

/** Magic editintros ****************************************************
*
* Description: Adds editintros on disambiguation pages and BLP pages.
* Maintainers: [[User:RockMFR]]
*/

function addEditIntro(name)
{
var el = document.getElementById('ca-edit');
if (!el)
return;
el = el.getElementsByTagName('a')[0];
if (el)
el.href += '&editintro=' + name;
}

if (wgNamespaceNumber == 0) {
addOnloadHook(function(){
if (document.getElementById('disambigbox'))
addEditIntro('Template:Disambig_editintro');
});

addOnloadHook(function(){
var cats = document.getElementById('mw-normal-catlinks');
if (!cats)
return;
cats = cats.getElementsByTagName('a');
for (var i = 0; i < cats.length; i++) {
if (cats[i].title == 'Category:Living people' || cats[i].title == 'Category:Possibly living people') {
addEditIntro('Template:BLP_editintro');
break;
}
}
});
}

/*
* Description: Stay on the secure server as much as possible
* Maintainers: [[User:TheDJ]]
*/
if(wgServer == 'https://secure.wikimedia.org') {
importScript( 'MediaWiki:Common.js/secure.js');
}

//</source>

KoLmafia Guide: Basics (Relay Browser)

2013-09-15T21:59:43Z

Fewyn:

We are going to play using KoLmafia in the easiest manner possible.
Here is a shot of the main frame where you will click one button and then minimize:

[[File:Interface-Main-Annotated.png]]

# On the Mafia Frame, click the '''RELAY BROWSER''' icon. It is second one over from the top left and looks like a little treasure map with an X marks the spot. [[File:Relay-icon.png]] Or, under the Main MenuBar click 'General', then click 'Relay Browser'.
## This opens your default browser to KoL and looks just like what you are used to when you login to KoL.
## It might use the wrong browser by default. For example, Internet Exploder instead of Firefox or Chrome that you might prefer. If this happens, do this:
##* Click General from the top menubar.
##* Click Preferences
##* Click the Browser Tab.
##* In the Browser textbar, click the [...] button to browse and find the executable for the desired browser. Alternatively, you can try typing in the name of the browser and KoLmafia will attempt to find it for you.
# Do you have any greasemonkey scripts? You can still use many of them in this relay browser. I don't really recommend using any invasive ones since we are trying to migrate away from them and focus on Mafia for the time being. Go ahead and disable all Greasemonkey scripts for now. Just keep in mind that you can still use them if you want functionality that Mafia cannot easily duplicate. For example, there is a Greasemonkey script that tries to calculate your total meat value that I still use. A Raid Manager is also a great one once you start doing Clan Dungeons which parses your clan dungeon logs. There is no equivalent in mafia at the time being.
# Completely ignore the Mafia Frame or minimize it. Play like normal for a while (at least 20 turns), using the Relay Browser. It is practically identical to standard play. Try to play in a zone with some non-combat choice encounters.

'''Seeing KoLmafia in Action:'''

While using the Relay Browser, you will start noticing some cool stuff that it does automatically to help you out. Here is a short list of stuff to note/try:

# If you encountered a non-combat adventure with choices, you will see the first Mafia bonus. Mafia gives you a short description of exactly what happens when you select that particular choice. This is super cool and really lowers the Wikipedia usage or guesswork, especially if you are a new player!
#:[[File:Dumpster Diving.png]]
# When you fight a foe, it gives you a quick display about that monster's level, estimated hit points, item drops and percentages, meat drop rate, and so forth. This is really helpful information and is much easier than looking up stuff in the Wiki, or playing blind.
#:[[File:Monster stats.png]]
# There is a hidden counter that gives you a semi-rare encounter periodically. It is normally tracked by eating a fortune cookie or two, then logic-ing out what the magic number is. Then keeping track of how many turns are left until the encounter. If you have no idea what I am talking about, look up [http://kol.coldfront.net/thekolwiki/index.php/Semi-Rare_Adventures semi-rare at the KoL Wiki].
#* With Mafia, when you eat a Fortune Cookie, it notes the 3 numbers given. It knows which numbers are out of bounds, based on your Ascention Path (Oxycore, Standard, BadMoon, etc) and can sometimes determine the Semi-Rare countdown number based on one cookie. In any case, all valid numbers are added to your buff entries as 'Fortune Cookie(XXX)' counters.
#*:[[File:Fortune cookie counter.png]]
#* Eating a second cookie will get rid of ambiguity if there are multiple valid Fortune Cookie counters.
#* The counter counts down as you adventure. When it is gone and you try to adventure, it will stop you. It reminds you that the counter is up and what your last semi-rare was (so you don't try to do the same one again, which negates it).
#* After the semi-rare, two buffs appear which are a minimum and maximum cookie counter. This makes it a lot more likely that Mafia can figure out the right counter number with only one cookie.
#*:[[File:Semirare window.png]]
# Your Last Adventure link now has a history which shows your last '''five''' adventure locations. Any of them are clickable. This is very convenient, especially when you make short-term detours such as doing a semi-rare and then have to find your adventure location again.
# If you use Action Bars (an interface choice in your KoL Account Preferences), you might notice a "Script" button at the top-left when in a fight. We will learn how to use that [[KoLmafia_Guide:_Attack_Script|later]] in the tutorial to automatically perform a series of combat actions.
#: [[File:Lesson1 CAB.png]]
#If you use the standard text-based stuff in a fight, you will see additional hotkey-able clickable buttons along the top with certain actions. Normally to use a combat skill, you have to select your combat skill to use from a drop-down. Mafia makes appropriate buttons for you to save time. It will always have buttons for noodles and olfaction if you know those skills. There's a button to jiggle your chefstaff if you have one equipped. It also adds a script button which will be discussed [[KoLmafia_Guide:_Attack_Script|later]]. Other buttons are the last several skills you have used.
#: [[File:Lesson1 KolCbt.png]]
# You will notice that Mafia helps you out some with quests. For example, it auto-fills in answers to certain puzzles, remembers which Dungeon of Doom potions do what, and misc other stuff.
# If you click the underlined number under an effect, KoLmafia will use an appropriate item or spell to remove it.
# You might even notice that Mafia does some stuff automatically whether you like it or not! For example, if you get beaten-up, Mafia might use an item to remove that condition automatically. This can be a source of irritation, but we will learn to handle it by setting our preferences appropriately in a later lesson.

'''BOTTOM LINE:''' You can play KoL just like normal and get a lot of handy bonus information very easily.

'''Continue''' to [[KoLmafia Guide: Java Interface|Lesson 2: Java Interface]]

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

File:Swordbot345.png

2011-06-29T00:34:50Z

Fewyn: Testing

Testing

User talk:Fewyn

2011-03-11T15:24:40Z

Fewyn:

Since a bunch of new functions have been added in the past few months, if you have time, could you [http://lide.wangsibs.com/test/ashsource.php update ash.php]? (This is fairly low priority, obviously.) Thanks a bunch! --[[User:Heeheehee|Heeheehee]] 04:33, 21 May 2010 (UTC)

Eventually, it would be nice to have the namespace "KoLMafia" renamed to "KoLmafia" to agree with how the devs capitalize it. However, this is totally not a huge deal, and is presented as a "when you find yourself bored" kind of thing, only. --[[User:StDoodle|StDoodle (#1059825)]] 04:13, 2 September 2010 (UTC)

herp derp testing derp derp

Abort

2010-05-30T22:43:56Z

Fewyn: Reverted edits by Fewyn (Talk) to last revision by Bale

{{
#vardefine:name|abort}}{{
#vardefine:return_type|void}}{{

FunctionPage|
name={{#var:name}}|

function1={{Function|
name={{#var:name}}|
aggregate={{#var:aggregate}}|
return_type={{#var:return_type}}|
return_also={{#var:return_also}}|
}}|

function2={{Function|
name={{#var:name}}|
aggregate={{#var:aggregate}}|
return_type={{#var:return_type}}|
return_also={{#var:return_also}}|
parameter1={{Param|string|message}}|
p1desc={{Pspan|message}} is the (optional) abort message (in place of "KoLmafia declares world peace.")|
}}|

function_description=Halts all queued functions and the entire script it is called from. Often used for error-handling.|

code1={{CodeSample|
title=Code Samples|
description=This code will abort the script if run by the "wrong" character.|
code=
<syntaxhighlight>
if (my_name() != "MrPicky") {
abort("I don't want you to run this script, mister!");
}
</syntaxhighlight>}}
{{CodeSample|
description=An example of '''abort()''' used for error-handling.|
code=
<syntaxhighlight>
float mass = 5.0;
float volume = some_function(); //where some_function() may return 0.0
float density;
if (volume_cf == 0) {
abort("Error: Division by zero requested.");
} else {
density = mass / volume;
}
</syntaxhighlight>}} |
cli_equiv=Also available as the CLI command "abort," which will not be queued (similarly stops execution of all remaining commands when parsed).
}}

[[Category:Miscellaneous Functions]]

Abort

2010-05-30T22:43:44Z

Fewyn:

{{#customtitle:My header|My Title}}
{{
#vardefine:name|abort}}{{
#vardefine:return_type|void}}{{

FunctionPage|
name={{#var:name}}|

function1={{Function|
name={{#var:name}}|
aggregate={{#var:aggregate}}|
return_type={{#var:return_type}}|
return_also={{#var:return_also}}|
}}|

function2={{Function|
name={{#var:name}}|
aggregate={{#var:aggregate}}|
return_type={{#var:return_type}}|
return_also={{#var:return_also}}|
parameter1={{Param|string|message}}|
p1desc={{Pspan|message}} is the (optional) abort message (in place of "KoLmafia declares world peace.")|
}}|

function_description=Halts all queued functions and the entire script it is called from. Often used for error-handling.|

code1={{CodeSample|
title=Code Samples|
description=This code will abort the script if run by the "wrong" character.|
code=
<syntaxhighlight>
if (my_name() != "MrPicky") {
abort("I don't want you to run this script, mister!");
}
</syntaxhighlight>}}
{{CodeSample|
description=An example of '''abort()''' used for error-handling.|
code=
<syntaxhighlight>
float mass = 5.0;
float volume = some_function(); //where some_function() may return 0.0
float density;
if (volume_cf == 0) {
abort("Error: Division by zero requested.");
} else {
density = mass / volume;
}
</syntaxhighlight>}} |
cli_equiv=Also available as the CLI command "abort," which will not be queued (similarly stops execution of all remaining commands when parsed).
}}

[[Category:Miscellaneous Functions]]

Abort

2010-05-30T22:31:49Z

Fewyn: Reverted edits by Fewyn (Talk) to last revision by Bale

Abort

2010-05-30T22:31:40Z

Fewyn:

File:Swordbot.png

2010-03-30T00:58:33Z

Fewyn:

MediaWiki:Sidebar

2010-03-01T04:09:53Z

Fewyn:

MediaWiki:Sidebar

2010-03-01T04:09:01Z

Fewyn:

MediaWiki:Sidebar

2010-03-01T04:07:58Z

Fewyn:

MediaWiki:Sidebar

2010-03-01T04:07:47Z

Fewyn:

MediaWiki:Sidebar

2010-03-01T04:07:32Z

Fewyn:

MediaWiki:Sidebar

2010-03-01T04:07:04Z

Fewyn:

User:Fewyn

2010-02-27T20:41:13Z

Fewyn:

WikiSysOP

<source>
// wears the appropriate war attire
void dress_apropos(boolean hippy_frat) {
if (hippy_frat) outfit("War Hippy Fatigues"); else outfit("Frat Warrior Fatigues");
}
</source>

Talk:Main Page

2009-09-04T03:19:47Z

Fewyn: Reverted edits by 94.142.128.140 (Talk) to last revision by Alhifar

Save these links for now:

ELg27M df1zv853gvrvb7gv94gmlas

WaBgN9 dfv078fnw8f934ndvkg2l

== Updating? ==
Let's get started, guys. Soon enough, I'll have a list of all the functions, which I think should go in a wiki page to (as someone above said) search and link. Also, is there a way to do monospacing with code? --[[User:MagiNinjA|MagiNinjA]] 00:35, 29 March 2007 (CDT)
:You can get mono-spaced text by using <code> tags. For example, using <pre><code>EXAMPLE TEXT</code></pre> produces this as a result. <code>EXAMPLE TEXT</code>
:If you need anymore help, just drop me a line on my [[User_talk:Ksumoe|talk page]]. [[User:Ksumoe|ksumoe]] ([[User_talk:Ksumoe|talk]] [[Special:Contributions/Ksumoe|contrib]]) 18:35, 10 April 2007 (CDT)

== Ideas... ==

These are my ideas that I have floating around in my head:
# A template to put all the relevant information about a function into a table (with proper colored backgrounds and such)
## I can do this; I just need to know what information is 'relevant'.
# Move this type of discussion to the Community Portal. Right now the CP is just a bunch of links (we can make a 'links' page and add it to the sidebar if needed).
# An overhaul of the main page. Someone said that they don't like the 'portal' type of look, but that kind of look has become the ''de facto'' standard for wikis, as it is the most popular. I'll pound out a rough draft on a subpage of my user space.
# Creation of a template structure. Templates for requesting deletion, protection, etc. That way non-sysop flagged users can 'tag' pages [[Talk:Bad title|such as this]] for deletion.
# Logo! 'Cause we need to be cool like that.
# Define a category structure. Do it now before too many pages get created.

Like I said... I'm here to help. [[User_talk:Ksumoe|Comments]]  plox. [[User:Ksumoe|ksumoe]] ([[User_talk:Ksumoe|talk]] [[Special:Contributions/Ksumoe|contrib]]) 21:17, 13 April 2007 (CDT)

I added some links on the home page -- hope that helps users find more documentation... :) -Daychilde

I corrected the Script Repository link to http://www.kolmafia.us from http://www.kolmafia.ua. ;) -Regnar

== Links to Redirects? ==

While I understand the need for redirect, why are we linking to redirect pages? Why not use <nowiki>[[Page Title|Displayed Text]]</nowiki> links instead?

== Protection ==
Seriously, protect the front page. This is getting completely destroyed by spam [[User:80.189.248.109|80.189.248.109]] 12:05, 27 August 2007 (CDT)

Is $wgSpamRegex set? If not it should be. If it is, it needs updating. Spam storming in like the flood! -divinewind420

Articles on the subject
http://nothing.tmtm.com/archives/2571
http://wiki.evernex.com/index.php?title=Blocking_Spam_in_Mediawiki
-divinewind420

== Current wiki layout ==
I was just curious if we could get the current wiki main page layout centered? As in simply putting <pre> <center> </center> </pre> around the main text.
--[[User:ZammyWarrior|ZammyWarrior]] 16:35, 7 December 2007 (PST)

What do you mean? And please sign your comments --[[User:Fewyn|Fewyn]] 10:59, 6 December 2007 (PST)

Main Page

2009-08-29T14:01:34Z

Fewyn: Unprotected "Main Page"

<center>
Welcome to the KoLmafia Wiki.

Please pardon our dust while we remodel. 
'''Progress level: [[Special:Statistics|{{NUMBEROFARTICLES}}]]'''

<table style="width:80%;margin-top: .7em;background-color:#F4DF3B;border:2px solid #8663A8">
<tr>
<td class="box_tgen" style="text-align:cen
1000
ter;color:#000;font-size:90%;border:none;margin: 0;padding:.1em;">
'''Quick Links:''' [[Your Character]] || [[Item Management]] || [[Equipment]] || [[Skills and Effects]] || [[Adventuring]] || [[In-combat functions for consult scripting]] || [[Miscellaneous]] || [[String Handling Routines]] || [[Datatype Constants]] || [[Datatype Conversions]] || [[KoLmafia Properties]] || [[Code Samples]]</td>
</tr>
</table>

To obtain a list of currently available ash functions for your current version of kolmafia type [[ashref]] into the graphical cli.

== Helpful Links ==

KoLMafia:

[http://kolmafia.sourceforge.net Download KoLMafia]

[http://kolmafia.sourceforge.net/manual.html KoLMafia Documentation]

[http://kolmafia.sourceforge.net/scripting.html CLI Scripting Manual]

[http://kolmafia.sourceforge.net/advanced.html ASH Scripting Manual]

[http://kolmafia.sourceforge.net/combat.html Custom Combat Scripting Manual]

[http://kolmafia.us The KoLMafia Script Repository]

[http://forums.kingdomofloathing.com/viewtopic.php?t=19779 The KoLMafia thread on the KoL Forums]

KoL:

[http://www.kingdomofloathing.com/ The Kingdom of Loathing]

[http://forums.kingdomofloathing.com/ KoL Forums]

</center>

Main Page

2009-07-08T01:27:25Z

Fewyn:

User:Fewyn

2009-05-24T06:47:41Z

Fewyn: Undo revision 4465 by 200.123.157.130 (Talk)

WikiSysOP

Kolmafia:Community Portal

2008-02-01T06:02:39Z

Fewyn: Reverted edits by 202.84.17.42 (Talk); changed back to last version by Fewyn

Here are some websites related to the KoLMafia community.

*[http://www.kingdomofloathing.com '''Kingdom of Loathing''']
: The game's main website.

*[http://kolmafia.us/index.php '''KoLMafia Script Repository''']
: The main script repository and forum for KoLMafia.

*[http://kolmafia.sourceforge.net/ '''KoLMafia at Sourceforge''']
: Project website for KoLMafia.
*[http://kolmafia.sourceforge.net/advanced.html '''Advanced Scripting Manual (ASH) at Sourceforge''']
: A useful manual to reference when using this wiki.

*[http://kol.coldfront.net '''Chillin' and Loathin' at Coldfront''']
: KoL at Coldfront is the official unofficial KoL fan site.

*[http://kol.coldfront.net/thekolwiki/index.php/Main_Page '''KoL Wiki (at Coldfront)''']
: Large spoiler site and wiki, a useful reference site.

Miscellaneous Functions

2008-02-01T06:01:45Z

Fewyn: Reverted edits by 141.223.149.36 (Talk); changed back to last version by Fewyn

== Part 7 - Miscellaneous ==
Mostly internal stuff. Some good for everyone, some only for ASH wizards.

void print( string output ) 
void print( string output, string color ) 
Prints output to the CLI buffer and displays it in the status line of the main Adventuring window. If color is specified any HTML in output is escaped and the string is wrapped in a font tag before being printed.

boolean cli_execute( string command ) 
Executes the given command as if it were entered into the graphical CLI window. This can be used for CLI commands or, if you’re careful and not an asshat, for raw URLs. 
See the [http://kolmafia.sourceforge.net/scripting.html CLI manual] for more details. 
Sample:[[%28ASHRM%29_Code_Samples#Sample_4:_Hedging|Hedging]]

void wait( int delay ) 
Sleeps for delay seconds.

string get_property( string key ) 
boolean set_property( string key, string value ) 
Gets or sets a stored property from your character’s .kcs file. 
The KoLmafia [[%28ASHRM%29_KoLMafia_Properties|properties]] page contains details on many of the keys that are available for access. 
Sample:[[%28ASHRM%29_Code_Samples#Sample_2:_Battlefield_gather|Battlefield_gather]]

boolean file_to_map( string file_to_load, map map_to_fill ) 
boolean map_to_file( map map_to_save, string file_to_write ) 
Loads and saves maps as tab-delimited text files.

int random( int range ) 
Generates a random integer between 0 and (range-1) inclusive.

int round( float ratio ) 
int floor( float ratio ) 
int ceil( float ratio ) 
int truncate( float ratio ) 
Returns an integer near the given real number. Respectively, it returns the nearest, next lowest, next highest, and decimal-stripped integer.

int count( map ) 
Returns the number of defined keys for the aggregate.

void clear( map ) 
Remove all keys from a map. 

void disable( string function_name ) 
void enable( string function_name ) 
For debugging purposes disables or enables the indicated function

float square_root( float value ) 
returns the square root of the passed value

string today_to_string() 
Returns today’s (real-world) date in the form yyyymmdd. It is based on your computer’s system date

Adventuring

2008-01-08T05:12:47Z

Fewyn: Reverted edits by 72.232.199.50 (Talk); changed back to last version by Ataradan

== Part 5 - Adventuring ==
Go get ‘em, tiger!

boolean adventure( int visits, [[%28ASHRM%29_Datatype_Constants#.24location.5Bconstant.5D|location place]] ) 
Visits the desired place the number of times that you wish. 
Sample:[[%28ASHRM%29_Code_Samples#Sample_4:_Hedging|Hedging]]

void add_item_condition( int quantity, [[%28ASHRM%29_Datatype_Constants#.24item.5Bconstant.5D|item it]] ) 
Specifies adventuring conditions. With conditions in place, adventure(…) will successfully complete before using all the specified adventures if the conditions are all met. 
See the [http://kolmafia.sourceforge.net/scripting.html CLI manual] for additional condition programming.

void council() 
Visits the Council of Loathing.

item guardians() 
Climbs the Naughty Sorceress’ Tower and passes the challenges that it can. If it completes the challenge, it returns $item[none]. Otherwise, it returns the item that is needed to pass the next stage.

boolean guild() 
boolean gourd() 
int tavern() 
boolean nemesis() 
boolean entryway() 
boolean hedgemaze() 
boolean chamber() 
Attempts to perform the associated tasks. The return value indicates the success. 
See the [http://kolmafia.sourceforge.net/scripting.html CLI manual] for more details. 
Sample:[[%28ASHRM%29_Code_Samples#Sample_4:_Hedging|Hedging]]

boolean train_familiar( int nGoal, string sGoal ) 
Trains your currently-equipped familiar. sGoal can be either “base”, “buffed”, or “turns”, and nGoal is either the target weight or desired number of battles.

location my_location() 
Returns the location where you last adventured. 

void refresh_status() 
Grabs a fresh copy of your sidebar, so that information on your health, effects, and such will be guaranteed accurate. In theory, this is not necessary unless you are attempting to script your own custom combat function.

monster [int] get_monsters( [[%28ASHRM%29_Datatype_Constants#.24location.5Bconstant.5D|location place]] ) 
returns an integer indexed map of potential monsters in the given location.

int monster_base_attack( [[%28ASHRM%29_Datatype_Constants#.24monster.5Bconstant.5D|monster eek]] ) 
int monster_base_defense( [[%28ASHRM%29_Datatype_Constants#.24monster.5Bconstant.5D|monster eek]] ) 
int monster_base_hp( [[%28ASHRM%29_Datatype_Constants#.24monster.5Bconstant.5D|monster eek]] ) 
Returns the stats for the given monster. 

spiceloop is a verified kolmafia ash function however the parameters and return type are speculation. This needs verified. 
void spiceloop( int count ) 
Executes kolmafia’s internal spiceloop for the specified number of adventures.

element monster_attack_element( monster ) 
element monster_defense_element( monster ) 
Returns the given monsters attack element and element which it can defend against.

Kolmafia:Community Portal

2008-01-08T05:10:24Z

Fewyn:

Miscellaneous Functions

2007-12-30T16:22:21Z

Fewyn: Reverted edits by 195.229.242.57 (Talk); changed back to last version by Fewyn

Talk:Main Page

2007-12-20T17:54:31Z

Fewyn: /* paparazzi photographs of britney spears n1 */

Save these links for now:

== Getting started ==

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
21895299452399151244860

== Wiki layout... ==

We really should consider exactly how to lay out the wiki... We should probably see how others (especially the KoL wiki) do it and take inspiration... :)

Also, I'm thinking we should eventually have a page for each function, to make searching the wiki more valuable... :)

--[[User:Daychilde|Daychilde]] 23:00, 8 January 2007 (CST)

I agree with your idea about one-page-per-function.

Also I think every* function's documentation should show a real-world example of use. The links to example scripts are a good start in this direction, but some code to read right on the function page would be nice. (*Yes, even the "you are not cool enough to use this" undocumented stuff.)

A master ASH function list page would be helpful. When trying to Find a keyword in browser to see if KM implements a given functionality, it's a minor PITA to have to click into each categorized page and search them all individually.

Also welcome would be some kind of icon, color, or other indicator for newly-added functions. Master list sorted/sortable by implementation version/date if possible.

Also, on the subject of general layout/UI improvements (since you asked): for the main page, I prefer a high-level bulleted-listy index/ToC, kinda like the ToCs on the current sourceforge manual pages. Personally, I find this more useful than the increasingly popular "widgety-portaly-stocks-news-and-weather" look.

Redundancy should be removed wherever possible -- e.g. (ASHRM) in front of every link. I understand if prefixes of that sort are there to assist in organizing the underlying database, but if not, I think they are totally unnecessary and a distraction -- that is, provided the containing page is appropriately identified with a nice big "ASH Reference Manual" heading at the top, breadcrumbs, etc.

I'll quit before I arrive at a frenzy of usability fanaticism the likes of which would make J. Nielsen repent like a dirty sinner. (Got work to do, actually. Now maybe if there was a "job opportunities" section.......)

--[[User:somebody who sincerely appreciates not having to register/login and probably wouldn't participate elsewise]] 12:35, 30 January 2007 (EST)

On the other hand, speed-bumping idiot apammers may be worth it. I could go on for ages about how offensive I find that kind of griefing (If you think life isn't a game, you're doing it wrong)--[[User:Metraxis|Metraxis]] 11:27, 18 February 2007 (CST)

== Updating? ==
Let's get started, guys. Soon enough, I'll have a list of all the functions, which I think should go in a wiki page to (as someone above said) search and link. Also, is there a way to do monospacing with code? --[[User:MagiNinjA|MagiNinjA]] 00:35, 29 March 2007 (CDT)
:You can get mono-spaced text by using <code> tags. For example, using <pre><code>EXAMPLE TEXT</code></pre> produces this as a result. <code>EXAMPLE TEXT</code>
:If you need anymore help, just drop me a line on my [[User_talk:Ksumoe|talk page]]. [[User:Ksumoe|ksumoe]] ([[User_talk:Ksumoe|talk]] [[Special:Contributions/Ksumoe|contrib]]) 18:35, 10 April 2007 (CDT)

== Ideas... ==

These are my ideas that I have floating around in my head:
# A template to put all the relevant information about a function into a table (with proper colored backgrounds and such)
## I can do this; I just need to know what information is 'relevant'.
# Move this type of discussion to the Community Portal. Right now the CP is just a bunch of links (we can make a 'links' page and add it to the sidebar if needed).
# An overhaul of the main page. Someone said that they don't like the 'portal' type of look, but that kind of look has become the ''de facto'' standard for wikis, as it is the most popular. I'll pound out a rough draft on a subpage of my user space.
# Creation of a template structure. Templates for requesting deletion, protection, etc. That way non-sysop flagged users can 'tag' pages [[Talk:Bad title|such as this]] for deletion.
# Logo! 'Cause we need to be cool like that.
# Define a category structure. Do it now before too many pages get created.

Like I said... I'm here to help. [[User_talk:Ksumoe|Comments]]  plox. [[User:Ksumoe|ksumoe]] ([[User_talk:Ksumoe|talk]] [[Special:Contributions/Ksumoe|contrib]]) 21:17, 13 April 2007 (CDT)

I added some links on the home page -- hope that helps users find more documentation... :) -Daychilde

I corrected the Script Repository link to http://www.kolmafia.us from http://www.kolmafia.ua. ;) -Regnar

== Links to Redirects? ==

While I understand the need for redirect, why are we linking to redirect pages? Why not use <nowiki>[[Page Title|Displayed Text]]</nowiki> links instead?

== Protection ==
Seriously, protect the front page. This is getting completely destroyed by spam [[User:80.189.248.109|80.189.248.109]] 12:05, 27 August 2007 (CDT)

Is $wgSpamRegex set? If not it should be. If it is, it needs updating. Spam storming in like the flood! -divinewind420

Articles on the subject
http://nothing.tmtm.com/archives/2571
http://wiki.evernex.com/index.php?title=Blocking_Spam_in_Mediawiki
-divinewind420

== Current wiki layout ==
I was just curious if we could get the current wiki main page layout centered? As in simply putting <pre> <center> </center> </pre> around the main text.
--[[User:ZammyWarrior|ZammyWarrior]] 16:35, 7 December 2007 (PST)

What do you mean? And please sign your comments --[[User:Fewyn|Fewyn]] 10:59, 6 December 2007 (PST)

Main Page

2007-12-08T01:34:49Z

Fewyn:

<center>
Welcome to the KoLmafia Wiki.

Please pardon our dust while we remodel. 
'''Progress level: [[Special:Statistics|{{NUMBEROFARTICLES}}]]'''

<table style="width:80%;margin-top: .7em;background-color:#F4DF3B;border:2px solid #8663A8">
<tr>
<td class="box_tgen" style="text-align:cen
1000
ter;color:#000;font-size:90%;border:none;margin: 0;padding:.1em;">
'''Quick Links:''' [[Your Character]] || [[Item Management]] || [[Equipment]] || [[Skills and Effects]] || [[Adventuring]] || [[In-combat functions for consult scripting]] || [[Miscellaneous]] || [[String Handling Routines]] || [[Datatype Constants]] || [[Datatype Conversions]] || [[KoLmafia Properties]] || [[Code Samples]]</td>
</tr>
</table>

== Helpful Links ==

KoLMafia:

[http://kolmafia.sourceforge.net Download KoLMafia]

[http://kolmafia.sourceforge.net/manual.html KoLMafia Documentation]

[http://kolmafia.sourceforge.net/scripting.html CLI Scripting Manual]

[http://kolmafia.sourceforge.net/advanced.html ASH Scripting Manual]

[http://kolmafia.sourceforge.net/combat.html Custom Combat Scripting Manual]

[http://www.kolmafia.us The KoLMafia Script Repository]

[http://forums.kingdomofloathing.com/viewtopic.php?t=19779 The KoLMafia thread on the KoL Forums]

KoL:

[http://www.kingdomofloathing.com/ The Kingdom of Loathing]

[http://forums.kingdomofloathing.com/ KoL Forums]

</center>

Talk:Main Page

2007-12-06T18:59:00Z

Fewyn: /* Current wiki layout... */

Save these links for now:

== Getting started ==

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
21895299452399151244860

== Wiki layout... ==

We really should consider exactly how to lay out the wiki... We should probably see how others (especially the KoL wiki) do it and take inspiration... :)

Also, I'm thinking we should eventually have a page for each function, to make searching the wiki more valuable... :)

--[[User:Daychilde|Daychilde]] 23:00, 8 January 2007 (CST)

I agree with your idea about one-page-per-function.

Also I think every* function's documentation should show a real-world example of use. The links to example scripts are a good start in this direction, but some code to read right on the function page would be nice. (*Yes, even the "you are not cool enough to use this" undocumented stuff.)

A master ASH function list page would be helpful. When trying to Find a keyword in browser to see if KM implements a given functionality, it's a minor PITA to have to click into each categorized page and search them all individually.

Also welcome would be some kind of icon, color, or other indicator for newly-added functions. Master list sorted/sortable by implementation version/date if possible.

Also, on the subject of general layout/UI improvements (since you asked): for the main page, I prefer a high-level bulleted-listy index/ToC, kinda like the ToCs on the current sourceforge manual pages. Personally, I find this more useful than the increasingly popular "widgety-portaly-stocks-news-and-weather" look.

Redundancy should be removed wherever possible -- e.g. (ASHRM) in front of every link. I understand if prefixes of that sort are there to assist in organizing the underlying database, but if not, I think they are totally unnecessary and a distraction -- that is, provided the containing page is appropriately identified with a nice big "ASH Reference Manual" heading at the top, breadcrumbs, etc.

I'll quit before I arrive at a frenzy of usability fanaticism the likes of which would make J. Nielsen repent like a dirty sinner. (Got work to do, actually. Now maybe if there was a "job opportunities" section.......)

--[[User:somebody who sincerely appreciates not having to register/login and probably wouldn't participate elsewise]] 12:35, 30 January 2007 (EST)

On the other hand, speed-bumping idiot apammers may be worth it. I could go on for ages about how offensive I find that kind of griefing (If you think life isn't a game, you're doing it wrong)--[[User:Metraxis|Metraxis]] 11:27, 18 February 2007 (CST)

== Updating? ==
Let's get started, guys. Soon enough, I'll have a list of all the functions, which I think should go in a wiki page to (as someone above said) search and link. Also, is there a way to do monospacing with code? --[[User:MagiNinjA|MagiNinjA]] 00:35, 29 March 2007 (CDT)
:You can get mono-spaced text by using <code> tags. For example, using <pre><code>EXAMPLE TEXT</code></pre> produces this as a result. <code>EXAMPLE TEXT</code>
:If you need anymore help, just drop me a line on my [[User_talk:Ksumoe|talk page]]. [[User:Ksumoe|ksumoe]] ([[User_talk:Ksumoe|talk]] [[Special:Contributions/Ksumoe|contrib]]) 18:35, 10 April 2007 (CDT)

== Ideas... ==

These are my ideas that I have floating around in my head:
# A template to put all the relevant information about a function into a table (with proper colored backgrounds and such)
## I can do this; I just need to know what information is 'relevant'.
# Move this type of discussion to the Community Portal. Right now the CP is just a bunch of links (we can make a 'links' page and add it to the sidebar if needed).
# An overhaul of the main page. Someone said that they don't like the 'portal' type of look, but that kind of look has become the ''de facto'' standard for wikis, as it is the most popular. I'll pound out a rough draft on a subpage of my user space.
# Creation of a template structure. Templates for requesting deletion, protection, etc. That way non-sysop flagged users can 'tag' pages [[Talk:Bad title|such as this]] for deletion.
# Logo! 'Cause we need to be cool like that.
# Define a category structure. Do it now before too many pages get created.

Like I said... I'm here to help. [[User_talk:Ksumoe|Comments]]  plox. [[User:Ksumoe|ksumoe]] ([[User_talk:Ksumoe|talk]] [[Special:Contributions/Ksumoe|contrib]]) 21:17, 13 April 2007 (CDT)

I added some links on the home page -- hope that helps users find more documentation... :) -Daychilde

I corrected the Script Repository link to http://www.kolmafia.us from http://www.kolmafia.ua. ;) -Regnar

== Links to Redirects? ==

While I understand the need for redirect, why are we linking to redirect pages? Why not use <nowiki>[[Page Title|Displayed Text]]</nowiki> links instead?

== Protection ==
Seriously, protect the front page. This is getting completely destroyed by spam [[User:80.189.248.109|80.189.248.109]] 12:05, 27 August 2007 (CDT)

Is $wgSpamRegex set? If not it should be. If it is, it needs updating. Spam storming in like the flood! -divinewind420

Articles on the subject
http://nothing.tmtm.com/archives/2571
http://wiki.evernex.com/index.php?title=Blocking_Spam_in_Mediawiki
-divinewind420

== Current wiki layout... ==

Just wondering if we could get it centered? :P

What do you mean? And please sign your comments --[[User:Fewyn|Fewyn]] 10:59, 6 December 2007 (PST)

Talk:String Handling Routines

2007-12-05T20:35:26Z

Fewyn:

So wtf does group_string actually do? The linked "descriptive" post has an utterly unhelpful example. Has anyone ever used it for anything?

Groups a string into a map using a regular expression. To understand the function you must know.
1. What maps are and how they are used.
2. Understand what regular expressions are and how to create them.

Using the original post:

FUNCTION DEFINTION: string [int,int] group_string( string source, string regex )
EXAMPLE: string [int,int] test = group_string( "This is a test", "([a-z] ) " );

Example Breakdown:
'''string [int,int]''' Define a map. Two dimensional. The indices are integers. The data is stored as a string.
'''test''' Define the map with name '''test'''.
'''group_string''' Call the function.
'''"This is a Test"''' Feeding the function a sample string.
'''"([a-z] ) "''' Your regular expression.

Regular expressions deal with pattern matching. You want the function to find a particular pattern. The function then returns that pattern, or the stuff before it, or the stuff after it, or splits them appart, or squeezes them together. So what does this regular expression look for?
'''The Parenthesis ():''' Tell the function this is a group of characters.
'''[a-z]:''' Tell us they will be lower case letters.
''' :''' Tell us to look for one or more characters.
That space between the ) and " Tells us the pattern ends in a space.

Thus reading down the string.
T = Does not match [a-z] is a capital letter.
h = Matches [a-z]. Starting Group
i = Matches [a-z]
s = Matches [a-z]
= Matches space. First group found and is "his "
i = Matches [a-z]. Starting Group
s = Matches [a-z]
= Matches space. Second group found, and is "is "
a = Matches [a-z]. Starting Group
= Matches space. Third group found, and is "a "
t = Matches [a-z]. Starting Group
e = Matches [a-z]
s = Matches [a-z]
t = Matches [a-z]
End of line. No more matches. Stop.

Thus, trusting the post, the map would be:

test[0][0] => "his "
test[0][1] => "his"
test[1][0] => "is "
test[1][1] => "is"
test[2][0] => "a "
test[2][1] => "a"

I personally haven't used it. Would be used in parsing a page by hand.

Talk:Main Page

2007-12-05T20:27:01Z

Fewyn:

Main Page

2007-12-05T20:25:31Z

Fewyn: Protected "Main Page" [edit=sysop:move=sysop]

Welcome to the KoLmafia Wiki.

Please pardon our dust while we remodel. 
'''Progress level: [[Special:Statistics|{{NUMBEROFARTICLES}}]]'''

<table style="width:80%;margin-top: .7em;background-color:#F4DF3B;border:2px solid #8663A8">
<tr>
<td class="box_tgen" style="text-align:cen
1000
ter;color:#000;font-size:90%;border:none;margin: 0;padding:.1em;">
'''Quick Links:''' [[Your Character]] || [[Item Management]] || [[Equipment]] || [[Skills and Effects]] || [[Adventuring]] || [[In-combat functions for consult scripting]] || [[Miscellaneous]] || [[String Handling Routines]] || [[Datatype Constants]] || [[Datatype Conversions]] || [[KoLmafia Properties]] || [[Code Samples]]</td>
</tr>
</table>

== Helpful Links ==

KoLMafia:

[http://kolmafia.sourceforge.net Download KoLMafia]

[http://kolmafia.sourceforge.net/manual.html KoLMafia Documentation]

[http://kolmafia.sourceforge.net/scripting.html CLI Scripting Manual]

[http://kolmafia.sourceforge.net/advanced.html ASH Scripting Manual]

[http://kolmafia.sourceforge.net/combat.html Custom Combat Scripting Manual]

[http://www.kolmafia.us The KoLMafia Script Repository]

[http://forums.kingdomofloathing.com/viewtopic.php?t=19779 The KoLMafia thread on the KoL Forums]

KoL:

[http://www.kingdomofloathing.com/ The Kingdom of Loathing]

[http://forums.kingdomofloathing.com/ KoL Forums]

User:Fewyn

2007-12-05T20:03:25Z

Fewyn: New page: WikiSysOP

WikiSysOP

Miscellaneous Functions

2007-12-05T19:59:45Z

Fewyn:

Main Page

2007-12-05T19:50:06Z

Fewyn: