# ShowBB

ShowBB is a lightweight Rust/Oxide plugin that visually displays Building Block spheres around areas where building is restricted.

The plugin automatically detects building-blocking spheres from the map and displays them to players when they are close enough, while only networking the spheres to players who need to see them. This keeps the visual information useful without unnecessarily sending every sphere to every player.

Features

* 🔴 Displays Building Block Spheres

* Shows building-blocking areas using the familiar red sphere effect.
* 🗺️ Automatic Map Detection

* Automatically scans the map for supported building-block sphere locations when the server starts.
* 👁️ Distance-Based Visibility

* Spheres are only shown to players within the configured viewing distance.
* 📡 Optimized Networking

* Uses per-player networking to show and hide spheres rather than globally networking everything to every player.
* 🏠 Deployable Support

* Automatically enables the sphere display system while players are holding the Building Plan or a valid deployable item.
* 🟣 Optional Safe Zone Spheres

* Can display safe zones using a separate purple sphere.
* ⚙️ Configurable Update Rate

* Control how frequently player distance checks are performed.
* 📏 Configurable View Extension

* Extend the visibility distance beyond the actual sphere radius.
* 🧹 Automatic Cleanup

* Properly removes player components and spawned sphere entities when the plugin unloads.

Configuration

The configuration file is located at:

oxide/config/ShowBB.json

Example configuration:

{
  "Extra Distance From Radius To Extend View": 20,
  "Show Safe Zones With Safe Zone Sphere": false,
  "Safe Zone Sphere": "assets/bundled/prefabs/modding/events/twitch/br_sphere_purple.prefab",
  "Component Tick Rate (sec)": 3.0
}

Configuration Options

| Setting | Default | Description |
| ------------------------------------------- | -------------------: | --------------------------------------------------------------------------------- |
| Extra Distance From Radius To Extend View | 20 | Additional distance beyond the sphere radius at which players can see the sphere. |
| Show Safe Zones With Safe Zone Sphere | false | Enables visualization of safe zones with a purple sphere. |
| Safe Zone Sphere | Purple sphere prefab | Prefab used when displaying safe zones. |
| Component Tick Rate (sec) | 3.0 | How frequently player distance/networking checks are performed. |

How It Works

When the server starts, ShowBB scans the map's serialized prefabs and identifies supported building-block and safe-zone sphere locations.

The plugin creates its own sphere entities and controls their networking on a per-player basis. When a player enters the appropriate viewing distance, the sphere is sent to their client. When they move away, it is removed from their view.

The display controller is only attached to players while they are holding a Building Plan or supported deployable, keeping unnecessary processing to a minimum.

Performance

ShowBB is designed to avoid unnecessary global networking.

Instead of making every sphere visible to every player, the plugin tracks which players have received each sphere and only sends or removes the sphere when the player crosses the configured visibility threshold.

The distance check interval is configurable, allowing server owners to balance responsiveness and performance.

Installation

1. Download ShowBB.cs.
2. Place it in:

oxide/plugins/

3. The plugin will automatically generate its configuration file.
4. Configure oxide/config/ShowBB.json if required.
5. Reload the plugin or restart the server.

ShowBB