PL-PLAN : A Java Open-Source AI Planner


    1- How do I run PL-PLAN from Eclipse?

    Follow these six steps:

    1. Download plplan-0.43.jar
    2. Open Eclipse
    3. Check for the latest Eclipse updates. Go into menu "Help/Software updates/Find and install...", and install the available updates. If you install updates, you will need to restart Eclipse before doing the next step.
    4. Make a new Java project.
    5. Import the sources and ressources from the plplan-0.42.jar file into the project. If Eclipse tell you that the .jar file is corrupted for whatever reasons, download the .jar file and try again. If it still doesn't work, extract the file manually with a ZIP file software such as the free 7-zip, or contact me.
    6. Right click on project and select "properties" from the contextual menu. Click on the "Java compiler" tab. Make sure that the JDK compliance level is set to Java 5.0 (1.5). You need to have JDK 5.0 or more to run PL-PLAN.

    After these steps, you are now ready to run PL-PLAN. We provide two examples (, and The first creates a new problem and then find a plan. The second load a problem definition from a file, and then find a plan. In the "gui" package there is the graphical interface that we use to launch automatic and manual tests.

    2 - How do I compile ActionTest, BWGraphplanTest, FWPlannerTest, LayerTest, MutexPropTest, PlanningGraphTest and PropositionTest ?

    These classes are unit test. Their purpose is to ensure that PL-PLAN classes are working. These classes are not required to run PL-PLAN, and are intended for developpers of PL-PLAN and those who could want to extend it. To compile these classes, you need to put junit.jar in your classpath. You can download junit from here. If you are using Eclipse, you should have a copy of the junit jar file in this folder : .\eclipse\plugins\org.junit_3.8.1.

    Do you have any other questions? Send me an e-mail.