About Switch Guard
SwitchGuard
Prevents unauthorized players from toggling Industrial Conveyors and Fluid Switches (water pump switches) on your server. Integrates with Clans, Friends, and Rust Teams so teammates can still use shared infrastructure.
Features
- Blocks unauthorized toggling of Industrial Conveyors (on/off)
- Blocks unauthorized toggling of Fluid Switches (water pump switches)
- Integrates with Clans, Friends, and native Rust Teams
- TC (Tool Cupboard) authorization support
- Per-entity-type protection (enable/disable independently)
- Message cooldown to prevent chat spam
- Multi-language support (English, Portuguese, Spanish)
- Zero performance impact — uses HarmonyPatch to intercept only player-initiated toggles
- No data storage required — fully stateless
How It Works
When a player tries to toggle an Industrial Conveyor or Fluid Switch, the plugin checks (in order):
- Permission bypass — switchguard.bypass
- Admin permission — switchguard.admin
- Server admin — if enabled in config
- Owner — the player who placed the entity can always toggle it
- TC Authorization — if the player is authorized on the nearby Tool Cupboard
- Clans — if the player is in the same clan or an allied clan as the owner
- Friends — if the player is friends with the owner
- Rust Teams — if the player is on the same team as the owner
If none of these checks pass, the toggle is blocked and the player receives a message.
Note: Entities with no owner (OwnerID = 0) are not protected — anyone can toggle them.
Permissions
| Permission | Description |
|---|---|
| switchguard.bypass | Bypass all protection checks |
| switchguard.admin | Admin-level bypass |
Configuration
JSON Configuration:
{ "Admin can always toggle (server.IsAdmin bypass)": false, "Use Friends API": true, "Use Clans API": true, "Use Rust Teams": true, "Use TC Authorization": true, "Protect Industrial Conveyors": true, "Protect Fluid Switches": true, "Message cooldown (seconds)": 3.0 }
| Option | Default | Description |
|---|---|---|
| Admin can always toggle | false | Allow server admins to toggle any protected entity |
| Use Friends API | true | Check Friends plugin for authorization |
| Use Clans API | true | Check Clans plugin for authorization |
| Use Rust Teams | true | Check native Rust teams for authorization |
| Use TC Authorization | true | Allow toggle if player is authed on the nearby TC |
| Protect Industrial Conveyors | true | Enable protection for Industrial Conveyors |
| Protect Fluid Switches | true | Enable protection for Fluid Switches |
| Message cooldown | 3.0 | Seconds between "not authorized" messages per player |
Supported Plugins (Optional)
- Clans — clan member and ally checks
- Friends — friend relationship checks
These are optional. If not installed, the corresponding checks are simply skipped.
Localization
The plugin ships with three languages. Custom messages can be edited in the lang files.
English (en)
{ "NotAuthorized": "You are not authorized to toggle this device.", "NoPermission": "You do not have permission to use this." }
Portuguese (pt-BR)
{ "NotAuthorized": "Voce nao tem autorizacao para ligar/desligar este dispositivo.", "NoPermission": "Voce nao tem permissao para usar isso." }
Spanish (es-ES)
{ "NotAuthorized": "No tienes autorizacion para activar/desactivar este dispositivo.", "NoPermission": "No tienes permiso para usar esto." }
FAQ
Q: Does this affect circuit-driven toggles (power on/off via wiring)?
A: No. Only manual player interactions are intercepted. Electrical circuits, power sources, and timer-based toggles work normally.
Q: Does this protect regular Electric Switches?
A: No, only Fluid Switches and Industrial Conveyors. Regular Electric Switches are unaffected.
Q: What happens if I don't have Clans or Friends installed?
A: The plugin works fine without them. Those checks are simply skipped, and authorization falls back to owner, TC auth, and teams.
Q: Does this work with Carbon and Oxide?
A: Yes. The plugin uses HarmonyLib which is supported by both frameworks.
