The Ultimate City Exploration Experience!

Elevate the exploration roleplay on your server to a professional level. sh_cityguide is not just a simple location list; it’s a comprehensive in-game ecosystem featuring a premium book-style interface, dynamic category management, and powerful admin tools. Transform San Andreas into a discoverable, guided journey that your players will actually use.

🌟 Key Features:

Immersive Book-Style NUI:

A fully custom-designed interface styled as an interactive book. It features elegant category tabs, detailed location descriptions, and smooth transitions. Built to meet the highest premium server standards for maximum immersion.

In-Game Admin Editor:

Manage your city's points of interest without ever leaving gameplay! Authorized staff can access a dedicated editor modal to:

• Add, update, or delete categories and locations on the fly.

• Trigger instant data refreshes across the server.

• Utilize safety confirmation modals to prevent accidental deletions.

Advanced Permission Logic:

Robust access control that works out of the box with multiple systems:

• ACE Permissions for native security.

• Identifier Whitelists (Steam, License, etc.).

• Framework Groups (Admin, Superadmin, etc.).

Custom Branding & Localization:

Make the guide truly yours. Set your server logo via config.lua and the NUI will automatically adapt. Choose from multiple languages or easily add your own via the modular JSON system.

Smart GPS Integration:

No more typing coordinates. Players can set a waypoint to any selected location directly from the NUI with a single click, making city navigation effortless and practical.

🛠 Technical Information:

• Frameworks: Full "Plug-and-Play" support for ESX, QB-Core, and Qbox (auto-detection).

• Data Storage: High-performance JSON-based storage with server-side normalization and validation.

• Performance: 0.00ms on resmon when idle. Highly optimized code designed for high-population servers.

• Localization: Includes ready-to-use translations for EN, PL, DE, ES, FR, RU, TR.

• Developer Friendly: Open the guide from any other script using a simple export: exports['sh_cityguide']:openGuide()

❓ FAQ

Do I need to edit NUI files to change the logo?

No. Simply set your Config.ServerLogoUrl in the config.lua and the script handles the rest.

Is it hard to add new categories or locations?

Not at all. Authorized admins can manage everything through the intuitive in-game editor. No coding or script restarts required to update your city's map.

Can I disable the command or keybind?

Yes. The configuration allows you to toggle Config.EnableCommand and Config.EnableKeybind independently to suit your server's needs.

How do I add a new language?

Just create a new file in the locales/ folder, translate the keys, and update your Config.Locale. It’s that simple.

📦 What’s Included:

• Complete sh_cityguide resource.

• Ready-to-use category and location configurations.

• High-quality UI assets and icons.

• Detailed installation guide and documentation.