hypermud-client

Crates.iohypermud-client
lib.rshypermud-client
version0.0.1
sourcesrc
created_at2019-03-05 23:49:41.73447
updated_at2019-03-06 00:49:26.08885
descriptionHyperMUD: Mystery. Multi-User Dungeon (multiplayer real-time virtual world). Client.
homepagehttps://www.hypermud-game.com/
repositoryhttps://github.com/ctsrc/hypermud
max_upload_size
id118990
size2,126
(throwaway1676847773)

documentation

README

HyperMUD: Mystery

Header image

A Multi-User Dungeon (multiplayer real-time virtual world)

Downloads:

You find yourself in a dungeon.

In your hand you are holding a sword.

You hear strange noises.

You feel hungry.

Better start moving I guess!

Use the wasd or ,aoe keys to walk.

Use spacebar to interact.

Table of Contents

Project status

Development has started. No usable server exists yet. No usable client exists yet.

Features

Eventually the game will feature:

  • RPG (role-playing game) elements
  • Hack-and-slash playstyle
  • PvP (player versus player)
  • Online chat

Running the client

Download the pre-compiled binary for your platform (links provided above).

Execute the binary to start the client.

./hypermud-client

The client will prompt you for which server it should connect to. The hostname and port field will contain the name of the last server you have successfully connected to. If you have never connected to any server before then this field will be pre-filled with the hostname and port of the official server; mystery.hypermud-game.com:2022.

News

  • 2019-03-05: Development started.

Want to run your own server?

Downloads:

Execute the binary to start the server.

./hypermud-server

By default the HyperMUD: Mystery server runs on port 2022. If you want to run it on another port, provide -p and desired port number as argument to the binary.

For example, to run the server on port 9022:

./hypermud-server -p 9022

Want to build the client from source?

If you want to build the client from source you will need a recent version of the Rust toolchain installed.

Get the Rust toolchain from https://rustup.rs/

Building the latest stable release of the client

Note: The latest stable release of the client will always correspond to the latest pre-built binary version. So if all you want is to have the latest stable release of the client, all you need to do is to download the prebuilt binary for your platform.

With that being said, if you still want to build the latest stable release of the client from source, here's what to do:

cargo install hypermud-client

The above command will download the required source file release packages from crates.io and build and install the client.

If you have your path set up correctly you will then be able to run the client that you just built:

hypermud-client

Building the current development version of the client

Note: The development version of the client is intended for development only. It might contain partially implemented features, and it might not be able to connect to the stable version of the server. In general, only developers should run this version, and they should connect to the corresponding development server version only.

So before you read on, you should first build and run the current development version of the server.

In the root of this repository, execute:

cargo build --bin hypermud-client

To run the client that you just built:

cargo run --bin hypermud-client -- -s localhost:3022

Want to build the server from source?

If you want to build the server from source you will need a recent version of the Rust toolchain installed.

Get the Rust toolchain from https://rustup.rs/

Building the latest stable release of the server

Note: The latest stable release of the server will always correspond to the latest pre-built binary version. So if all you want is to have the latest stable release of the server, all you need to do is to download the prebuilt binary for your platform.

With that being said, if you still want to build the latest stable release of the server from source, here's what to do:

cargo install hypermud-server

The above command will download the required source file release packages from crates.io and build and install the server.

If you have your path set up correctly you will then be able to run the server that you just built:

hypermud-server

Building the current development version of the server

Note: The development version of the server is intended for development only. It might contain partially implemented features, and stable clients might not be able to connect to the development version of the server. In general, only developers should run this version, and they should connect to it with the corresponding development version client only.

Clone this repository and then in the root of the repository, execute:

cargo build --bin hypermud-server

To run the server that you just built:

cargo run --bin hypermud-server -- -p 3022

With the current development version of the server running you should then build and run the current development version of the client.

Copyright notice and license

Copyright (c) Erik Nordstrøm 2019

The HyperMUD: Mystery client and server source code and assets are released under the terms of the ISC license. See file LICENSE for details.

Commit count: 52

cargo fmt