frandallfarmer / neohabitat

Repository for the NeoClassical Habitat Server Project
http://neohabitat.org
MIT License
229 stars 42 forks source link

NeoHabitat.org: The Neoclassical Habitat Server Project

license Twitter Follow Developer Discord

We're recreating Lucasfilm's 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 still in development, so there will likely be some instability. If you see anything weird, please tell us about it in our Discord.

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

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

Windows

OS X

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

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.

Before you go anywhere, we highly recommend opening up our Docent support software. It's a browser based guide that'll help you navigate NeoHabitat, learn the controls and teach you about the history of the world. It's interactive and will update as you move around without you having to lift a finger.

If you are using the web based client mentioned earlier, the Docent support software is already active!

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

Your default controls for NeoHabitat are mapped to the numpad and Right-CTRL.

There is also a NeoHabitat Controls cheat sheet which tells you all of the keys you need to know.

For the most authentic experience, 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.

We have tested with various different gamepads that all work fine with Habitat. We have personally tested it with the Xbox 360 Wireless Controller for PC.

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:

Help!

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

If you encounter a glitch whilst playing NeoHabitat, please check to see if it's been filed as an issue. If it hasn't, we'd appreciate it if you let us know what happened so we can investigate.

Developer Documentation

If you'd like to contribute to NeoHabitat, 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!