Disclaimer: You can use the provided scripts however you like and do whatever you like with them. They've been created based off of my own inventions as well as pieces of code scavenged from other people's scripts (not necessarily TF ones at that) over the years.
Download and installation
There are various ways of installing TinyFugue, some Linux distributions have it in their software repositiories but there's also an option to build it from source (sometimes preferable if you know what you're doing).
Official webpage with downloads and installation instructions is here: http://tinyfugue.sourceforge.net/
If you don't want to install from source on some *nix systems, you can simply google "tinyfugue mac" or similar and there should be 'one-click install' packages available (although last I checked they were of older version, which shouldn't really change anything for you).
Basic usage
Let's get to the gist of it. TF is fairly simple to use but requires us to do some configuration in order to have everything run smoothly. In order to do that locate the tfrc file. On *nix based systems this will be in your home directory or where you installed tf (or simply create a new one in your home directory, this will override the default). On Windows this will be in the tf installation directory.
Note: On *nix systems the file will be called '.tfrc' (with a dot) and on Windows 'tfrc' (without the dot). Regardless, you can edit it with any text editor.
Code: Select all
/set lp on
/load alias.tf
/addworld -Tlp genesis mud.genesismud.org 3011
Optional settings:
Code: Select all
/set visual off
/set hiliteattr r
You can read on all of that by invoking /help in tf. It has very good documentation with lots of info.
Useful commands:
Code: Select all
/world <name>
/dc
The scripts
Now, let's get to the gist of it. I'll tell you how to set up the basic scripts, tell you what they do and how to expand on them. Download the archive and extract it somewhere. You'll need to adjust 2 files:
.tfrc - mentioned earlier
general.tf - in the script folder
What you need to do is add the /load path/to/general.tf in the .tfrc and adjust the load paths in general.tf (it serves as a file to load other files) to where you keep your scripts (currently general.tf assumes that you keep the genesis_scripts folder in your home directory).
Scripts themselves aren't super fancy, they provide you with some basic colouring, automation and aliases that make your life easier. I've also provided a sample guild script (for mercenaries) that you can adjust for other guilds if you wish or just look it up to see how it can be done. There are also some helper definitions so you can easily customize things even if you have no programming knowledge.
If you want to change or add something, simply edit one of the files or add your own (don't forget to load it). Things that most people will want in the beginning, that are simples to implement are:
Code: Select all
/hilite this will highlight entire line containing this text
/partial only this part of the line will be highlighted (/hilite and /partial work off hiliteattr we set earlier, so they will reverse the colours - white background, black letters by default)
/alias alias_name alias_body
/alias multi_command command %; command %; command
/unset alias_name - removes the alias
/def -F -t'regex pattern' trigger_name = trigger_body
/undef trigger_name - removes the trigger
/echo this text will show up on your screen but not in the game
; this is a comment
; lines starting with ";" are ignored
; below are some helper definitions in the scripts that you can use
/YELLOW this text will be yellow
/GREEN this text will be green
/RED this text will be red
/CYAN this text will be cyan
/MAGENTA this text will be magenta
/BLUE this text will be blue
/WHITE this text will be bright white (as opposed to the dim white of standard tf font)
Ok, on to the scripts. You should really go through the files and look up all the aliases and maybe change them because they're my own and not something people would consider standard in some cases (like 'hh' being 'search here for herbs' while 'h' being 'health all' - can get you in trouble).
Automation
The scripts automate some of the tedious tasks. There are plenty of switches for them so that you can control it. All switches work as an on/off button (it will tell you which option you've switched to) and don't take any arguments unless stated otherwise:
Code: Select all
; combat
/atk - repeat the kill command
/assisting - automatic assist
/coins - get coins from corpse
/gems - get gems from corpse
; note: they only trigger after YOU killed something, so no worries about stealing loot, assisting also only works when the team leader is attacking/attacked
; note2: the team triggers might be outdated a bit, if you don't see any messages when joining/leaving the team you can set them by invoking '/team' and/or '/leader Name'
; you can also update them if you wish by simply editing the trigger patterns
; utility
/light - automatically fill lamps with oil when they run out etc.
/pack - automatically pack loot (don't worry, it won't pack worn/wielded items)
; other
/boarding - automatically board/disembark ships
/herbing - pack herbs in pouch and search again (in the same room, doesn't move you, doesn't continue searching if you don't find anything)
/hfind <herb name> - sets what herb you'll be looking for
/hcontainer <container> - where to pack herbs
Other things to remember
up arrow - that brings back your last typed input, invoking it repeatedly will cycle through input history
Code: Select all
/repeat -x y command - repeats command y times every x seconds ('/repeat -60 10 vitals' will check your vitals every minute for 10 minutes)
/for i do x command - invokes command x+1 times (eg. '/for i do 16 ne' will be equivalent to typing 'ne' and pressing return 17 times)
/recall - well, just do '/help recall', it's an amazing thing that helps you fetch stuff from session history
/log filename - start logging stuff (works with recall too)
/log off - stop logging
Code: Select all
; definitions
/def find = /recall -t$["%H:%M:%S"] -w -mglob 0- *%{*}*
; tools
/alias vitals_forever \
/send vitals %;\
/repeat -00:05:00 1 %vitals_command
/alias viton \
/set vitals_command vitals_forever %;\
vitals_forever
/alias vitoff /unset vitals_command
'viton' and 'vitoff' simply set/unset an endless loop of vitals checking every 5 minutes.
I'll add more stuff if I recall something important. If you have any questions or problems feel free to ask.