GET STARTED

Thankyou for wanting to try the KMAPI api for KMABC.

The following pages on the left show all of the functions that can be called using kmabc and contain some examples on how to use them.

There is a demonstration modification that you can use to see how to get started. this is enclosed in the: "DEMOMOD.zip".
Extract this into the folder it is in and run the "KmabcModInstaller.exe" executable.

Unlike version 1.3, all future versions of kmapi will support the following format:

[mod_*.zip]
	| -- [mod_***.lua]
	| -- [modInstall.istl]
	| -- [mods required image files]
Once extracted, run the "KmabcModInstaller.exe" executable. to install the modification. When starting a mod, the first file you need to crerate is the mod_*.lua
where the * is the name of your mod. enter the following lines into the mod:

import "QueekusPlugins.kmabc.kmapi"; -- This is important else you wont have access to the api features

identifyer = "xxx"; -- This is required for adding buttons and other features. it is a good practice to name the * in the mod_*.lua this too.

ModID = kmapi.getNextFreeId() -- This allows you to have a unique id for your mod that none of the others will have.

After adding this, add these lines:

* = 	{ -- Where * is the name of your mod
		loadmod = function()
		end
	}

This is where all of your calls go. See the "DEMOMOD.zip" file's mod_*.lua file to see how to use them

The second file you will need is the "modInstall.istl" file.

In here, put the following:

xxx -- where xxx is the full name of your mod. This appears in the installer and not in the plugin.
* -- Where * is the name of your mod
import "QueekusPlugins.kmabc.*"; -- Where * is the name of your mod

FOR REFERENCE, HERE ARE THE 2 FILES YOU HAVE CREATED IN FULL:

mod_xxx.lua
import "QueekusPlugins.kmabc.kmapi";
identifyer = "xxx";
ModID = kmapi.getNextFreeId()

xxx = 	{
		loadmod = function()
		end
	}

modInstall.istl
xxx The Mod For KMABC
xxx
import "QueekusPlugins.kmabc.mod_xxx";

The rest is upto you, add colours, languages, buttons and have fun.

if you need any help, contact me on lotrointerface via "Queekusme" without quotes
or on the Withywindle server, Charname: Feladion