How to install the PikkuBot on Linux

• A recent Linux distribution of your choice
• mono > 1.5.4
• 7zip for linux
• screen (optional)

1. Login into your server
2. Install the required mono-packages (please refer to the documentation of your distribution on how to do this)

Here are the list of mono-packages under Debian:

ii  libmono-accessibility2.0-cil              1.9.1+dfsg-1~bpo40+1                     Mono Accessibility library
ii  libmono-corlib1.0-cil                     1.9.1+dfsg-1~bpo40+1                     Mono core library (1.0)
ii  libmono-corlib2.0-cil                     1.9.1+dfsg-1~bpo40+1                     Mono core library (2.0)
ii  libmono-data-tds2.0-cil                   1.9.1+dfsg-1~bpo40+1                     Mono Data Library
ii  libmono-mozilla0.2-cil                    1.9.1+dfsg-1~bpo40+1                     Mono Mozilla library
ii  libmono-security2.0-cil                   1.9.1+dfsg-1~bpo40+1                     Mono Security library
ii  libmono-sharpzip2.84-cil                  1.9.1+dfsg-1~bpo40+1                     Mono SharpZipLib library
ii  libmono-sqlite2.0-cil                     1.9.1+dfsg-1~bpo40+1                     Mono Sqlite library
ii  libmono-system-data2.0-cil                1.9.1+dfsg-1~bpo40+1                     Mono System.Data Library
ii  libmono-system-web2.0-cil                 1.9.1+dfsg-1~bpo40+1                     Mono System.Web Library
ii  libmono-system2.0-cil                     1.9.1+dfsg-1~bpo40+1                     Mono System libraries (2.0)
ii  libmono-winforms2.0-cil                   1.9.1+dfsg-1~bpo40+1                     Mono System.Windows.Forms library
ii  libmono0                                  1.9.1+dfsg-1~bpo40+1                     libraries for the Mono JIT
ii  libmono2.0-cil                            1.9.1+dfsg-1~bpo40+1                     Mono libraries (2.0)
ii  mono-common                               1.9.1+dfsg-1~bpo40+1                     common files for Mono
ii  mono-gac                                  1.9.1+dfsg-1~bpo40+1                     Mono GAC tool
ii  mono-jit                                  1.9.1+dfsg-1~bpo40+1                     fast CLI JIT/AOT compiler for Mono
ii  mono-runtime                              1.9.1+dfsg-1~bpo40+1                     Mono runtime

1. Download the PikkuBot exe file (Link)
2. Extract the exe file with 7zip
3. 'cd' to the PikkuBot directory (i.e.: cd pikkubot-299)
4. Type “touch NOGUI.dat” to prevent GUI usage
5. Replace the System.Data.SQLite.DLL in the Bot-Directory with the one from the sqlite/linux directory
6. Start the bot by invoking it with the mono binary:
   mono PikkuBot.exe [Bot first name] [Bot last name] [Bot pass] [Master first name] [Master last name] [optional: “Sim”] [optional: region coordinates]

For being able to let the bot run unattended on a server the program 'screen' is recommended. Start it before you launch the bot by typing 'screen' once. After hitting enter, the only thing you might see now is a cleared screen. Congratulations, that was the first part.

Now launch the bot and press the following key combination: <Ctrl> + <a> and finally hit the <d> key. You should now see a message like [detached]. That's it - your bot is now running in that screen session and you can terminate your shell without killing the bot.

For reattaching a screen session, use the command 'screen -r'.

It's not the end of the world if things are not working. This is a small list to check before reporting a bug:

1. Check the mono libraries - make sure they are all available and up to date (matching your mono core)
2. Check for running PikkuBots and own mono threads and kill them if needed
3. Check the version of the bot and make sure you're having a recent version as old versions are not maintained anymore