<h1 align="center">
  <br>
  <a href="https://github.com/Mudlet/Mudlet"><img src="https://github.com/Mudlet/artwork/blob/master/mudlet_main_256px.png?raw=true" alt="Mudlet"></a>
  <br>
  Mudlet
  <br>
</h1>

<h4 align="center">Play immersive, multiplayer, pure-text RPGs on Mudlet.</h4>

<p align="center">
  <a href="https://discord.gg/kuYvMQ9">
    <img src="https://discordapp.com/api/guilds/283581582550237184/embed.png?style=shield">
  </a>
  <a href="https://github.com/mudlet/mudlet/issues">
    <img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat">
  </a>
  <a href="https://github.com/Mudlet/Mudlet/stargazers">
    <img src="https://img.shields.io/github/stars/Mudlet/Mudlet.svg"/>
  </a>
  <a href="https://www.codefactor.io/repository/github/mudlet/mudlet">
    <img src="https://www.codefactor.io/repository/github/mudlet/mudlet/badge" alt="CodeFactor" />
  </a>
  <a href="https://console.algora.io/org/Mudlet/bounties?status=open">
    <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fconsole.algora.io%2Fapi%2Fshields%2FMudlet%2Fbounties%3Fstatus%3Dopen"/>
  </a>
</p>

<p align="center">
  <a href="#about">About</a> •
  <a href="#key-features">Key Features</a> •
  <a href="#download">Download</a> •
  <a href="#how-to-use">How To Use</a> •
  <a href="#roadmap">Roadmap</a> •
  <a href="#credits">Credits</a> •
  <a href="#license">License</a>
</p>

<p align="center">
  <img alt="Interfaces players have created with Mudlet" height="500" src="https://github.com/Mudlet/artwork/raw/master/sample-mudlet-uis.gif">
</p>

## About

Mudlet is a quality [MUD](https://en.wikipedia.org/wiki/Multi-user_dungeon) client, designed to take mudding to a new level.

It’s a modern breed of a client on the gaming scene – with an intuitive user interface, a specially designed scripting framework, and a very fast text display. That, along with cross-platform capability and an open-source development model result in a very likable game client.

## Key Features

* Simple to use
* Very, very fast
* Active development
* Big, thriving community
* Powerful trigger engine
* Rich Lua-based coding functionality (API)
* Excellent script editor
* 2D and 3D mapper with autowalk
* Powerful and simple to use GMCP
* Discord integration
* Completely themable
* Open-source and Free
* Cross platform: runs on Windows, macOS and Linux
* Full compatibility: run same scripts on any of the above

<details>
  <summary>Explain?</summary>

### Easy to use client

We’re big on usability, and as such, creating an easy to use client and interface is one of the defining goals of the project. This applies to both the power users and usual gamers – everyone will feel at home with Mudlet, without having to waste too much time figuring out how to do something.

### Designed for speed

Mudlet is designed and built to be very fast and efficient right from the start. Its scripting engine is designed to scale to large systems without bogging down – and the text display is designed to handle thousands of lines in under a second. All in all, we are very serious about Mudlet being quick – and take all measures to make it so.

### Powerful Scripting

Mudlet features a scripting framework using [Lua](https://www.lua.org/) – a small, fast and efficient scripting language. This allows Mudlet to leverage the existing community and large ecosystem of existing packages for Lua without the many drawbacks of creating a Mudlet specific scripting language. Best of all, the Lua API is seamlessly integrated in Mudlet and shared by all aliases, triggers, scripts, keybindings, buttons and other Mudlet components.

### Cross-Platform love

We believe in making Mudlet available to people on all major platforms, and we work on keeping cross-platform compatibility right from start. Mudlet is available on Linux (both 32bit and 64bit), Windows, and macOS; you may be able to run it on additional platforms as well.
</details>

## Download

Download for free from [mudlet.org](https://www.mudlet.org/download/).

## How To Use

1. Download and double-click on Mudlet to run
1. Pick an existing game and hit `Connect`
1. ... or play one of your choosing:
    1. Click `New`
    1. Enter `Server address` and `Port` of your game (found on the game's website, e.g. `mygame.com` and `2003`)
    1. Pick a `Profile name`
    1. Hit `Connect`

## Compiling

If you'd like to compile Mudlet yourself instead of [downloading](https://www.mudlet.org/download/), you can find instructions to do so [here](https://wiki.mudlet.org/w/Compiling_Mudlet).

## Vision

Mudlet's [vision](https://www.mudlet.org/about/vision/) is to build the best text gaming experience possible to nurture & grow this niche scene.

## Roadmap

See the [project's roadmap](https://www.mudlet.org/2019/09/mudlet-5-roadmap-focus-on-first-time-player-experience/) to get an idea of where it's headed

## Contribute

Join in, contributions are welcome! Find out how you can start [Contributing](docs/CONTRIBUTING.md).

## Credits

Author: [Mudlet Makers](https://github.com/Mudlet/Mudlet/graphs/contributors). 

This software wouldnt've been possible without these open source packages:

- [Qt](https://www.qt.io/)
- [Lua](https://www.lua.org/)
- [PCRE](https://www.pcre.org/)
- [edbee](http://www.edbee.net/)
- [DBLSQD](https://www.dblsqd.com/)
- [argparse](https://github.com/luarocks/argparse)
- [Boost Graph Library](https://www.boost.org/doc/libs/1_83_0/libs/graph/doc/)
- [Busted](https://lunarmodules.github.io/busted/)
- [Ccache](https://ccache.dev/)
- [Communi](https://communi.github.io/)
- [Hunspell](https://hunspell.github.io/)
- [lua-http](https://daurnimator.github.io/lua-http/)
- [lua-yajl](https://github.com/brimworks/lua-yajl)
- [lua-zip](https://github.com/brimworks/lua-zip)
- [LuaFileSystem](http://keplerproject.github.io/luafilesystem/)
- [Luarocks](https://luarocks.org/)
- [LuaSQL](http://keplerproject.github.io/luasql/)
- [luautf8](https://github.com/starwing/luautf8)
- [pugixml](https://pugixml.org/)
- [SQLite](https://sqlite.org/index.html)
- [yajl](http://lloyd.github.io/yajl/)

Credit to [Markdownify](https://github.com/amitmerchant1990/electron-markdownify) for the README inspiration.

Windows code signing provided by [SignPath.io](https://about.signpath.io), certificate by [SignPath Foundation](https://signpath.org).

## License

GPL2+

---

> [website](https://www.mudlet.org/) &nbsp;&middot;&nbsp;
> [forums](https://forums.mudlet.org/) &nbsp;&middot;&nbsp;
> [manual](https://wiki.mudlet.org/w/Manual:Contents)

