TkTurf Plugins

The TkTurf plugin system allows anyone to distribute code patches which are not part of the "official" distribution. To use a plugin simply download it and place it in C:\tkturf\plugins\ in Windows, or in a folder called ::tkturf:plugins right inside the hard drive icon on a Mac, or in UNIX place them in ~/.tkturf/plugins/. Regardless of your respective system, if you have run TkTurf once already this directory should already exist somewhere.

Please note that plugins with version numbers below 1.0 are pre-releases. They have been deemed stable, but bugs should be expected.

Also note that version numbers and last modified dates on this page may be inaccurate. If you need accuracy use the Plugin Version Checker plugin for downloading plugins. It is always up to date (done automatically).

General Plugins

The AnyConnect plugin provides a menu option enabling connections to arbitrary hosts and ports.

Adds an Ascii Art editor which can be piped to channels on Turf.
Based on AsciiArtWidget v0.3 TCL library.

Bookie automatically tracks your bets and lets you know when you need to claim them. Bets made before installing this plugin may be loaded with the command "bookie" (you must be in the Turf Accountant's Office to do this).

Filters out most miss lines from combat.

Shows clans with logos sorted by clan points. Orders, guilds, and clans are distinguished by white, black, and red rectangles around their logos, respectively.
Requires: Userlist Viewer by Mango (below).

Requested by several people, this plugin highlights every friends channel in a unique colour. This colour can be configured (and saved) by clicking on a line of text written in the colour you wish to change.

Adds persistant geometry specs (window location and size) to TkTurf.

Provides a data popup window when the mouse is over the prompt area. Designed for immortals who want some info easily available, but not always taking up prompt space (like area name). Also works for players, possibly with things like current amount of gold.

Allows movement using the keypad keys towards the corresponding compass point. KP_5 is flee, KP_Substract is recall, KP_Addition is up, and KP_Enter is down. Keys may be customized by holding control and hitting the key to change.

Adds local echo to TkTurf. Example:

claim
----------------------------------------------------------------------
Your claim form.
----------------------------------------------------------------------
You have no results to collect.
----------------------------------------------------------------------
Trout          1 - 1    50000   10.39:45 AM - Sun, 19 September 1999 (your time)
----------------------------------------------------------------------
gr
Fastjack's group:
[ 39 Mage   ] Fastjack        358/ 358 hp  327/ 327 mana  476/ 476 mv 39020 xp
idle mtf
Mtf           21 minutes and  6 seconds.

This plugin creates a padlock icon in the TkTurf tray which can be used to execute a locking command, such as klock. To install, copy to the plugins folder and edit .turfrc to include a LCKCMD:whatnot entry. Also binds meta-s to use the lock command.
UNIX-only.

Allows the user to record, name, and quickly play back sets of recorded actions. Most suitable for getting from one place to another along a fixed path (speedwalking).

See the TkTurf MCCP page for details.

This plugin allows you to over-ride Turf's default name expansion with your own preferred expansions. For example, if you've been typing 'tell fast *' for years and now your tells go to Fastfox this plugin can force them to go to Fastjack.

An alternative (beep-based) new message notification system designed for those using GNOME or some other desktop system for which the built-in notification system does not work.

Creates a database of items you identify and can search through it and display the results as well as pop up info on items you pick up. Averages items added multiple times.

OneShot adds one-shot triggers, triggers which will trigger once and then delete themselves. To make a trigger one-shot with this plugin, simply add "oneshot" on a line of its own at the end of the trigger body. Putting "oneshot" on any line but the last will cause early termination of trigger execution.

TkTurf normally stores Autologin passwords as plain text in both files and memory. This plugin replaces that Autologin system and stores passwords as weakly encrypted strings in both file and memory. Encryption is based on adding a seed to the ASCII values of the characters in the password; protection provided by this system should be considered trivial and sufficient only to prevent accidental viewing of the password on disk or in memory.
Example:

	Normal:     login: Grazzt snurf
	Encrypted:  login: Grazzt 186181188185173

Checks the versions of all your plugins and downloads out-of-date plugins. Also finds new plugins and asks if you would like them downloaded. Defaults to checking once per day. Also allows browsing of plugins not currently installed.

Provides a preview of prompts as you construct them and lists information needed in building a prompt.

Attempts to guess what spell you want as you type it and fill it in for you. Also handles the nasty single-quotes needed on double-word spells.

QuickStat adds highlighting to any statistics shown by "score" or "group", and indicates relative level. Most useful for large groups, where finding out who is and who is not ready quickly is important. Colors are configurable, defaulting to blue and red.

Also displays adds warning lists of spells which are missing and you have asked for notification of when they are not present.
Examples:

Avocado's group:
[ 14 Mage   ] Avocado          92/ 134 hp   99/ 184 mana  174/ 174 mv 14109 xp
[ 14 Templar] Berty           120/ 172 hp   30/ 164 mana  130/ 177 mv 14117 xp
[ 14 Warrior] Mars             30/ 205 hp  133/ 133 mana  129/ 176 mv 14254 xp
[  7 Psychic] Recently         77/  77 hp    3/ 137 mana  103/ 135 mv  7495 xp
[ 20 Warrior] Trinette        237/ 257 hp  149/ 149 mana  213/ 213 mv 20172 xp

Missing spell notification:

Spell: 'sanctuary' for 2 hours.
Spell: 'shield' modifies armour class by -20 for 41 hours.
Spell: 'combat mind' modifies armour class by -23 for 28 hours.
Spell: 'combat mind' modifies hit roll by 6 for 28 hours.
Spell: 'adrenaline control' modifies constitution by 2 for 20 hours.
Spell: 'adrenaline control' modifies dexterity by 2 for 20 hours.
Spell: 'thought shield' modifies armour class by -20 for 23 hours.
Spell: 'stone skin' modifies armour class by -40 for 23 hours.
Spell: 'mental barrier' modifies armour class by -20 for 9 hours.
Spell: 'inertial barrier' for 7 hours.
Spell: 'energy containment' modifies save vs spell by -7 for 8 hours.
Spell: 'armour' modifies armour class by -20 for 6 hours.
Spell: 'intellect fortress' modifies armour class by -40 for 5 hours.
Spell: 'giant strength' modifies strength by 3 for 20 hours.
MISSING: displacement
MISSING: flesh armour

Adds a "speedwalk" facility based on stringing walk commands together in a particular format.

Re-adds the Turf logo to TkTurf whenever TkTurf is not connected. This feature was made a plugin to save users a 47K download each time they need to upgrade TkTurf.

Adds printing to TkTurf, both full text window, and selection.
UNIX only.

Makes URls mentioned in the mud clickable (provided they are entirely on one line).

Provides a unique way of viewing Turf's userlist, and allows the user to specify sorting based on three ordered criteria. To install from the above link to a tar.gz file unzip in C:\tkturf (Win) or ~/.tkturf (UNIX). Or, you can download the files manually from this directory. userlist.tcl should go in the C:\tkturf\plugins\ or ~/.tkturf/plugins directory for Windows or UNIX, respectively, and all the files in pixmaps should be saved in a new folder called C:\tkturf\pixmaps\ or ~/.tkturf/pixmaps under Windows or UNIX.
A screenshot is available.
Image updates are available as are plugin updates. (update to 1.3)

Adds a command "window" allowing you to put the output of a command into a window of its own.

Prompt Plugins

Presents hp and mana (or other things) as graphical bars in the prompt, with colour changing to indicate one of four levels.
Read the help in Help->Misc->Pretty Prompt or you won't know how to use this.
Requires: pprompt.mod for full functionality. Save in your main tkturf directory one level up from the plugins directory.

Same as pretty prompt but it shades between your choice of two colours, for even, accurate colour changes, rather than colour changes based on one of four levels.
Read the help in Help->Misc->Pretty Prompt or you won't know how to use this.
Warning: incompatable with Pretty Prompt, above.
Requires: pprompt.mod for full functionality. Save in your main tkturf directory one level up from the plugins directory.

QuickStat Prompt adds QuickStat 4.0+ highlighting to your prompt.
Requires: QuickStat 4.0+

Key Bindings

Binds Home and End to scroll the main text window (and shift-* to scroll the filter window.

This plugin provides more traditional UNIX bindings for the command area.

More xterm-like bindings (shift-pg scrolling, overwrites filter window scroll bindings).

Debugging Plugins

Debug 1.1 (12-8-99)

This plugin is only useful for Fastjack. It provides a more simple interface to the remote debugging feature.

Makes errors less instrusive by piping them to a special error log window. Adds a bomb icon to the tray which turns red when an error occurs.

This is a namespace-aware variable viewer and runtime function editor. The plugin is an interface to the included FJDebugger package.

Provides a tray icon to display a window showing all protocol messages received.

Deprecated/Buggy Plugins

Orders spell affects with those soonest to wear off at the top in the score display.
Example:
Normal

Spell: 'sanctuary' for 2 hours.
Spell: 'shield' modifies armour class by -20 for 41 hours.
Spell: 'combat mind' modifies armour class by -23 for 28 hours.
Spell: 'combat mind' modifies hit roll by 6 for 28 hours.
Spell: 'adrenaline control' modifies constitution by 2 for 20 hours.
Spell: 'adrenaline control' modifies dexterity by 2 for 20 hours.
Spell: 'flesh armour' modifies armour class by -40 for 23 hours.
Spell: 'thought shield' modifies armour class by -20 for 23 hours.
Spell: 'stone skin' modifies armour class by -40 for 23 hours.
Spell: 'mental barrier' modifies armour class by -20 for 9 hours.
Spell: 'displacement' modifies armour class by -32 for 17 hours.
Spell: 'inertial barrier' for 7 hours.
Spell: 'energy containment' modifies save vs spell by -7 for 8 hours.
Spell: 'armour' modifies armour class by -20 for 6 hours.
Spell: 'intellect fortress' modifies armour class by -40 for 5 hours.
Spell: 'giant strength' modifies strength by 3 for 20 hours.

With Affects Viewer

Spell: 'sanctuary' for 3 hours.
Spell: 'intellect fortress' modifies armour class by -40 for 6 hours.
Spell: 'armour' modifies armour class by -20 for 7 hours.
Spell: 'inertial barrier' for 8 hours.
Spell: 'energy containment' modifies save vs spell by -7 for 9 hours.
Spell: 'mental barrier' modifies armour class by -20 for 10 hours.
Spell: 'displacement' modifies armour class by -32 for 18 hours.
Spell: 'adrenaline control' modifies constitution by 2 for 21 hours.
Spell: 'adrenaline control' modifies dexterity by 2 for 21 hours.
Spell: 'giant strength' modifies strength by 3 for 21 hours.
Spell: 'flesh armour' modifies armour class by -40 for 24 hours.
Spell: 'thought shield' modifies armour class by -20 for 24 hours.
Spell: 'stone skin' modifies armour class by -40 for 24 hours.
Spell: 'combat mind' modifies armour class by -23 for 29 hours.
Spell: 'combat mind' modifies hit roll by 6 for 29 hours.
Spell: 'shield' modifies armour class by -20 for 42 hours.

Automatically sets your title to indicate AFK after ten idle minutes, and provides a handy "afk" command to indicate that you are AFK.

Adds diary-style logging of life events on a per-character basis. All date stamps are in Turf time, this is a fun plugin, not a practical one.

The following events can be optionally recorded:

• Kills (with name and xp)
• Deaths (with killer's name)
• Fleeing
• Levels (with name of level kill, not optional)
• (Un)Grouping (leader's name only)
• (Un)Following (with name)

Showlist provides a front end to the showlist command, providing easy one-click flag setting as well as easy clearing of all flags by name.