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.

Also optionally supports blocking research of locked workbenches so that players can't then replicate them via industrial crafters.

Supports the following notification method(s) on craft/research failure: Chat (up to once every 5 seconds), sound, toast.

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:

{
  "Block crafting of locked workbench(es)": true,
  "Block researching of locked workbench(es)": true,
  "Report craft failure as chat message": false,
  "Report craft failure as sound effect": true,
  "Report craft failure as toast message": true,
  "Global status broadcast interval in seconds (0 to disable)": 300,
  "Time that current wipe started (UTC)": "2024-12-10T01:05:57Z",
  "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