Common Issues
"/radio" doesn't open and shows "You need: radio"
You don't have the item, or the inventory isn't responding. Check exports['biyei_radio']:getIntegration() and public/inventory.lua. Set Config.RequireItem = false to test without it.
Using the item in the inventory does nothing
items.lua is missing client = { export = 'biyei_radio.openRadio' } }, or the inventory resource wasn't restarted after editing it.
I can't hear the radio / volume doesn't change
pma-voice only applies the radio volume when the other player is more than ~4 m away. Up close you hear them through proximity voice instead.
The menu doesn't get focus / doesn't scroll
Make sure biyei_radio is ensured after pma-voice, and rebuild the UI (npm run build).
The UI doesn't load (blank screen)
web/dist is missing. Run npm install && npm run build inside web/.
My real name shows up even in anonymous mode
Anonymous mode is applied when you join a frequency — toggle it before joining, or leave and rejoin after switching it.
SCRIPT ERROR: "Dict: <name> did not exist" when talking on the radio
The dict in one of your Config.Animations entries isn't a valid/streamed animation dictionary on that server (pma-voice checks DoesAnimDictExist before applying it). The 3 built-in presets use vanilla dictionaries (random@arrests, cellphone@str) except anim@male@holding_radio, which is not a stock GTA V dict — it must be provided by a separate streamed anim-pack resource. Either install that anim pack, or change Config.DefaultAnimation / edit that preset's dict to a vanilla one.