Repository for the NeoClassical Habitat Server Project
Switch branches/tags
Clone or download
Randy Farmer
Latest commit a3ae070 Sep 24, 2018
Failed to load latest commit information.
astroturf Various region tweaks and additions to help restore Populopolis back … Aug 25, 2018
bridge Downtown_3f - Removed construction sign and added link to Over Ave Cr… Mar 14, 2018
data Complete refactor of Vagrant automation, eliminating its Docker depen… Jan 15, 2017
db Add new regions and stuff to existing database. Sep 24, 2018
exhibit Added {'users':[]} to game server connection for automatic cleanup an… Feb 24, 2018
incomplete Plaza + Woods Beta now default world. Teleport to tehst regions Feb 23, 2017
pushserver Revert "Fix docent compass rose" Aug 24, 2018
regionator Add scripts for parsing MC_region and MC_object databases. Mar 25, 2018
src/main More region restoration Aug 13, 2018
test Real working C64 Heap management support. See wiki for detailed descr… Feb 19, 2018
tools Move db.close() into callback Jun 6, 2017
vagrant Working API routes Mar 12, 2018
.gitattributes Disabling LFS Feb 7, 2017
.gitignore Adding pushserver start script Mar 7, 2018
.travis.yml Bugfixing and enabling travis test integration Mar 7, 2018
Backbone Working API routes Mar 12, 2018
Dockerfile Fixes Book of Records generation in Docker Apr 5, 2018
LICENSE Initial commit Jan 9, 2017 Update Jun 30, 2017 generalize Linux instructions to mention BSDs Jun 13, 2017
Vagrantfile Adds EventStream persistence improvements and Vagrant build scripting… Mar 8, 2018
docker-compose.yml Corrects docker-compose Apr 6, 2018
package-lock.json Initial commit of a functional prototype Mar 5, 2018
package.json Initial commit of a functional prototype Mar 5, 2018
pom.xml Corrects JITPack JAR location Nov 7, 2017
run Using supervisor to ensure Pushserver remains running Mar 7, 2018 The Neoclassical Habitat Server Project

Build Status license Twitter Follow Slack

We're recreating Habitat, the world's first MMO, using modern technology. We'd love it if you joined us!

Play Habitat Now!

We maintain a demo server running the latest Neohabitat code and you can connect to it at any time. There's often a few members of the regular crew hanging out there, so come say hey!

Please note: Neohabitat is currently in alpha, so there will likely be some instability. If you see anything weird, please tell us about it in our Slack.

With all that out of the way, here's how to get started:

  • If you want to use Habitat with a real C64, please switch over to these instructions for making disks and using modern connection hardware.

Step 1 - Download and Install either the Windows or OSX Habitat package (which comes with VICE, the C64 emulator)


  • Download

  • Unzip onto the desktop

  • Open the Neohabitat folder

  • Double-click the Launch Habitat icon.

    • If double clicking on the launcher does not work, try running it as administrator. If you are still encountering issues then scroll down to the "Help!" section of the readme for other alternatives.


  • Download Neohabitat.dmg and double-click on the DMG file.

  • Drag the Neohabitat application to the Applications folder.

  • Launch the Neohabitat application you dragged to Applications.

Please Note: OS X may inform you that this app comes from an unknown developer upon first launch. If this happens, open System Preferences and click Security & Privacy. From the following pane, click Open Anyway to launch the Neohabitat application.

Linux and *BSD

  • Install VICE and nc (netcat) via your package manager
  • Extract the Windows release of to get the .d64 files and fliplist-C64.vfl
  • Run the VICE C64 emulator with these options set:
    x64 -rsuser -rsuserdev 0 -rsdev1 '|nc 1986' -rsuserbaud 1200 -flipname fliplist-C64.vfl Habitat-Boot.d64

Step 2 - Login and play!

In a few moments, you'll be brought to the Neohabitat splash screen:

Neohabitat Splash Screen

Major thanks to Gary Lake-Schaal who developed our custom loader and built the original Habitat client from the original 1985 source!

At this point, Press Enter then enter your username:

Neohabitat Login

Press Enter again, then wait until the Habitat client loads and asks you to insert your imagery disk:

Habitat Imagery Disk Step

At this point, Press Alt-n or ⌘-n, then Press Enter.

If all goes well, you'll materialize in downtown Populopolis:

Avatar In Populopolis

Step 3 - Learn How to Play

Welcome to Neohabitat! There's a whole lot you can do here and thousands of exotic places to visit.

To learn about all the things you can do, read the official Habitat manual from 1988.

You'll also need to hook up a joystick, whether it's physical or virtual. To set one up, open the Settings menu then select Joystick. Habitat expects a joystick in port #1. Your default controls for Habitat are mapped to the numpad and Right-CTRL.

Right-Ctrl + Numpad 8 initiates the "GO" command Right-Ctrl + Numpad 2 initiates the "DO" comamnd Right-Ctrl + Numpad 6 initiates the "GET" command Right-Ctrl + Numpad 4 initiates the "PUT" command

Step 4 (Optional) - Controls

If you don't own a joystick and wish to change the controls to suit your needs then follow these steps:

  • At the top of your VICE emulator, select "Settings"
  • Hover your mouse over "Joystick Settings" and then select "Joystick Settings..." (Windows) or "Joystick" (OS X)
  • A window should now popup saying "Joystick settings"
  • For "Joystick #1", select "Keyset A"
  • Click "Configure Keyset A" (Windows) or "Keyset" (OS X) and map the controls to whatever you like
  • If you are running into issues, head on over to the #troubleshooting channel on our Slack
  • If you have a localized keyboard (e.g. German QWERTZ) you might not be able to find some essential keys, like ":". It might help if you change "Settings - Keyboard Settings - Active Keymap" from Symbolic to Positional, the keyboard will behave like a C64 keyboard.


If you're having trouble getting Neohabitat working, don't worry, we're here to help! Come join our Slack and join our #troubleshooting room.

If running the file as administrator does not work then double click on the file named "x64" to start the VICE emulator. Then drag and drop the "Habitat-Boot.d64" file onto the emulator and proceed as normally.

If you encounter a glitch that's unreported in Habitat please open an issue at

Developer Documentation

If you'd like to contribute to Habitat, there are plenty of great opportunities! Come check our our extensive developer documentation:

Have Fun!

On behalf of the entire Neohabitat Project, we hope that you have a great time, and we'll see you in-world!