Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
module:ircbot [2019/04/18 15:19] – hansolo | module:ircbot [2019/04/24 12:29] – Removed the IRC log (placeholder documentation) from the top of the page. ecbbs | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
+ | |||
+ | **Installation** | ||
+ | |||
+ | The IRC bot is included with Synchronet BBS, at '' | ||
+ | |||
+ | **Configuration** | ||
+ | |||
+ | The IRC bot configuration file is '' | ||
< | < | ||
- | < | + | [server_ServerName] |
- | < | + | addresses=add.ress.one, add.ress.two |
- | < | + | nick=BotNickname |
- | < | + | services_password=? |
- | < | + | channels=# |
- | < | + | port=6667 |
- | < | + | |
- | < | + | |
- | < | + | |
</ | </ | ||
- | I'm going to start working on revising this page. Since there is not a great deal of info about the ircBot included with the BBS package, I've been doing some experimenting. | + | // |
+ | - If you are running | ||
+ | - You may place more than one server section in '' | ||
- | Installation | + | **Modules** |
- | ------------ | + | There are a number of modules available for the IRC bot, but they are not all enabled |
- | There is an ircBot program included with the Synchro.net BBS package, but it is not enabled | + | |
- | Configuration | + | < |
- | ------------- | + | [module_ModuleName] |
- | The ircBot is controlled via a settings file ctrl/ircbot.ini | + | channels=# |
- | Most important are the server settings (omit the * I just needed them for formatting in this wiki); | + | dir=/sbbs/ |
+ | lib=mylib.js | ||
+ | global=true | ||
+ | </ | ||
- | * [server_ServerName] | + | Looking at the '' |
- | * addresses=add.ress.one, add.ress.two | + | |
- | * nick=BotNickname | + | |
- | * services_password=? | + | |
- | * channels=# | + | |
- | * port=6667 | + | |
- | Notes: | + | < |
- | -- If running from the same machine as the ircD then using localhost or 127.0.0.1 works OK. But if you have multiple IP's configured use the specific IP' | + | |
- | -- Port is required but if you use the default 6667 or a dedicated port doesn' | + | |
- | -- Passwords are important but quite honestly I have not figured out how to authenticate a bot other than with /oper lines. | + | |
- | -- I have found that you may place more than one server section in the ini and it does in fact create more than one bot in the ircd. However, the subsequent bots do not see to behave the same as the default and I need to experiment more with using dedicated ports / running multiple command windows to host individual bots. | + | |
- | Modules | + | ; |
- | ------- | + | ; |
- | There are a number of modules available for the ircBot to host, although they are not all enabled (or listed) in the ctrl/ircbot.ini by default. | + | |
- | * [module_ModuleName] | + | [module_Admin] |
- | * channels=#channelone < | + | global=true |
- | | + | dir=/ |
- | * lib=mylib.js | + | |
- | * global=true | + | |
- | Looking at the sbbs\exec\ircbots | + | [module_Antispam] |
+ | global=true | ||
+ | dir=/sbbs/exec/ircbots/antispam/ | ||
- | * [module_Admin] | + | [module_Decider] |
- | | + | global=true |
- | | + | dir=/ |
- | * [module_Antispam] | + | [module_Dice] |
- | | + | global=true |
- | | + | dir=/ |
- | * [module_Decider] | + | [module_Dis] |
- | * global=true | + | dir=/ |
- | * dir=/ | + | |
- | * [module_Dice] | + | ;[module_Google] |
- | | + | ;global=true |
- | | + | ;dir=/ |
- | * [module_Dis] | + | [module_Ham] |
- | | + | dir=/ |
- | * ;[module_Google] | + | [module_Humanity] |
- | * ; | + | dir=/ |
- | * ;dir=/ | + | |
- | * [module_Ham] | + | [module_Info] |
- | | + | global=true |
+ | dir=/ | ||
+ | lib=http.js | ||
- | * [module_Humanity] | + | [module_Poker] |
- | | + | dir=/ |
+ | lib=cardlib.js | ||
- | * [module_Info] | + | [module_Presence] |
- | * global=true | + | dir=/ |
- | * dir=/ | + | |
- | * lib=http.js | + | |
- | * [module_Poker] | + | [module_Weather] |
- | | + | global=true |
- | | + | dir=/ |
+ | lib=http.js | ||
- | * [module_Presence] | + | [module_WhereIs] |
- | | + | global=true |
+ | dir=/ | ||
+ | lib=http.js | ||
- | * [module_Weather] | + | [module_RPG] |
- | * global=true | + | dir=/ |
- | * dir=/ | + | </ |
- | * lib=http.js | + | |
- | * [module_WhereIs] | + | //Notes// |
- | * global=true | + | |
- | * dir=/sbbs/exec/ircbots/ | + | - No trivia directory although it is listed in the ini file. |
- | | + | - Otherwise, by adding the modules to the ini and restarting the bot you may make these available in your ircd. |
+ | |||
- | | + | **Running the IRC Bot** |
- | | + | |
- | Good seems to have some file dependencies and doesn't execute so I have it commented out. Also, no trivia directory although it is listed in the ini file. | + | The IRC bot can be executed via [[: |
- | See the help by sending /msg < | + | You can also run the IRC bot via your services thread |
- | You will need to IDENT against your bot to see the full menu of items, without IDENT the help looks like; | + | |
+ | < | ||
+ | [IRCBot] | ||
+ | Port=6668 | ||
+ | Options=STATIC|LOOP | ||
+ | Command=ircbot.js | ||
+ | </ | ||
+ | |||
+ | Note that the //Port// value must be supplied, but is irrelevant; the bot does not listen for connections. | ||
+ | |||
+ | You can add '' | ||
+ | |||
+ | |||
+ | **Using the IRC Bot** | ||
+ | |||
+ | - See the help menu by sending **/msg < | ||
+ | - Some commands are restricted and will not show up in the help menu (or be usable), until you have identified yourself to the bot. To identify, use **/msg < | ||
+ | |||
+ | Without **IDENT** the help looks like; | ||
+ | |||
+ | < | ||
Usage: HELP < | Usage: HELP < | ||
[main] help,?, | [main] help,?, | ||
Line 130: | Line 149: | ||
for help creating a characer, type 'rpg help create' | for help creating a characer, type 'rpg help create' | ||
for help with the editor, type 'rpg help editor' | for help with the editor, type 'rpg help editor' | ||
+ | </ | ||
- | With IDENT it looks like; | + | With **IDENT** it looks like; |
+ | |||
+ | < | ||
Usage: HELP < | Usage: HELP < | ||
[main] reload, | [main] reload, | ||
Line 154: | Line 176: | ||
for help creating a characer, type 'rpg help create' | for help creating a characer, type 'rpg help create' | ||
for help with the editor, type 'rpg help editor' | for help with the editor, type 'rpg help editor' | ||
- | + | </ | |
- | I am going to begin going through all the commands for the bot and will list them out here. | + | |
===== See Also ===== | ===== See Also ===== |