/Blightmud

A terminal mud client written in Rust

Primary LanguageRustGNU General Public License v3.0GPL-3.0

Rust Security audit Coverage Status

Blightmud : A mud client for the terminal

Blightmud has been a passion project of mine for some time. A big user of the old but great tinyfugue I always wanted to create my own similar mud client. Even though I don't play much muds these days.

screenshot

The name?

The client is written in rust. Some navigating throught the thesaurus brought me to the word blight and here we are.

Features

  • Completely terminal based (mac and linux)
  • Telnet:
    • TLS connections
    • GMCP support
    • MSDP support
    • MCCP2 support (compress2)
  • Lua scripting:
    • Output and sending
    • Aliases
    • Triggers
    • Timers
    • Customizing status bar
    • Persistent storage
    • Session storage
    • Keybindings
    • Text-To-Speech
    • Mouse scrolling (experimental)
    • Plugins
  • Low resource and fast
  • In client help and manuals
  • Native Text-To-Speech functionality (optional compile)
  • Tab completion

Compiling

  • Install rust
  • Run cargo build to compile
  • Run cargo run to run

Compile with text-to-speech

  • Run cargo build|run|install --all-features

Installation

  • Ubuntu/Debian : Deb packages can be found on the releases page
  • Archlinux/Manjaro : Packages are available on AUR
  • Mac/Homebrew : We have a homebrew tap brew tap Blightmud/blightmud
  • Other/Alternative : Download source and run cargo install --path . from the project root
  • Windows : No native windows support but Blightmud runs fine under WSL

Support, questions and help

Join our discord

Contributing

All contributions are welcome. Check out contributing guidelines.

Side notes

This is my first rust project that has actually grown a bit. Some things might look silly but thanks to rust they should still be safe. Anywho. If you find some antipattern where you have a better idea I'm more then happy to se the PR and learn some more rustier ways.