TT5 documentation

This is my 5th generation of tintin suite for realms, so it's named tt5.

Installation

• Download the whole tt5 folder

 wget -r -nH -np -R "index.html*" http://dyrdex.com/tt5/

• Run your tt++ with the path to my init script:

tt++ tt5/scripts/init.tin

That should be it. If you wanna re-name/move "tt5" you'll need to update the $home var at the top of this file:

tt5/scripts/init.tin

• NOTES:
  • All the scripts are commented so refer to scripts directly for more information.
  • All commands should display their syntax if typed with no argument.

Connection

• Type 'go character' and enter your password. That info will be saved for future logins.
  • Once logged in, use 'nickname FOO' so you can log in via nickname later (go foo)

• The system also supports login by nickname, creating login groups, aliases for dc/rc, and offline character status, class search, and buffer display.

Character Management

Full commands list: (Typing a command with no argument should display its syntax information.)

  go                      Display Full Character List;
  go CHARACTER            Log in (foreground);
  go NICKNAME             Log in (foreground)
  go GROUP                Log entire group in.
  bg CHARACTER            Log in (background) (also works with nicknames);
  nickname FOO            Set -current- char's nickname to FOO (must be logged in);
  dc                      Disconnect;
  relog                   Disconnect & Reconnect;
  delchar CHARACTER;      Remove all configs for char;

Group Management

  addgroup GROUPNAME Guy1 Guy2 Guy3 Guy4   (up to 8 supported);
  remgroup GROUPNAME Guy1;                 Removes Guy1 from GROUPNAME;
  delgroop GROUPNAME                       Deletes entire group;

Offline Information

  show  <character-full-name>
  show  <mag|cle|thi|war|vam|dru|ran|aug|pal|nep|fat|bar|dre|har|kni|hun|inf|buc>
  tail  (will display last 200 buffer lines)

Character Configuration

Full commands list:

  flags             Display All Current Flags;
  flag NAME FILE    Add a new flag of "NAME" to read "FILENAME" from associated directory;
  unflag NAME       Remove the NAME flag;

This system requires explanation.

• Each character gets 'flags' to denote which config files it should read in.
  • These are for: character/class/group/org/run/bot and 'misc'

(Upon initial log in, some of these will be auto-discovered by running 'score' and saved: character, class, organization.)

• NOTE: These are for scripts you only want implement on a character/class/org/group/run/bot basis.
  • If you want ALL chars to have a script, you may actually want to load a global MODULE (see modules section below)

• Upon login, your character's flags and loaded configs are displayed.
  • Type 'flags' to see the syntax and current configuration information.

Example: Dyrdex has 3 flags currently configured, for his character, class, and organization:

       Loaded File Flags:
       Flag Name: character Value: dyrdex       From tt5/characters/dyrdex.tin
       Flag Name: class     Value: Thief        From tt5/classes/Thief.tin
       Flag Name: org       Value: Ascendere    From tt5/orgs/Ascendere.tin

• There are 6 default flag names which correspond to data directories for their files:

Flag Name: character    will read files from /tt5/characters/   (*Auto-added to all characters)
Flag Name: class        will read files from tt5/class/         (*Auto-added to all characters)
Flag Name: group        will read files from tt5/group/         (*Auto-added to all login group members)
Flag Name: bot          will read files from tt5/bot/                                    
Flag Name: org          will read files from tt5/org/
Flag Name: run          will read files from tt5/run/

• There is 1 'catch-all' directory for all other flag names:
  • Flag Name: ANYTHING will read files from tt5/misc/

• To set a flag, you specify a flag NAME and then your FILENAME:

Syntax: flag <name> <filename>

• Examples:
  • If you want to flag your character with a seth run script:

1. Place your script into tt5/runs/ 
2. flag run seth           (will read tt4/runs/seth.tin at login)

• • To flag yourself with a spellbot type script:

1. Place your script into tt5/bot/
2. flag bot spellbot

• • If you want to assign yourself a flag named 'butthead' thats reads in a file named 'fart.tin':

1. Place your script into tt5/misc/
2. flag butthead fart      (will read tt5/misc/fart.tin at login)

• • To remove a flag, just use 'unflag FLAGNAME'

Syntax: unflag <name>

• Remember that's the flag NAME (not filename):

unflag run
unflag bot
unflag butthead

The goal of this system was to both easily sort out common groups (character/class/org/group/run/bot) into folders while also providing full customization for flags and files via the 'misc' folder.