# In-Game Repeaters

{% embed url="<https://www.youtube.com/watch?v=sHAgi1Z_Er8>" %}

## Available Repeater Types

### Server Rack

Server rack style repeaters are found by default inside of police stations and hospitals. These repeaters offer the most interactive destruction experience.

Press `E` on the door to open it.

Each server inside can be individually destroyed and will fall separately out of the rack. These can be configured with 1-5 servers in each. As more of these servers are destroyed, the repeater signal will diminish.

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FmgOnpBJj4gPTcs0cv1d5%2Fserver.png?alt=media&#x26;token=021eb0f3-4a3f-4939-b18b-1652b9da80c6" alt=""><figcaption><p>Server Rack</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FN2PGkt9Zzqz3vHTrHBCz%2Fserver_opened.png?alt=media&#x26;token=d72b50b8-dcf0-4b2a-a633-a08741b5a4b9" alt=""><figcaption><p>Server Rack - Opened</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FaTalvuJvr0EEy0GwKvT1%2Fserver_destroyed.png?alt=media&#x26;token=e866374d-f58b-46f7-90e8-3b4503e90af2" alt=""><figcaption><p>Server Rack - Destroyed</p></figcaption></figure></div>

### Radio Tower

Tower style repeaters are found by default on hills, mountains, and large rooftops.

Players can climb the ladder to reach the top.

There are four dishes inside that each account for 25% of the health. As more of these dishes are destroyed, the repeater signal will diminish.

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2F7jnBJLmuJ4D9iFR0FUE4%2Ftower%20(1).png?alt=media&#x26;token=b107f44f-ca3d-49f0-9922-07c1626451ce" alt=""><figcaption><p>Radio Tower</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FLx1BY47xDLBLujxXe6lF%2Ftower_broken.png?alt=media&#x26;token=a2f4c616-5a2d-4737-a6aa-42f590312999" alt=""><figcaption><p>Radio Tower - Destroyed</p></figcaption></figure></div>

### Cellular Antenna

Cellular antenna style repeaters are found by default on the side of high-rises and other buildings.

Destroying this antenna will disable it's repeater range.

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FgzHGrKTG2Fl0J8iJqEb8%2Fcell.png?alt=media&#x26;token=a7e544ea-0130-43cb-a7ce-79b474a31a43" alt=""><figcaption><p>Cellular Antenna</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FvOt4GJsnYDPgZ1WRCIBa%2Fcell_destroyed.png?alt=media&#x26;token=70ff289a-e4ab-4710-a668-abde7afc5843" alt=""><figcaption><p>Cellular Antenna - Destroyed</p></figcaption></figure></div>

### Custom Repeaters

Additional integrations like the [mobile command center](#mobile-command-center-repeater), [power grid hacking](#hacking-repeaters-power-grid-integration), and [custom vehicle repeaters](#mobile-vehicle-repeaters) offer further customization.

***

## Configuration

### Tower Placement

#### Default Positions

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FZXosfpoXocmcQy6ZrMWr%2FDefault%20Placement.png?alt=media&#x26;token=45483307-9eea-44a8-b2cd-f0ff1bd49029" alt="" width="303"><figcaption><p>Sonoran Radio - Default Tower Positions</p></figcaption></figure>

#### Game Menu Configuration

To add, edit, or remove a repeater, open the configuration menu by typing `/radioMenu`

Access to this command requires the `sonoranradio.towers` [ACE permission](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/configuring-ace-permissions).

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FFXnhnwDya2tj7Q99jOV3%2Fimage.png?alt=media&#x26;token=587730a9-6b9c-4971-8ed4-cc8162f230a2" alt=""><figcaption><p>Spawn Repeater</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FbGP9901U4A6HotO4E6Yx%2Fimage.png?alt=media&#x26;token=4042f0f3-9950-419b-bc11-c99bc919d28b" alt=""><figcaption><p>Move/Edit Repeater</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FJ9oSi9q5VnJ7SOzpwHJu%2Fimage.png?alt=media&#x26;token=c9500654-fc9f-4a96-85f0-ce6705687762" alt=""><figcaption><p>Delete Repeater</p></figcaption></figure></div>

#### Manual Configuration

Alternatively, you can edit the individual `towers.json` file in the `sonoranradio` resource.

<details>

<summary>towers.json</summary>

```json
[
  // Radio Tower
  {
    // Unique Identifier
    "Id": "74d910e5-5705-4b58-baaf-88a8ca82734c",
    // Type of repeater (tower)
    "type": "radioTower",
    // XYZ Coordinates
    "PropPosition": {
      "x": -577.4769287109375,
      "y": -138.4747314453125,
      "z": 51.9765625
    },
    // Signal range in units
    "Range": 1500,
    // Allow destruction
    "Destruction": true
  },
  // Server Rack
  {
    // Unique Identifier
    "Id": "50a9c40a-e5bb-46b2-9a83-c5164599c64c",
    // Type of repeater (Server Rack)
    "type": "serverRack",
    // XYZ Coordinates
    "PropPosition": {
      "x": 443.3538513183594,
      "y": -983.1824340820312,
      "z": 30.6783447265625
    },
    // 360 degree compass heading for angles
    "heading": 90,
    // Signal range in units
    "Range": 1500,
    // Status of each server in rack: "alive" or "dead"
    "serverStatus": [
      "alive",
      "alive",
      "alive",
      "alive",
      "alive"
    ],
    // Is the repeater on or not
    "Powered": true,
    // Make the repeater invisible by setting to true
    "NotPhysical": false,
    // Temporary repeater
    "DontSaveMe": false,
    // Allow destruction
    "Destruction": true
  },
  // Cell Repeater
  {
    // Unique Identifier
    "Id": "1f68f034-500b-4b29-9356-8c8bf63fda04",
    // Type of repeater (cell repeater)
    "type": "cellRepeater",
    // XYZ Coordinates
    "PropPosition": {
      "x": 152.5,
      "y": -775.9000244140625,
      "z": 264.29998779296877
    },
    // 360 degree compass heading for angles
    "heading": 340.0,
    // Signal range in units
    "Range": 1500.0,
    // Is the repeater on or not
    "Powered": true,
    // Make the repeater invisible by setting to true
    "NotPhysical": false,
    // Temporary repeater
    "DontSaveMe": false,
    // Status of the antenna: "alive" or "dead"
    "AntennaStatus": "alive",
    // Allow destruction
    "Destruction": true
  }
]

```

</details>

***

## Using the In-Game Towers

### Destroying a Tower

When tower destruction is enabled, users can use any form of weapon to damage the repeaters.

Once damaged and destroyed, the tower no longer provides radio coverage within that range.

### Repairing a Tower

#### Individual Towers

Players can walk up to a destroyed repeater and press `G` to being the repair process.

The repair time can be configured in the `config.lua`'s `towerRepairTimer`.

You can also restrict permissions to repairing a tower with [ACE permissions](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/configuring-ace-permissions) by setting `acePermsForTowerRepair` to `true` in the `config.lua`.

#### All Towers

The configuration menu can be used to repair all repeaters on the map at once.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2F653WXKV0WOvUgFPuKIxh%2Fimage.png?alt=media&#x26;token=5ce95d45-3e3d-44ec-8f33-98fb76e82f75" alt="" width="222"><figcaption><p>Sonoran Radio: Repair All Repeaters</p></figcaption></figure>

### Viewing Tower Coverage

#### Via In-Game Map

Enabling`Config.debug` in the `config.lua` file will display a radius around each tower, where the edge represents 50% radio quality.

#### Via Sonoran CAD Live Map

View Sonoran Radio repeater signal strength and health on the integrated CAD live map.\
Or, view dispatch call information on the in-game radio!

{% content-ref url="../../integrations/sonoran-cad-integration" %}
[sonoran-cad-integration](https://docs.sonoransoftware.com/radio/tutorials/integrations/sonoran-cad-integration)
{% endcontent-ref %}

### Viewing Signal Strength

Coming Soon!

***

## Degrade Signals in Tunnels

Sonoran Radio also allows you to configure tunnels and other areas where signal will be degraded!

{% content-ref url="tunnels-and-degrade-zones" %}
[tunnels-and-degrade-zones](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/tunnels-and-degrade-zones)
{% endcontent-ref %}

***

## Additional Integrations

### Mobile Command Center Repeater

The [Sonoran Mobile Command Center](https://www.sonoran.store/package/5287071) also offers a built-in radio repeater to improve reception on a scene.

Raise the radio antenna by running the `/mccradio` command.

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FVzlgedLKHuCWSQM3mYj1%2Fmcc.png?alt=media&#x26;token=a4f07792-5959-49d9-97f1-53eb66a3b707" alt=""><figcaption><p>Sonoran Mobile Command Center</p></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FXpKcSgIGxEkCV2kzPWA1%2Fmcc_radio.png?alt=media&#x26;token=1db0b7e8-5cbb-4814-8201-b4b230be3993" alt=""><figcaption><p>Sonoran Mobile Command Center</p></figcaption></figure></div>

### Hacking Repeaters - Power Grid Integration

Communities can add additional [Sonoran Power Grid](https://www.sonoran.store/package/5120025) integration support, enabling users to hack a radio repeater's power source instead of destroying it.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FhB73m9If1mbEZRihuEuJ%2Fpower_grid_promo.png?alt=media&#x26;token=b72903cd-ed22-44a1-a930-7193946b6b6e" alt="" width="563"><figcaption><p>Sonoran Power Grid</p></figcaption></figure>

### Mobile (Vehicle) Repeaters

To extend coverage range, communities can also customize what vehicles contain a radio repeater.

In the `config.lua`, you can configure vehucle types and the range of a given vehicle's repeater.

**Example Config Structure:**

```lua
-- Enable mobile repeaters
Config.enableVehicleRepeaters = true
-- Mobile repeater spawncodes
Config.repeaterVehicleSpawncodes = {
    {model = "police", label = "Police Vehicle", range = 200},
    {model = "police2", label = "Police Vehicle", range = 200},
}
```

In-game, you can press `G` to toggle the mobile repeater on a configured vehicle.

If a vehicle is destroyed, it will no longer function as a radio repeater.