FICTION 2.6.32 BETA

I'm too fucking lazy to list all the changes this application has gone through since the public
version of 2.x was released several years ago. Find out for yourself.

Also: don't bitch about the difficulty of using the advanced configuration options. I originally
wasn't even going to include any form of documentation on them, and there's little to no error checking
present for them.

------------
Dependencies
------------

The following files are required to be present in order to load Fiction:

* Visual Basic 6.0 dependencies
* MSINET.OCX, MSWINCK.OCX, RICHTX32.OCX

* \Fiction.exe
* \fiction.ini
* \created.txt
* \libbnet.dll

* Hashes

* \Hashes\Lockdown\lockdown-IX86-00.dll - \Hashes\Lockdown\lockdown-IX86-19.dll

In addition to these, you will need to specify and have at least one list file.

-------------
Configuration
-------------

Fiction's default configuration is kept pretty concise, but there are several advanced configuration options you
could also enable to tweak the bot to your liking.

You can completely reload your entire configuration whenever you'd like without the need to restart your bot by
using the 'Configuration' menu on the bot. This will literally reload everything, and your active connections will
not be interrupted at all (unless you're changing servers for that particular bot, or removing it).

     =====================
     Default configuration
     =====================

     [global]                              ' Don't edit this line.
     BotCount=2                            ' Maximum number of bots you'll be loading.
     Password=fiction                      ' Password the bot will use when making your accounts.

     [1]                                   ' Bot 1's settings section. The following settings apply to bot 1.
     Server=useast.battle.net              ' Server for bot 1 to use.
     Delay=5000                            ' Creation attempt delay in milliseconds (5000 = 5 seconds).
     ListFile=list.txt                     ' List file for bot 1.
     Product=DRTL                          ' Product for bot 1 (valid values: DRTL, WAR3).
     CDKey=123123123123123                 ' CDKey for bot 1 (only necessary when using WAR3).

     [2]                                   ' Bot 2's settings section. The following settings apply to bot 2.
     Server=uswest.battle.net              ' Server for bot 2 to use.
     Delay=5000                            ' Creation attempt delay in milliseconds (5000 = 5 seconds).
     ListFile=list.txt                     ' List file for bot 2.
     Product=DRTL                          ' Product for bot 2 (valid values: DRTL, WAR3).
     CDKey=123123123123123                 ' CDKey for bot 2 (only necessary when using WAR3).

     ==============================
     Advanced configuration options
     ==============================

     Advanced configuration options allow you to customize Fiction to your liking, but, by default, are not
     included in the configuration file to retain simplicity. In order to use these options, you will need to
     add an "[options]" section to your configuration file where you'll specify whichever options you'd like.

     All advanced configuration options have a default value that is enabled when they are not specified in the
     configuration file, so it is by no means necessary to add any of these unless you want to tweak their values.

     These options are for advanced users only, and some remain untested. Being that there is minimal error
     checking for advanced configuration options, you may get some unwanted results. Please report any bugs you
     find immediately.

     It's also worth noting that these options are global. They apply to all bots.

     Format: Key name under [options] - (accepted type) [input description] - Default value when not tweaked

     * Font - (string) font name - Tahoma
     * FontSize - (integer) - 8
     * UseUpdateCheckTimer - (boolean) - True
     * UsePopupsOnCreation - (boolean) - True
     * WritePasswordOnCreate - (boolean) - True
     * MaxLinesBeforeClear - (integer) - 50
     * ConnectionDelay - (integer) - 0
     * AutoReconnect - (boolean) - True
     * AutoReconnectDelay - (integer) milliseconds - 60000
     * SendToSystemTray - (boolean) - True
     * RemoveNamesFromRotation - (boolean) - False
     * CleanMemory - (boolean) - True
     * CleanMemoryDelay - (integer) milliseconds - 5000
     * VersionByte - (string) - 2A

     And, of course:

     * PlaySoundOnCreation - (string) .wav file - NULL [off]

          +++++++++++++++++++++++++++
          PlaySoundOnCreation feature
          +++++++++++++++++++++++++++

          Just like classic Fiction 2.x, you can have a sound play when you create an account.
          The recommended sound file is alert.wav, available for download at the following website:
          http://divine.bitching.org/Fiction/alert.zip

          To enable (with alert.wav being in the bot's directory), you would specify:

          [options]
          PlaySoundOnCreation=alert.wav

     * ListShare - (string) list file - NULL [off]

          +++++++++++++++++
          ListShare feature
          +++++++++++++++++

          The ListShare feature allows all indices to share one list and evenly distribute creation attempts.
          This only makes sense to use if all of your indices are on the same server and product.

          Example:
               Bot 1 tries name 1.
               Bot 2 tries name 2.
               Bot 3 tries name 3., etc.

          To enable, add the following to your configuration file:

          [options]
          ListShare=list.txt               ' List file to split up between indices.

-------
Credits
-------

In addition to my own, this application samples code written by the following authors:

* Cloaked - packet buffer class
* Grok[vL] - richtextbox appending method
* Rob - libbnet Battle.net library

Additional credits to:

* Jimmy - feature suggestion / beta testing
* Crisis - reported several bugs during closed beta
* TehUser - hosting

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Dark Elements
Channel Clan de on the U.S. West gateway
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

http://www.dark-elements.net/
http://divine.bitching.org/Fiction/