Register forum user name Search FAQ

MUSHclient scripting

Description of MUSHclient world function: world.EnableTriggerGroup


Name EnableTriggerGroup
Type Method
Summary Enables/disables a group of triggers
Prototype long EnableTriggerGroup(BSTR GroupName, BOOL Enabled);
Description

Triggers, aliases and timers can be placed in "groups" where a group is a bunch of related items. Groups have names, there is no restriction on the name of a group. Ungrouped items have blank (empty) names.

To enable an entire group of triggers do this:

world.EnableTriggerGroup "groupname", 1

To disable the entire group:

world.EnableTriggerGroup "groupname", 0

For debugging purposes the function returns a count of the number of members in the group (not the number enabled, as some may already be enabled). eg.

dim mycount
mycount = world.EnableTriggerGroup ("groupname", 1)

If you are using plugins only the members of the current plugin (if any) are affected. If the call is made outside a plugin only the members of the group that are not in a plugin are affected.


Note: Available in version 3.27 onwards.


VBscript example
world.EnableTriggerGroup "groupname", 1  ' enable the group
world.EnableTriggerGroup "groupname", 0  ' disable the group
Jscript example
world.EnableTriggerGroup ("groupname", 1);  // enable the group
world.EnableTriggerGroup ("groupname", 0);  // disable the group
PerlScript example
$world->EnableTriggerGroup ("groupname", 1);  # enable the group
$world->EnableTriggerGroup ("groupname", 0);  # disable the group
Python example
world.EnableTriggerGroup ("groupname", 1)  # enable the group
world.EnableTriggerGroup ("groupname", 0)  # disable the group
Lua example
EnableTriggerGroup ("groupname", true)  -- enable the group
EnableTriggerGroup ("groupname", false)  -- disable the group
Lua notes
The enabled flag is optional, and defaults to true.
Returns A count of the number of items in that group.
Introduced in version 3.27

See also ...

Function Description
DeleteGroup Deletes a group of triggers, aliases and timers
DeleteTriggerGroup Deletes a group of triggers
EnableAliasGroup Enables/disables a group of aliases
EnableGroup Enables/disables a group of triggers, aliases and timers
EnableTimerGroup Enables/disables a group of timers
GetTriggerInfo Gets details about a named trigger

Search for script function

Enter a word or phrase in the box below to narrow the list down to those that match.

The function name, prototype, summary, and description are searched.

Search for:   

Leave blank to show all functions.


Return codes

Many functions return a "code" which indicates the success or otherwise of the function.

You can view a list of the return codes


Function prototypes

The "prototype" part of each function description lists exactly how the function is called (what arguments, if any, to pass to it).

You can view a list of the data types used in function prototypes


View all functions

[Back]

Information and images on this site are licensed under the Creative Commons Attribution 3.0 Australia License unless stated otherwise.