Workbench Extended 1.2.0

The most lightweight and efficient workbench range system for Rust.

Workbench Extended solves a simple but annoying problem: having to stand directly next to a workbench to craft. The plugin was originally designed with a specific philosophy: if a workbench is physically installed in your base (or Tugboat), you should be able to use it anywhere inside that structure.

While the core mechanic is simple, the plugin offers a highly flexible permission system to configure VIP tiers, team access, and safe zone crafting.

Requirements

• Framework: Oxide (uMod) OR Carbon.
• Dependencies: None.

How It Works (Simple Logic)

1. Range & Zone: The extended workbench range matches your Building Privilege zone. If you can build there, you can craft there.
2. Authorization: As soon as you authorize on the Tool Cupboard (TC), you automatically gain access to all workbenches in that building (depending on your permissions).If you lose authorization or the TC is destroyed, the plugin stops working for you immediately. You revert to vanilla mechanics (must stand next to the bench).
3. Strict Matching: The plugin does not give workbenches "out of thin air". To have remote access to a Level 3 Workbench, a Level 3 Workbench must physically exist inside the building.

Permissions

Standard Permissions

Recommended for default players or basic functionality.

workbenchextended.tier3

• The Main Permission.
• Allows remote access to any workbench level (1, 2, or 3) found in the building.
• Example: If a player crafts and places a Level 3 Bench, they can use it throughout their entire base.

workbenchextended.tugboat

• Enables the extended range functionality on Tugboats.
• Requires the player to be the owner or authorized on the Tugboat.

VIP Permissions (Limited)

Used to create donation tiers (e.g., Bronze/Silver VIP).

workbenchextended.tier1

• Allows remote use of Level 1 Workbench only.
• Important: Even if a Level 3 Bench physically exists in the base, this player can only remotely craft Level 1 items. To craft Level 3 items, they must walk up to the bench (vanilla mechanic).

workbenchextended.tier2

• Allows remote use of Level 1 and 2 Workbenches.
• Important: Even if a Level 3 Bench exists, remote crafting is capped at Level 2. For Level 3 items, vanilla proximity is required.

Special Permissions

workbenchextended.team

• Allows using the workbench if a Teammate is authorized on the Tool Cupboard (instead of the player).
• Useful for clans to save TC authorization slots.

workbenchextended.noauth

• Raider Mode. Allows using the extended workbench range in any building, ignoring the need for TC authorization.
• The range is still tied to the building's privilege zone.

workbenchextended.global

• God Mode. Grants Level 3 Workbench access everywhere on the map.
• No building, TC, or physical workbench required.

SafeZone Permissions

Allows utilizing static workbenches found in monuments.

workbenchextended.outpost

•  Works throughout the entire Outpost Safe Zone.

workbenchextended.bandit

• Works throughout the entire Bandit Camp Safe Zone.

How to Grant Permissions

You can assign permissions using console commands or through a visual menu, depending on your server framework.

Via Console Commands

For Oxide (uMod):

// Grant to all players (default group): 
o.grant group default workbenchextended.tier3 

// Grant to a specific player: 
o.grant user <SteamID> workbenchextended.tier3

For Carbon:

// Grant to all players (default group): 
c.grant group default workbenchextended.tier3 

// Grant to a specific player: 
c.grant user <SteamID> workbenchextended.tier3

Via Visual Menu (UI)

For Oxide (uMod):
If you prefer a visual interface, you can use any popular permission management plugin (such as Permissions Manager or AdminMenu). These allow you to toggle permissions simply by clicking checkboxes in-game.

For Carbon:
Carbon comes with a built-in, powerful admin panel:

• Navigate to the Permissions tab.
• Select the group (e.g., default) or specific player.
• Search for workbenchextended and toggle the desired permissions.

Configuration

codeJSON

{
  "Enable Team Access": true,
  "Enable Tugboats": true,
  "Debug Mode": false
}

Admin Commands

/wb.stats        - Cache statistics (buildings, tugboats, players)
/wb.debug        - Toggle debug mode
/wb.reload       - Reload plugin and caches
/wb.clear        - Clear player cache
/wb.player [name] - Workbench info for specific player
wb.status        - Plugin health status (console only)

Performance

Built for high-population servers with a "Zero-Overhead" philosophy.

• No Physics Queries: Does not use heavy OverlapSphere or Raycast methods.
• Harmony Patching: Hooks directly into game logic for native performance.
• Smart Caching: Instant access level lookup using bitmasks.
• Network Throttling: Updates UI icons only when necessary.
• CPU Usage: Negligible (~0.05ms) even with 200+ players.

Developer API

// Get player's workbench level
int level = (int)WorkbenchExtended?.Call("API_GetWorkbenchLevel", player);

// Set level manually (temporary)
WorkbenchExtended?.Call("API_SetPlayerLevel", player, 3, 60f);

// Invalidate player cache
WorkbenchExtended?.Call("API_InvalidateCache", player);

// Get cache statistics
Dictionary<string, object> stats = (Dictionary<string, object>)WorkbenchExtended?.Call("API_GetCacheStats");

Feedback & Support

If you encounter any errors, issues, or have suggestions for improving or expanding the plugin's functionality, please let me know! I will gladly consider them all. Please feel free to share your thoughts in the Comments section.