Skip to content

Latest commit

 

History

History
289 lines (186 loc) · 8.31 KB

in-game-repeaters.md

File metadata and controls

289 lines (186 loc) · 8.31 KB
description
Configure and customize destructible radio towers in-game to impact radio performance.

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.

Server Rack

Server Rack - Opened

Server Rack - Destroyed

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.

Radio Tower

Radio Tower - Destroyed

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.

Cellular Antenna

Cellular Antenna - Destroyed

Custom Repeaters

Additional integrations like the mobile command center, power grid hacking, and custom vehicle repeaters offer further customization.


Configuration

Tower Placement

Default Positions

Sonoran Radio - Default Tower Positions

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.

Spawn Repeater

Move/Edit Repeater

Delete Repeater

Manual Configuration

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

towers.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
  }
]

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

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 by setting acePermsForTowerRepair to true in the config.lua.

Viewing Tower Coverage

Via In-Game Map

EnablingConfig.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.md" %} sonoran-cad-integration.md {% 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.md" %} tunnels-and-degrade-zones.md {% endcontent-ref %}


Additional Integrations

Mobile Command Center Repeater

The Sonoran Mobile Command Center also offers a built-in radio repeater to improve reception on a scene.

Raise the radio antenna by running the /mccradio command.

Sonoran Mobile Command Center

Sonoran Mobile Command Center

Hacking Repeaters - Power Grid Integration

Communities can add additional Sonoran Power Grid integration support, enabling users to hack a radio repeater's power source instead of destroying it.

Sonoran Power Grid

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:

-- 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.