PPF Home
Plugins
Developers
   Font size:      

Frequently Asked Questions

PDF
PDF

Questions

1. Running

1.1. What do I need to run PPF?

^

PPF is written in Java, so you must install, or have installed, a Java Virtual Machine (JVM) to run it. Check out The Source for JavaTM Technology to find a suitable JVM for your system.

1.2. Why do I get "not a recognized command" (or something similar) when I try to run PPF?

^

You don't have the java executable in your PATH. Make sure that you have java installed. If Java is installed, you must add the "bin" directory inside the Java installation into the PATH of your system.

1.3. How do I run PPF as a Windows service?

^

In the PPF root folder you will see a command prompt file named runAsService.cmd. Open that file in a text editor, and configure the JRE_HOME parameter to point to where you have Java Runtime Enviroment installed. By default your JRE should be in a path similar to this: C:\Program Files\Java\jre1.5.0_10. After you have set the JRE_HOME correctly, save the file. Finally run runAsService.cmd by double-clicking on it, and your service should now be installed and named PPF in Windows Services. The service will automatically start your PPF bot when Windows starts up.

1.4. I run PPF as a Windows service. How can I uninstall the service?

^

In the PPF root folder you will see a command prompt file named removeService.cmd. You run this file by double-clicking on it, and your PPF Windows service wil uninstalled.

1.5. I am a first time user and can't get PPF to run on BSD/Linux. What do I do?

^

On BSD/Linux/Unix, PPF runs in nohup, so all standard out messages are stored in <PPF-dir>/system/PPF/nohup.out. Look at the nohup.out file to check if there is any logical explaination to the problem. For instance you might not have java installed, java is not in the PATH, or you simply forgot to disable the Die plugin.

1.6. I have a question not in this FAQ...what do I do?

^

Post your question in the User Help Forum.

2. Config

2.1. How do I change the PPFConfig.xml file?

^

Any plain text editor such as notepad, emacs or even vi :)

3. Connecting to IRC

3.1. Everything seems ok, but it just won't connect to IRC.

^

If you have a firewall, you will have to allow the Java process access.

4. Basic Commands

4.1. How do I auth?

^

/msg BotNick auth Password

4.2. How do I tell the bot to join a channel while it's running?

^

First, you must auth as an admin, then: /msg BotNick join #channel

If the channel has a password, then: /msg BotNick join #channel chan-pass

4.3. How do I tell the bot to leave a channel while it's running?

^

First, you must auth as an admin, then: /msg BotNick part #channel

4.4. How do I change the nick/name of the bot while it's running?

^

First, you must auth as an admin, then: /msg BotNick nick NewNick

4.5. How do I stop the bot?

^

First, you must auth as an admin, then: /msg BotNick die

This will disconnect the bot from the server and close the Java JVM

5. Other Q's

5.1. What does the original author of PircBot think about your project?

^

Jibbler (author of PircBot): "As always, i am glad to see PircBot being used effectively and for people to be using it."