Remote Commands

 

The following commands are used to modify settings in scripts and in the remote section.

 

General Commands

 

/ctcps [on|off]

This switches processing of ctcp events on/off.

 

/events [on|off]

This switches processing of named events on/off.

 

/dlevel <level>

This changes the default user level to the specified level.

 

/raw [on|off]

This switches processing of numeric events on/off.

 

/remote [on|off]

This switches processing of all scripts on/off.

 

Group Commands

These commands allow to turn groups on and off in remote scripts. You can find out about groups in the Access Levels section.

 

/enable <group1 group2 ... groupN>

This enables the specified groups in all scripts.

 

/enable #one #two #three

 

You can also specify a wildcard to enable all matching groups:

 

/enable #help*

 

/disable <group1 group2 ... groupN>

This disables the specified groups in all scripts.

 

/disable #one #two #three

 

You can also specify a wildcard to disable all matching groups:

 

/disable #help*

 

/groups [-e|d]

This displays a list of either all, enabled, or disabled groups in your scripts.

 

User and Level Commands

You can use the following three commands to add and remove users to the users list, as well as to add and remove levels from existing users.

 

/auser [-a] <levels> <nick|address> [info]

This adds the specified nick/address exactly as it is given to the users list with the specified levels. If you specify [-a], then if the user already exists, the specified levels are added to the current levels the user has. Remember, if the first level is not preceded by an equal sign then it is a general access level.

 

/auser 1,2,3 Nick

 

This adds this nick with these access levels to the user list (replacing an existing user of the same name).

 

/auser -a 1,2,3 Nick

 

This adds the specified levels to this user. If the user does not exist, it is created.

 

/auser -a =1,2,3 Nick

 

This looks like the above command, however the =1 is very important. The =1 means that the initial general access level is not replaced. If you had used 1 then the initial access level would be replaced.

 

The info parameter allows you to append text to the entry that is added to the users list, you can reference this later with the $ulist() identifier.

 

/flush [-l] [levels]

This clears the remote user list of nickname definitions that are no longer valid.

 

/flush 1,2,3

 

For each nick in the remote user list that matches the specified levels mIRC checks to see if that nick is on any of the channels that you are currently on. If not, the nick definition is removed from the remote user list. If you do not specify levels then mIRC clears all nicks from the remote user list that do not exist on channels you are on.

 

You can use the -l switch to remove only the specified levels from entries in the user list, instead of removing the entries.

 

/guser [-a] <levels> <nick> [type] [info]

This works the same as the /auser command except that it looks up address of the specified nick and adds it to the user list. It does this by doing a /userhost on the given nickname, and returning an address in the format specified by type. If no type is specified then a default address format is selected.

 

The info parameter allows you to append text to the entry that is added to the users list, you can reference this later with the $ulist() identifier.

 

/iuser <nick | address> [info]

This allows you to set or remove the info appended to a user list entry.

 

/ruser [levels] <nick | address> [type]

If used without specifying levels, this removes the specified user from the user list. If you specify levels then these levels are removed from the current access levels of this user. If all a user's levels have been removed, the user is removed. If you specify a type then the users address is looked up with a /userhost and any users in the users list matching this address are removed.

 

/ruser Nick

/ruser 1,2,3 Nick

/ruser 1,2,3 Nick 1

 

If you use /ruser Nick! (with an exclamation mark at the end), it removes all users with an address beginning with Nick!.

 

/rlevel [-r] <levels>

This removes all users from the remote users list with the specified general access level.

 

/rlevel 20

/rlevel =10

 

If the -r option is specified, then this applies to all the access levels for a user (not just the first general access level). Any matching levels are removed. If a user has no more levels left then the user is also removed.

 

/rlevel -r 1,5,7,8

 

/ulist [<|>] <level>

This lists users which have the specified access levels.

 

/ulist <10    lists users with access levels less than or equal to 10

/ulist >5      lists users with access levels greater than or equal to 5

/ulist 4        lists users with access level 4

 

Note: The /guser and /ruser commands do a /userhost on a nick to find the nick's address, thus they are delayed commands since they need to wait for a reply from the server. mIRC tries to get around this delay by maintaining its own Internal Address List which will speed things up in certain situations.