Command Limiter and Cooldown

1 Screenshot

2.5k
8
24.29 kB
April 3

About Command Limiter and Cooldown

Command Limiter

Info

Command Limiter allows you to limit the use of commands that players can use. For each command you can set the cooldown, minute, hourly, daily and wipe usage limits.
It also allows you to apply limits in case of Building Blocks, Safe Zones, block the command permanently, etc...
Command Limiter is useful for limiting the use of commands from plugins that do not implement a blocking system or implement an inflexible blocking system.

Commands

Commands can be typed in chat (by putting the / character in front of the command), or from console.

/cl reset <steamID> — This command allows you to reset usage limits for a specific player. To use this command you must have permission: commandlimiter.admin
/cl wipe — This command allows reset all usage limits for all players. To use this command you must have permission: commandlimiter.admin

Commands can be added or modified in the configuration file: /oxide/config/CommandLimiter.json

Permissions

Quote

This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>.
To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.

commandlimiter.admin -- Allows the use of commands reserved for administrators
commandlimiter.bypass -- Allows you to bypass the command usage limit, but only for commands that have the CanBeBypassed field set to TRUE
commandlimiter.bypass.force -- Allows you to easily bypass the command usage limit, regardless of the CanBeBypassed field

Default Configuration

{
   "TimeZone":"Europe/London",
   "Wipe data on new save file":true,
   "Chat Command":[
      "cl",
      "commandlimiter"
   ],
   "Command Setting":[
      {
         "Enabled":true,
         "Command":"cmd",
         "BlockCommand (If set to TRUE players will no longer be able to use this command. Default FALSE)":false,
         "SafeZone. Value [AllowOnly | Allow | Block] (Default Allow)":"Allow",
         "BuildingBlocked. Value [AllowOnly | Allow | Block] (Default Allow)":"Allow",
         "CanBeBypassed (If set to TRUE the command block can be bypassed. It depends on the user permissions)":false,
         "CooldownSeconds (-1 infinite)":5,
         "MaxUsagePerMinute (-1 infinite)":5,
         "MaxUsagePerHour (-1 infinite)":10,
         "MaxUsagePerDay (-1 infinite)":20,
         "MaxUsagePerWipe (-1 infinite)":100
      }
   ]
}

TimeZone -- Set the time zone with which the dates will be saved: Default: Europe/London.
Wipe data on new save file -- Clear command usage data after a wipe. Default TRUE.
Chat Command -- Here you can add, edit or delete commands can be typed in chat (by putting the / character in front of the command), or from console.
Command Setting -- The list of commands on which to apply the usage and cooldown limits must be inserted here.
Enabled -- If set to TRUE, limits and cooldowns for this command will be enabled.
Command -- The command on which to apply limits and cooldowns.
BlockCommand -- If set to TRUE, the command cannot be used by any player, except for players with the permissions: commandlimiter.admin or commandlimiter.bypass.force.
SafeZone. Value [AllowOnly | Allow | Block] (Default Allow) -- Sets whether the command can be used in safe zones:
- AllowOnly: The command can only be used in safe zones.
- Block: The command cannot be used in safe zones.
- Allow: No restrictions for safe zones.
BuildingBlocked. Value [AllowOnly | Allow | Block] (Default Allow) -- Sets whether the command can be used in areas where you have building permissions:
- AllowOnly: The command can only be used where you do not have building permissions.
- Block: The command can only be used where you have building permissions.
- Allow: No restrictions for building zones.
CanBeBypassed -- If set to TRUE the command can be bypassed by players with permission: commandlimiter.bypass.
CooldownSeconds — -- Cooldown for command reuse.
MaxUsagePerMinute -- Limit the use of the command for each minute.
MaxUsagePerHour -- Limit the use of the command for each hour.
MaxUsagePerDay -- Limit the use of the command for each day.
MaxUsagePerWipe -- Limit the use of the command for wipe.

Order Application Limits

The usage and cooldown limits of the various commands are applied in the following order:

Wipe limits -- If the wipe limits have not been exceeded, proceed to the next check, otherwise the command will be blocked.
Daily limits -- If the daily limits have not been exceeded, proceed to the next check, otherwise the command will be blocked.
Hourly limits -- If the time limits have not been exceeded, proceed to the next check, otherwise the command will be blocked.
Limits per minute -- If the minute limits have not been exceeded, proceed to the next check, otherwise the command will be blocked.
CooldownSeconds -- The command will be executed if the cooldown has expired, otherwise you will have to wait for the cooldown to reset.