TinyFugue basics
Posted: 22 Aug 2010 15:06
This thread is for those who would like to start using this awesome client, but don't really know where/how to start.
Note: This guide is intended for TF version 4.01 stable, some of the things might be different in 5.0 beta and more modern builds.
Where do I get it?
Windows: http://www.druware.com/downloads/tf-40s1-w.zip
Mac: http://www.druware.com/downloads/tf-40s1-osx.dmg.gz
Unix: http://sourceforge.net/projects/tinyfugue/ (source file that needs to be compiled)
There are also other OS's supported, like OS/2, BeOS etc. You can check everything here:
http://tinyfugue.sourceforge.net/
Note for Unix based systems users: The TF source is very old one indeed and it won't compile on newer systems. What you need to do is replace the history.c and history.h files in the source with the ones I attached here.
Ok, now I got it installed and all, what's next?
The next things to look into, is the .tfrc (or just tfrc on Windows) file. This is the equivalent to your config/ini files for other things.
Mine looks more or less like this:
Let's break it down into pieces now.
Most LP muds, Diku muds, telnetd, and some other types of servers send unterminated prompts, that is, prompts that do not end with newline or any other special character. Normally, TF will not display text until a newline is received, so you may not see the prompt until after you press return. But if the %{lp} flag is on, TF will attempt to separate these prompts from normal text and display them correctly.
This is a matter of personal preference, by default it is on and what it does is creating a horizontal line, separating your input from the server output (ie: you have clear separation of world/client). It can be useful for typing long lines of text.
I prefer the oldschool look, especially that TF is smart and even without visual on, your prompt and input always remain in the same place and aren't broken by server output moving on.
This sets the default hilites we will see with /partial and /hilite commands.
Possible options are:
B - bold (default)
r - reverse (switching the foreground and background colours)
u - underline
C<name> - colour
Defines how many lines can be stored in history (useful for some advanced macros, you may just as well omit it)
Loading additional functionality for TF. alias.tf allows us to create aliases and kbstack.tf is a very useful tool for additional keybindings: save the current line with ESC-DOWN and recall it later with ESC-UP. There are also other files that can help in that, like changing your keybindings to bash or emacs ones.
Loading triggers stored in files. Note how the path starts with /cygdrive/, it's from the Windows machine as TF was written primarily for Unix systems and requires cygwin to change the paths into ones it can recognize.
This simple function adds the default world we'll be connecting to (you can add more if you wish, you can have several worlds open at once in TF and switch between them if you like to). How it works: -T is for type, lp is obvious choice here, gen is the name we assign to our world and then follows the address. The name can be used with commands like /dc <name(optional>(disconnect) and /world <name>(connect).
Ok, I'm all set up for start, how do I make my triggers and stuff?
Here's the list of some basic TF commands and how do they work.
Obviously, the most important command of them all.
This is for highlighting entire line (hilite) or specific words (partial) using your default hiliteattr.
Aliases just like your standard gen stuff. With the exception that you can put a lot of stuff there and it will be executed much faster. %; separator between jobs is equal to pressing [Return] on your keyboard.
This is used to create/remove your basic triggers. Typical usage would be:
Which would make you smile upon receiving some text from the server.
This is primarily used for your client to "talk to you". I'm using it it inform me when 60 seconds passed from the last time I ate a herb, when I'm changing some settings etc.
This makes your client repeat <action> every <time> <repetitions> times.
This example will make your character check health all every 3 minutes and will do so 5000 times (waiting 3 minutes between each time of course).
This example will make you instantly drink from fountain 10 times (not waiting between repetitions).
Post any questions you might have. For more advanced triggers/macros examples you can check out the TF threads with scripts I've made on this forum.
Hope you'll find it useful.
Note: This guide is intended for TF version 4.01 stable, some of the things might be different in 5.0 beta and more modern builds.
Where do I get it?
Windows: http://www.druware.com/downloads/tf-40s1-w.zip
Mac: http://www.druware.com/downloads/tf-40s1-osx.dmg.gz
Unix: http://sourceforge.net/projects/tinyfugue/ (source file that needs to be compiled)
There are also other OS's supported, like OS/2, BeOS etc. You can check everything here:
http://tinyfugue.sourceforge.net/
Note for Unix based systems users: The TF source is very old one indeed and it won't compile on newer systems. What you need to do is replace the history.c and history.h files in the source with the ones I attached here.
Ok, now I got it installed and all, what's next?
The next things to look into, is the .tfrc (or just tfrc on Windows) file. This is the equivalent to your config/ini files for other things.
Mine looks more or less like this:
Code: Select all
/set lp on
/set visual off
/set hiliteattr r
/histsize 10000
/load kbstack.tf
/load alias.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/hilites.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/aliases.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/items.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/travel.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/teams.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/combat.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/herbing.tf
/load /cygdrive/d/genesis/tf/genesis_scripts/general/statistics.tf
/addworld -Tlp gen mud.genesismud.org 3011
Code: Select all
/set lp on
Code: Select all
/set visual off
I prefer the oldschool look, especially that TF is smart and even without visual on, your prompt and input always remain in the same place and aren't broken by server output moving on.
Code: Select all
/set hiliteattr r
Possible options are:
B - bold (default)
r - reverse (switching the foreground and background colours)
u - underline
C<name> - colour
Code: Select all
/histsize 10000
Code: Select all
/load kbstack.tf
/load alias.tf
Code: Select all
/load /cygdrive/d/genesis/tf/genesis_scripts/general/hilites.tf
...
Code: Select all
/addworld -Tlp gen mud.genesismud.org 3011
Ok, I'm all set up for start, how do I make my triggers and stuff?
Here's the list of some basic TF commands and how do they work.
Code: Select all
/help
Code: Select all
/hilite <text>
/partial <text>
Code: Select all
/alias <name> <job> [%; <another job> %; <another job> ...]
Code: Select all
/def <options> <name> = <body>
/undef <name>
Code: Select all
/def -F -t'*some text*' my_first_trigger = smile
Code: Select all
/echo <attributes(optional)> <text>
Code: Select all
/repeat <time> <repetitions> <action>
Code: Select all
/repeat -180 5000 health all
Code: Select all
/repeat -0 10 drink from fountain
Post any questions you might have. For more advanced triggers/macros examples you can check out the TF threads with scripts I've made on this forum.
Hope you'll find it useful.