> For the complete documentation index, see [llms.txt](https://fetchq-store.gitbook.io/fetchq-store-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fetchq-store.gitbook.io/fetchq-store-docs/advanced-interactive-wanted-poster-script.md). # Advanced Interactive Wanted Poster Script ## 🎯 FetchQ Bounty An immersive, feature-rich wanted poster and bounty system for FiveM servers. Allow your law enforcement or players to create, place, and hunt down bounties using interactive 3D posters placed anywhere in the world. *** ### 🌟 Overview **FetchQ Bounty** introduces a dynamic wanted poster placement system. Police officers (or authorized players) can design custom bounty posters via an interactive UI and physically attach them to walls across the city. Ranging from modern A4 case files to classic frontier warrants, this script offers a highly immersive way to track criminals and reward bounty hunters. *** ### ✨ Features #### 📝 Dynamic Poster Creation & Designs * **Custom Designs:** Choose from 5 different unique poster styles (A4 Case File, Reward Broadside, Frontier Warrant, Telegraph Notice, Marshal Dossier) to fit any roleplay scenario. * **Detailed Information:** Input the target's name, crime, description, a custom photo URL, and set a custom reward amount (up to configurable maximums). * **Expiration System:** Set an expiration timer (e.g., 72 hours). Posters automatically expire and show a damaged/expired state before cleanup. #### 📍 Interactive 3D World Placement * **Live HUD Preview:** Use an advanced placement HUD to position the poster exactly where you want it on any wall or surface. * **Adjustable Transform:** Easily scale, rotate, and adjust the height of the poster before confirming the placement. * **Global Sync:** The poster is rendered from a dedicated DUI page onto a textured 3D quad, ensuring it is flawlessly synced and visible to all players in the server. #### 🔍 Reading & Interacting * **Seamless Interaction:** Nearby players can walk up to a poster on the wall, use an eye-target or text prompt to interact, and read the high-resolution DUI poster up close. * **Multiple Integrations:** Built-in support for `qb-text`, `ox_lib`, `qb-target`, and `ox_target` for seamless reading interactions. #### 👥 Management & Access Control * **Active Bounty List:** Use a dedicated UI (`/wantedlist`) to view all active bounties, mark them as completed, or remove them entirely from the world. * **Job Locking:** Restrict poster creation and management to specific jobs (like police) or open it up for public use via the configuration. #### ⚙️ System & Administration * **Framework Auto-Detection:** Seamlessly integrates out-of-the-box with `qb-core`, `qbx_core`, and `es_extended`. * **Persistent Storage:** All active posters are safely stored in a local `posters.json` file, meaning they will automatically restore exactly where they were placed after a server restart. *** ### 🚀 Installation & Configuration #### 1. General Setup The script **does not require any SQL database!** It uses a localized JSON file to manage history and active bounties. Simply place it in your resources folder and ensure it in your `server.cfg`. #### 2. Framework Adjustments > \[!IMPORTANT] The resource uses `Config.Framework = 'auto'` to automatically detect your core. You can manually set this to `qb`, `qbox`, or `esx` if needed. Ensure you have the corresponding target or drawtext script enabled for poster interactions. #### 3. Permissions & Commands By default, the script commands (`/wanted`, `/wantedlist`, `/wantedplace`) are restricted to the police job. > \[!TIP] To make it a public bounty hunting system, simply change `Config.Access.Public = true` in the config. *** ### 🛠️ Customization (`config.lua`) You can easily customize almost every aspect of the script in `config.lua`: * **Designs & Rewards:** Modify poster designs, max/min reward limits, default expiration hours, and string lengths. * **Placement Physics:** Fine-tune the placement distances, rotation steps, scaling limits, and surface offsets for the 3D projection. * **Interactions:** Choose your preferred prompt system (`qb-text`, `ox_lib` floating text, or a target eye resource) in `Config.Interaction`. * **Translations:** Easily translate all in-game notifications, errors, and prompts via the `Config.Text` table. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://fetchq-store.gitbook.io/fetchq-store-docs/advanced-interactive-wanted-poster-script.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.