Timed Workbench Unlock 2.2.1

Provides timed/manual/disabled unlocking of workbenches.

Introduction

This plugin will allows the server owner to lock out any or all workbenches from being crafted until specified amounts of time have elapsed since start of wipe, or indefinitely / until manually unlocked.

Players will be notified up to once every 5 seconds on crafting failure.

Tutorial Island players are exempted from lockouts, as completing that requires crafting a Level 1 Workbench.

Important
This plugin is based on "Timed Workbench" by DizzasTeR, but is a significant overhaul. The two plugins cannot coexist in a single server installation.

The plugin will detect map wipes and will automatically refresh the workbench locks. To facilitate other forms of wiping, the server owner/maintainer may manually invoke the `twwipe` command.

Permissions

* `timedworkbenchunlock.skiplock` — Allows crafting workbenches regardless of lock status
* `timedworkbenchunlock.admin` — Gives access to **all** commands below
* `timedworkbenchunlock.broadcast` — Gives access to the `twbroadcast` command
* `timedworkbenchunlock.info` — Gives access to the `twinfo` command
* `timedworkbenchunlock.modify` — Gives access to the `twmodify` command
* `timedworkbenchunlock.reload` — Gives access to `twreload` command
* `timedworkbenchunlock.reset` — Gives access to `twreset` command
* `timedworkbenchunlock.wipe` — Gives access to `twwipe` command

Note: No permissions are granted automatically.

Commands

* `twbroadcast <value>` — Configure global status broadcast period to the specified number of seconds, or specify a non-positive number to disable
* `twinfo` — Prints elapsed time since wipe, and unlock status and times for each workbench tier
* `twmodify <tier> <value>` — Configure lockout for the given workbench tier, where a negative value is indefinite lockout, zero is unlocked, and a positive value is the number of seconds to unlock after start of wipe
* `twreload` — Reload the config file to pick up manual changes while the server is running
* `twreset` — Resets config to the default settings (**be careful with this!**)
* `twwipe` — Resets the last wipe timestamp to the current time, effectively restarting the lockout timers

Configuration
Example config file:

{
  "Global status broadcast interval in seconds (0 to disable)": 300,
  "Time that current wipe started (UTC)": "2024-08-29T02:04:53Z",
  "Workbench unlock times (seconds from start of wipe, or 0 for unlocked, or -1 for permanently locked)": [
    86400,
    172800,
    259200
  ]
}

Except for detailed tweaks to wipe time, all of the config settings are modifiable via ingame comands.

Credits
* DizzasTeR for the original "Timed Workbench" plugin on which this is based
* Umod.org documentation/forums/discord
* Other plugins as examples of best practices and Oxide API usage
* MrBlue for being patient with me lol
* misticos for detailed feedback