README.md

RPi-WaterbearNodeJS

A nodejs server which serves Waterbear from the RaspberryPi and provides a way for nodejs scripts to be uploaded and run.

This includes ways to program

• Minecraft Pi Edition http://pi.minecraft.net/?p=68
• PiFace Digital I/O board http://www.piface.org.uk/products/piface_digital/
• PiBrella I/O board http://pibrella.com/
• Firmata (not currently tested)

For news follow @EduMakeCoop on Twitter

Requirements

• A Raspberry Pi
• To use the minecraft features get & install Minecraft Pi Edition from http://pi.minecraft.net/?p=68

Installing

If you don't have git yet

sudo apt-get install git

Once you have that....

git clone https://github.com/EduMake/RPi-WaterbearNodeJS.git
cd RPi-WaterbearNodeJS
sudo ./installer.sh

This will take a while (10 minutes is not unusual) and install lots of stuff.

Running

To use Minecraft Pi get that running and start a game.

To start the waterbear server.....

./waterbear.sh

or if you want to use a PiBrella

./pibrella-waterbear.sh

then using a web browser on another machine visit

http://IP:8000/node.html

changing the IP to the one for your Raspberry Pi

Running on the PC version (V.V. Buggy)

This is more technical and I'm being vague so only try this if you have a idea what I'm on about

Install a bukkit server from http://wiki.bukkit.org/Main_Page (I'm using the dev build )

Install the RaspberryJuice plugin from http://dev.bukkit.org/server-mods/raspberryjuice/

Clone this repo and init and update the submodules, then run "npm install", Once its installed "node waterbear.js" will start the server.

Try not to make 40000 blocks of TNT touch lava.

License

Copyright 2011 EduMake Limited

RPi-WaterbearNodeJS code licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

RPi-WaterbearNodeJS Documentation by EduMake Limited is licensed under a Creative Commons Attribution 3.0 Unported License.
Permissions beyond the scope of this license may be available at http://www.apache.org/licenses/LICENSE-2.0.