Skip to content

Commit

Permalink
updated instructions (readme markdown)
Browse files Browse the repository at this point in the history
  • Loading branch information
pBlueG committed Apr 22, 2014
1 parent 3cbcad9 commit 956f819
Showing 1 changed file with 43 additions and 11 deletions.
54 changes: 43 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,67 @@
mYsTeRy IRC PHP Bot
=======

Once you have configured the bot, execute run_win32.bat (windows) or run_unix.ssh (linux).
The following short instruction will show you how to configure the IRC bot. Once the bot is configured, you can run the bot via the enclosed run_(win32.bat|unix.ssh) files. You'll need PHP installed to run the bot.

### Directory hierarchy

**-- General Configuration:**
- mYsTeRy-v2.0a/
- /classes/
- /configuration/
- /bots/
- /networks/
- /database/
- /interfaces/
- /logs/
- /pawn/
- /plugins/
- /ssl/

configuration/general.cfg

### General Configuration:

> /configuration/general.cfg
**-- Network Configuration:**
[General]
SQLite = on # requires the php_sqlite3.(dll|so) module
MySQL = off # see mysql.ini for host/user/db config
AdminPass = testicle # specifies the password to get recognised as bot admin -> /msg BotNickname login password
Admins[] = "[email protected]" # adding your ident allows you to get recognised as administrator without login
;Admins[] = "[email protected]" # format: nickname!ident@hostname
Logging = on # specifies whether all channel messages get logged
Sleep = 40000 # specifies the sleep time of the bot = 1mio/sleeptime => ticks per second (1000000/40000 = 25 ticks)
Prefix = "!" # command prefix
Ping = 45 # specifies the bot ping timeout check in seconds
# plugins loaded on startup, use !load/!unload when the bot is connected
Plugins[] = ctcp
Plugins[] = dcc
Plugins[] = "auto_perform"

configuration/networks/




### Network Configuration:

> /configuration/networks/
How to define a new network (required file format):

[Network]
Name = Networkname # Case sensitive string
Name = Networkname # Case sensitive string
SSL = false # boolean (alt)
SSL_CRT = "" # case sensitive string (alt)
SSL_CRT = "" # case sensitive string (alt)
Port = 6667 # integer
Servers[] = "irc.network.address" # Array set of strings

The filename does not matter.



**-- Bot Configuration:**
### Bot Configuration:

configuration/bots/
> /configuration/bots/
How to create a new bot:

Expand All @@ -53,7 +85,7 @@ within the bots/ folder.



**-- Commands:**
### Commands:

The bot has built in commands to fully control the bot. (admin privileges required)

Expand All @@ -74,7 +106,7 @@ The bot has built in commands to fully control the bot. (admin privileges requir



**-- Admin authentication:**
### Admin authentication:

You will need admin privileges to control the bot and run commands. There
are two ways to identify as administrator:
Expand Down

0 comments on commit 956f819

Please sign in to comment.