Project Snowman Installation Guide

Today I was trying to install Project Snowman. I downloaded the distribution package, followed the instructions in Snowman’s wiki and got this error:

[java] SEVERE: DataService initialization failed
[java] java.lang.UnsatisfiedLinkError: no libdb_java45 in java.library.path

After founding the library and pasting it in the right folder… another error…

[java] SEVERE: DataService initialization failed
[java] com.sun.sgs.impl.service.data.store.DataStoreException: DataStore initialization failed: Unexpected database exception: com.sleepycat.db.DatabaseException: Bad address: Bad address

So I looked up google,  and found an installation guide for snowman in a cached page from www.timadorus.org.  I’m afraid the cached page could be lost so I’m copying and pasting the guide here. If you know who can be the author please post a comment so I can give him or her credit.

The guide says it’s for Windows XP.  I tried in Windows 7 32 bits and it worked perfectly.
Update 20100913: Today I tried in Windows 7 64 bit and it gives me the following error:

[java] SEVERE: DataStore initialization failed
[java] java.lang.UnsatisfiedLinkError: C:\Users\Alhvi\Desktop\snowman-dist-
0.1\snowman-dist\natives\bdb\win32-x86\libdb_java45.dll: Can't load IA 32-bit .d
ll on a AMD 64-bit platform


Anyway… for the rest of the people who uses a 32 bit Windows Version, or another OS  here is the guide:

Installation Guide for Snowman version 0.1

The game:

Download link: https://project‐snowman.dev.java.net/

Requirements:

• Apache Ant (Download link: http://ant.apache.org/bindownload.cgi)
• Java SDK 6
• Current OpenGL driver for used video card

Installation process:

Step 1:

Unzip the file snowman-dist.01.zip

Step 2:

After unzipping the file two new folders will be created:
/natives/
/snowman-dist/

To get the client running on Windows XP you have to copy libdb_java45.dll from
Path: /natives/bdb/win32 –x86
to the following folder:
path: /snowman-dist/natives/bdb/win32 –x86/

The next step is to create a new folder named “win32 –x86”.
Path: /snowman-dist/lwjgl-binaries/win32 –x86
Now copy the file “lwjgl.dll” from win32 to your new created folder.
Path: /snowman-dist/natives/lwjgl-binaries/win32

*Step 3:

Change dir to the folder snowman-dist
Path:/snowman-dist/
A file called build.xml should be found there

Step 4:

Open console and enter the following commands:
ant run-single
ant run-client

…and enjoy your snowball fight!!

Step 5:

If the game does not start please check the output for “Bad address” warnings like this:
Notice the missing slashes!
[java] WARNUNG: Database error message: Z:\xp-pro\Desktop\snowman-dist-0.1\
snowman-dist\xp-proDesktopsnowman-dist-0.1snowman-dist  mpsnowman\dsdb: Bad addr

If so open the build.xml file and look for these lines:
…

…

com.sun.sgs.app.name=Snowman
com.sun.sgs.app.root=${app.dir}
com.sun.sgs.app.port=${server.port}
com.sun.sgs.impl.service.transport.udp.port=1234
com.sun.sgs.impl.service.data.store.db.environment.class=${bdb.env}

…

Replace “${app.dir}” with the snowman path. *The line to change should be 168.
Example:
com.sun.sgs.app.root=c:\\snowman-dist\\tmp\\snowman

*Dont forget the double backslashes

*Run again:

ant run-single
ant run-client
Now the game should start without any problems.

Further commands for the console:

ant run-single:         starts a local server
ant run-client:        starts a client
ant run-server:        starts a server
ant run-editor:        starts the editor

Download Source Code:

svn url : https://project-snowman.dev.java.net/svn/project-snowman/trunc

Name: guest
Password: empty

Comment by Alhvi:

After following the guide everything works as it should. The only thing I didn’t knew is that you need to run two clients to be able to play.

Update 20100913: Changed the format to make the guide a little bit more understandable. Added some comments to the post (marked with *). Happy programmers day!!