The first time you run FreeBot, your bot will come with only a few files, the most important are WhileFix.dll, mirc.exe and updater.mrc (Should any of these be missing, please contact the FreeBot creator)
Now, first of all, you will need to extract the files, you have now either downloaded a .zip or .rar file. If you downlaoded the .zip version, Windows will be able to read the file for you (requires Windows Me or newer), if not, you will have to get an application.
For these files, we recomend getting 7zip, 7zip is an Open Source file compressor and de-compressor.
After extracting the files, run mirc.exe and your copy of FreeBot will start downloading all it's bot files, you will know it is completed once the framed message below is displayed;
When it is done, a first time configuration window will open;
1: Pick a name for your bot
2: Enter the bots password (This is not required, only if you have registered yoru bot with NickServ adn wish to make use of the built in auto-identifier that comes with FreeBot)
3: Enter yoru email (This is for the Bot List on the FreeBot website)
4: Pick a public trigger (most commonly used is "@" so it is recomended you pick something unique)
5: Pick a Private trigger (most commonly used is "!" so it is recomended you pick something unique)
6: Enter the server to connect to (Default is SwiftIRC, which is where FreeBot has its home channel)
7: Check this option if you wish for your bot to be invitable, we will get back to this later on in the Bot Configuration section
8: The "Connect" button, click this once you've entered the above fields, and your bot will eb connected. If you connect to the SwiftIRC network, your bot will also automatically join #FreeBot
Now, we move onto the advanced bot configurations!
Right click your screen and select the option "FreeBot Control Panel";
You should now be greeted by the following sight
General Settings
Nickname
Here you can change yoru bots main nickname, alternative nickname (pre-set to a random one based on your main nickname), as well as change your NickServ password and enable/disable the auto-login feature
Triggers
Here you can change the public and private triggers, shoudl you so desire
Spam Settings
This is how long your bot will ignore each person before allowing the mto enter a new command, this is to prevent bot-flooding (though there are extensions available which do this much more effectively, but we'll get to that later)
Invitations
Now we're starting to get to the interesting parts; invitations!
"Message On Join" - This message will be sent by yoru bot whenever it joins a channel (careful as some channels frown upon its advertising)
"Message On Part" - This message will be the bots leave message when someone uses the part command
"Log Invitations/Part Commands" - Makes your bot keep a log of who invites the bot, when etc. Nice to check fi someone keeps mass-inviting, abusing etc.
"Enable Invites" - Self explaining, enable/disable the invite feature
"Max Channels" - Set how many channels the bot will join max when invitable (IF you are on a low connection, you should reduce this to prevent lag to your self or the bot)
"Enable Parting" - Enable/disable the part command
"Part Command" - Lets yo udecide the part command, keeping in mind that it will use the private/public triggers you've set in front of it to work.
"Invitable By" - Here you can decide who may invite the bot, to prevent normal users from mass inviting bots to other channels etc.
Connection Settings
"Server" - Enter the server the bot should connect to
"Connect on Start" - With this enabled, yoru bot will automatically connect to the entered server when you start it
"Reconnect on Disconnect" - This will make your bot attempt to reconnect if it should be disconnected for whatever reason
Total Control
Enable/disable the entire bot in one single click!
Channel Settings
Channel List
A list of the channels your bot has joined, and the settings made for those channels, also has the option to add new channels before the bot has joined them (for example if you wish to blacklist a channel).
Channel Settings
Enable/disable public or private triggers (Turn on or off the bots for public or private use), mark channel as blacklisted, and set how many kicks a channel has out of the total allowed kicks. (If total kick count is reached, the channel is blacklisted).
Personal Scripts
This section lets you load custom scripts that are not included in the FreeBot extension system, nor the base files.
Stats
Stats Display
"Items Till Level" - Determines how many items should be listed when showing how many items/actions remain till you receive a level up
"Items Per Line" - How many Items Till Level should show in one line (more lines may cause excess floods easier).
"Items Above Level" - How many items over your level you want to show (Most people want to keep this to it's default, 0, as there's no need to show how many items of something you can't even use till you get yoru level).
"Items Below Level" - How many items below your level you want to show (Items Till Level determine how many will be shown, starting from the LOWEST level required for the item/action).
Skill
A list of the skills, using their data file name (.ini is the file extension)
Item/Action Name
The items which there is any data for, from the selected Skill
Data/Information
Here you may edit/update the information stored within the Skill Data Files.
Exp Given - How much exp does the selected item/action give you.
Level Needed - Which level is required to perform the action/make the item.
Display Name - This feature lets you change the name of the skill when it's being showed to users using the stats command(s).
Updater Settings
FreeBot offers its user the ability to keep an auto-updater running, to ensure all scripts are held up to date, and always working with the latest features.
You may also enable the "Inform users before updating" option, which will send out a message informing the channels the bot is in about what is being updated, and telling them the features associated may be unavailable for a short period of time while you are fetchign the new version.
Triggers
Trigger List
Add or remove triggers, these should be in the form of "command", do NOT include the trigger symbol defined in the General Settings.
Trigger Settigns
"Trigger" - The command used to execute the trigger you've created.
"Output" - Here you may set what the bot should respond with when the defined command is entered. Every new line you create (by hitting Enter/Return) will be sent as a new line by the bot. You may also use identifiers etc, as these will be evaluated (use $nick for the nick of the user typing the command for example).
Stats Triggers
Here you can pick a skill, and define a new trigger for it.
For example, you could pick "magic" from the list, and the default triggers will show:
After this, you may add a new command on every new line, letting you customize your bots commands.
Enable/Disable Features
Lets you enable/Disable large sections of the bot (based on the base pack that comes with every copy of FreeBot).
Extension Manager
Available Extensions
Clicking the "Update" button will fetch a list form the FreeBot website allowing with the latest extensions and their versions, you then pick an extension form the lsit to view details on them.
Extension Details
"Name" - The name of the Extension
"Author" - The author of the Extension
"New Version" - The current version available online
"Old Version" - If you already have a version installed, this will be the version number for it
"Description" - A short text describing the extension and what it does.
Hit Install/Uninstall as you please if you wish to add/remove an extension. Keep in mind that some extensions may rely on otehr extensions (this should be informed about when you start the script, potentially they may fetc hthe required extensions automatically.)
This concludes our brief explanation of FreeBot's usage and Control Panel, enjoy the bot