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

# aps_cityhall

A complete City Hall for **ESX, QBCore and Qbox**, presented as a Windows 7-style computer that players use in game.

Players walk up to the City Hall clerk and sit down at a PC with a desktop, taskbar, start menu and windows. From there they take theory exams, order documents, insure vehicles, pay bills and taxes, register businesses, apply for jobs and more. Every module can be switched off, and every price, text and table name is configurable.

***

## City Hall services

> [card] License Center
>
> Timed theory exams with question pools, fees, cooldowns and refunds.

> [card] Document Office
>
> ID cards, licenses, permits and badges as real items with serial number, photo and validity.

> [card] Vehicle Insurance
>
> Prices based on vehicle value and category, renewable plans.

> [card] Bills & Fines
>
> Invoices, tickets, traffic tickets and receipts through one export.

> [card] Vehicle Registry & VIN
>
> Every owned vehicle with plate, VIN, garage status and insurance.

> [card] Business Register
>
> Company directory with permits, business vehicles, employees and certificates.

> [card] Government Portal
>
> Staff review businesses and manage citizens' licenses, documents, bills and taxes. Access by job or login.

> [card] Taxes & Treasury
>
> Personal and business taxes, recurring vehicle and property tax, city treasury.

> [card] Job Center & Paychecks
>
> Take a job or apply for one; collect salaries at City Hall.

> [card] Suspension & Penalty Points
>
> Temporary license suspensions and points from traffic tickets.

> [card] Phone integration
>
> City Hall app, notifications and mails for sd-phone, LB Phone, 17Movement and more.

> [card] Hacking
>
> Hidden Command Prompt commands for criminal roleplay.

## The desktop

* **Windows 7 look:** Aero glass windows, Aero Snap, Ctrl+Tab switcher, taskbar previews, start menu with search, right-click menus, gadgets and a welcome screen.
* **Apps:** Internet (built-in city websites), File Explorer, Writer, Spreadsheet, Paint, Photo Viewer, Media Player, Mail, Command Prompt, Calculator, Notepad and Control Panel.
* **Mini-games** with server-side leaderboards and anti-cheat checks: Paperwork Tower, Queue Rush and Typing Test.
* **Per-player settings:** wallpaper, window colour, screen saver, clock format, account picture.
* **Translations:** English and German included, every text can be translated.

> [!NOTE]
>
> New here? Follow the [Installation](https://docs.aps-store.com/assets/aps_cityhall/installation.md), then go through [config.lua](https://docs.aps-store.com/assets/aps_cityhall/configuration-files/config.lua.md). Everything else is optional fine-tuning.

***

## Documentation

* [Installation](https://docs.aps-store.com/assets/aps_cityhall/installation.md)
* [Compability](https://docs.aps-store.com/assets/aps_cityhall/compability.md)
* [FAQ](https://docs.aps-store.com/assets/aps_cityhall/faq.md)
* [Common Errors](https://docs.aps-store.com/assets/aps_cityhall/common-errors.md)
* [Guides](https://docs.aps-store.com/assets/aps_cityhall/guides)
* [Developer API](https://docs.aps-store.com/assets/aps_cityhall/developer-api)
* [Configuration Files](https://docs.aps-store.com/assets/aps_cityhall/configuration-files)
* [Changelog](https://docs.aps-store.com/assets/aps_cityhall/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.