This version of these scripts requires TinTin++ 2.02.20 or later.
This is planned to change to 2.02.61 Soon™, meaning most Linux users will have to compile tt++ themselves.

tt_dw

TinTin++ scripts for the Discworld MUD.

All public domain (including the bits I lifted from tintin.mudhalla.net) Feel free to use/modify whatever you want from these, or even bother Oki¹ about it ingame or at oki@tubul.net This documentation is probably incomplete, and might be outdated in places, good luck!

¹ Check finger info for alts: I sometimes go months only playing those.

Installation

PC: INSTALL.md
Android: INSTALL_ANDROID.md
Development version: INSTALL_DEV.md

After your first login (with every character), in TinTin++ run the alias /setup to apply recommended Discworld options, Stuff may Break if your options are not set as expected by tt_dw!

/help will show a bunch of useful commands;

Features

General

• ZMP support (mini-map, vitals, surrounding rooms)
• Mission timers
• Use Quow`s database to lookup items and NPCs
• Blorp management
• Status bar
• Stat items
• Speedwalk to rooms
• Sound triggers
• Sound effects
• Skill calculator
• Mobile view
• Bookmark system
• Vault tracker
• Much more!

Guild-specific

• Arcane shielding
• Broomstick charge colouring
• Spell sizes
• Quota timer
• Spellcheck info, method TM spell suggestions

Setup

By default, you get a layout roughly like this:

+----------------------------------+
|mini|         map            |text|
|map |                        |map |
+----------------------------------+
|                         |chat log|
| Discworld!              |        |
|                         |        |
|                         |        |
|                         |        |
+=[status]=========================+
| > type here                      |
+----------------------------------+

Drag dividers around to change the various panel sizes (except the mini map). Click on screen edges to hide/show panels.

Directory layout:

• scripts : TinTin++ script files
• settings : personalized settings
• logs : logs will be written here
• map : map from https://code.tubul.net/tt_dw/map
• quow : _quowmap_database.db from Quow`s plugin

Settings:

To save per-alt setup:
copy settings/example.tin to settings/global/<altname>.tin
Settings files (if they exist) are applied in this order:
(Note: these live outside the scripts directory!)

1. settings/global/tt_dw.db (SQlite database)
2. settings/global/_shared.tin
3. settings/local/_shared.tin
4. settings/global/<altname>.tin
5. settings/local/<altname>.tin

The idea is that if you play from multiple locations, you can set up some sort of cloud sync for settings/global/, and use settings/global/ for settings on a specific client. You can use /options to toggle (some) options, these are automatically saved. If you have setup syncing across devices, you can put /override in a local file to set device-specific options. (see settings/example.tin)

See alias.tin for some useful TinTin++ aliases (more are hidden throughout the code). /alias also gives a list of short aliases.

Your theft quota is shown only if you read/check it using read quota brief/check quota brief

Commands:

/discworld  Connect to Discworld

After logging in:

/help             Show tt_dw commands
/tips             Show tips about in-game mechanics
/options          Show tt_dw options
/toggle <option>  Toggle a single option

/hunt <target>    Highlight <target> red in written map list and rooms
/unhunt <target>  Stop highlighting <target>

/bookmark help    Show bookmark commands
/blorp help       Show blorp commands

Bookmarks and Blorps

You can manage bookmarked rooms with the /bookmark command (shortcut: /b), these are shared between all your characters. You could for example add your player house or clubhouses for convenient speedwalking.

Similarly, you can manage rooms where you can quickly travel to with /blorp. (Apologies to priests, witches, etc.) If you set /option blorps show, search results will also show the nearest "blorp" location and distance for rooms (when it's closer-by than walking). With /option blorps sort (the default), the list will also take these into account when sorting by distance. With /option blorp_cost 10, blorps will only be suggested if they are at least 10 steps closer than just walking.

Speedwalks, Item/NPC/Room lookup:

This uses Quow's database.

/room <part of room name>
/r <part of room name>
  to find room by short name
/npc <part of NPC name>
/n <part of NPC name>
  to look up a NPC
/item <part of item name>
/i <part of item name>
  to look up an item
/shop <part of item name>
  to only list places where you can buy the item
/loot <part of item name>
  to only list places where you can loot/gather/pickup the item
/item <number>
  to show item details with number from last result list

Use * or ? for wildcard searches. Use ^ and $ for exact start/end match. Make your search specific enough to match one item and it will tell you where to find it. If there are multiple item results, press the number in front to select one. Otherwise, the numbers in front of room/item/npc locations make you walk there. /p Only highlights the path to a room instead of walking there. If a room has no number, that usually means there is no way to walk there. (At least not a mapped way)

/resume (or /repeat) will resume/repeat walking to your last destination. /return will walk you back to the starting point of your last speedwalk. /last shows your last speedwalk.

Examples:

/item cake
  To find "cake"s, "pancake"s, "cake tin"s, ...
  Now you can press a number to show a specific cake
/item * cake
  To not find "pancake"s
/item cake$
  To only find items ending in cake, so not e.g. "cake tin"
/item straw*cake
  To find strawberry cakes

/item strawberry cheese cake
  or
/item straw* cake
  Only one match: will show you where to find a "strawberry cheese cake"
  Now you can press the number in front of one of those locations to walk there.

/npc william
  Shows a list of williams
  You can press the number in front of one of those locations to walk there.

/room drum
  Shows a list of rooms around the Mended Drum

Movement:

Movement/commands via keypad or VI-keys

Click (touch it on mobile) on a room in the map to walk there.

Logging

Every line is logged to ~/.tintin/log/discworld/<current date>

Status bar

Most stat items/arcane shielding is shown in the status bar Some keeping track of missions

• Hint: use /alias to get a list of two and three letter aliases (which are (usually) short for the complete alias)

Map:

• Left-click (touch on mobile) on a room to walk there
• Drag the map to move it
• Hold down the right mouse button and move the cursor over a room to show the name+notes in the map title bar
• Right-click on a room to output its name+notes
• Middle-click on a room to show the full room info (mostly for mapping/debugging)

Mapping:

This mostly works, but there are lots of caveats, especially when actually mapping new rooms. Also, merging TinTin++ map files isn't really feasible, so mostly you are encouraged to just use tt_map.