GhiaccioScripts

Radio

Troubleshooting

Double animation, missing prop, item problems, job channels, transmit blocks and death detection.

#Two animations at once

setr voice_enableRadioAnim 0 is missing. Set it in server.cfg before ensure pma-voice and restart.

#The radio prop does not show

ghiaccio_radio_props is not started, or it starts after ghiaccio_radio. Start it before. Without the model the radio falls back to prop_cs_hand_radio with a console warning. For your own prop check the .ytyp is registered with data_file and the names match (Config.Debug = true).

#Prop in hand but no animation

The prop is on the wrong hand. The random@arrests clips move the LEFT hand (bone 60309), the phone-style clips move the RIGHT hand (bone 28422). Fix prop.bone in the preset.

#Cannot open the radio / using the item does nothing

  • The radio item is missing: see Installation. Or set Config.RequireItem = false.
  • ox_inventory: the item needs client = { event = 'ghiaccio_radio:client:use' }.
  • QBCore / ESX: Config.UsableItem must be true.
  • Without an inventory resource the item requirement is ignored with a warning. qs-inventory is not tested.

#The player is disconnected after losing the item

Intended: the server checks the item every Config.ItemCheckSeconds seconds and on every action.

#Cannot join a job channel

The job or grade does not match jobs in Config.JobChannels (config_server.lua), or onDuty = true and the player is off duty. On standalone nobody has a job: return { name, grade } from bridge/server/standalone.lua. If the job or grade changes, the player is removed from the channel (re-read every Config.JobRecheckSeconds).

#Channels clash with other scripts

Other scripts already use small numeric pma-voice channels. Raise Config.ChannelOffset in config_server.lua.

#Cannot transmit

  • Dead or cuffed: the radio does not transmit (Config.Death).
  • No signal: below Config.Signal.minTransmit bars with blockTransmit = true. Move near a tower or set blockTransmit = false.
  • PTT cooldown: a press within Config.Ptt.cooldown ms of the previous one is refused. Release and press again.
  • A pma-voice radioDelay stacks with the radio cooldown: set one of them to 0.
  • A weapon in hand does not block the radio.

#The radio thinks I am dead (or the opposite)

Check Config.Death.mode. With a custom ambulance script use 'export', 'event' or 'statebag'.

#Esc opens the pause menu

Update to 1.1.0: with the UI open, Esc only closes the radio.

#"Too many requests"

A network rate limit in Config.RateLimit was hit. Wait a few seconds. Rejected requests are logged with Config.LogRejected.

#Settings and favorites are not saved

Check the console line about storage. With oxmysql started the data goes to the database; otherwise to the server KVP. Data is tied to the Rockstar license, not to the character.

#A custom animation preset is ignored

Presets are validated at start: an invalid one is skipped with a warning naming the preset and the field. Check the server console. A non-existent dict is silently ignored in game.