> ## Documentation Index
> Fetch the complete documentation index at: https://docs.virusstudio.in/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQs

> Common questions about vrs_newspaper: how rounds work, cooldowns, framework support, and troubleshooting.

### Gameplay

<AccordionGroup>
  <Accordion title="How does a round work?" icon="circle-play">
    Clock in at the depot, pick a district (districts on cooldown are shown but greyed out), and a bike spawns with a duffle bag on your back. The round's papers land in your inventory, one per house plus spares. Throw at the houses in any order, each marker clears as it lands, then ride back to the depot to hand the round in and get paid.
  </Accordion>

  <Accordion title="Can I change how and when players get paid?" icon="coins">
    Yes. `Config.Pay.perRoute` sets the base pay for a full round, split across the houses. `Config.Pay.payPerHouse` pays each house on the spot instead of at the end, and `Config.Route.handInAtDepot` controls whether pay lands the instant the last paper is thrown or only after riding back to the depot.
  </Accordion>

  <Accordion title="Do cooldowns survive a restart?" icon="clock">
    Yes. Cooldowns are stored against the character in MySQL, so relogs and server restarts do not clear them. `Config.Cooldowns.enabled` is the master switch, off by default.
  </Accordion>
</AccordionGroup>

### Setup and configuration

<AccordionGroup>
  <Accordion title="Which frameworks are supported?" icon="layers">
    QBox, QBCore, and ESX, via [vrs\_bridge](/getting-started/submitting-a-request). The bridge auto-detects the running framework, inventory, target script, and vehicle-key system, so no per-framework configuration is required.
  </Accordion>

  <Accordion title="Do I need to import an SQL file?" icon="database">
    No. Database tables are created automatically on first run. `sql/install.sql` is there if you prefer to provision by hand.
  </Accordion>

  <Accordion title="Can I add my own districts or delivery points?" icon="map-pin">
    Yes, either by editing `routes.lua` directly or by recording points live in-game with `/npbuilder`, see [Integrations](/newspaper/integrations#extending-delivery-points) for the commands and export flow. Street names are optional, leave `label` out and it is read from the world at runtime.
  </Accordion>

  <Accordion title="Can I lock the job behind a framework job?" icon="lock">
    Yes. Set `Config.Job.require = true` in `config.lua`, then add a `newspaper` job to your framework (QBox/QBCore `shared/jobs.lua`, or the `jobs`/`job_grades` tables for ESX). See [Installation](/newspaper/installation#optional-lock-it-behind-a-job).
  </Accordion>
</AccordionGroup>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Why does the depot say it has no papers to give out?" icon="triangle-alert">
    `WEAPON_NEWSPAPER` is not registered with your inventory. Add it to `data/weapons.lua` (not `items.lua`) and restart the inventory resource, new items are usually cached at boot.
  </Accordion>

  <Accordion title="Why does every throw cost two papers?" icon="triangle-alert">
    `Config.Papers.inventoryConsumes` is set to `false` on an inventory that already consumes throwables itself, causing a double deduction. Set it back to `true`.
  </Accordion>

  <Accordion title="Markers are floating or sitting underground, how do I fix that?" icon="triangle-alert">
    Set `groundSnap = true` on that district in `routes.lua`. Points recorded with the builder on the ground already default to this.
  </Accordion>

  <Accordion title="The resource won't start, what now?" icon="circle-x">
    Check the server console for the specific message. The most common causes are:

    * `vrs_bridge` is not started, or is older than **v1.3.0** (needed for the cooldown system).
    * `oxmysql` is not started or cannot connect.
    * `ox_lib` is missing.

    Ensure them in the correct order in `server.cfg`:

    ```cfg theme={null}
    ensure oxmysql
    ensure ox_lib
    ensure vrs_bridge
    ensure vrs_newspaper
    ```
  </Accordion>
</AccordionGroup>