CamfrogBot Owner Guide

Getting Started

First install the Camfrog Video Chat bot on your computer by double clicking the installer. The bot will install in the C:\Program Files\Camfrog folder. Now launch the bot by double clicking it and a grey bot icon will appear in the bottom right system tray in the task manager. When the bot icon is grey it means it is not connected to the Camfrog Webcam Chat central server.
Once the bot is installed you will need to register a new bot nickname. Right click the bot in the system tray and choose "register new bot" to create a new bot nickname. Please note you cannot use a Camfrog Video Chat client or server nickname for your bot. The bot nicknames have a separate database and they must use a separate nickname and password. Be sure you make your bot 18 years of age or older if you want it to join an adult room or it will be rejected from your room. If you ever lose your bot password go to our Camfrog Video Chat "contact" page and click the "I lost my password" button.
After you have registered a nickname for your bot go to the "connection" window by double clicking the bot icon in the system tray. Enter your bots nickname, password, your Camfrog server room nickname, and your bot serial number. Press the "connect on startup" check box if you want it to automatically always join your room on startup. IMPORTANT: Be sure your bot is added as owner in your room or it will be unable to join if you don't allow users without webcams.

Room Troubleshooting

If your bot cannot join your room try these things:

1.  Make sure your bot age is 18 years of age or older. If your bot is under 18 then register a new bot nickname.
2.  Make sure your bot nickname is added as owner of your room. Make sure you spell your bot nickname correctly in the owner list.
3.  Make sure in your Camfrog Video Chat Server settings that you don't have the settings made where bots are not allowed in your room or your bot will be unable to enter your chat room.

Trivia and other Plugins

To add, remove, or change Trivia questions open the questions.dat file in the "plugins\trivia" folder. You can open this file with Microsoft Notepad that can be found under start/programs/accessories. Be sure you've chosen to view all file types, not just txt when trying to open this file with Notepad. Make sure your questions are in the same exact format as our trivia file or the questions will not work.
To use the other modules click the module once and then click the "settings" button at the bottom right of the window. You can also turn off any module by highlighting it once and clicking the "Turn Off" button. The far right column will change from "A" for active to a blank window so you can easily see what modules are on and off.
If you'd like to write you own Camfrog bot module you can examine the "version.dll" plugin source code (located at "plugins\sample-src" folder). You can also post any questions on our help forum any time about making your own bot module and we will try our best to help.
For someone to send the bot text commands the user must be a bot owner. To become a bot owner click the "imcontrol" module and add your Camfrog client nickname there. An example command that uses this is the "whobanned" command. If someone was banned or punished in your room you can type /whobanned nickname and it will show the nickname of the user who did this.

Because this bot is plugin-oriented the commands are separated by the plugins. All the commands excepting "/ver" are parsed by the imcontrol.dll plugin. This plugin forwards the commands to the correct modules.

Bot commands list:

** Bot Commands

/ver - display bot version (version.dll)
/shutdown - shut down the bot (imcontrol.dll)

** Room controls

/postmsg message - post message to chat (imcontrol.dll)
/kickuser nickname - kick user from chatroom (imcontrol.dll)
/punishuser nickname - punish user in chatroom (imcontrol.dll)
/unpunishuser nickname - unpunish user (imcontrol.dll)

** Trivia Game

/trvplay 0|1 - turn Trivia game on/off (trivia.dll)
/trvstart - start Trivia game (trivia.dll)
/trvstop - stop Trivia game (trivia.dll)
/trvclear - clear records (trivia.dll)

** Posting messages to the room

/msgrtime 30-30000 - set messages posting interval (messenger.dll)
/msgrclear - clear message list (messenger.dll)
/msgradd message - add message to message list (messenger.dll)

** Bad expressions

/bexpr 0|1 - turn bad expressions catcher on/off (badwords.dll)
/bekick - select kick for bad expressions (badwords.dll)
/bepunish - select punish for bad expressions (badwords.dll)
/bereason reason - set kick/punish reason (badwords.dll)
/becount 1-10 - set the forbidden words counter (badwords.dll)
/bewords 0|1 - select regular expressions/words mode - with "0" it will use regular expressions, with "1" just kick for word substring (badwords.dll)
/beclear - clear bad expressions list (badwords.dll)
/beadd expression - add expression to bad list (badwords.dll)

** Whobanned plugin. These commands are working with events that happened during the bot uptime only! For example if the bot exits and is restarted all prior moderation events will be lost and you'll need to check the logs file. All previous events can be found in the plugin logs at the server.

/whobanned nickname - check who banned nickname (whobanned.dll)
/whokicked nickname - check who kicked nickname (whobanned.dll)
/whopunished nickname - check who punished nickname (whobanned.dll)
/whounpunished nickname - check who unpunished nickname (whobanned.dll)

** Bot owners control

/owners - display owners list (imcontrol.dll)
/addowner nickname - add new owner (imcontrol.dll)
/delowner nickname - delete owner (imcontrol.dll)

Bad expressions rule examples