PA | Megaphone

This resource adds a working megaphone system for emergency vehicles, helicopters, and handheld use.

Installation

Make sure you are using the latest version of pma-voice

1

Enable native audio and submixes

Add these lines into your server.cfg

setr voice_useNativeAudio true
setr voice_enableSubmix 1

Those lines must be added above the line ensure pma-voice or ensure [standalone]

2

Drop this resource folder into your resources folder

3

Add the following line to your server.cfg

ensure cfx-retro-megaphone
4

Optional

You can also add 

setr voice_disableAutomaticListenerOnCamera 1

to the server.cfg

This changes how audio is heard depending on the camera position.

Configuration

All settings are inside config.lua.

Keybinds

Config.EnableKeybinds = true -- Enable/Disable keybinds
Config.VehicleMegaphoneBind = 'K' -- Key for vehicle megaphone
Config.HandMegaphoneBind = 'H' -- Key for handheld megaphone

  • EnableKeybinds: Master switch for using keybinds.

  • VehicleMegaphoneBind: Key used when inside a vehicle.

  • HandMegaphoneBind: Key used when holding a handheld megaphone (not in vehicle).

Voice Effect

Config.MegaphoneEffect = 3 -- 1 = default, 2 = new, 3 = custom

  • 1: Default GTA effect

  • 2: Alternative effect

  • 3: Custom effect using Config.SubmixSettings

Vehicle support

Config.OnlyFromList = false
Config.PoliceVehicles = {
  [`So2`] = true,
  [`So3`] = true,
  [`So4`] = true,
  [`So5`] = true
}
Config.Helis = {
  [`frogger`] = true,
}

  • OnlyFromList:

    • true → Only vehicles listed in Config.PoliceVehicles will have megaphone access.

    • false → Works in all emergency vehicles.

  • PoliceVehicles: List of vehicle models allowed to use megaphone.

  • Helis: List of helicopters allowed to use megaphone.

Only for front seats

Config.OnlyFrontSeats = true

If set to true only players in the front seats will be able to use PA (Public Address) system.

Effect distances

Config.MegaphoneProximity = 20.0
Config.HeliMegaphoneProximity = 48.0
Config.HandProximity = 14.0

  • MegaphoneProximity: Range when using vehicle megaphone.

  • HeliMegaphoneProximity: Range when using helicopter megaphone.

  • HandProximity: Range when using handheld megaphone.

If your voice distance does not change after adjusting the values above try istalling v7.0.0 of pma-voice (pay attention to the changes in the changelog)

Volume Control

Config.CustomVolume = true
Config.CustomVolumeFloat = 1.8

  • CustomVolume: Enables bypassing 3D distance and using fixed volume.

  • CustomVolumeFloat: Adjusts volume multiplier (play around with values).

Framework & Item checker support

Config.Framework = 'standalone' -- esx | qb-core | qbox | ox | standalone
Config.MegaphoneItemName = 'megaphone'

  • Framework: Choose your framework (standalone requires manual edit in inventory/client.lua).

  • MegaphoneItemName: Item name required for handheld megaphone.

Submix & Settings

Config.SubmixSettings = {
  freq_low = 289.0,
  freq_hi = 9000.0,
  fudge = 0.5,
  rm_mod_freq = 1.0,
  rm_mix = 0.16,
  o_freq_lo = 548.0,
  o_freq_hi = 8900.0
}

Custom audio effect configuration using GTA’s SetAudioSubmixEffectParamFloat native.

PreviousStinger Strip

Last updated