Extended Aliases


These aliases allows you to direct add/modify/delete an entry from the scripts , or the address book . These commands are a little complicated ,but they are powerful tools for scripting

/_alias enables you to add/edit/remove a script from the aliases .

aliasname , is the name of the alias you would like to add/modify/remove , including the / preffix.

popupmask , is the mask which describes the popup action of the alias . Values are

  1. 1 - Server Popup
  2. 2 - Channel Nick Popup
  3. 4 - Query Popup
  4. 8 - DCC Popup

for example , to set an alias to be both query + server popup , you use 5 ( 1 + 4 )

Use 0 to prevent an alias to be a popup

key , is the shortcut char to be copied in the shortcut alias entry . Use 0 ( zero) for no shortcut

The rest of the parameters of the /_alias , are describing the script lines , divided by three |'s . Use no script to indicate that the alias should be deleted . Use an asterisk "*" to leave the existing script in place . To clear the script without deleting the alias , use blank lines , for example /_alias aliasname 3 0 ||| ||| ||| ... etc . When one or more of your virtual lines start with ? , TurboIRC will read the relative file . Example

/_alias /hey 0 0 /mme #channel hey there|||?c:\sc.txt|||/mme #channel end file

this will create a script that starts with the first /mme command , then comes the file sc.txt and then the last command .

See Aliases for details .

Examples

Add or modify an alias with name /testalias , to be query popup , with no shortcut and with the script /me hey there ! and /me are you ok today ?

/_alias /testalias 3 0 /me hey there !|||/me are you ok today ?

to delete this alias we created / modified :

/_alias /testalias 3 0

to change this alias only the popup mask , and leave the script in place

/_alias /testalias 3 0 *

Warning : You cannot use $ variables within /_alias , /_event , /_spevent or /_alarm , if you call /_x from another script , because these variables will be replaced before the /_alias is executed . If you use e.g. this line within a script : /_alias /testalias 3 0 /mode $channel +nt , the /testalias will not have /mode $channel +nt as a script , it will have replaced the $channel with the channel you were on when you called the original alias .

 

eventname , is the name of the event

functionmask , is the combination of options that the event should have :

  1. 1 - Enabled
  2. 2 - Locked
  3. 4 - After Fire
  4. 8 - Multi Handler
  5. 16 - Global Match
  6. 32 - Case Sensitive

e.g. use 9 for an enabled multi handler event

enableattrmask , is the combination of the event levels that should be ON

  1. 1 - You have +v
  2. 2 - You have +o
  3. 4 - You have +q
  4. 8 - You are IRCop
  5. 16 - You are Admin
  6. 32 - You are in IRCX

disableattrmask , is the same combination of the event levels that should be OFF

If a level is neither in the enableattrmask , nor in the disableattrmask , it will be set to DON'TCARE

See Events for details .

The rest are the lines describing the scripts , divided by 3 |'s . Each logical line that has the + sign in front of , goes to the "Trigger Masks" . Each logical line that has the - sign in front of , goes to the "Refuse Masks". Use blank script to indicate that an event should be deleted .Use an asterisk "*" to leave the existing script in place . You can also take the script from a file , check the /_alias description .

Example

/_event testevent 1 0 0 +:*!*@* JOIN*|||-:W*!*@* JOIN*|||/notice $nick hey !

This creates/updates an event "testevent" , sets the "enabled" flag , sets all the levels to DON'T CARE , adds the *!*@* JOIN* to the trigger masks , adds the :W*!*@* JOIN* to the refuse masks and the rest is the script .

 

The syntax of /_alarm is relative to /_alias , except for the few more number parameters that give the day,month,year,hour,min and second . To delete an alarm , include no script . Use an asterisk "*" to leave the existing script in place . You can also load a script from a file , as described in /_alias .

 

See Alarms for details

The syntax of /_spevent is the same with the /_alias , except that the /_spevent can only modify special events . Using the /_spevent with a speventname that does not exist does nothing . Using blank script makes /_spevent to clear the script from the special event , but not delete the event itself . You can also take the script from a file , check the /_alias description .

See Special Events for details .

To remove an entry from the address book , use /_ab user

/_ab cannot add multiple line information to the address book .

/_set allows you to dynamically modify a TurboIRC option . The options that can be modified are listed in the Preferences and other configuration dialogs . With /_set , you can change an option temporarily . This change will remain until you restart TurboIRC , or you reload the options with /reloadoptions . No changes are written to PREF.INI

Available options are :

  1. "BanType" : The value must be a number from 0 to 14 specifying the ban type . You can view the preferences dialog to see the available ban types . If value is empty , 0 is assumed.
  2. "PirchNotice" : The value must be 0 or 1 , to ignore or enable the PIRCH Notice string .
  3. "VircNotice" : The value must be 0 or 1 , to ignore or enable the VIRC Notice string .
  4. "DisconnectDestroy" : If this is 1 , all server windows are destroyed upon disconnection .
  5. "KickDestroy" : If this is 1 , when you are kicked from a channel the window is destroyed .
  6. "KickRejoin" : If this is 1 , TurboIRC sends a /join command if you are kicked .
  7. "WarnExtend" : If this is 1 , TurboIRC warns you on special mode channels .
  8. "CloneJoin" : If this is 1 , TurboIRC joins automatically a clone channel .
  9. "VoiceFrequency" : The value is a number that describes the default Chat Voice Frequency .
  10. "AutoFiles" : If 1 , auto accept file transfers
  11. "AutoChat" : If 1 , auto accept DCC Chats
  12. "IgnoreF" : If 1 , ignore IRCX +f
  13. "MailServer" : The default server for KTP
  14. "AutoFav" : If 1 , auto join favorites on connection
  15. "FilesDir", "SoundDir" , "LogDir" : The new paths for files,sounds,logs
  16. "ShowTip" : If 1 , show tip of the minute on startup
  17. "ShowLast" : If 1 , show last channels on connect
  18. "ShowJoin" : If 1, show the join dialog on connect
  19. "IdentString" : The new string for the IDENT service
  20. "PlaySound" : If 1 , play received sounds
  21. "RecLinks" : If 1 , auto recognize hyperlinks in text
  22. "KeypressAway" : If 1 , auto remove away on keypress
  23. "ServiceError" : If 1 , show service errors
  24. "ServiceInfo" : If 1 , show service information

See Preferences

The following parameters of /_set can change the Appearance Formatting :

  1. "RawServer"
  2. "NoticeAll"
  3. AutoSavePos"
  4. "HidePP"
  5. "ShowSmallTips"

All can take 0 or 1 as a value ( disabled / enabled ) . See Appearance Formatting .

The following parameters of /_set can change the Metrics :

  1. "EditBG"
  2. "XView"
  3. "YView"
  4. "XInput"
  5. "YButton"
  6. "BGBitmap"
  7. "IsNickLeft"
  8. "Toolbar2"

1-6 take a description string , and 7,8 take 0 or 1 ( disable/enable ) . See Metrics .

The following parameters of /_set can change other options :

  1. AutoPing
  2. AutoTime
  3. AutoFinger
  4. AutoFile
  5. AutoChat
  6. AutoVoice
  7. FloodDelay
  8. YieldNum
  9. ServerOut
  10. ChannelOut
  11. QueryOut
  12. DCCOut
  13. EscAction
  14. WarnOff
  15. AltF4Close
  16. ColorServer

See MoreOptions .


See also :

Default Aliases