Starting/Running ehMOO

[home] [download] [quick start] [FAQ] [bugs] [tech info] [bots] [contact]

Starting ehMOO

ehMOO only runs on Linux:

make all the textures in eh_www_images-0.95.tar.gz available on a web server (some options: just copy everything to your 'home page area' on your ISP, or use Personal Web Server (PWS) on Windows or thttpd on Linux)
get ehCore-0.95.db.gz and uncompress it or get a fresh LambdaCore and follow the instructions for building ehCore-0.95.db from scratch
start ehMOO using ehCore-0.95:
```
restart ehCore-0.95
```

Starting miniMOO

Same for Windows and Linux:

make all the textures in eh_www_images-0.95.tar.gz available on a web server (some options: just copy everything to your 'home page area' on your ISP, or use Personal Web Server (PWS) on Windows or thttpd on Linux)
start miniMOO using the sample world (my.db is the world database and will be created the first time you run this):
```
java minimoo my.db sampleroom
```
You should see 'World file sampleroom loaded'
make a text connection and create the player named in myminimoo as read by .ehwtrc:
```
telnet localhost 7777
connect wizard
@make-player tom tom
```
start ehwt using -c option to get starting world from minimoo
```
./ehwt -c myminimoo
```

connecting to ehMOO

Using ehwt on Linux:

Start ehMOO as in Starting ehMOO
connect as wizard:
```
connect wizard
```
create a character for yourself:
```
@make-graphics-player tom tom@localhost
@new-password tom is tom
```
You now have a regular MOO character who also has graphics capabilities.
copy the ehwthome directory from home.linux (in the ehwt distribution) to your home dir or wherever you want eh worlds cached.
```
cp -ar ehwthome ~
```
copy the following files from home.linux (in the ehwt distribution) to your home dir
```
cp .ehwtrc ~
cp myminimoo ~
cp ehmoo ~
```
edit ~/.ehwtrc:
change the line:
```
ehwt_home ~/ehwthome
```
to point to wherever it was that you copied ehwthome, if not your home dir
edit ~/ehmoo:
change the following lines to reflect the host and port ehmoo is running on (default port is 11111) and the character and password of the character you created above:
```
host localhost
port 11111
character tom
password tom
```
change the following line to reflect the base URL of the images used for the world, set up as described in the starting minimoo or starting ehMOO sections:
```
url_base_a http://192.168.1.1/eh_images
```
NOTE: Due to a bug in the URL handling code, localhost won't work as a hostname in the url_base_a - use the DNS name or IP address of the host
start ehwt:
```
./ehwt
```
You should be in a room with a doorway straight ahead:
This room is your local home world, room 0, and isn't part of any ehMOO. (If the room, ceiling, floor, etc are all gray, it means the textures weren't loaded from the webserver you specified in the ehmoo file for some reason. See Bugs and Troubleshooting.) To get to ehMOO, you need to walk through a red doorway outside and to the left of the room you start out in. Using the arrow keys, walk out the doorway in front of you and turn left:
Go to the red door and enter the doorway as if you were going to walk up and open the door:
This will trigger your entry into ehmoo if all goes well. You should see 'Looking up host' followed by 'Contacting host' followed by a bunch of other messages indicating activity in the window you started ehwt from. (If things get stuck at either 'Looking up' or 'Contacting', you most likely don't have the correct hostname. See Bugs and Troubleshooting.) You're now in the first room of ehMOO:
If you walk back out the door you just came in, you'll re-enter the local homeworld. Actually, there are 2 red doors in the room, the first leads home, the other leads to a currently undefined world which you can edit using the eh world editor, ehed. If you see a fish near the door you just entered, that's the graphical representation for wizard who is logged on textually (characters that haven't edited their appearance appear as fish, see objed). Try logging wizard off - you should see the fish disappear. Log on again and the fish reappears.

Using ehwt on Windows:

If you've built ehwt yourself, you should put the path to the libwww DLLs in your path e.g. put these in your PATH statement in autoexec.bat:
```
C:\eh\w3c-libwww-5.0a\Bin\Debug
C:\eh\w3c-libwww-5.0a\Bin\Release
```
If not, just cd to the ehwtwin.bin directory containing the ehwtwin.exe and dlls to run ehwt.
The home.windows directory (in the ehwt or ehwtwin distribution) contains the configuration files ehwtwin needs in order to run. Copy the eh subdirectory from home.windows\Program Files to C:\Program Files
edit C:\Program Files\eh\ehwt\ehmoo:
change the following lines to reflect the host and port ehmoo is running on (default port is 11111) and the character and password of the character you created above:
```
host localhost
port 11111
character tom
password tom
```
change the following line to reflect the base URL of the images used for the world, set up as described in the starting minimoo or starting ehMOO sections:
```
url_base_a http://192.168.1.1/eh_images
```
NOTE: Due to a bug in the URL handling code, localhost won't work as a hostname in the url_base_a - use the DNS name or IP address of the host
start ehwt:
```
.\ehwtwin
```
You should be in a room with a doorway straight ahead:
This room is your local home world, room 0, and isn't part of any ehMOO. (If the room, ceiling, floor, etc are all gray, it means the textures weren't loaded from the webserver you specified in the ehmoo file for some reason. See Bugs and Troubleshooting.) To get to ehMOO, you need to walk through a red doorway outside and to the left of the room you start out in. Using the arrow keys, walk out the doorway in front of you and turn left:
Go to the red door and enter the doorway as if you were going to walk up and open the door:
This will trigger your entry into ehmoo if all goes well. You should see 'Looking up host' followed by 'Contacting host' followed by a bunch of other messages indicating activity in the window you started ehwt from. (If things get stuck at either 'Looking up' or 'Contacting', you most likely don't have the correct hostname. See Bugs and Troubleshooting.) You're now in the first room of ehMOO:
If you walk back out the door you just came in, you'll re-enter the local homeworld. Actually, there are 2 red doors in the room, the first leads home, the other leads to a currently undefined world which you can edit using the eh world editor, ehed. If you see a fish near the door you just entered, that's the graphical representation for wizard who is logged on textually (characters that haven't edited their appearance appear as fish, see objed). Try logging wizard off - you should see the fish disappear. Log on again and the fish reappears.

connecting to miniMOO

Using ehwt on Linux:

start miniMOO using the sample world (my.db is the world database and will be created the first time you run this):
```
java minimoo my.db sampleroom
```
Should see 'World file sampleroom loaded'
make a text connection and create player in myminimoo read in .ehwtrc:
```
telnet localhost 7777
connect wizard
@make-player tom tom
```
You now have a regular MOO character who also has graphics capabilities.
copy the ehwthome directory from home.linux (in the ehwt distribution) to your home dir or wherever you want eh worlds cached.
```
cp -ar ehwthome ~
```
copy the following files from home.linux (in the ehwt distribution) to your home dir
```
cp .ehwtrc ~
cp myminimoo ~
cp ehmoo ~
```
edit ~/.ehwtrc:
change the line:
```
ehwt_home ~/ehwthome
```
to point to wherever it was that you copied ehwthome, if not your home dir
edit ~/ehmoo:
change the following lines to reflect the host and port ehmoo is running on (default port is 11111) and the character and password of the character you created above:
```
host localhost
port 11111
character tom
password tom
```
change the following line to reflect the base URL of the images used for the world, set up as described in the starting minimoo or starting ehMOO sections:
```
url_base_a http://192.168.1.1/eh_images
```
NOTE: Due to a bug in the URL handling code, localhost won't work as a hostname in the url_base_a - use the DNS name or IP address of the host
start ehwt:
```
./ehwt -c myminimoo
```
You should see a room that looks surprisingly like the normal home room, the difference being that this is actually a minimoo room:
Start another session, and you should see one window track the other when you move around:
```
./ehwt -c myminimoo
```
Wizard is the fish you see.
To simulate a multi-player session, we'll create another player and call it tom2. So, add another player in the minimoo text session:
```
@make-player tom2 tom2
```
copy ~\.ewhtrc to ~\.ehwtrc.tom2
copy ~\myminimoo to ~\myminimoo.tom2
change myminimoo to myminimoo.tom2 in .ehwtrc.tom2
edit myminimoo.tom2, change to new char tom2 password tom2
start a new session as tom2 and connect to myminimoo.tom2:
```
./ehwt -i .ehwtrc.tom2 -c myminimoo.tom2
```
You should see 1 or two other fish, depending on whether wizard is still connected in the text session. Have tom look at tom2, then move tom2 around - tom should see tom2 moving around:
let's make tom2 an upsidedown fish - cd to the objed directory and start objed:
```
java objed
```
Select the menu item File | Select Facings and navigate to the eh_images directory
Select a set of 8 images with the same base name and image type
You'll notice that the images aren't in quite the right order, drag and drop the thumbnail images on the left to rearrange them:
Select the menu item File | Connect To World - fill in the dialog, press ok:

Should see CONNECTED to xxx:11111 in message window on bottom
fill in object id of tom2 (#4)
Press submit
You should see "Submitted facing ..." lines
It may be necessary to disconnect/reconnect to see tom2's new facings

Using ehwt on Windows:

start miniMOO using the sample world (my.db is the world database and will be created the first time you run this):
```
java minimoo my.db sampleroom
```
Should see 'World file sampleroom loaded'
make a text connection and create player in myminimoo read in .ehwtrc:
```
telnet localhost 7777
connect wizard
@make-player tom tom
```
If you've built ehwt yourself, you should put the path to the libwww DLLs in your path e.g. put these in your PATH statement in autoexec.bat:
```
C:\eh\w3c-libwww-5.0a\Bin\Debug
C:\eh\w3c-libwww-5.0a\Bin\Release
```
If not, just cd to the ehwtwin.bin directory containing the ehwtwin.exe and dlls to run ehwt.
The home.windows directory (in the ehwt or ehwtwin binary distribution) contains the configuration files ehwtwin needs in order to run. Copy the eh subdirectory from home.windows\Program Files to C:\Program Files
edit C:\Program Files\eh\ehwt\myminimoo:
change the following lines to reflect the host and port myminimoo is running on (default port is 11111) and the character and password of the character you created above:
```
host localhost
port 11111
character tom
password tom
```
change the following line to reflect the base URL of the images used for the world, set up as described in the starting minimoo or starting ehMOO sections:
```
url_base_a http://192.168.1.1/eh_images
```
NOTE: Due to a bug in the URL handling code, localhost won't work as a hostname in the url_base_a - use the DNS name or IP address of the host
start ehwt:
```
./ehwtwin -c myminimoo
```
You should see a room that looks surprisingly like the normal home room, the difference being that this is actually a minimoo room:
Start another session, and you should see one window track the other when you move around:
```
ehwtwin -c myminimoo
```
Wizard is the fish you see.
To simulate a multi-player session, we'll create another player and call it tom2. So, add another player in the minimoo text session:
```
@make-player tom2 tom2
```
copy C:\Program Files\eh\ehwt\.ewhtrc to C:\Program Files\eh\ehwt\.ehwtrc.tom2
copy C:\Program Files\eh\ehwt\myminimoo to C:\Program Files\eh\ehwt\myminimoo.tom2
change myminimoo to myminimoo.tom2 in .ehwtrc.tom2
edit myminimoo.tom2, change to new char tom2 password tom2
start a new session as tom2 and connect to myminimoo.tom2:
```
ehwtwin -i .ehwtrc.tom2 -c myminimoo.tom2
```
You should see 1 or two other fish, depending on whether wizard is still connected in the text session. Have tom look at tom2, then move tom2 around - tom should see tom2 moving around:
let's make tom2 an upsidedown fish - cd to the objed directory and start objed:
```
java objed
```
Select the menu item File | Select Facings and navigate to the eh_images directory
Select a set of 8 images with the same base name and image type
You'll notice that the images aren't in quite the right order, drag and drop the thumbnail images on the left to rearrange them:
Select the menu item File | Connect To World - fill in the dialog, press ok:

Should see CONNECTED to xxx:11111 in message window on bottom
fill in object id of tom2 (#4)
Press submit
You should see "Submitted facing ..." lines
It may be necessary to disconnect/reconnect to see tom2's new facings