> For the complete documentation index, see [llms.txt](https://x1studios.gitbook.io/x1studios-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://x1studios.gitbook.io/x1studios-docs/advanced-aop-system/documentation.md). # Documentation ## X1Studios Advanced AOP System ### Overview The **X1Studios Advanced AOP System** is a lightweight and fully standalone Area of Patrol management system designed for FiveM roleplay servers. The system allows authorized staff members to quickly change the server's active Area of Patrol while automatically displaying the current AOP to players through a clean, modern in-game UI. Built with performance and simplicity in mind, the Advanced AOP System requires **no external frameworks or dependencies**. The system also supports **Discord role-based ACE permissions** and **Discord webhook logging**, giving server owners additional control and visibility over staff AOP changes. *** ## Features ### Fully Standalone X1Studios Advanced AOP System is completely standalone. It does not require: * ESX * QBCore * QBox * ox\_lib * Any other framework * Any external dependency The script can be installed directly onto virtually any FiveM server. *** ### Discord ACE Permissions Server owners can control access to the AOP management system using Discord roles. Authorized Discord roles can be granted permission to access the AOP management menu. This prevents unauthorized players from changing the active patrol area. #### Permission Benefits * Role-based staff access * Prevents unauthorized AOP changes * Uses FiveM ACE permissions * Works with Discord role integration * Easy to manage through server configuration *** ## Discord Webhook Logging Every AOP change can be logged to a Discord channel through a webhook. Logs can provide staff with a record of AOP changes, including information such as: * Staff member who made the change * New AOP * Time of the change This provides server owners and management with an easy way to monitor changes made to the patrol area. *** ## AOP Selection Menu Authorized staff members have access to a dedicated AOP management menu. The menu allows staff to quickly select the active Area of Patrol during an active roleplay session. The system is designed to make changing the AOP quick and straightforward without requiring complicated commands or configuration changes. *** ## AOP Display UI Players are shown the currently active AOP through an in-game UI element. The UI provides players with an immediate indication of the current patrol area without requiring them to open a menu or use a command. The display is designed to remain lightweight while providing a clean appearance. *** ## Customizable UI The AOP display can be customized to better match your server's branding and visual design. Server owners can configure the available UI options provided by the resource. This allows the AOP display to fit naturally alongside other server UI systems. *** ## Performance The Advanced AOP System was designed with performance in mind. The script uses a lightweight approach to managing and displaying the active AOP, making it suitable for both small communities and larger, high-player-count roleplay servers. *** ## How The System Works The basic AOP workflow is simple: **1.** An authorized staff member opens the AOP menu. **2.** The staff member selects the desired patrol area. **3.** The active AOP is updated. **4.** Players are shown the updated AOP through the UI. **5.** The AOP change can be sent to Discord through the configured webhook. This allows staff to manage patrol areas quickly while keeping the entire server informed. *** ## Permissions Access to the AOP management menu is restricted through the configured ACE permissions. Server owners should ensure that only trusted staff members receive the required permission. The exact permission identifier and Discord role configuration can be found within the resource's configuration files. *** ## Discord Integration The system can integrate with your Discord server for both permissions and logging. #### Discord Permissions Discord roles can be used to determine which users are authorized to manage the AOP. #### Discord Logging A Discord webhook can be configured to send AOP change logs to a designated Discord channel. *** ## Requirements #### Required Dependencies **Nothing.** X1Studios Advanced AOP System is: * 100% standalone * Framework independent * Dependency free * Ready to install on a FiveM server *** ## Compatibility The script is designed to work with any FiveM server configuration. #### Supported * Standalone * QBCore * QBox * ESX * vMenu * Custom server frameworks Because the system does not rely on a framework, it can operate independently alongside other server resources. *** ## Support X1Studios provides support through Discord. #### Support Policy For assistance with the Advanced AOP System, please open a support ticket in the official X1Studios Discord. #### X1Studios Discord *** ## Community Join the X1Studios Discord to see: * Upcoming FiveM scripts * Free FiveM EUP packs * Custom liveries * Development previews * New releases * Updates * Support **X1Studios Discord** --- # 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://x1studios.gitbook.io/x1studios-docs/advanced-aop-system/documentation.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.