FAQ

From Mudlet
Jump to navigation Jump to search

Where can I get it?

Mudlet can be downloaded at: https://www.mudlet.org/download/
You can download the source code of the latest git-version here: https://github.com/Mudlet/Mudlet

Is there a Manual?

Yes. The manual and supporting documentation can be found here: Manual:Contents

I've read the manual, but I don't understand something. What now?

Well, we have a few different options here.
For real-time interactive help, we have a few Discord channels. You can get there using THIS LINK.
There are also the Mudlet forums where you can search to see if someone else has posted a similar question, and if not post it yourself.
You can also try searching the wiki to see if the subjest comes up in any other pages. This can sometimes contextualize a concept, and provide a sort of "Aha!" moment.
Last, but not least, for years we have been using an IRC channel on freenode, #mudlet. You can get there using THIS LINK. Please be patient, as most users have moved to Discord, responses may take some time.

I've got my map pulled up, and it looks all jumbled

Example: Mapperissue.png
In the above example, click on the long blue arrow. There will be spinners for Rooms and Exits. If you adjust what you have towards the general vicinity of the values in the following image, it should get better.
Mapcontrols.PNG

How do I go about making my own GUI?

For those who don't know, GUI means Graphical User Interface, like pictures and gauges and all sorts of fancy things.
Well, you're in luck. You can do some pretty cool stuff with Mudlet. In fact, at the moment there are three primary options for creating your own GUI. Which one you choose will ultimately depend on what you are trying to accomplish.
1. I want to create a full heads up display, with stuff on all the edges and pictures and the like.
Well, you may want to look into Vyzor. It is created specifically with this in mind, and will give you easy access to all four edges of the screen. When using Vyzor, it is recommended you stick strictly with Vyzor, but there is some pretty good documentation linked from the Vyzor page itself, including a sample walkthrough.
2. I want a nice toolkit for making widgets, or even full blown GUIs by bolting widgets together.
You may be interested in Geyser. You can create complex, intricate, full featured GUIs using this tool, or also very simply create a small console to just echo some text to. The manual for this GUI framework can be found here: Manual:Geyser
3. I prefer to cook up my own solutions from scratch. I want the barebones access to the UI elements.
Welcome, intrepid adventurer. It is indeed true that both Geyser and Vyzor are frameworks which are built upon the UI functionality provided by Mudlet itself. If you wish to forge your own trail and so on and so forth, then you will want to spend a lot of time meditating upon this tome: Manual:UI_Functions

Distorted font on Windows?

If you're on a high-resolution display using Windows, you might be seeing strange text like this:

Highdpi-distortion.PNG

The issue is with how Windows is upscaling the fonts. To fix this, right-click on mudlet.exe and change it to the following:

Working-settings-hidpi.PNG

macOS and Linux aren't affected by the problem.

Where can I get information on regular expressions / regex / pcre?

Regular expressions can seem a bit like black magic until you get to know them a bit better. Once you've created a few they come much more easily. Here are some places you can go for more information.
PCRE regular expression tutorial & reference: http://www.regular-expressions.info/reference.html
PCRE manual: http://www.pcre.org/pcre.txt

How to see terminal output for Mudlet on macOS?

After opening the Terminal application, and verifying that the Mudlet application is located inside the main Applications folder, use this command:
open /Applications/Mudlet.app/Contents/MacOS/Mudlet
If you have renamed your Mudlet application, use the matching name, and if that name includes a space, like this "Mudlet 3.15", then put a "\" before any spaces in the name when you open it. Here is an example using that file name:
open /Applications/Mudlet\ 3.15.app/Contents/MacOS/Mudlet

I use character ; (semicolon) in my input line, but strange things happen, why?

Mudlet's default command separator is ; which results in the semicolon not being sent, but instead splitting the command line content in two (or more) separate commands being sent to the game.
You can (and should, if it's an characer used in the game) change it in the settings.

I use character : (colon) at the start of my input, but strange things happen, why?

The : is used in an alias to send the following text simultaneusly from all connected profiles.
If you don't need such functionality, you could either disable or change the "send-text-to-all-games" alias, or altogether uninstall the package of the same name. To do that, go to the "Package Manager", select "send-text-to-all-games" and hit "uninstall".