22 October 2016
21 August 2016
21 August 2016
|Type||Corrade progressive command|
|Last Changes||Release 9.138 - changed the meaning of the command.|
softban command can be used to soft-ban, soft-unban and query the soft-ban list for a given group. Contrasted to the ban command, the soft-ban command acts upon a separate list that Corrade maintains that is independent of the server-side (grid) group ban list but is also able to temporarily add an avatar to the server-side (grid) group ban list.
softban command, when invoked with the
action parameter set to
ban adds agents to Corrade's internal soft-ban list. Additionally, if a list of minutes is passed to the
time parameter, then Corrade will additionally add the avatars to the server-side (grid) group ban list and will remove the ban from the server-side (grid) group ban list after the specified time has elapsed - the server-side (grid) group ban expires no sooner than the configured MembershipSweepInterval. In case the time passed to the
time parameter has elapsed, then Corrade removes the avatar from the server-side (grid) group ban list but keeps the avatar in the soft-ban list. In case the avatar joins the group again, then the avatar will be ejected and added again to the server-side (grid) group ban list until the next expiration. In case a
time parameter has not been supplied when banning with
action set to
ban, Corrade will just add the avatars to its internal soft-ban list and eject them every time they rejoin the group.
softban is meant as a wrapper to the Linden Lab group ban functionality since group ban entries are limited to 500 avatars. By using
softban you can prevent banned avatars from quickly rejoining the group and also avoid the 500 entry limitation.
Corrade sweeps the group rooster every MembershipSweepInterval milliseconds in order to detect new members joining the group and to check whether they should be ejected or not. For a faster reaction time, you would need to change the MembershipSweepInterval configuration key.
|Command||Required Parameters||Required Corrade Permissions||Required Group Abilities||Example|
| || || || * If the |
llInstantMessage(CORRADE, wasKeyValueEncode( [ "command", "softban", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), // ban some avatars "action", "ban", "avatars", wasURLEscape( wasListToCSV( [ "Philip Linden", // ban by UUID "ff19c6b5-4824-4de3-995a-d739d588cf18" ] ) ), // A list of minutes for which the avatars should // be added to the built-in (grid) group ban list. "time", wasListToCSV( [ 2, // minutes to ban avatar "Philip Linden" 10 // minutes to ban avatar "ff19c6b5-4824-4de3-995a-d739d588cf18" ] ), "callback", wasURLEscape(URL) ] ) );
|Parameter||Possible Value||Parameter||Possible Value||Optional Parameter||Possible Value||Description|
| || || ||A CSV list of minutes.|| Soft-ban avatars from a group as well as optionally adding them to the built-in (grid) group ban list for the specified period of
| || ||A CSV list of minutes.||Change the period for which avatars will be added to the server-side (grid) group ban list.|
| ||Soft-unban an avatar from the group.|
| ||Return a CSV list of avatar names by UUIDs.|
| || || ||Import the calling group's ban list into the Corrade-managed soft-ban list.|
| || ||Import the agents muted by the account Corrade is connected on into the Corrade-managed soft-ban list for the calling group.|
| || || ||Add all agents from the Corrade-managed soft-ban list to the group ban list. Corrade will fail and report an error in case the group ban list bounds would be overstepped.|
| || || || Make Corrade add all the avatars in the soft-ban list to the Corrade mute list - optionally with
|Optional Parameter||Possible Value||Description|
| ||A group name or UUID.|| The group to act upon. If this parameter is omitted, then the command acts upon the configured group passed to the
The command will return a list of avatars that could not be soft-banned, soft-unbanned or ejected from the the group.