TinTin++ Mud Client

Frequently Asked Questions


General FAQ

  1. Actions do not always trigger, sometimes an '8' is randomly inserted, or lines are cut off in the middle.

    This is caused by packet fragmentation. You can solve this by setting #config {packet patch} to a value somewhere between 0.5 and 5.0 seconds. If your mud doesn't support GA (Go Ahead) or EOR (End of Record) to tag prompts, prompts will be displayed after the given delay. If your mud allows adding a line break after the prompt this is an option as well. The '8' is displayed as of TinTin++ 1.99.0 on terminals that poorly handle packets breaking on a color codes, in previous versions this would have resulted in the cursor getting stuck above the split line.

  2. I want to make an alias that sets actions using %0

    Use %%0 for %0, %%1 for %1, for example: #alias {test} {#action {%%1 has arrived} {murder %%1}}

  3. How to make color triggers?

    Start an action with a tilde ~ and it will not strip colors. You can use #config {convert meta} {on} to have the mud client display colors as escape sequences, so you know what to fill in.

  4. Numpad doesn't work

    The problem is caused by either the terminal you are using, your operating system, or a combination of both. There are mutual problems on the Cygwin and Redhat platform, but for some reason nobody seems motivated/capable of solving the problem on those platforms.
    Try a different terminal or play with your terminal configuration. For Cygwin you can use PuTTYcyg. See also the keypad manual entry.

  5. I want to change the command character from # to /

    This can be done with #config {tintin char} {/} or having a / as the first character in your script file.

  6. How to enable chinese characters?

    You can do this by using ./configure --enable-big5 before compiling the mud client source code.

  7. I use OS X and ran tt++ a few times, and now every time I open a terminal window it runs tt++ automatically.

    You used 'use settings as default' while running the tt++ binary. There are a few ways out of this, but the easiest is locating your terminal preference (home : library : com.apple.Terminal.plist) and deleting it. You'll have to redo anything custom you set up (screen size, colors, etc.), but it will get the terminal back to the default of loading into your home directory.

WinTin++ FAQ

  1. I am getting a DLL error.

    This is generally because you have Cygwin installed. Try to update Cygwin, if that doesn't help you're better off running the mud client in Cygwin instead by copying tt++.exe to the /bin directory in Cygwin.

  2. The #system and #suspend commands do not work.

    That's because there is no shell to interact with, if you want full functionality you need to install Cygwin.

  3. TinTin++ script files look weird in notepad.

    This is because notepad only follows the windows text format. Try using wordpad instead.

  4. How to automatically read in a file when starting this beast?

    Good question. Right click the WinTin++ shortcut, and choose properties. You'll see an input field containing the following:

    "C:\Program Files\WinTin++\cygterm.exe" -cygterm bin/tt++ -t WinTin++

    If your filename is named default.txt you need to change the link to the following:

    "C:\Program Files\WinTin++\cygterm.exe" -cygterm bin/tt++ -t WinTin++ default.txt

  5. Where does TinTin++ save/read the files?

    TinTin++ does so in the install directory. The installer makes a shortcut in: start -> program files -> WinTin++ -> Directory, which will take you there.

  6. How does copy/paste work?

    Text is automatically copied when text is selected. You can paste with the right mouse button, or pressing shift-insert. Do not press ctrl-c, since that will clear the input line.

  7. How do I change the default settings of the terminal?

    Go to the WinTin++ directory at C:\Program Files\WinTin++\ and double click on cygterm.exe which will open the configuration menu. After making your changes go back to the Session tab. Find the 'Saved Sessions' list, select 'Default Settings', and click the Save button.

    You can also access the configuration menu by right clicking on the WinTin++ title bar and selecting 'New Session'

    Another option is creating and configuring a new session named tt++. In order to use it you would change the shortcut to the following:

    "C:\Program Files\WinTin++\cygterm.exe" -load tt++ -cygterm bin/tt++ -t WinTin++

  8. How to get fonts with line drawing characters to work?

    Follow the instructions above for editing the default settings. In the +Window - Translation dialog, select 'Use font encoding' in the character set drop down list.

  9. How does WinTin++ work?

    WinTin++ exists of 3 components. The first component is the Cygwin DLL which allows precompiled C code written for linux systems to work on Windows. The second component is the compiled TinTin++ source code. The third component is a modified version of PuTTY known as mintty that functions as a Cygwin compatible VT100 terminal. The source code of mintty is available at: http://code.google.com/p/mintty

  10. Where's my beloved input bar?

    Type: #split, you may also want to check out #help prompt.

  11. Why doesn't #write work on Windows Vista?

    This is because Vista restricts writing to the Program Files directory. Go to the C:\Program Files\WinTin++ directory and right click terminal.exe. Select Properties and enable 'Run this program as an administrator' in the Compatibility tab. You might have to do the same thing for the bin/tt++.exe file. An alternative to this would be installing WinTin++ in your user directory instead.

Text To Speech

  1. Can TinTin++ be used with a speech synthesizer?

    As a console mud client TinTin++ should work with text to speech programs that are capable of reading a console terminal.

    On Mac OS X you can use VoiceOver, which works out of the box with the TinTin++ precompiled Mac OS X binary. Unfortunately there are some issues with VoiceOver and Terminal (the default OS X console) on Mac OS X 10.5, but these problems have been fixed for Snow Leopard (Mac OS X 10.6). One thing you might want to do is setting: #gag {^$} to have TinTin++ remove empty lines so VoiceOver does not announce them.

    On Windows you can install WinTin++, which however does not use the default Windows console which speech synthesizers are likely to work with. To run WinTin++ in the Windows console go to start, run, and launch cmd.exe. Type: cd c:\program files\wintin++ Next type: copy "bin\tt++.exe" After this you can launch the mud client typing: tt++. To have the shortcut launch tt++.exe and have it also read the main.tin file, right click the shortcut, select properties, and change the target field to: "C:\Program Files\WinTin++\tt++.exe" main.tin If your text to speech program has problems with color codes use: #sub {~\e[%W{[a-zA-Z]}} {} to have TinTin++ strip most ANSI escape codes.