JJM Modifications
🤖

Troubleshooting

Solutions to common issues with JM-SimpleHUD.

Work through the steps below before reaching out for support.

HUD is not visible#

  • Confirm the resource is running: type ensure JM-SimpleHUD in the server console and check for errors.
  • Make sure Config.Enabled is true in config.lua.
  • If you have toggled the HUD off in-game, use /simplehud to turn it back on.
  • Check that Config.HideWhenHudHidden is not hiding the HUD — open the pause map to rule out cinematic/radar-hidden state.
  • Look for JavaScript errors in the FiveM client console (F8) related to app.js or index.html.

Postal code is not showing or is wrong#

  • Check the server console for a message from [jm_simplehud] about loading postals. If it reports 0 postals loaded, the data/postals.json file may be missing or malformed.
  • Confirm your postal file uses code, x, and y fields (or wraps the array under a postals key).
  • If postals update slowly in fast-moving vehicles, lower Config.PostalUpdateMs (e.g. 500) or increase Config.PostalSearchRings to scan more grid cells.

Street, area, or county is incorrect#

  • Street and zone data come directly from the GTA V map. Custom map additions may produce zone codes not recognised by the resource.
  • If a location is showing the wrong county, add or remove the relevant zone short code from Config.Counties.BlaineZones in config.lua.

HUD overlaps the minimap#

  • Ensure Config.AnchorToMinimap is true. When enabled, the HUD automatically repositions above the minimap.
  • Fine-tune the gap with Config.MinimapMarginX and Config.MinimapMarginY.
  • If your server uses a custom minimap size or position, disable Config.AnchorToMinimap and set Config.Position manually.

Near label is not appearing#

  • Confirm Config.Near.Enabled is true.
  • Check that the player is within Config.Near.Radius game units of a location defined in Config.Near.Locations.
  • Increase the radius or add the relevant location to the list if needed.

Getting support#

When contacting support through your Tebex product page or ticket system, please include:

  • Your FiveM server artifact version.
  • Any console errors (server and client F8 console).
  • A brief description of what you expected versus what happened.