> For the complete documentation index, see [llms.txt](https://baobab-interactive.gitbook.io/baobab-interactive-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://baobab-interactive.gitbook.io/baobab-interactive-docs/junk-removal-simulator/troubleshooting.md).

# Troubleshooting

| Symptom                      | Check                                                                                                                                 |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Tablet will not open         | Confirm the resource started, inspect F8/server errors, try /junk and check the player's key binding.                                 |
| Admin page missing           | Config.Admin.Enabled, configured ACE and the player's actual group membership.                                                        |
| Messages unavailable         | Read the displayed error, confirm the selected framework/character loaded, check KVP write access and use Refresh Messages.           |
| No new inquiries             | Go on duty, allow the default 2–5 minute interval, make room in the inbox and check eligible deployed sites/rigs.                     |
| Advanced rig missing         | Required resources and APIs, ownership, XP and supported truck/trailer combination.                                                   |
| Cannot book a visit          | Resolve saved cleanup, pending payment, active visit, busy property or equipment condition shown in Messages.                         |
| GPS interrupted              | Choose job GPS again or use /junk gps. Current behavior uses one destination marker.                                                  |
| Trailer will not load/dump   | Follow its readiness message; check hitch, body, doors, location, stopped rig and controller status. Resolve salvage before disposal. |
| Saved cleanup blocked        | Restore the required equipment and unchanged job definition; follow the recovery reason before canceling.                             |
| Editor export missing        | Export prepared jobs, then check data/exports/job\_sites.txt on the server, not the player's computer.                                |
| Edited locations not offered | Deploy Config.DeployedJobs into shared/jobs.lua and restart. Check enabled, XP, rig allowlist and validation errors.                  |
| Machinery inquiries missing  | Install compatible machinery/roll-off resources and deploy an enabled machinery site; none ships deployed.                            |
| Native missing               | Update the FXServer artifact and confirm OneSync.                                                                                     |
| Payment needs a log check    | Use the exact receipt reconciliation procedure in Frameworks and payments; do not blindly retry or grant duplicate money.             |

## Reporting an issue

Include:

* Runtime/distribution version and framework/core version.
* Relevant optional equipment/controller versions.
* Job type, deployed location and objective stage.
* Reproduction steps and what you expected.
* Relevant F8/server errors and, for payments, the receipt reference.
* Whether the issue occurs with the free Bison on a minimal standalone installation.

Remove player identifiers, credentials and private server information before sharing logs. Preserve KVP and affected job definitions so recovery problems can be investigated.

See [Frameworks and payments](/baobab-interactive-docs/junk-removal-simulator/frameworks-and-payments.md), [Saved data and upgrades](/baobab-interactive-docs/junk-removal-simulator/saved-data-and-upgrades.md) and [Trailers and specialized work](/baobab-interactive-docs/junk-removal-simulator/trailers-and-specialized-work.md).