HabitRPG-Local - Unofficial

3 posts / 0 new
Last post
HabitRPG-Local - Unofficial


Edit: hmm...there was no link.  Since I last edited this on 8/26,  there has been no link for about a month.  Don't know how that happened.


This is a windows installer for the Unofficial HabitRPG-Local server and client.  This is outdated, and the last released predates the rewrite.  To get the latest code, go to the github repository https://github.com/lefnire/habitrpg and follow the directions in the readme.

This will install a server and client identical to habitrpg.com, as it was on August the 21st 2013, with some distinct differences.  

NOTICE:  This is a local version that DOES NOT sync with habitrpg.com.  You will NOT be able to log in with Facebook, or your habitrpg.com username.  If you have a problem with the installation or the local server install, post your message in this forum thread or here.  DO NOT post your questions or bugs anywhere else. If you don't use windows, please let me know which OS you would like an installer for.


What you can do with HabitRPG-Local:

1. Create as many user names as you would like, and do whatever  you want with them, at blazing fast speeds.  Rack up points, get armor, kill your characters.  Get drops.  Experiment.  Go nuts.  Do whatever.  It's not cheating because it's your server.

2.  Access your HabitRPG-Local server/client while offline.

3.  Access your server/client from other web browsers within your local network(and even over web).  Details below.


The installer installs links to launch the server, launch the client, view the readme,  uninstall, and go to this forum thread.

There are detailed instructions for installing at the beginning of the installation process, and a README with more information at the end.   I posted the README below.

In this latest installer, I put in some safeguards to protect someone from accidentally overwriting their data, but the data is still solely the responsibility of the owner.


tl;dr: Simple windows installer.  Just run, click through it.  Don't change anything.  If it doesn't work, you're going to have to do a little reading, or just post a comment here.



README for HabitRPG-Local 0.2.1

Known issues 08-26-2013:
I'm using the 32 bit version of node.js and mongodb for the sake of backward compatibility and ease of installation.  However, journaling is disabled by default, and data can become corrupted in some cases, such as sudden power failure.  If you have a 64-bit system, it would be a good idea to delete the contents of the mongodb directory(Not the habitdb directory!), and then replace it with a 64-bit version.   Also, mongodb has a limit to the size of the database, which I believe is 2gb, including journaling.  You can turn on journaling for mongodb, and I will do that in the next relaese, but I'm not sure that it works.  With mongodb 64-bit, it will create three 1 gb files when it first starts.  If you are running the server from the link, the server window will fail.  Wait for mongodb to finish and then, close the server window and reload the server.  If you are using 64-bit you will probably want to replace node with 64-bit as well.  I'll post more info on this later.

If your data becomes corrupted, you can follow the procedures outline here http://docs.mongodb.org/manual/tutorial/recover-data-following-unexpecte....

To summarize that link, you can run these three commands, one after the other, from the hrpgl directory in the command line.

del habitdb\mongod.lock
cd mongodb\bin
mongod.exe --dbpath ..\..\habitdb --repair

I will include scripts and more information in the next release.



HabitRPG-Local 0.2.1


This is an unofficial package of habitrpg's server/client. 

NOTICE:  This contains a local server, that DOES NOT sync with the remote server at habitrpg.com.  You cannot log-in with facebook or your habitrpg.com username.  You will have to create new users, and all of your data will be stored in your local database in the "c:\hrpgl\habitdb" folder. 

(If you chose to install HabitRPG-Local to any folder besides "c:\hrpgl", then substitue your installation folder for "c:\hrpgl" in this document.)


-Microsoft Windows  (Only Windows XP and Windows 7 have been tested.)
-Aproximately 600MB of hard drive space.

To Install:

Run the HabitRPGSetup021.exe file.  There are instructions in the installation.  They will say, "READ THIS BEFORE INSTALLING!!!" 

To Use the Server and Client:


(Note: When you finish installation, there is a checkbox option to run the server.  If the two cmd windows are open, you do not need to run them again.  If they are functioning properly, you can skip to "Client:")
Run "HabitRPG-Local Server" from the "HabitRPG-Local" folder in your start menu, or from the desktop.  Two black command prompt windows called "mongodb.cmd" and "server.cmd" will open.  On first run, some windows may pop up saying that some programs are requesting access to the network.  Accept the requests.  Server.cmd may take some time to load, and may stay black while it's loading. 

If mongodb.cmd and server.cmd are successful, the server.cmd window should say that socket.io started, followed by 4 lines of text about expressions.  You may minimize these windows, if you like, but they must stay open for the server and client to work. 


Once the server is running you can then open the client from the start menu(or desktop) by running "HabitRPG-Local Client",or by entering "localhost:3000" in your web browser's address bar.

NOTICE:  The mongodb.cmd and server.cmd windows must be open for the server and client to work.  I don't know how to hide them or run them in background, so you're stuck with them, for now.  When you are done with the server/client, you may close them, but you will need to open them again with the "HabitRPG-local Server" link before you can access the HabitRPG-Local server/client again.

Start with Windows:

If you would like the HabitRPG-Local Server to start with windows, you can copy the HabitRPG-Local Server link to the "startup" folder in the start menu.

To uninstall:

NOTICE:  The Uninstaller for 0.2.1 is set to leave the c:\hrpgl\habitdb\ folder, so that your data will be left intact.  You will have to delete that folder by hand to removed from your computer.

To uninstall simply run the uninstaller from HabitRPG-Local start menu folder.


The installer gives errors:
The errors are probably caused by your install path being too long, or not having the right permissions to install.  Try installing to the "c:\hrpgl" folder.

The "HabitRPG-Local" folder isn't in the start menu:
If you renamed the startup folder, look for the folder with the name you gave it.  If you didn't rename the start folder you can go to "switch users" through the start menu.  When you reach the login screen, log back in.  Alternatively you can log out, and log back in, or restart the computer.  The folder should show up in your start menu.

The "HabitRPG-Local Server" and "HabitRPG-Local Client" are not showing up on my desktop:
There was an option you were supposed to check in the installer to insert these icons on the desktop.  If you did not check that option, you can simply copy the icons from the start menu, or right click them and click "send to > desktop".

Localhost:3000 doesn't show anything, or shows an error:
Make sure that the server.cmd and mongodb.cmd windows are open.  If they are open, and you are still receiving an error, or a black page at "localhost:3000", then close the cmd windows and then reload them with "HabitRPG Local Server".  If closing the two cmd windows, and restarting them doesn't solve your problem, and you installed to a folder that was not "C:\hrpgl" then it is possible that the server is having a problem with the path you chose to install to.  You can try to  uninstall and then reinstall to "c:\hrpgl".  If you don't have administrator privileges, "c:\user\'your user name'\hrpgl" might work, where 'your user name" is the actual user name you log in with.

Troubleshooting does not solve the problem:
See "Bug Reporting etc." below.

Accessing HabitRPG-Local over LAN
You can access your HabitRPG-Local server over your local network by entering the server computers ip followed by the port number(, for example).  To find your the server computers ip, run "ipconfig" in a command prompt window.  The ports will need to be open, if you have a firewall.

Technical Details

HabitRPG-Local is just a snapshot of the HabitRPG develop branch on Github, with a windows node.js binary, a copy of Mongodb, and some batch scripts(cmd).

The batch scripts run mongodb and then the server.  It's not pretty, but it seems to work.

The installer extracts everything to a folder, and then adds icons to the HabitRPG-local start menu folder and desktop.

Other Operating Systems:
Other operating systems would probably work by replacing mongodb and the node.js binary with the version for your operating system, but the batch files wouldn't work. You would need to run the mongod executable as well as "(node binary) server.js" by hand.  It would make more sense to follow the directions at:

The license file, called "licenses.txt" with all the relevant licensing information, is in the "C:\hrpgl\" folder.


Version 0.2.1 - Aug. 21, 2013
Fixed missing node.js.
Tried to create prompts for overwriting directories in the installer.  Also, tried to change uninstaller to leave habitdb folder.

Version 0.2.0 - Aug. 18, 2013
Added InnoSetup installer.
habitrpg:develop snapshot Aug. 17, 2013
mongodb version 2.4.5 i386
node.js version 0.8.25 32-bit

Version 0.1.0 - Aug. 17, 2013
Initial release.
WinRAR Self Extracting Executable.
habitrpg:develop snapshot Aug. 17, 2013
mongodb version 2.4.5 i386
node.js version 0.8.25 32-bit


Bug Reporting Etc.

If you have problems or questions please post them to the forum thread at http://community.habitrpg.com/content/habitrpg-local-unofficial.  There is a link to the forum thread in the HabitRPG-Local Start Menu folder called "HabitRPG-Local on the Web"



More details on accessing your local server over your network.

The details in the README on accessing over the network are sparse, so here's some more details

Accessing HabitRPG-Local client from other devices on your network:
To access your HabitRPG-Local client on other web browsers in your network, you must enter the ip address of the computer hosting the server followed by the port.  It should look something like this "".  

In order to get the ip address, of the computer hosting the server open a command prompt, by typing "command" or "cmd" into the "run" box or "search" box and then typing "ipconfig".  Following the first "Ethernet Adapter" listing, you should see a listing that says "ipv4 Address" and on the same line a number that starts with "192.168".  The entire number is the address.  Copy that address.  Add ":3000" to the end of it, and that is how you can access your local server on other devices in your local network.

Notice:  Your ip address might change, every time you restart the server computer.  If you want it to stay the same you will need to give it a static ip in your network.  This can usually be done with dhcp ip address reservation, but I'm not going to go into details on how to that, at this time.

I have been successful in accessing my local server through a domain address from outside my local network, but the process to setup can be complicated.  I have used no-ip.org and localtunnel.me with some success.

You can test that server at http://habit.servebeer.com/ .  Be warned, this server is hosted on my workstation at home, and is likely to go down at any time.  I have also been able to access my server from two of the mobile apps.


And remember, it's not cheating, because it's YOUR server.