[feature] optional plugin.rate (& friends) argument to limit admins

[dgw]

Requested Feature

Basically, the following:

@plugin.rate(600, message='Wait your turn!', include_admins=True)
def game_func(bot, trigger):
    # some e.g. reward-collection or PvP-combat function that users
    # *including bot admins* are only allowed to call after a cooldown

(Of course, apply to the limit-type-specific decorators as well.)

Problems Solved

There's no way at the moment for plugin devs to rate-limit triggers by admins, without resorting to manual workarounds.

This snippet from one of my mIRC-script clones demonstrates a potential use case. (It also returns a message with the remaining time, and pulls the allowed rate from a config value. Those would be separate feature requests in core, though remaining time is included in the list of requested message placeholders in #2325.)

Alternatives

No response

Notes

No response