This project is read-only.

After you have compiled or dowloaded the latest release of SharpIRC you may configure it.

Step 1: Generate configuration.

If you have chosen to compile SharpIRC yourself read this, if not move on to Step 2.
Start the SharpIRC.exe application ("mono SharpIRC.exe" if on Linux or Mac).
The Application will continue to generate some configuration files and folders. You may choose to leave the application running for now, or to exit it.

Step 2: Basic settings.

Open Settings.xml in a text editor, this is the file that does most of the configuration for this application, and is defined in XML. You will need to define the following variables:

  • CommandPrefix:

This defines the symbol that is used by your bot to identify commands.
By default it is the symbol ! which means the command "google" will be triggered by starting your message with !google.
These are defined by an ASCII numeric value. In this instance "33" represents the default symbol !
You can find out the ASCII value for the symbol you want here


  • LogComments

Whether or not to log all output to the console that are not IRC traffic to file (such as errors, warnings, reconnect messages.) Defined either by "true" or "false".


  • AutomaticConfigurationReload

Whether or not to automatically reload configuration files and database files as they are changed by another application. Defined either by "true" or "false".

This feature is not yet supported and will be ignored.

  • DisableSessionTimer

The 60 minute timer that automatically signs out administrators will be disabled and they will remain logged in until they quit. Defined either by "true" or "false".

  • StartupDelay

Enables a 15 second delay before sending commands to the servers after it has connected. Defined either by "true" or "false".

  • SplitCommandOutput

Splits and sends channel messages in bulks of 420 characters to avoid messages from being cut off by server.

 Defined either by "true" or "false".


  • ChatHistory

Log server traffic to file in a chat-history style format. Seperated by user and channel.

 Defined either by "true" or "false".


Step 3: Set Administrator Privilegies.

This is the administrator/superuser section. You can copy and paste the <Admin></Admin> section over for each new admin and change the settings below.

  • Username

This is the username that is used for the "login <username> <password>" command used to initialize an administrator session. Usernames are used so people with multiple IRC instances or nicks only need one account. Usernames are case-sensitive.

  • Password

This is the password used in the login command.

  • Owner

In the "Admin" tag you will find a value showing Owner="true" or Owner="false". This designates the user that is the owner of the bot. Multiple owners do not work and if multiple are defined the bot won't run so don't try.


Step 4: Server Configuration

Last edited Dec 17, 2012 at 7:47 AM by lexi, version 6


No comments yet.