JJM Modifications
🤖

Troubleshooting

Solutions to common issues with JM-UwUCatCafe.

If something is not working as expected, work through the relevant section below before reaching out for support.

Resource Fails to Start#

  • Confirm all dependencies (qb-core/qbx_core, qb-target/ox_target, PolyZone, qb-doorlock, qb-menu) are started before JM-UwUCatCafe in server.cfg.
  • Check the server console for a red [JM-UwUCatCafe] error line — it will indicate which dependency is missing.

Interaction Zones Don't Appear#

  • Ensure PolyZone is running. Without it the resource will not create any interactive zones.
  • Check that Config.TargetSystem in config.lua matches the target resource you actually have installed ('qb-target' or 'ox_target').
  • Enable Config.TargetDebug = true temporarily to draw zone boxes in-game and verify their positions.

Staff Can't Clock In#

  • Verify the player's character is assigned the uwucafe job in the database.
  • Confirm the server's system clock is within the configured business hours (Config.BusinessHours.Open to Config.BusinessHours.Close). Use /uwuhours to adjust hours temporarily for testing.
  • Make sure the player is standing within the duty clock zone radius.

Register or Shop Not Opening#

  • The register only works for on-duty uwucafe staff. Confirm the player is clocked in.
  • Verify that item entries have been added to your inventory resource and that item images are in the correct folder.
  • Check the server console for any CreateShop or registerShop errors when the resource starts.

Items Not Showing in Inventory#

  • Ensure you copied the correct item block from items/items.lua or items/ox_inventory.lua into your inventory resource.
  • Copy item images from the items/ folder into your inventory's images directory.
  • Restart your inventory resource (or the full server) after adding new items.

Door Locks Not Working#

  • Confirm the four .lua files from qb-door-lock-files/ are in your qb-doorlock/configs/ directory.
  • Restart qb-doorlock after adding the files.
  • If you use a different cafe MLO, the door object coordinates and hashes may not match — update the files accordingly.

Security Alarm Triggers Incorrectly#

  • Review Config.Security.Zones and adjust Center and Radius values so they don't overlap public areas.
  • Use /uwusecurity to disarm the system while you adjust zone positions.

Stock Is Not Persisting#

  • The resource requires oxmysql or ghmattimysql to save stock to the database. If neither is found, a console warning is printed and stock resets on restart.
  • Confirm uwu_catcafe.sql has been imported and the uwu_store_stock table exists.

Getting Further Help#

If the issue isn't covered here, open a ticket in the JM Modifications Discord: [https://discord.gg/N9KgZx4KUn](https://discord.gg/N9KgZx4KUn)