Berkeley Undermind - Readme.txt

Contact: Axel Prompt (aprompt@berkeley.edu)
Bot Type: Java proxy

Required Dependencies (all compiled dlls are bundled with the proxy):
* All dependencies that ship with BWAPI
* libprotobuf http://code.google.com/p/protobuf/downloads/list version 2.3.0
* Boost DateTime 1.40:
http://www.boost.org/doc/libs/1_40_0/more/getting_started/windows.html
* Boost Foreach 1.40 (header only library)
* Boost IOStream 1.40 (header only library)

Compilation Instructions

Step 1: Compile the C++ proxy module

-Open proxy/cpp/ClientModule.sln in VS Studio 2008 (Express)

-We assume that boost is installed at C:\Program Files
(x86)\boost\boost_1_40. (We just used
http://www.boostpro.com/download/boost_1_40_setup.exe). You can change
the include path by right clicking on ClientModule in VS -> Properties
-> C/C++ -> Additional Include Directories

-Build -> Build Solution

-The proxy dll (included in the exe submission as Undermind.dll) now
lives at proxy/cpp/Release/ClientModule.dll


Step 2: Compile the Java proxy jar

To build the java half, we need jdk 1.6, JNative.jar junit-4.7.jar
and protobuf.jar
 * JNative lives here : http://sourceforge.net/projects/jnative/
 * JUNit 4.7 lives here: https://github.com/KentBeck/junit/downloads
 * protobuf lives here:
http://code.google.com/p/protobuf/downloads/list again, 2.3.0

-Import the proxy folder as an existing Eclipse project (File, Import
-> Existing Projects into Workspace, Root directory = proxy)

-Let Eclipse build it

-Export a jar using jj.jardesc (right click on it)

-Copy the newly exported proxy.jar into the undermind/lib directory


Step 3: Compile the proxy bot

-Import the undermind folder as an existing Eclipse project

-Run the build.xml script (right click, Run As, Ant Build)

-The resulting jar file UndermindProject.jar is the one included in
the exe submission.
