Skip to content

Mudlet: General Guide

Mudlet logo

Mudlet is a MUD (Multi-User Dungeon) client that allows you to connect to text-based online multiplayer games (the precursors to modern MMOs).

Mudlet enables MUD server maintainers to add visual elements and custom features, while allowing players to script, automate, and customize their gameplay experience.

⚠️ W.I.P Article - Not yet in RetroDECK ⚠️


Resource Link
Mudlet - Github Link
Mudlet - Packages Link
Mudlet - Webpage Link
Mudlet - Wiki Link
The Telnet BBS Guide Link

Where to put the games?

You don’t need to add them manually. Mudlet profiles are automatically stored in the retrodeck/roms/muds/ folder.


Does Mudlet require BIOS or Firmware?

No, Mudlet does not require BIOS or firmware, as the games run on remote servers that store all game data.


What file formats are supported?

File Format Description
.mud RetroDECK mud parser file

Directory structure

Type Directory Comment
ROMs retrodeck/roms/muds/<server_profiles> All local server-specific data is stored in its own server profile folder.

Controls: Keyboard ⌨️ & Mouse 🖱️

Cannot be played with a controller easily and is best used with a physical keyboard and mouse.

Each MUD server can have different hotkeys and extra controls.


How-to: Display MUD Games in RetroDECK

We will use Midnight Sun II as an example.

  1. Launch Mudlet: Open Mudlet via RetroDECK ConfiguratorOpen ComponentMudlet.
  2. Connect to the MUD: Connect to each MUD server you play on, exit after each login, and quit Mudlet when finished.
  3. Restart RetroDECK: During a restart RetroDECK will automatically populate and convert all your logged in profiles into .mud (for example, Midnight Sun II.mud) during boot and store them in: retrodeck/roms/muds/ as seperate game entries.
  4. Launch the game: All MUD games will now appear in ES-DE under the MUDs system and auto connect to the profile when played.

How-to: Migrate profiles from another Mudlet instance to RetroDECK?

  1. Profiles in ROMs: Put your game profiles in the roms folder retrodeck/roms/muds/.
  2. Restart RetroDECK: During a restart RetroDECK will automatically populate and convert all your logged in profiles into .mud during boot.
  3. Launch the game: All your old MUD games will now appear in ES-DE under the MUDs system and auto connect to the profile when played.